| 1 |
=== Donation Forms by Charitable - Donations Plugin & Fundraising Platform for WordPress === |
| 2 |
Contributors: WPCharitable, griffinjt, smub, dimensionmedia |
| 3 |
Tags: donate, donate button, donation, donations, fundraising, fundraising platform, donation form, donor, charity, campaign, fundraising campaign, paypal donations, stripe donations, credit card donations, crowdfunding, crowdfunding platform |
| 4 |
Requires at least: 4.1 |
| 5 |
Tested up to: 6.0.2 |
| 6 |
Stable tag: 1.7.0.2 |
| 7 |
License: GPLv2 or later |
| 8 |
License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 9 |
|
| 10 |
🤩 Easily accept donations on your website today with the smart donation forms and powerful fundraising platform by Charitable! 🚀 |
| 11 |
|
| 12 |
== Description == |
| 13 |
|
| 14 |
= The Best WordPress Donation & Fundraising Plugin = |
| 15 |
|
| 16 |
We believe that collecting online donations should be easy and affordable. That's why Charitable is makes it painless to create and publish high-converting donation forms and fundraising campaigns on your website. |
| 17 |
|
| 18 |
With Charitable, you can create fundraising campaigns in minutes, whether you need a donation form for your regular ongoing donations, you're raising money for a time-sensitive need, or you are collecting donations for a specific fundraising goal. |
| 19 |
|
| 20 |
Charitable is the top-rated WordPress donation plugin available, with 5-star reviews from 100+ happy users. |
| 21 |
|
| 22 |
Join 10,000+ non-profits getting more donations from their websites and growing their online fundraising campaigns with Charitable. |
| 23 |
|
| 24 |
> Grow your online fundraising platform faster with a Charitable Pro plan that has support for recurring donations, peer to peer fundraising, email marketing integrations, gateway fee recovery and much more. [Click here to unlock Charitable Pro, the most powerful WordPress fundraising plugin available.](https://www.wpcharitable.com/pricing/?utm_source=WordPress&utm_medium=Plugin+Readme+Charitable+Pro+Link&utm_campaign=Charitable&utm_content=Click+here+to+unlock+Charitable+Pro) |
| 25 |
|
| 26 |
[youtube https://www.youtube.com/watch?v=CqNOJ4H8guI] |
| 27 |
|
| 28 |
= Unlimited fundraising campaigns = |
| 29 |
|
| 30 |
Set up as many campaigns as you would like with Charitable and tailor them to your needs: |
| 31 |
|
| 32 |
* Create as many fundraising campaigns as you need. |
| 33 |
* Set fundraising and donation goals for your campaigns. |
| 34 |
* Create time-sensitive fundraising campaigns that end automatically when they're finished. |
| 35 |
* Inherits your theme's styles for seamless integration. |
| 36 |
|
| 37 |
= Customizable donation forms = |
| 38 |
|
| 39 |
You can completely customize your online fundraising and donation form experience. |
| 40 |
|
| 41 |
* Provide suggested amounts, allow people to donate as much as they want, or do both. |
| 42 |
* Load donation forms in a modal, on a separate page, or on the same page as the campaign. |
| 43 |
* Shorten your donation forms by just showing required fields. |
| 44 |
* Embed a donation form on any page. |
| 45 |
|
| 46 |
= PayPal donation forms made simple = |
| 47 |
|
| 48 |
Start accepting donations through PayPal without hiring a developer. |
| 49 |
|
| 50 |
* Add your PayPal address and you're done. |
| 51 |
* Donors use the secure, familiar PayPal interface to finalize their donation. |
| 52 |
* Automatically track a donation's status after the donor completes their donation. |
| 53 |
|
| 54 |
= Stripe donation forms made simple = |
| 55 |
|
| 56 |
Start accepting credit card donations through Stripe without hiring a developer. |
| 57 |
|
| 58 |
* One-click Connect with Stripe flow to begin accepting credit card donations on your site. |
| 59 |
* Use an onsite credit form or use Stripe Checkout to alllow for quick and painless donations from your donors. |
| 60 |
* Automatically track a donation's status after the donor completes their donation. |
| 61 |
|
| 62 |
= More ways to give = |
| 63 |
|
| 64 |
Collect donations via check, bank transfer or any other offline method. |
| 65 |
|
| 66 |
* Provide your donor with clear instructions for making their offline donation. |
| 67 |
* Send a unique offline donation receipt to donors after they create an offline donation. |
| 68 |
* Choose from 10+ additional payment gateways through one of our [Pro paid plans](https://www.wpcharitable.com/pricing/?utm_source=WordPress&utm_medium=Plugin+Readme+More+Give+Link&utm_campaign=Charitable&utm_content=Pro+paid+plans). |
| 69 |
|
| 70 |
= GDPR-ready WordPress donation plugin = |
| 71 |
|
| 72 |
Make your donation forms GDPR compatible in just a few clicks. |
| 73 |
|
| 74 |
* Add a Privacy notice and Terms & Conditions to your donation form. |
| 75 |
* Charitable supports the personal data export & personal data eraser in WordPress. |
| 76 |
* Compatible with the GDPR Cookie Compliance plugin. |
| 77 |
|
| 78 |
= Painless donation management = |
| 79 |
|
| 80 |
Create and edit donations directly in the WordPress dashboard. No add-on necessary! |
| 81 |
|
| 82 |
* Resend donation emails. |
| 83 |
* Sort and search donations in the dashboard. |
| 84 |
* Export a CSV report of donations. |
| 85 |
|
| 86 |
= Easy to customize emails = |
| 87 |
|
| 88 |
Donation receipts, admin notifications and other emails are available out of the box. |
| 89 |
|
| 90 |
* Easily customize your email subject lines, headlines and content. |
| 91 |
* Add custom email tags for dynamic, personalized emails. |
| 92 |
* Send a donation receipt and admin notification automatically for new donations. |
| 93 |
* Send donors instructions for completing their offline donation. |
| 94 |
* Send administrators an email when a fundraising campaign has finished. |
| 95 |
* Password reset & email verification messages. |
| 96 |
|
| 97 |
= Why we made Charitable = |
| 98 |
|
| 99 |
We built Charitable because we were tired of seeing non-profits use hosted fundraising platforms that charge hefty fees and strip them of the ability to brand & control their donation pages. Other WordPress donation plugins existed, but they missed important functionality or were poorly supported, leaving non-profits to choose between expensive platforms or plugins lacking the features they really needed. |
| 100 |
|
| 101 |
So we created & launched Charitable in 2015 as a feature-rich, affordable WordPress alternative to hosted fundraising platforms. Four years on, we still actively develop and support Charitable, which is trusted by over 10,000 non-profits all over the world. |
| 102 |
|
| 103 |
= Powerful donation features to grow your online fundraising = |
| 104 |
|
| 105 |
Looking for more donation form and fundraising functionality? Our Pro plans give you the flexibility and features you need to grow your fundraising efforts. |
| 106 |
|
| 107 |
**[Recurring Donations](https://www.wpcharitable.com/pricing/?utm_source=WordPress&utm_medium=Plugin+Readme+Recurring+Donations+Link&utm_campaign=Charitable&utm_content=Recurring+Donations)** |
| 108 |
|
| 109 |
* Generate a reliable donation stream for your non-profit. |
| 110 |
* Increase the lifetime value of donors. |
| 111 |
* Integrated seamlessly with our PayPal, Stripe, Authorize.Net and PayFast payment gateways. |
| 112 |
|
| 113 |
**[Peer to Peer Fundraising](https://www.wpcharitable.com/pricing/?utm_source=WordPress&utm_medium=Plugin+Readme+Peer+Fundraising+Link&utm_campaign=Charitable&utm_content=Peer+to+Peer+Fundraising)** |
| 114 |
|
| 115 |
* Front-end campaign submission form. |
| 116 |
* Allow your supporters to create fundraising campaigns for your organization. |
| 117 |
* Grow your donation reach exponentially through your supporters' network of friends and family. |
| 118 |
|
| 119 |
**[Crowdfunding Platforms with WordPress](https://www.wpcharitable.com/pricing/?utm_source=WordPress&utm_medium=Plugin+Readme+Crowdfunding+Link&utm_campaign=Charitable&utm_content=Crowdfunding+Platforms+with+WordPress)** |
| 120 |
|
| 121 |
* Front-end campaign submission form. |
| 122 |
* Allow people to create crowdfunding campaigns for personal causes. |
| 123 |
* Pay them automatically using [Stripe Connect](https://www.wpcharitable.com/pricing/?utm_source=WordPress&utm_medium=Plugin+Readme+Stripe+Connect+Link&utm_campaign=Charitable&utm_content=Stripe+Connect). |
| 124 |
|
| 125 |
**[Recover Payment Gateway Fees](https://www.wpcharitable.com/pricing/?utm_source=WordPress&utm_medium=Plugin+Readme+Fee+Relief+Link&utm_campaign=Charitable&utm_content=Recover+Payment+Gateway+Fees)** |
| 126 |
|
| 127 |
* Grow your donations by letting your donors cover the payment gateway fees. |
| 128 |
* Supports PayPal, Stripe, Braintree, Authorize.Net, Mollie, GoCardless, Windcave, Payrexx, PayFast and Paystack. |
| 129 |
* Works with recurring donations. |
| 130 |
|
| 131 |
**Premium Payment Gateways** |
| 132 |
|
| 133 |
* [Braintree](https://www.wpcharitable.com/extensions/charitable-braintree/?utm_source=WordPress&utm_medium=Plugin+Readme+Braintree+Link&utm_campaign=Charitable&utm_content=Braintree) |
| 134 |
* [Authorize.net](https://www.wpcharitable.com/extensions/charitable-authorize-net/?utm_source=WordPress&utm_medium=Plugin+Readme+Authorize+Net+Link&utm_campaign=Charitable&utm_content=Authorize.net) |
| 135 |
* [Mollie](https://www.wpcharitable.com/extensions/charitable-mollie/?utm_source=WordPress&utm_medium=Plugin+Readme+Mollie+Link&utm_campaign=Charitable&utm_content=Mollie) |
| 136 |
* [GoCardless](https://www.wpcharitable.com/extensions/charitable-gocardless/?utm_source=WordPress&utm_medium=Plugin+Readme+GoCardless+Link&utm_campaign=Charitable&utm_content=GoCardless) |
| 137 |
* [Windcave](https://www.wpcharitable.com/extensions/charitable-windcave/?utm_source=WordPress&utm_medium=Plugin+Readme+Windcave+Link&utm_campaign=Charitable&utm_content=Windcave) |
| 138 |
* [Payrexx](https://www.wpcharitable.com/extensions/charitable-payrexx/?utm_source=WordPress&utm_medium=Plugin+Readme+Payrexx+Link&utm_campaign=Charitable&utm_content=Payrexx) |
| 139 |
* [PayFast](https://www.wpcharitable.com/extensions/charitable-payfast/?utm_source=WordPress&utm_medium=Plugin+Readme+PayFast+Link&utm_campaign=Charitable&utm_content=PayFast) |
| 140 |
* [Paystack](https://www.wpcharitable.com/extensions/charitable-paystack/?utm_source=WordPress&utm_medium=Plugin+Readme+Paystack+Link&utm_campaign=Charitable&utm_content=Paystack) |
| 141 |
|
| 142 |
**[Email Marketing & Newsletter Integration](https://www.wpcharitable.com/extensions/charitable-newsletter-connect/?utm_source=WordPress&utm_medium=Plugin+Readme+Email+Marketing+Link&utm_campaign=Charitable&utm_content=Email+Marketing+Newsletter+Integration)** |
| 143 |
|
| 144 |
* MailChimp |
| 145 |
* Campaign Monitor |
| 146 |
* Mailerlite |
| 147 |
* ActiveCampaign |
| 148 |
* MailPoet |
| 149 |
* Mailster |
| 150 |
|
| 151 |
**[Automation with Zapier and Other Automation Platforms](https://www.wpcharitable.com/extensions/charitable-automation-connect/?utm_source=WordPress&utm_medium=Plugin+Readme+Automate+Link&utm_campaign=Charitable&utm_content=Automation+with+Zapier+and+Other+Automation+Platforms)** |
| 152 |
|
| 153 |
* Connect your Charitable donation forms and fundraising campaigns to your favorite apps by creating automatic workflows with Zapier. |
| 154 |
* Prefer another automation app to Zapier? Easily integrate with other automation platforms like Zoho Flow, Integromat or Automate.io through Webhook Subscriptions. |
| 155 |
|
| 156 |
**Other features** |
| 157 |
|
| 158 |
* [PDF Receipts](https://www.wpcharitable.com/extensions/charitable-pdf-receipts/?utm_source=WordPress&utm_medium=Plugin+Readme+PDF+Receipts+Link&utm_campaign=Charitable&utm_content=PDF+Receipts) |
| 159 |
* [Annual Receipts](https://www.wpcharitable.com/extensions/charitable-annual-receipts/?utm_source=WordPress&utm_medium=Plugin+Readme+Annual+Receipts+Link&utm_campaign=Charitable&utm_content=Annual+Receipts) |
| 160 |
* [Donor Comments](https://www.wpcharitable.com/extensions/charitable-donor-comments/?utm_source=WordPress&utm_medium=Plugin+Readme+Donor+Comments+Link&utm_campaign=Charitable&utm_content=Donor+Comments) |
| 161 |
* [Anonymous Donations](https://www.wpcharitable.com/extensions/charitable-anonymous-donations/?utm_source=WordPress&utm_medium=Plugin+Readme+Anonymous+Donations+Link&utm_campaign=Charitable&utm_content=Anonymous+Donations) |
| 162 |
* [Gift Aid](https://www.wpcharitable.com/extensions/charitable-gift-aid/?utm_source=WordPress&utm_medium=Plugin+Readme+Gift+Aid+Link&utm_campaign=Charitable&utm_content=Gift+Aid) |
| 163 |
* [Easy Digital Downloads](https://www.wpcharitable.com/extensions/charitable-easy-digital-downloads-connect/?utm_source=WordPress&utm_medium=Plugin+Readme+Easy+Digital+Downloads+Link&utm_campaign=Charitable&utm_content=Easy+Digital+Downloads) |
| 164 |
* [User Avatar](https://www.wpcharitable.com/extensions/charitable-user-avatar/?utm_source=WordPress&utm_medium=Plugin+Readme+User+Avatar+Link&utm_campaign=Charitable&utm_content=User+Avatar) |
| 165 |
* [Videos](https://www.wpcharitable.com/extensions/charitable-videos/?utm_source=WordPress&utm_medium=Plugin+Readme+Videos+Link&utm_campaign=Charitable&utm_content=Videos) |
| 166 |
* [Simple Updates](https://www.wpcharitable.com/extensions/charitable-simple-updates/?utm_source=WordPress&utm_medium=Plugin+Readme+Simple+Updates+Link&utm_campaign=Charitable&utm_content=Simple+Updates) |
| 167 |
* [Geolocation](https://www.wpcharitable.com/extensions/charitable-geolocation/?utm_source=WordPress&utm_medium=Plugin+Readme+Geolocation+Link&utm_campaign=Charitable&utm_content=Geolocation) |
| 168 |
|
| 169 |
> [Click here to upgrade to Pro and get all the features you need to get more donations from your donation forms.](https://www.wpcharitable.com/pricing/?utm_source=WordPress&utm_medium=Plugin+Readme+All+Features+Link&utm_campaign=Charitable&utm_content=Click+here+to+upgrade+to+Pro+and+get+all+the+features) |
| 170 |
|
| 171 |
= Join our community = |
| 172 |
|
| 173 |
When you download Charitable, you are joining over 10,000 other non-profits, developers and fundraising professionals across the globe. We regularly cast a spotlight on the amazing things people in the Charitable community are doing in our newsletter and social media. |
| 174 |
|
| 175 |
* [Facebook](https://www.facebook.com/wpcharitable/) |
| 176 |
* [Twitter](https://twitter.com/wpcharitable/) |
| 177 |
|
| 178 |
Using Charitable in a language other than English? Help us make Charitable better for you by [contributing to the translation project in your language.](https://translate.wordpress.org/projects/wp-plugins/charitable) |
| 179 |
|
| 180 |
== Installation == |
| 181 |
|
| 182 |
1. Upload `charitable.php` to the `/wp-content/plugins/` directory. |
| 183 |
1. Activate the plugin through the 'Plugins' menu in WordPress. |
| 184 |
1. Go to Charitable > Add Campaign to create your first campaign! |
| 185 |
|
| 186 |
== Frequently Asked Questions == |
| 187 |
|
| 188 |
= Can I accept donations directly on my site? = |
| 189 |
|
| 190 |
Yes you can! If you use PayPal, donors will be redirected to PayPal to complete their donation. However, you can use the Offline Donations gateway to allow your donors to create a donation and make the payment via cheque or bank transfer (you can display your payment details to them). |
| 191 |
|
| 192 |
Better yet, let your donors make credit card donations directly on your WordPress website with the following payment gateway extensions: |
| 193 |
|
| 194 |
* [Stripe](https://www.wpcharitable.com/extensions/charitable-stripe/?utm_source=WordPress&utm_medium=Plugin+Readme+Stripe+Link&utm_campaign=Charitable&utm_content=Stripe) |
| 195 |
* [Braintree](https://www.wpcharitable.com/extensions/charitable-braintree/?utm_source=WordPress&utm_medium=Plugin+Readme+Braintree+Link&utm_campaign=Charitable&utm_content=Braintree) |
| 196 |
* [Authorize.net](https://www.wpcharitable.com/extensions/charitable-authorize-net/?utm_source=WordPress&utm_medium=Plugin+Readme+Authorize+Net+Link&utm_campaign=Charitable&utm_content=Authorize.net) |
| 197 |
|
| 198 |
Want to use a different payment gateway? [Click here to let us know!](https://www.wpcharitable.com/support/?utm_source=WordPress&utm_medium=Plugin+Readme+Support+Link&utm_campaign=Charitable&utm_content=Click+here+to+let+us+know) |
| 199 |
|
| 200 |
= How do I add a grid of fundraising campaigns to my page? = |
| 201 |
|
| 202 |
Easy. Just add `[campaigns]` into your page content. [Read more](https://www.wpcharitable.com/documentation/the-campaigns-shortcode/?utm_source=WordPress&utm_medium=Plugin+Readme+Fundraising+Grid+Link&utm_campaign=Charitable&utm_content=Read+more). |
| 203 |
|
| 204 |
= How do I add a donation form to a page? = |
| 205 |
|
| 206 |
You can use the `[charitable_donation_form]` shortcode to embed a particular campaign's donation form on a page. [Read more](https://www.wpcharitable.com/documentation/add-your-donation-form-to-a-page/?utm_source=WordPress&utm_medium=Plugin+Readme+Add+Donation+Form+Link&utm_campaign=Charitable&utm_content=Read+more) |
| 207 |
|
| 208 |
= Can I collect recurring donations with Charitable? = |
| 209 |
|
| 210 |
You can accept monthly, quarterly or semi-annually or annually recurring donations with the [Recurring Donations extension](https://www.wpcharitable.com/extensions/charitable-recurring-donations/?utm_source=WordPress&utm_medium=Plugin+Readme+Collect+Recurring+Donations+Link&utm_campaign=Charitable&utm_content=Recurring+donations+extension). This works with PayPal, Stripe, Braintree, Authorize.Net and PayFast. |
| 211 |
|
| 212 |
= Can I run peer-to-peer fundraising campaigns with Charitable? = |
| 213 |
|
| 214 |
Indeed you can! Charitable is the best way to run peer-to-peer fundraising campaigns with WordPress. Peer-to-peer fundraisers are supported with our [Ambassadors extension](https://www.wpcharitable.com/extensions/charitable-ambassadors/?utm_source=WordPress&utm_medium=Plugin+Readme+Ambassadors+Link&utm_campaign=Charitable&utm_content=Ambassadors+extension) |
| 215 |
|
| 216 |
= Can I let donors pay the gateway processing fees? = |
| 217 |
|
| 218 |
Yes. Our Fee Relief extension adds support for this, with the option to set how fees are calculated for different payment gateways. [Read more](https://www.wpcharitable.com/extensions/charitable-fee-relief/?utm_source=WordPress&utm_medium=Plugin+Readme+Fee+Relief+Link&utm_campaign=Charitable&utm_content=Read+more) |
| 219 |
|
| 220 |
= Can I add donors to my newsletter or email marketing list? = |
| 221 |
|
| 222 |
You certainly can. The [Newsletter Connect extension](https://www.wpcharitable.com/extensions/charitable-newsletter-connect/?utm_source=WordPress&utm_medium=Plugin+Readme+Newsletter+Connect+Link&utm_campaign=Charitable&utm_content=Newsletter+Connect+extension) supports MailChimp, Campaign Monitor, ActiveCampaign, Mailerlite, MailPoet and Mailster. |
| 223 |
|
| 224 |
= Does WP Charitable work with WooCommerce? = |
| 225 |
|
| 226 |
No. WP Charitable is a standalone donation and fundraising plugin and does not integrate with WooCommerce. |
| 227 |
|
| 228 |
= Can I translate Charitable into my language? = |
| 229 |
|
| 230 |
You can. Charitable has full localization support through the `charitable` textdomain. All Charitable extensions are also fully translatable. |
| 231 |
|
| 232 |
[Contribute to the translation project in your language](https://translate.wordpress.org/projects/wp-plugins/charitable) and help us make Charitable better for everyone! |
| 233 |
|
| 234 |
= How do I get support? = |
| 235 |
|
| 236 |
You can post in the [support forum](https://wordpress.org/support/plugin/charitable) or reach us via [our support form](http://wpcharitable.com/support/?utm_source=WordPress&utm_medium=Plugin+Readme+Support+Link&utm_campaign=Charitable&utm_content=our+support+form). |
| 237 |
|
| 238 |
== Screenshots == |
| 239 |
|
| 240 |
1. Creating a donation form & fundraising campaign. |
| 241 |
2. A donation form campaign running on a default WordPress theme. |
| 242 |
3. A grid of donation form campaigns, added using the `[campaigns]` shortcode. |
| 243 |
4. Setting up Charitable Donation Forms: The General settings area. |
| 244 |
5. Setting up Charitable Donation Forms: The Payment Gateways settings area. |
| 245 |
6. Setting up Charitable Donation Forms: The Email settings area. |
| 246 |
|
| 247 |
== Changelog == |
| 248 |
|
| 249 |
= Donation Form & Fundraising Campaigns v1.7.0.2 = |
| 250 |
* NEW: Add charitable_email_shortcode_get_value filter. |
| 251 |
* NEW: Automatically add min 1.00 amount for donations if site is using Stripe gateway. |
| 252 |
* FIX: Resolve issue involving the recurring support checkbox with Stripe Connect on front-end dontain forms. |
| 253 |
* FIX: Resolve issue relating to licenses and WordPress multisite. |
| 254 |
* FIX: Avoid triggering a fatal error in certain cases upon checkout when using Stripe Checkout. |
| 255 |
* FIX: Add misc coding checks to prevent PHP warnings in certain install setups. |
| 256 |
|
| 257 |
= Donation Form & Fundraising Campaigns v1.7.0.1 = |
| 258 |
* FIX: Issue regarding deactivation of Stripe gateway in gateway settings resolved, which also resolves JavaScript error on donation page in certain scenarios. |
| 259 |
* FIX: Checking recurring donations on donation page should not remove Stripe as an option. |
| 260 |
* FIX: Avoid triggering a fatal error relating to Stripe Connect when submitting a donation. |
| 261 |
|
| 262 |
= Donation Form & Fundraising Campaigns v1.7.0 = |
| 263 |
* NEW: Integrated Stripe Connect for easy one-click connection to Stripe. |
| 264 |
* NEW: Improved notices and menu updates to ensure donation forms are configured properly. |
| 265 |
* NEW: Ability to add license for "Charitable Pro" in addition to the other addons (license tab in settings). |
| 266 |
* NEW: New installs default to United States as country/currency. |
| 267 |
* FIX: Charitable settings no longer have to be saved twice on first install. |
| 268 |
|
| 269 |
= Donation Form & Fundraising Campaigns v1.6.61 = |
| 270 |
* FIXED: Now displays proper "enter amount" prompt for donation in certain scenarios. |
| 271 |
|
| 272 |
**[View entire donation form and fundraising platform changelog](https://plugins.svn.wordpress.org/charitable/trunk/CHANGELOG.md)** |
| 273 |
|
