Contributing to WooCommerce PayPal Payments ✨

WooCommerce PayPal Payments provides a comprehensive solution for online payment processing powered by PayPal. Your contributions to enhance this tool are invaluable. Let's collaborate to make it even better!

Here's how you can contribute:

• Help improve the translations in various languages.
• Answer questions in the WooCommerce PayPal Payments community or on related forums.
• Test open issues or pull requests and share your insights.
• Test beta versions and release candidates before the official release.
• Propose and submit bug fixes, improvements, and features.
• If you come across security vulnerabilities, please discreetly report them via HackerOne.

To contribute code, follow the guide below, fork the repository, commit your changes, and submit a pull request 🎉.

Beginner-friendly issues will be marked with the good first issue label. You can find them here.

The WooCommerce PayPal Payments plugin is licensed under the GPL-2.0. Any contribution you make will fall under this license. Though you retain copyright over your contribution, by making a pull request, you agree to release it under the GPL-2.0 license.

For questions or detailed discussions about your contributions, connect with the plugin support team or other plugin developers on the WooCommerce community Slack or other relevant channels.

Getting Started

Before diving in, familiarize yourself with the following resources:

• Project readme
• How to set up WooCommerce PayPal Payments development environment
• Naming conventions
• Running unit tests
• Running e2e tests
• Running Playwright tests

Coding Guidelines and Development 🛠

• Adhere to the WordPress Coding Standards.
• Refer to the documentation for setting up the development environment, which will guide you on installing hooks, dependencies, etc.
• Before pushing to GitHub, ensure your code aligns with our code standards by using the provided linters and tools.
• Please address and rectify any code standards violations in the segments you modify.
• Set your code editor to use LF line endings. If your editor supports EditorConfig, it will handle indentation, line endings, and other settings automatically.
• Reference any related issues in your commits and provide clear notes on the changes.
• Make sure your code is compatible with the minimum supported versions of PHP, WordPress, and WooCommerce mentioned in the readme.txt file.
• Push your changes to your fork and submit a pull request to the main branch of the WooCommerce PayPal Payments repository.
• Write concise and informative commit messages. A helpful guide on commit messages is available.
• Please avoid direct modifications to the changelog or .pot files. The WooCommerce team will handle these updates.

Feature Requests 🚀

To suggest new features, visit our feature request page. Here, you can browse, vote on, or create new feature requests.

Alternatively, for simple technical enhancements, open a new issue on GitHub. For topics that need more extensive discussion, it's a good idea to connect with the plugin support team.