Givewp
GiveWP - The #1 Donation Plugin for WordPress. Easily accept donations and fundraise using your WordPress website.
Install / Use
/learn @impress-org/GivewpREADME
👉 Not a developer? Running WordPress? Download GiveWP on WordPress.org.
Welcome to the GiveWP GitHub repository. This is the core repository and heart of an ecosystem of active development. Here you can browse the source, look at open issues, and contribute to the project.
Many of our add-ons are in public repositories, however, the majority are private. If you have a legitimate need for access, please reach out to us and we'll be happy to grant you access.
🙋 Support
This repository is not suitable for WordPress admin or donor support. Please don't use GitHub issues for non-development related support requests. Don't get us wrong, we're more than happy to help you! However, to get the support you need please use the following channels:
- WP.org Support Forums - for all free users.
- Priority Support - exclusively for our customers.
- GiveWP Documentation - for all admins.
🌱 Getting Started
If you're looking to contribute or actively develop on GiveWP, welcome! We're glad you're here. Please ⭐️ this repository and fork it to begin local development.
Most of us are using Local by Flywheel to develop on WordPress, which makes set up quick and easy. If you prefer Docker, VVV, or another flavor of local development that's cool too!
✅ Prerequisites
- Node.js as JavaScript engine
- NPM npm command globally available in CLI
- Composer composer command globally available in CLI
💻 Local Development
To get started developing on the GiveWP platform you will need to perform the following steps:
- Create a new WordPress site with
give.testas the URL cdinto your local plugins directory:/path/to/wp-content/plugins/- Fork this repository from GitHub and then clone that into your plugins directory in a new
givedirectory - Run
composer installto set up dependencies - Run
npm installto get the necessary npm packages - Run
npm run devto build the initial scripts & styles - Activate the plugin in WordPress
That's it. You're now ready to start development.
Available commands
Note: We use @wordpress/scripts. The commands are as follows:
| Command | Description |
|:----------------|:------------------------------------------------------------------------|
| npm run dev | Runs a one time build for development. No production files are created. |
| npm run watch | Automatically re-builds as changes are made. |
| npm run build | Builds the minified production files for release. |
Development Notes
- Ensure that you have
SCRIPT_DEBUGenabled within your wp-config.php file. Here's a good example of wp-config.php for debugging:// Enable WP_DEBUG mode define( 'WP_DEBUG', true ); // Enable Debug logging to the /wp-content/debug.log file define( 'WP_DEBUG_LOG', true ); // Loads unminified core files define( 'SCRIPT_DEBUG', true ); - Commit the
package.lockfile. Read more about why here. - Your editor should recognize the
.eslintrcand.editorconfigfiles within the Repo's root directory. Please only submit PRs following those coding style rulesets. - Read CONTRIBUTING.md - it contains more about contributing to GiveWP.
