Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/amnestywebsite/humanity-donations
Adds petitions support to WordPress in conjunction with the Humanity Theme and WooCommerce
https://github.com/amnestywebsite/humanity-donations
Last synced: 4 days ago
JSON representation
Adds petitions support to WordPress in conjunction with the Humanity Theme and WooCommerce
- Host: GitHub
- URL: https://github.com/amnestywebsite/humanity-donations
- Owner: amnestywebsite
- License: other
- Created: 2024-02-01T12:44:34.000Z (10 months ago)
- Default Branch: develop
- Last Pushed: 2024-10-16T13:30:16.000Z (about 1 month ago)
- Last Synced: 2024-10-19T15:04:14.045Z (about 1 month ago)
- Language: JavaScript
- Homepage:
- Size: 604 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Governance: GOVERNANCE.md
Awesome Lists containing this project
README
# Humanity Donations
This plugin leverages WooCommerce to provide support for individual and recurring, fixed and variable price donations.
## Minimum Requirements
This plugin requires:
- WordPress 5.8+
- PHP 8.2+ with the Intl extension
- [Humanity Theme](https://github.com/amnestywebsite/humanity-donations) v1.0.0+
## Required Plugins
- [WooCommerce](https://wordpress.org/plugins/woocommerce/)
- [WooCommerce Checkout Manager](https://quadlayers.com/portfolio/woocommerce-checkout-manager/)
- [WooCommerce Name Your Price](https://woocommerce.com/products/name-your-price/?quid=e43c9ef0c4c9521a6c2f6e5319a3ff63)
- [WooCommerce Subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/)
## Companion Plugins
- [Salesforce Adapter](https://github.com/amnestywebsite/humanity-donations-salesforce-adapter)
## Usage
The quickest way to get started using the plugin is to download the zip of the [latest release](https://github.com/amnestywebsite/humanity-donations/releases/latest), and install it via upload directly within WP Admin -> Plugins.
### One-off Donations
For fixed-price, one-off donations, create a *variable* product, and then follow the below process:
1. Create a custom attribute, and define the values (separated by a `|` pipe character) for each of the donation amounts you would like the user to be able to choose from. Ensure that you select the _used for variations_ option: 
2. Create variations from the attribute, and specify the price for each option.
3. For each variation, ensure that it is a) enabled, and b) virtual. For a donation of a custom amount, select the _name your price_ field: 
You may create as many donation products as you like, and insert them into pages via use of the *donation Gutenberg block*.
Having multiple donation products means that you can create products for different campaigns or calls to action that you wish to accept donations for.
### Recurring Donations (Subscriptions)
Create a *variable subscription* product, and follow the same process for One-off Donations.
### Donations Gutenberg Block
The donation block supports adding either donations, subscriptions, or both.
If both a donation and a subscription are added to the block, it will show the user an option to toggle the form between one-off and recurring donations.
To add the option for a user to choose a specific target campaign/fund for their donation, you will need to create a checkout field using WooCommerce Checkout Manager. Visit WooCommerce Settings -> Checkout -> Additional to create your field; then:
1. create a *select* field type (this is very important), and give it an appropriate label
2. create as many options within this field as you wish - one for each desired campaign/fund that you'd like the user to be able to support 
3. this field, once saved, can then be used within a donation block - the block will retrieve its label and options automatically once you have told it which field to use. You can see an example here: 
## Governance
See [GOVERNANCE.md](GOVERNANCE.md) for project governance information.
## Changelog
See [CHANGELOG.md](CHANGELOG.md) or [Releases page](https://github.com/amnestywebsite/humanity-donations/releases) for full changelogs.
## Contributing
For information on how to contribute to the project, or to get set up locally for development, please see the documentation in [CONTRIBUTING.md](CONTRIBUTING.md).
### Special Thanks
We'd like to say a special thank you to these lovely folks:
| [Cure53](https://cure53.de) | [WP Engine](https://wpengine.com) |
| --- | --- |
|  |  |
### Want to know more about the work in other Amnesty GitHub accounts?
You can find repositories from other teams such as [Amnesty Web Ops](https://github.com/amnestywebsite), [Amnesty Crisis](https://github.com/amnesty-crisis-evidence-lab), [Amnesty Tech](https://github.com/AmnestyTech), and [Amnesty Research](https://github.com/amnestyresearch/) in their GitHub accounts
