Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/breviam-llp/wp-donation-system
WP Donation System provides a complete donation management solution for WordPress websites
https://github.com/breviam-llp/wp-donation-system
donation-website donations mpesa-payments paypal wordpress wordpress-development wordpress-plugin wp-plugin
Last synced: about 1 month ago
JSON representation
WP Donation System provides a complete donation management solution for WordPress websites
- Host: GitHub
- URL: https://github.com/breviam-llp/wp-donation-system
- Owner: Breviam-LLP
- Created: 2024-12-02T09:40:34.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-12-12T09:01:23.000Z (about 1 month ago)
- Last Synced: 2024-12-12T11:19:31.116Z (about 1 month ago)
- Topics: donation-website, donations, mpesa-payments, paypal, wordpress, wordpress-development, wordpress-plugin, wp-plugin
- Language: PHP
- Homepage: https://github.com/victorKariuki/wp-donation-system/wiki
- Size: 300 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
# WP Donation System
A WordPress plugin for handling donations via PayPal and M-Pesa payment gateways.
## Description
WP Donation System provides a complete donation management solution for WordPress websites. It supports both PayPal and M-Pesa payment gateways, making it ideal for organizations that need to accept donations globally and within Kenya.
### Features
- Easy-to-use donation form
- Multiple payment gateways:
- PayPal
- M-Pesa
- Admin dashboard with:
- Donation management
- Detailed reports
- Export functionality
- Email notifications for:
- Donors (receipt)
- Administrators
- Test mode for safe testing
- Mobile-responsive design
- Detailed logging system
## Installation
1. Upload the `wp-donation-system` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to Donations > Settings to configure your payment gateways
4. Add the donation form to any page using the shortcode: `[donation_form]`
## Configuration
### PayPal Setup
1. Create a PayPal Developer account at https://developer.paypal.com
2. Create a new app to get your API credentials
3. Enter your Client ID and Secret in the plugin settings
4. Test using Sandbox mode before going live
### M-Pesa Setup
1. Create a Safaricom Developer account at https://developer.safaricom.co.ke
2. Create a new app to get your API credentials
3. Enter your Consumer Key, Secret, and Shortcode in the plugin settings
4. Test using Sandbox mode before going live
## Updates
### Checking for Updates
1. Log in to your WordPress dashboard
2. Navigate to Plugins > Installed Plugins
3. Look for "WP Donation System" in the list
4. If an update is available, you'll see an "Update Available" message
5. Click "View version x.x.x details" to see what's new
6. Click "Update Now" to install the latest version
### Automatic Updates
The plugin supports WordPress automatic updates. To enable:
1. Go to Dashboard > Settings > Auto Updates
2. Find "WP Donation System" in the plugins list
3. Toggle "Enable auto-updates"
Note: Always backup your website before updating any plugins.
## Usage
Add the donation form to any page or post using the shortcode: `[donation_form]`
## Contributing
We welcome contributions from the community! Please read our [Contributing Guidelines](CONTRIBUTING.md) before submitting pull requests.
### Development
- [Issue Tracker](https://github.com/victorKariuki/wp-donation-system/issues)
- [Source Code](https://github.com/victorKariuki/wp-donation-system)
See [CHANGELOG.md](CHANGELOG.md) for a list of changes and [CONTRIBUTING.md](CONTRIBUTING.md) for development setup instructions.
## Support
If you encounter any problems or have suggestions, please:
1. Check our [Documentation](https://github.com/victorKariuki/wp-donation-system/wiki)
2. Search the [Issues](https://github.com/victorKariuki/wp-donation-system/issues)
3. Create a new issue if your problem persists
## License
This project is licensed under the GPL v2 or later - see the [LICENSE](LICENSE) file for details.
## Authors
* **Victor Kariuki** - *Initial work* - [victorKariuki](https://github.com/victorKariuki)
See also the list of [contributors](https://github.com/victorKariuki/wp-donation-system/contributors) who participated in this project.
## Acknowledgments
* WordPress Plugin Development Team
* PayPal Developer Community
* Safaricom Developer Community