=== Charitable - Fundraising & Crowdfunding ===
Contributors: WPCharitable, ericdaams
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=paypal%40164a%2ecom
Tags: donations, donate, donation plugin, fundraising, fundraising plugin, non-profit, non-profits, charity, churches, commerce, crowdfunding, crowd funding, paypal donations, paypal, stripe, stripe donations, campaigns, gifts, giving, wordpress fundraising, wordpress donations, wordpress donation plugin, peer to peer fundraising, peer to peer fundraiser, peer fundraising, social fundraising
Requires at least: 4.1
Tested up to: 4.3.1
Stable tag: 1.2.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Charitable is a powerful, extendable fundraising plugin that gives you full control over your website donations. 

== Description ==

**[Charitable](https://wpcharitable.com/?utm_source=readme&utm_medium=description-tab&utm_content=intro&utm_campaign=plugin-page-referrals)** is the WordPress fundraising alternative for non-profits, built to help non-profits raise money on their own website. 

You can accept PayPal or offline donations right out of the box, with support for other gateways available as [extensions](https://wpcharitable.com/extensions?utm_source=readme&utm_medium=description-tab&utm_content=intro&utm_campaign=plugin-page-referrals).

= Unlimited fundraising campaigns = 

You can set up as many campaigns as you'd like with Charitable, and you can tailor them to your needs. You can set up suggested donation amounts, allow them to donate as much as they want, or do both.

Need to set a fundraising goal? No problem. 

Running a time-sensitive campaign? Set an end date for your campaign and give it a sense of urgency.

= Easy to use =

Install, activate and create your first fundraising campaign in less than 5 minutes. With Charitable, adding campaigns is a straightforward, intuitive process. Less time setting up campaigns means more time for you to raise awareness for your campaign.

= Accept credit card donations = 

By coupling Charitable with our [Stripe extension](https://wpcharitable.com/extensions/charitable-stripe?utm_source=readme&utm_medium=description-tab&utm_content=credit-card-donations&utm_campaign=plugin-page-referrals), you can accept credit card donations directly on your website. Improve your donor conversion rates by keeping them on your website instead of redirecting them to PayPal.

Want to use a different payment gateway? [Let us know](https://wpcharitable.com/support?utm_source=readme&utm_medium=description-tab&utm_content=credit-card-donations&utm_campaign=plugin-page-referrals).

= Use Peer-to-Peer Fundraising to expand your reach = 

With our [Charitable Ambassadors extension](https://wpcharitable.com/extensions/charitable-ambassadors?utm_source=readme&utm_medium=description-tab&utm_content=peer-to-peer-fundraising&utm_campaign=plugin-page-referrals), you can use peer-to-peer fundraising to leverage your supporters’ network of friends and family. 

Ambassadors also supports people creating fundraisers for personal causes, allowing you to create a crowdfunding platform powered by Charitable Ambassadors.

= Skip the transaction fees = 

Other fundraising software charges you for every donation you receive. 

Charitable is different. We won't charge you any transaction fees and you can use Charitable for free.

= Works with any theme = 

Charitable has been designed to work with any well-coded theme, including the default WordPress themes.

= Extensions = 

One size does *not* fit all. That's why we made Charitable an extendable platform. 

* **[Ambassadors](https://wpcharitable.com/extensions/charitable-ambassadors?utm_source=readme&utm_medium=description-tab&utm_content=extensions&utm_campaign=plugin-page-referrals)** - Add peer-to-peer fundraising or crowdfunding to your website.
* **[Stripe](https://wpcharitable.com/extensions/charitable-stripe?utm_source=readme&utm_medium=description-tab&utm_content=extensions&utm_campaign=plugin-page-referrals)** - Accept credit card donations on your website.
* **[PayUMoney](https://www.wpcharitable.com/extensions/charitable-payu-money/?utm_source=readme&utm_medium=description-tab&utm_content=extensions&utm_campaign=plugin-page-referrals)** - Take donations with PayUMoney, a payment gateway for Indian non-profits and organizations.
* **[Anonymous Donations](https://wpcharitable.com/extensions/charitable-anonymous-donations?utm_source=readme&utm_medium=description-tab&utm_content=extensions&utm_campaign=plugin-page-referrals)** - Allow people to make donations anonymously.
* **[User Avatars](https://wpcharitable.com/extensions/charitable-user-avatar?utm_source=readme&utm_medium=description-tab&utm_content=extensions&utm_campaign=plugin-page-referrals)** - Let your donors upload their own profile photo to your site, instead of using their Gravatar profile.
* **[Simple Updates](https://wpcharitable.com/extensions/charitable-simple-updates?utm_source=readme&utm_medium=description-tab&utm_content=extensions&utm_campaign=plugin-page-referrals)** - Add updates about your fundraising campaigns.

Looking for more? 

[View all extensions](https://wpcharitable.com/extensions?utm_source=readme&utm_medium=description-tab&utm_content=extensions&utm_campaign=plugin-page-referrals). 

= Get involved =

Join the community on [WP Charitable](https://wpcharitable.com/?utm_source=readme&utm_medium=description-tab&utm_content=get-involved&utm_campaign=plugin-page-referrals). 

Developers can contribute to Charitable on our [Github repository](https://github.com/Charitable/Charitable).

== Installation ==

1. Upload `charitable.php` to the `/wp-content/plugins/` directory.
1. Activate the plugin through the 'Plugins' menu in WordPress.
1. Go to Charitable > Add Campaign to create your first campaign!

== Frequently Asked Questions ==

= I don't want to send my donors to PayPal. How can I accept donations right on my site? =

You can accept donations with the Offline Donations gateway, which allows your donors to create a donation and make the payment via cheque or bank transfer (you can display your payment details to them).

You can also accept credit card donations with the [Stripe extension](https://wpcharitable.com/extensions/charitable-stripe?utm_source=readme&utm_medium=faq-tab&utm_content=avoid-paypal&utm_campaign=plugin-page-referrals). If you want to use a different payment gateway, [let us know](https://wpcharitable.com/support?utm_source=readme&utm_medium=faq-tab&utm_content=avoid-paypal&utm_campaign=plugin-page-referrals).

= How do I add a grid of campaigns to my page? = 

Easy. Just add `[campaigns]` into your page content. [Read more](https://wpcharitable.com/documentation/the-campaigns-shortcode?utm_source=readme&utm_medium=faq-tab&utm_content=campaigns-shortcode&utm_campaign=plugin-page-referrals).

= Does Charitable support recurring donations? =

Support for recurring donations will be added as an extension, but is not yet available.

= How do I get support? = 

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=readme&utm_medium=faq-tab&utm_content=support&utm_campaign=plugin-page-referrals). 

== Screenshots ==

1. Creating a campaign.
2. A campaign running on Twentyfifteen (the default WordPress theme).
3. A grid of campaigns, added using the `[campaigns]` shortcode.
4. Setting up Charitable: The General settings area. 
5. Setting up Charitable: The Payment Gateways settings area. 
6. Setting up Charitable: The Email settings area. 

== Changelog ==

= 1.2.2 = 
* Fixes a bug that prevented the donation form from working correctly when the donor is not logged in.

= 1.2.1 = 
* Including missing files from 1.2.0 release.

= 1.2.0 = 
* [Read the full release notes](https://www.wpcharitable.com/charitable-1-2-0-is-ready-to-download/?utm_source=readme&utm_medium=changelog-tab&utm_campaign=plugin-page-referrals&utm_content=1-2-0-release-notes).
* NEW: Change the highlight colour via the WordPress Customizer. You can preview your changes as you make them. 
* NEW: There is a shiny new dashboard widget when you log into the WordPress dashboard to highlight your donation stats. 
* NEW: You can now limit the donation form to only display required user fields. 
* NEW: Create a static page with the [donation_receipt] shortcode to customize your donation receipt.
* NEW: All donation data is now displayed in the admin donation page.
* NEW: You can now change the campaign creator via the Campaign management page.
* NEW: Adds a login link to the donation form when donors are not logged in.
* NEW: When a user is logged in but has not filled out all required fields, they are presented with all the user fields.
* Removed the 'charitable_after_update_donation' hook. To respond to updates to a donation, use the 'save_post_donation'.
* Fixed a bug that resulted in `[campaigns orderby=popular]` to include non-complete donations when determining the order of campaigns.
* Fixed a bug that prevented donors from receiving their donation receipt after a donation is updated directly on the donation page.
* Fixes a bug that redirected donors to a "Page Not Found" page after donating on sites where the WordPress address and site address are not the same.
* Fixes bugs in the Donation Stats and Donors widget that causes them to include pending donations in the total.
* Fixes a bug in the Benefactors addon that caused fixed contribution amounts to not be saved.
* Major performance improvements in the WordPress dashboard.
* Better PHP 5.2 compatibility.

= 1.1.5 = 
* Fixes a bug that allowed people to make a donation without entering required details, or with an amount of $0 or less.

= 1.1.4 = 
* Fixes a critical bug that resulted in PayPal donations not working if you didn't have any other gateways installed.
* Fixes an error when trying to retrieve a donor name for a donation that does not have a matching donor.

= 1.1.3 = 
* Enhancement: Added the ability to change the dimensions of the user avatars added using Charitable User Avatar, with a PHP filter function.
* Fixes an issue where only having one active gateway meant that those gateway's donation form fields would not show.
* Fixes a problem with the permalinks structure that prevented you being able to create pages with slugs of "/donate/" or "/widget".
* Fixes the WP Editor form field template to prevent the text from being wrapped in HTML tags.

= 1.1.2 = 
* Security Fix: Prevent unauthorized users accessing your donation receipt.
* Fix: Localization with the .po/.mo files now really does work correctly. For real this time.

= 1.1.1 = 
* Fix: Emails will now correctly be sent with the body, headline and subject you set, instead of the default. 

= 1.1.0 = 
* Enhancement: Added a new email that can be sent when a campaign has finished. 
* Fix: Localization with the .po/.mo files now works correctly.
* Fix: Chrome 45 bug when clicking directly on suggested amount inputs is resolved.

= 1.0.3 =
* Improvement: Using `wp_list_pluck` instead of `array_column` for compatibility with versions of PHP prior to 5.5.
* PHP 5.2 Compatibility: Avoid T_PAAMAYIM_NEKUDOTAYIM error in older versions of PHP.

= 1.0.2 =
* Fix: Added missing file into the repo. 

= 1.0.1 =
* Improvement: Moved the user dashboard functionality into the core of the plugin, so that it is always available.
* Fix: The installation routine now flushes permalinks correctly -- no more "Page not Found" problems!

= 1.0.0 =
* Initial release