| @@ -1,661 +1,655 @@ | ||
| 1 | -=== Charitable - Donation Plugin === | |
| 2 | -Contributors: WPCharitable, ericdaams | |
| 3 | -Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=paypal%40164a%2ecom | |
| 4 | -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 | |
| 5 | -Requires at least: 4.1 | |
| 6 | -Tested up to: 5.0.0 | |
| 7 | -Stable tag: 1.6.7 | |
| 1 | +=== Charitable - Donation & Fundraising Platform (Donation Forms, Recurring Donations & Fundraising Campaigns) === | |
| 2 | +Contributors: WPCharitable, smub, dimensionmedia | |
| 3 | +Tags: donation, donate, fundraising, crowdfunding, recurring donations | |
| 4 | +Requires at least: 5.9 | |
| 5 | +Tested up to: 7.1.2 | |
| 6 | +Requires PHP: 7.4 | |
| 7 | +Stable tag: 1.8.13 | |
| 8 | 8 | License: GPLv2 or later |
| 9 | 9 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 10 | 10 | |
| 11 | -Grow your online fundraising with Charitable, the powerful WordPress donation plugin with 5-star support. | |
| 11 | +The best WordPress donation plugin. Create fundraising donation forms, accept recurring donations, easy donor management, add crowdfunding, and more. | |
| 12 | 12 | |
| 13 | 13 | == Description == |
| 14 | 14 | |
| 15 | -**[Charitable](https://www.wpcharitable.com/?utm_source=readme&utm_medium=description-tab&utm_content=intro&utm_campaign=plugin-page-referrals)** is the donation plugin that gives you everything you need to start accepting donations today, for free. Designed to integrate seamlessly with WordPress, Charitable allows non-profits and developers to create powerful fundraising platforms on their own website. | |
| 15 | += The Best WordPress Donation & Fundraising Plugin = | |
| 16 | 16 | |
| 17 | -= Free Features = | |
| 18 | -**Unlimited Campaigns** | |
| 17 | +[Charitable](https://wpcharitable.com/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) is the best WordPress donation plugin that's both EASY & POWERFUL. Add a simple donate button, create beautiful fundraising campaigns with smart donation forms, accept recurring donations with Stripe, PayPal, & Square, add crowdfunding / peer-to-peer fundraising, and other powerful donation features to your site in minutes with just a few clicks! | |
| 19 | 18 | |
| 20 | -* Create as many fundraising campaigns as you need. | |
| 21 | -* Set goals for your campaigns. | |
| 22 | -* Create time-sensitive campaigns that end automatically when they're finished. | |
| 23 | -* Inherits your theme's styles for seamless integration. | |
| 19 | +At Charitable, user experience is our #1 priority. Our pre-built donation form templates and workflows make Charitable the most beginner-friendly donation plugin on the market. You can create a fundraising campaign in less than 5 minutes with our drag & drop donation form builder or by using our pre-built donation campaign templates to get a head start. | |
| 24 | 20 | |
| 25 | -**Customizable Donation Forms** | |
| 21 | +Over 10,000+ nonprofits, charity foundations, clubs & NGOs get more donations from their websites with Charitable. | |
| 26 | 22 | |
| 27 | -* Provide suggested amounts, allow people to donate as much as they want, or do both. | |
| 28 | -* Load donation forms in a modal, on a separate page, or on the same page as the campaign. | |
| 29 | -* Shorten your donation forms by just showing required fields. | |
| 30 | -* Embed a donation form on any page. | |
| 23 | +> <strong>Charitable Pro</strong><br /> | |
| 24 | +> This plugin is the Lite version of Charitable Pro, which comes with additional email marketing & payment integrations, crowdfunding, peer-to-peer fundraising, automated workflows, and more. [Click here to purchase the best premium WordPress donation & fundraising plugin now!](https://wpcharitable.com/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin&utm_content=charitablepro) | |
| 31 | 25 | |
| 32 | -**PayPal & Offline Payment Support** | |
| 26 | +https://vimeo.com/1182636888 | |
| 33 | 27 | |
| 34 | -* Easy PayPal setup. Add your PayPal address and you're done. | |
| 35 | -* Customize your offline donation instructions. | |
| 36 | -* More payment gateways available as [paid add-ons](https://www.wpcharitable.com/extensions/category/payment-gateways/?utm_source=readme&utm_medium=description-tab&utm_content=features&utm_campaign=plugin-page-referrals). | |
| 28 | += Fully Customizable Donation Forms with Drag & Drop = | |
| 37 | 29 | |
| 38 | -**Donation Management** | |
| 30 | +Create custom donation forms and donate buttons in minutes with our easy-to-use drag and drop donation form builder (no coding needed). | |
| 39 | 31 | |
| 40 | -* Create and edit donations in the dashboard. No add-on necessary. | |
| 41 | -* Resend donation emails. | |
| 42 | -* Sort and search donations in the dashboard. | |
| 43 | -* Export a CSV report of donations. | |
| 32 | +With Charitable donation form builder, you can: | |
| 44 | 33 | |
| 45 | -**Customizable Emails** | |
| 34 | +* Add suggested donation amounts, allow people to donate custom amounts, or do both. | |
| 35 | +* Accept one-time donations and recurring donations. | |
| 36 | +* Add donation goals and display them in the donation widget. | |
| 37 | +* Easily collect all relevant donor details. | |
| 38 | +* Customize your donate buttons to match your design needs. | |
| 39 | +* Display donation forms in a popup modal, on a separate page, in a widget on your site, or on the same page as the campaign. You can embed donation forms anywhere on your site. | |
| 46 | 40 | |
| 47 | -* Automated donation receipt. | |
| 48 | -* Offline donation receipts with payment instructions. | |
| 49 | -* Admin notifications when people donate or campaigns end. | |
| 50 | -* Password reset & email verification messages. | |
| 41 | += Optimized Fundraising Campaign Templates = | |
| 51 | 42 | |
| 52 | -= Why We Made Charitable = | |
| 43 | +Charitable comes with pre-built highly optimized donation & fundraising campaign templates to help raise maximum donations for your charity or nonprofit organization. | |
| 53 | 44 | |
| 54 | -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. | |
| 45 | +* Create unlimited fundraising campaigns for your charity (no extra costs). | |
| 46 | +* Create time-sensitive fundraising campaigns that end automatically when they're finished. | |
| 47 | +* Set fundraising goals, display total donors (donor wall) for your campaigns, share donor comments, donation updates, fundraising video, and more. | |
| 48 | +* Add peer-to-peer fundraising (aka crowdfunding) to maximize your donations. | |
| 55 | 49 | |
| 56 | -So we created & launched Charitable in 2015 as a feature-rich, affordable WordPress alternative to hosted fundraising platforms. With Charitable, we won’t charge you any transaction fees for the donations you receive, and you can use the core Charitable plugin for free, forever. We support Charitable’s development through extension purchases, which add extra features. | |
| 50 | += Comprehensive Donor Management Tools = | |
| 57 | 51 | |
| 58 | -Two years on, we still actively develop and support Charitable, which is trusted by over 10,000 non-profits all over the world. | |
| 52 | +Charitable makes it easy to manage day-to-day donor management operations. This is why over 10,000+ charity & nonprofit organizations choose Charitable as their donation platform. | |
| 59 | 53 | |
| 60 | -= Popular Upgrades = | |
| 54 | +* See a complete history of your donor activity, track donation goal progress, and more in a single dashboard. | |
| 55 | +* Send beautiful annual tax-deductible donation receipts for end of year tax reporting. | |
| 56 | +* Add donor profiles to highlight your top contributors and raise more donations toward your cause. | |
| 57 | +* Send personalized donor updates to keep donors informed about their donations & contributions to your nonprofit charity. | |
| 58 | +* Export all donation details in CSV to help with your workflow. | |
| 61 | 59 | |
| 62 | -Looking for more functionality? Our paid extensions give you the flexibility and features you need to grow your fundraising. | |
| 60 | += Over a Dozen Donation Payment Integrations = | |
| 63 | 61 | |
| 64 | -**[Recurring Donations](https://www.wpcharitable.com/extensions/charitable-recurring-donations/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals)** | |
| 62 | +Charitable integrates with all the top payment providers including Stripe donations, PayPal donations, Braintree, Square payments, and 10+ more to ensure you can accept both one-time donations as well as recurring donations using the payment solution of your choice. | |
| 65 | 63 | |
| 66 | -* Generate reliable income for your non-profit. | |
| 67 | -* Increase the lifetime value of donors. | |
| 68 | -* Integrated seamlessly with our PayPal, Stripe, Authorize.Net and PayFast payment gateways. | |
| 64 | +We’re proud to be a Stripe Verified Partner. This partnership allows us to build the best Stripe integration with early access to features. You can use our Stripe integration to accept both one-time payments as well as recurring donations while syncing all donation data to your Stripe account. | |
| 69 | 65 | |
| 70 | -**[Peer to Peer Fundraising](https://www.wpcharitable.com/extensions/charitable-ambassadors/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals)** | |
| 66 | +We’re also proud to be a Square Verified Partner. This partnership allows us to build the best Square integration with early access to features. You can use our Square integration to accept both one-time payments as well as recurring donations while syncing all donation data to your Square account. | |
| 71 | 67 | |
| 72 | -* Front-end campaign submission form. | |
| 73 | -* Allow your supporters to create fundraising campaigns for your organization. | |
| 74 | -* Grow your reach exponentially through your supporters' network of friends and family. | |
| 68 | +Our PayPal integration is just as robust, allowing you to easily accept PayPal donations and manage them directly within Charitable. This makes offering PayPal as a payment option seamless for both you and your donors. | |
| 75 | 69 | |
| 76 | -**[Crowdfunding Platforms](https://www.wpcharitable.com/extensions/charitable-ambassadors/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals)** | |
| 70 | +Our full list of payment integrations include: Stripe, PayPal, Square, Authorize.net, Braintree, PayFast, Payrexx, Mollie, PayUMoney, GoCardless, Paystack, Razorpay, and Windcave. | |
| 77 | 71 | |
| 78 | -* Front-end campaign submission form. | |
| 79 | -* Allow people to create campaigns for personal causes. | |
| 80 | -* Pay them automatically using [Stripe Connect](https://www.wpcharitable.com/extensions/charitable-stripe-connect/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals). | |
| 72 | +Our Donation Fee Relief feature allows you to ask donors to donate extra to cover payment processing fees to maximize the impact. | |
| 81 | 73 | |
| 82 | -**Premium Payment Gateways** | |
| 74 | += Peer to Peer Fundraising with Donation Teams & Ambassadors = | |
| 83 | 75 | |
| 84 | -* [Stripe](https://www.wpcharitable.com/extensions/charitable-stripe/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals) | |
| 85 | -* [Authorize.Net](https://www.wpcharitable.com/extensions/charitable-authorize-net/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals) | |
| 86 | -* [PayFast](https://www.wpcharitable.com/extensions/charitable-payfast/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals) - leading South African payment gateway. | |
| 87 | -* [PayUMoney](https://www.wpcharitable.com/extensions/charitable-payu-money/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals) - Indian payment gateway. | |
| 76 | +Charitable's [Peer to Peer fundraising feature](https://www.wpcharitable.com/features/peer-to-peer-fundraising/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) allows you to maximize your donations through the power of community, donation teams & ambassadors. | |
| 88 | 77 | |
| 89 | -**[Email Marketing & Newsletter Integration](https://www.wpcharitable.com/extensions/charitable-newsletter-connect/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals)** | |
| 78 | +The peer-to-peer crowdfunding feature allows your supporters to raise donations on your behalf and gain incredible support for their cause. | |
| 90 | 79 | |
| 91 | -* MailChimp | |
| 92 | -* Campaign Monitor | |
| 93 | -* Mailerlite | |
| 94 | -* MailPoet | |
| 95 | -* Mailster | |
| 80 | +Each donation or fundraising campaign can have leaders & ambassadors that invite others to their donation team to help you get more donations by leveraging the power of community. | |
| 96 | 81 | |
| 97 | -**More Extensions** | |
| 82 | +Our crowdfunding peer to peer donations feature is great for community events like: | |
| 98 | 83 | |
| 99 | -* [Anonymous Donations](https://www.wpcharitable.com/extensions/charitable-anonymous-donations/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals) | |
| 100 | -* [Gift Aid](https://www.wpcharitable.com/extensions/charitable-gift-aid/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals) | |
| 101 | -* [Easy Digital Downloads](https://www.wpcharitable.com/extensions/charitable-easy-digital-downloads-connect/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals) | |
| 102 | -* [User Avatar](https://www.wpcharitable.com/extensions/charitable-user-avatar/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals) | |
| 103 | -* [Videos](https://www.wpcharitable.com/extensions/charitable-videos/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals) | |
| 104 | -* [Simple Updates](https://www.wpcharitable.com/extensions/charitable-simple-updates/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals) | |
| 105 | -* [Geolocation](https://www.wpcharitable.com/extensions/charitable-geolocation/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals) | |
| 84 | +* Nonprofit Charity Walkathons | |
| 85 | +* Nonprofit Charity Carwashes | |
| 86 | +* Nonprofit Charity Fundraising Dinners | |
| 87 | +* Other non-profit charity events | |
| 106 | 88 | |
| 107 | -Ready to upgrade? | |
| 89 | += Communication & Promotion Tools to Maximize Donations = | |
| 108 | 90 | |
| 109 | -* [View pricing options](https://www.wpcharitable.com/packages/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals) | |
| 110 | -* [Browse extensions](https://www.wpcharitable.com/extensions/?utm_source=readme&utm_medium=description-tab&utm_content=upgrades&utm_campaign=plugin-page-referrals) | |
| 91 | +Charitable comes with all the marketing and promotion tools you need to get maximum donations for your charity or nonprofit organization. | |
| 111 | 92 | |
| 112 | -= Join our community = | |
| 93 | +* [Integrate with your favorite email marketing tools](https://www.wpcharitable.com/extensions/charitable-newsletter-connect/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) like Mailchimp, ActiveCampaign, MailerLite, Campaign Monitor, and more. | |
| 94 | +* Give your fundraising campaigns a boost through [Charitable videos](https://www.wpcharitable.com/extensions/charitable-videos/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin). | |
| 95 | +* Enable [Charitable Geolocation](https://www.wpcharitable.com/extensions/charitable-geolocation/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) to geotag your donation campaigns to bring more awareness to the fundraising cause. | |
| 96 | +* Save time with [smart donation workflow automation](https://www.wpcharitable.com/extensions/charitable-automation-connect/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) with Zapier, Zoho Flow, and Webhooks. | |
| 113 | 97 | |
| 114 | -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. | |
| 98 | += Easy to Customize and Extend = | |
| 115 | 99 | |
| 116 | -* [Subscribe to our newsletter](http://164a.us7.list-manage.com/subscribe?u=627673bb29eec8993b0b3215b&id=ce7842eb06) | |
| 117 | -* [Facebook](https://www.facebook.com/wpcharitable/) | |
| 118 | -* [Twitter](https://twitter.com/wpcharitable/) | |
| 100 | +Charitable is a 100% open-source donation plugin for WordPress. You can easily customize your donation forms, fundraising campaigns, donate buttons, donation goal widgets, and everything else thanks to our built-in features. | |
| 119 | 101 | |
| 120 | -Developers, we would love to invite you to join us in creating the most powerful fundraising plugin! Get started as a contributor on [our GitHub repository](https://github.com/Charitable/Charitable). | |
| 102 | +We also know that our developer friends may want more control, so we have added tons of hooks and filters. | |
| 121 | 103 | |
| 122 | -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) | |
| 104 | += Full Charitable Feature List = | |
| 123 | 105 | |
| 106 | +* Donation Form Builder - powerful drag & drop donation form builder. Create smart donation forms, add custom donate buttons, accept donation payments, and more without writing any code. | |
| 107 | +* Visual Donation Form Builder – Design beautiful donation forms in minutes with a true drag & drop visual editor, live previews, and code-free customization. | |
| 108 | +* Page Builder & Analytics Integrations – Deeply integrated with Elementor, Divi, WPBakery, and Google Analytics 4 for seamless visual design and automatic conversion tracking. | |
| 109 | +* Secure Credit Card & Digital Wallet Payments – Securely accept credit cards and Apple Pay/Google Pay with built-in Square support, plus Stripe, PayPal, and more. | |
| 110 | +* Comprehensive Donor Management System – A full CRM to manage donor relationships, track activity, log offline gifts, and view donor history from a single dashboard. | |
| 111 | +* Donor Dashboard – Provide a dedicated, self-service portal for supporters to manage profiles, view donation history, and download receipts. | |
| 112 | +* [Donor Leaderboard](https://www.wpcharitable.com/introducing-donor-leaderboard/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) – Gamify fundraising by showcasing top supporters in list or card views to encourage friendly competition. | |
| 113 | +* Social Proof (DonorTrust) – Increase trust and conversions by displaying real-time popup notifications of recent donations to site visitors. | |
| 114 | +* Easy Data Migration – Import donors from other platforms or spreadsheets in minutes with the powerful CSV Importer. | |
| 115 | +* 100% mobile responsive. | |
| 116 | +* GDPR & CCPA friendly - full privacy compliance tools | |
| 117 | +* [Pre-built Fundraising Templates](https://www.wpcharitable.com/templates/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - Get access to sleek modern fundraising templates that are optimized to help you raise more donations. | |
| 118 | +* Secure Credit Card Payments - securely accept credit card donations on your website with Stripe donations, Square donations, PayPal donations, and dozens of other payment gateways. | |
| 119 | +* [Recurring Donations](https://www.wpcharitable.com/features/recurring-donations/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - accept recurring donations on your website with Stripe, PayPal, and other payment solutions. Turn one-time donors into repeat supporters. | |
| 120 | +- [Offline Donations](https://www.wpcharitable.com/features/offline-donations/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - accept offline donations from donors through other payment methods like cash, check, and wire transfer while keeping track of it in Charitable donation platform. | |
| 121 | +* [Automatic Donation Receipts](https://www.wpcharitable.com/extensions/charitable-pdf-receipts/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - automatically send PDF receipts for each donation to your donors (save time). | |
| 122 | +* [Comprehensive Donation Management](https://www.wpcharitable.com/features/donor-management/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - easily manage and track all donor activity, donation amount, donor communication, and more from a single dashboard. | |
| 123 | +* [Actionable Donation Reports](https://www.wpcharitable.com/features/reports/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - see all your donation reports in one place. | |
| 124 | +* [Peer to Peer Fundraising](https://www.wpcharitable.com/features/peer-to-peer-fundraising/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - allow your community to raise more donations for your cause with crowdfunding. | |
| 125 | +* [Donation Teams with Ambassadors](https://www.wpcharitable.com/features/peer-to-peer-fundraising/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - allow supporters and ambassadors to create donation teams to help raise more money for your nonprofit. Track progress through custom donate buttons for each team. | |
| 126 | +* [Donation Fee Relief](https://www.wpcharitable.com/extensions/charitable-fee-relief/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - allow donors to cover donation payment processing fees. | |
| 127 | +* [Donation Goal Widget](https://www.wpcharitable.com/documentation/campaign-donation-widget/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - Display public donation goals in a donation widget to motivate your donors and supporter. | |
| 128 | +* [Annual Donation Receipts](https://www.wpcharitable.com/extensions/charitable-annual-receipts/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - help donors with annual tax planning with beautiful donation receipts. | |
| 129 | +* [Anonymous Donations](https://www.wpcharitable.com/extensions/charitable-anonymous-donations/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - allow donors to make anonymous donations. | |
| 130 | +* [Gift Aid](https://www.wpcharitable.com/extensions/charitable-gift-aid/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - allow donors to boost their donations through the government's gift aid tax incentive. | |
| 131 | +* [Spam protection](https://www.wpcharitable.com/extensions/charitable-spam-blocker/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) built-in with support Google reCAPTCHA and hCaptcha. | |
| 132 | +* [Workflow Automation](https://www.wpcharitable.com/extensions/charitable-automation-connect/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) to help you save time with Zapier, Webhooks, Zoho Flow, and more. | |
| 133 | +* [Donation Recovery](https://www.wpcharitable.com/introducing-donation-recovery-in-charitable-pro/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - automatically recover abandoned donations and failed payments to win back supporters and maximize revenue. | |
| 134 | +* [Donations Feed](https://www.wpcharitable.com/introducing-donations-feed/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - display a live, real-time donation feed to build momentum and social proof for your fundraising campaigns. | |
| 135 | +* [Campaign Updates](https://www.wpcharitable.com/introducing-campaign-updates/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - post timeline-style milestones, news, and progress reports directly on your campaign page to keep donors engaged. | |
| 136 | + | |
| 137 | += Donation Payment Integrations = | |
| 138 | + | |
| 139 | +Allow your users to donate with the payment solution of their choice to reach your donation goals faster. | |
| 140 | + | |
| 141 | +* [Stripe](https://www.wpcharitable.com/integrations/stripe/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - We're a Stripe Verified Partner for Stripe Donation payments. Easily accept credit card donations on your website with Stripe. | |
| 142 | +* PayPal - Paypal is a trusted and familiar way for donors to contribute. Easily accept PayPal donations on your website. | |
| 143 | +* [Square](https://www.wpcharitable.com/extensions/charitable-square/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - We're a Square Verified Partner for Square Donation payments. Easily accept credit card donations on your website with Square. | |
| 144 | +* [Braintree](https://www.wpcharitable.com/extensions/charitable-braintree/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) | |
| 145 | +* [Authorize.net](https://www.wpcharitable.com/extensions/charitable-authorize-net/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) | |
| 146 | +* [Mollie](https://www.wpcharitable.com/extensions/charitable-mollie/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) | |
| 147 | +* [PayFast](https://www.wpcharitable.com/extensions/charitable-payfast/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) | |
| 148 | +* [Payrexx](https://www.wpcharitable.com/extensions/charitable-payrexx/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) | |
| 149 | +* [PayUMoney](https://www.wpcharitable.com/extensions/charitable-payu-money/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) | |
| 150 | +* [GoCardless](https://www.wpcharitable.com/extensions/charitable-gocardless/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) | |
| 151 | +* [Paystack](https://www.wpcharitable.com/extensions/charitable-paystack/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) | |
| 152 | +* [Razorpay](https://www.wpcharitable.com/extensions/charitable-razorpay/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) | |
| 153 | +* [Windcave](https://www.wpcharitable.com/extensions/charitable-windcave/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) | |
| 154 | + | |
| 155 | += Marketing & Donation Workflow Integrations = | |
| 156 | + | |
| 157 | +* [Mailchimp](https://www.wpcharitable.com/extensions/charitable-newsletter-connect/#mailchimp?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) | |
| 158 | +* [Campaign Monitor](https://www.wpcharitable.com/extensions/charitable-newsletter-connect/#campaign-monitor?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) | |
| 159 | +* [ActiveCampaign](https://www.wpcharitable.com/extensions/charitable-newsletter-connect/#activecampaign?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) | |
| 160 | +* [Zapier](https://www.wpcharitable.com/extensions/charitable-automation-connect/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - connect with over 7000+ apps. | |
| 161 | +* [Zoho Flow](https://www.wpcharitable.com/documentation/charitable-automation-connect/#Zoho_Flow?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) - connect with over 900+ apps. | |
| 162 | +* [MailerLite](https://www.wpcharitable.com/extensions/charitable-newsletter-connect/#mailerlite?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) | |
| 163 | +* [MailPoet](https://www.wpcharitable.com/extensions/charitable-newsletter-connect/#mailpoet?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) | |
| 164 | +* [Mailster](https://www.wpcharitable.com/extensions/charitable-newsletter-connect/#mailster?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin) | |
| 165 | +* Webhooks | |
| 166 | + | |
| 167 | +You can see why Charitable is the best WordPress donation plugin on the market! Want to unlock all the features? [Upgrade to our Pro version](https://wpcharitable.com/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin). | |
| 168 | + | |
| 169 | += Who is Charitable Donation Platform Built For? = | |
| 170 | + | |
| 171 | +We built Charitable to help anyone who wants to fundraise online, and Charitable supports both one-time donations and recurring donations. Below are the common use-cases: | |
| 172 | + | |
| 173 | +* Charities | |
| 174 | +* Non-profit Organizations | |
| 175 | +* Political Fundraisers | |
| 176 | +* Foundations, Clubs, & NGOs | |
| 177 | +* Individuals looking to raise money (i.e weddings, birthdays, etc) | |
| 178 | + | |
| 179 | += Credits = | |
| 180 | + | |
| 181 | +This plugin is built by [David Bisset](https://davidbisset.com/) and [Syed Balkhi](https://syedbalkhi.com/). | |
| 182 | + | |
| 183 | += Branding Guidelines = | |
| 184 | + | |
| 185 | +Charitable® is a registered trademark of WP Charitable LLC. When writing about the donation form plugin by Charitable, please make sure to the letter casing is spelled correctly. | |
| 186 | + | |
| 187 | +* Charitable (correct) | |
| 188 | +* WPCharitable (correct) | |
| 189 | +* WP Charitable (incorrect) | |
| 190 | +* wpcharitable (incorrect) | |
| 191 | + | |
| 192 | += What's Next = | |
| 193 | + | |
| 194 | +Help make Charitable make a bigger impact around the world by translating our donation plugin in your language. [Contribute to the translation project in your language.](https://translate.wordpress.org/projects/wp-plugins/charitable) | |
| 195 | + | |
| 196 | +Love Charitable? [Leave us a review](https://wordpress.org/support/plugin/charitable/reviews/?filter=5#new-post) - it's really motivating for our team. | |
| 197 | + | |
| 198 | += Recommended Resources = | |
| 199 | + | |
| 200 | +* [AIOSEO](https://wordpress.org/plugins/all-in-one-seo-pack/) - free WordPress SEO plugin for nonprofits (trusted by over 3 million sites). | |
| 201 | +* [Duplicator](https://wordpress.org/plugins/duplicator/) - free WordPress backup plugin to help you protect your donations and nonprofit website (trusted by over 1 million sites). | |
| 202 | +* [WP Mail SMTP](https://wordpress.org/plugins/wp-mail-smtp/) - free plugin to help improve email deliverability. | |
| 203 | +* [Sugar Calendar](https://wordpress.org/plugins/sugar-calendar-lite/) - free event management plugin. Great for organizing nonprofit fundraising events. | |
| 204 | +* [SeedProd](https://wordpress.org/plugins/coming-soon/) - Create beautiful landing pages for your nonprofit donation campaigns with this free drag & drop page builder. | |
| 205 | +* [MonsterInsights](https://wordpress.org/plugins/google-analytics-for-wordpress/) - best free analytics plugin for nonprofits & charity websites. | |
| 206 | +* [WPForms](https://wordpress.org/plugins/wpforms-lite/) - best contact form and survey plugin for nonprofits. | |
| 207 | + | |
| 208 | +Visit [WPBeginner](https://www.wpbeginner.com/ "WPBeginner") to learn from their [free WordPress video courses](https://videos.wpbeginner.com/courses/) and see their pick for [best WordPress plugins](https://www.wpbeginner.com/showcase/24-must-have-wordpress-plugins-for-business-websites/). | |
| 209 | + | |
| 124 | 210 | == Installation == |
| 125 | 211 | |
| 126 | -1. Upload `charitable.php` to the `/wp-content/plugins/` directory. | |
| 127 | -1. Activate the plugin through the 'Plugins' menu in WordPress. | |
| 128 | -1. Go to Charitable > Add Campaign to create your first campaign! | |
| 212 | +1. Install Charitable either via the WordPress.org plugin repository or by uploading the files to your server. (See instructions on [how to install a WordPress plugin](https://www.wpbeginner.com/beginners-guide/step-by-step-guide-to-install-a-wordpress-plugin-for-beginners)) | |
| 213 | +2. Activate Charitable. | |
| 214 | +3. Navigate to the Charitable menu in your WordPress admin area and create your first campaign. | |
| 215 | +4. Want more features? [Purchase Charitable Pro](https://wpcharitable.com/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin)! | |
| 129 | 216 | |
| 217 | + | |
| 130 | 218 | == Frequently Asked Questions == |
| 131 | 219 | |
| 132 | -= I don't want to send my donors to PayPal. How can I accept donations right on my site? = | |
| 220 | += Can I accept donations directly on my site? = | |
| 133 | 221 | |
| 134 | -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). | |
| 222 | +Yes you can! If you use Stripe, donors will be able to make credit card donations right on your website. If you use PayPal, donors will be redirected to PayPal to complete their donation. You can also 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). | |
| 135 | 223 | |
| 136 | -You can also accept credit card donations with the [Stripe extension](https://www.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://www.wpcharitable.com/support?utm_source=readme&utm_medium=faq-tab&utm_content=avoid-paypal&utm_campaign=plugin-page-referrals). | |
| 224 | +Want to accept credit card donations from other payment gateways? [Upgrade to Charitable Pro](https://wpcharitable.com/?utm_source=wprepo&utm_medium=link&utm_campaign=liteplugin). | |
| 137 | 225 | |
| 138 | -= How do I add a grid of campaigns to my page? = | |
| 226 | += How do I add a grid of fundraising campaigns to my page? = | |
| 139 | 227 | |
| 140 | -Easy. Just add `[campaigns]` into your page content. [Read more](https://www.wpcharitable.com/documentation/the-campaigns-shortcode?utm_source=readme&utm_medium=faq-tab&utm_content=campaigns-shortcode&utm_campaign=plugin-page-referrals). | |
| 228 | +Easy. Just add `[campaigns]` into your page content. [Read more](https://www.wpcharitable.com/documentation/the-campaigns-shortcode/?utm_source=wprepos&utm_medium=link&utm_campaign=liteplugin&utm_content=Read+more). | |
| 141 | 229 | |
| 142 | -= Does Charitable support recurring donations? = | |
| 230 | += How do I add a donation form to a page? = | |
| 143 | 231 | |
| 144 | -Yes. Recurring donations support is possible with our [Recurring Donations extension](https://www.wpcharitable.com/extensions/charitable-recurring-donations/?utm_source=readme&utm_medium=faq-tab&utm_campaign=recurring-donations). | |
| 232 | +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=wprepos&utm_medium=link&utm_campaign=liteplugin&utm_content=Read+more) | |
| 145 | 233 | |
| 146 | -= How do I get support? = | |
| 234 | += Can I collect recurring donations with Charitable? = | |
| 147 | 235 | |
| 148 | -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). | |
| 236 | +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=wprepos&utm_medium=link+Link&utm_campaign=liteplugin&utm_content=Recurring+donations+extension). This works with PayPal, Stripe, Braintree, Authorize.Net and PayFast. | |
| 149 | 237 | |
| 150 | -== Screenshots == | |
| 238 | += Can I run peer-to-peer fundraising campaigns with Charitable? = | |
| 151 | 239 | |
| 152 | -1. Creating a campaign. | |
| 153 | -2. A campaign running on Twentyfifteen (the default WordPress theme). | |
| 154 | -3. A grid of campaigns, added using the `[campaigns]` shortcode. | |
| 155 | -4. Setting up Charitable: The General settings area. | |
| 156 | -5. Setting up Charitable: The Payment Gateways settings area. | |
| 157 | -6. Setting up Charitable: The Email settings area. | |
| 240 | +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=wprepos&utm_medium=link+Link&utm_campaign=liteplugin&utm_content=Ambassadors+extension) | |
| 158 | 241 | |
| 159 | -== Changelog == | |
| 242 | += Can I let donors pay the gateway processing fees? = | |
| 160 | 243 | |
| 161 | -= 1.6.7 = | |
| 162 | -* FIX: Load scripts properly when adding a custom 'picture' field to the donation form. [#627](https://github.com/Charitable/Charitable/issues/627) | |
| 163 | -* FIX: Save settings on Extensions settings page when there is only a single checkbox field. This bug affected Donor Comments. [#629](https://github.com/Charitable/Charitable/issues/629) | |
| 164 | -* FIX: Add full support for radio & multi-checkbox fields with the Donation Fields API. [#577](https://github.com/Charitable/Charitable/issues/577) and [#576](https://github.com/Charitable/Charitable/issues/576) | |
| 165 | -* FIX: Properly reflect the value for the "Send after Registration" setting in the settings for the User Verification email. [#626](https://github.com/Charitable/Charitable/issues/626) | |
| 166 | -* FIX: Only define defaults for database fields that require one. This avoids duplicate primary key issues in certain environments (Windows servers). [#623](https://github.com/Charitable/Charitable/issues/623) | |
| 167 | -* FIX: Add responsive styling for campaign grid when masonry is turned on. [#628](https://github.com/Charitable/Charitable/issues/628) | |
| 168 | -* FIX: Removed confusing "Payment attempted" log message for new donations. [#624](https://github.com/Charitable/Charitable/issues/624) | |
| 169 | -* FIX: Added debug logging when CHARITABLE_DEBUG constant is set and true, and when a nonce check fails. [#630](https://github.com/Charitable/Charitable/issues/630) | |
| 170 | -* FIX: Made sure the `charitable_user_registration_fields` filter actually works. :) | |
| 244 | +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=wprepos&utm_medium=link&utm_campaign=liteplugin&utm_content=Read+more) | |
| 171 | 245 | |
| 172 | -= 1.6.6 = | |
| 173 | -* FIX: Prevents an endless loop in the donor id upgrade process added in version 1.6.5. In certain cases, the upgrade could not complete properly. | |
| 246 | += Can I add donors to my newsletter or email marketing list? = | |
| 174 | 247 | |
| 175 | -= 1.6.5 = | |
| 176 | -* NEW: Added `meta_query` and `date_query` support to `Charitable_Donations_Query` and `Charitable_Donor_Query`. [#615](https://github.com/Charitable/Charitable/issues/615) and [#614](https://github.com/Charitable/Charitable/issues/614) | |
| 177 | -* NEW: Added `charitable_get_campaign_creator_field` helper function to retrieve meta information about a campaign creator given a campaign ID and a key. Designed to be used with the Campaign Fields API. | |
| 178 | -* NEW: Added `charitable_donor_contact_consent_changed` hook to broadcast when a donor has updated their contact consent setting. | |
| 179 | -* NEW: Added a multi-select field for admin forms. [#609](https://github.com/Charitable/Charitable/issues/609) | |
| 180 | -* NEW: Added a Customizer control for select fields with optgroups. [#610](https://github.com/Charitable/Charitable/issues/610) | |
| 181 | -* FIX: Fixed an error that resulted in a database error when adding donations in certain conditions. This only occurred on sites that upgraded to version 1.6.0 - 1.6.4 without running the database upgrade, and could result in donations being prevented or in donations being recorded without a donor record. This version resolves this bug, and also adds an upgrade routine to retroactively add donor records for all donations missing one. [#616](https://github.com/Charitable/Charitable/issues/616) | |
| 182 | -* FIX: Help text for End Date & Goal fields were swapped. [#606](https://github.com/Charitable/Charitable/issues/606) | |
| 183 | -* FIX: Browser security warning when doing a donation in the PayPal sandbox. [#604](https://github.com/Charitable/Charitable/issues/604) | |
| 184 | -* FIX: Prevent time-outs in AJAX requests to process donations. | |
| 248 | +You certainly can. The [Newsletter Connect extension](https://www.wpcharitable.com/extensions/charitable-newsletter-connect/?utm_source=wprepos&utm_medium=link&utm_campaign=liteplugin&utm_content=Newsletter+Connect+extension) supports MailChimp, Campaign Monitor, ActiveCampaign, Mailerlite, MailPoet and Mailster. | |
| 185 | 249 | |
| 186 | -= 1.6.4 = | |
| 187 | -* FIX: Fixed a fatal error triggered during donations when using a previous version of WordPress. [#603](https://github.com/Charitable/Charitable/issues/603) | |
| 250 | += Does WP Charitable work with WooCommerce? = | |
| 188 | 251 | |
| 189 | -= 1.6.3 = | |
| 190 | -* FIX: Fixed bug that prevented donation form from submitting in certain cases when using Stripe or Authorize.Net alongside another payment gateway. [#601](https://github.com/Charitable/Charitable/issues/601) | |
| 252 | +No. WP Charitable is a standalone donation and fundraising plugin and does not integrate with WooCommerce. | |
| 191 | 253 | |
| 192 | -= 1.6.2 = | |
| 193 | -* NEW: Allow donors to manage their contact consent preference via the Profile form. [#591](https://github.com/Charitable/Charitable/issues/591) | |
| 194 | -* NEW: Include terms and conditions, privacy policy and contact consent checkbox in Registration form. [#599](https://github.com/Charitable/Charitable/issues/599) | |
| 195 | -* NEW: Include donor's contact consent status in Donations export. [#590](https://github.com/Charitable/Charitable/issues/590) | |
| 196 | -* NEW: Show whether contact consent was given in donation details. [#589](https://github.com/Charitable/Charitable/issues/589) | |
| 197 | -* NEW: Added "User Privacy" and "Terms and Conditions" sections to the Charitable Customizer panel. [#592](https://github.com/Charitable/Charitable/issues/592) | |
| 198 | -* NEW: Added the `required` attribute to all required form fields. [#595](https://github.com/Charitable/Charitable/issues/595) | |
| 199 | -* FIX: Prevent donors from changing their profile email to same as existing donor. [#596](https://github.com/Charitable/Charitable/issues/596) | |
| 200 | -* FIX: Fixed `array_combine` PHP warning in donation form. [#593](https://github.com/Charitable/Charitable/issues/593) | |
| 201 | -* FIX: Misspelt function name in Donation Field Registry class. [#594](https://github.com/Charitable/Charitable/issues/594) | |
| 202 | -* FIX: Improved inline documentation for PayPal API fields. [#587](https://github.com/Charitable/Charitable/issues/587) and [#588](https://github.com/Charitable/Charitable/issues/588) | |
| 254 | += Can I translate Charitable into my language? = | |
| 203 | 255 | |
| 204 | -= 1.6.1 = | |
| 205 | -* FIX: Cleans up a fatal error in the previous release in certain versions of PHP. | |
| 256 | +You can. Charitable has full localization support through the `charitable` textdomain. All Charitable extensions are also fully translatable. | |
| 206 | 257 | |
| 207 | -= 1.6.0 = | |
| 208 | -* NEW: Added Terms and Conditions section to the donation form with privacy notice, terms and conditions checkbox and marketing consent checkbox. [#558](https://github.com/Charitable/Charitable/issues/558) | |
| 209 | -* NEW: Added Privacy Policy snippets for policy page builder in WordPress 3.9.6. [#557](https://github.com/Charitable/Charitable/issues/557) | |
| 210 | -* NEW: Included Charitable donation and donor data in user data erasure, with additional settings to control when data can be erased. [#551](https://github.com/Charitable/Charitable/issues/551) & [#556](https://github.com/Charitable/Charitable/issues/556) | |
| 211 | -* NEW: Included Charitable donation and donor data in user data export. [#550](https://github.com/Charitable/Charitable/issues/550) | |
| 212 | -* NEW: Added "Customize" link to the Charitable menu to expose Customizer options. [#559](https://github.com/Charitable/Charitable/issues/559) | |
| 213 | -* NEW: Added checkbox to the donation form to get donor consent to being contacted. [#420](https://github.com/Charitable/Charitable/issues/420) | |
| 214 | -* NEW: Added a [charitable_stat] shortcode. [#23](https://github.com/Charitable/Charitable/issues/23) | |
| 215 | -* NEW: Automatically refund donations in PayPal (more gateway support coming soon). [#269](https://github.com/Charitable/Charitable/issues/269) | |
| 216 | -* NEW: Added campaign export report. [#529](https://github.com/Charitable/Charitable/issues/529) | |
| 217 | -* NEW: Added Campaign Fields API. [#530](https://github.com/Charitable/Charitable/issues/530) | |
| 218 | -* NEW: Added a "meta" section within the "Your Details" donation form section. [#495](https://github.com/Charitable/Charitable/issues/495) | |
| 219 | -* NEW: Added ability to register new sections in forms through fields APIs. [#541](https://github.com/Charitable/Charitable/issues/541) | |
| 220 | -* NEW: Added Charitable REST API namespace in preparation for Gutenberg. [#542](https://github.com/Charitable/Charitable/issues/542) | |
| 221 | -* NEW: REST API: Added /reports/ REST API endpoint. [#543](https://github.com/Charitable/Charitable/issues/543) | |
| 222 | -* NEW: Added informed consent notice to Licenses settings page. [#547](https://github.com/Charitable/Charitable/issues/547) | |
| 223 | -* NEW: Added the ability to enter different PayPal addresses for live and testing (sandbox). [#517](https://github.com/Charitable/Charitable/issues/517) | |
| 224 | -* FIX: Improved underlying structure of the Campaign Settings meta box. [#531](https://github.com/Charitable/Charitable/issues/531) | |
| 225 | -* FIX: Support creating manual donations without an email address. [#535](https://github.com/Charitable/Charitable/issues/535) | |
| 226 | -* FIX: Added way to re-check license expiry dates in case of license renewal. [#477](https://github.com/Charitable/Charitable/issues/477) | |
| 227 | -* FIX: Prevent donation forms from displaying publicly for unpublished or inactive campaigns. This includes the Donate widget. [#276](https://github.com/Charitable/Charitable/issues/276). | |
| 228 | -* FIX: Removed "Change Status" toggle in Donation management page. Status changes are included in the Donation Actions meta box. [#579](https://github.com/Charitable/Charitable/issues/579) | |
| 229 | -* FIX: Bug that treated dates differently in the Donations Filter and Export. [#546](https://github.com/Charitable/Charitable/issues/546) | |
| 258 | +[Contribute to the translation project in your language](https://translate.wordpress.org/projects/wp-plugins/charitable) and help us make Charitable better for everyone! | |
| 230 | 259 | |
| 231 | -= 1.5.14 = | |
| 232 | -* SECURITY FIX: Prevent unauthorized users from accessing the user and donation details of previous donations through an exploit. See [our blog](http://www.wpcharitable.com/blog/?utm_source=readme&utm_medium=changelog-tab&utm_campaign=release-notes&utm_content=1-5-14-release) for a post in the coming days. | |
| 233 | -* FIX: Avoid duplicate donations when a donation fails and is re-attempted by the donor. [#173](https://github.com/Charitable/Charitable/issues/173) | |
| 260 | += How do I get support? = | |
| 234 | 261 | |
| 235 | -= 1.5.13 = | |
| 236 | -* FIX: In some cases, when a custom donation field is registered, it was left blank in donation receipts & other donation emails. This occurred with regular PayPal donations as well as recurring donations through Stripe, and most probably with other payment gateways as well. [#540](https://github.com/Charitable/Charitable/issues/540) | |
| 237 | -* FIX: A previous update broke the way required checkboxes in donation forms and other forms worked. When a required checkbox is not checked, the form should not submit. This was broken, but is now fixed. [#539](https://github.com/Charitable/Charitable/issues/539) | |
| 262 | +You can post in the [support forum](https://wordpress.org/support/plugin/charitable) or reach us via [our support form](https://wpcharitable.com/support/?utm_source=wprepos&utm_medium=link&utm_campaign=liteplugin&utm_content=our+support+form). | |
| 238 | 263 | |
| 239 | -= 1.5.12 = | |
| 240 | -* FIX: In some themes, campaign pages displayed the campaign description and summary block twice. This has been fixed. [#536](https://github.com/Charitable/Charitable/issues/536) | |
| 241 | -* FIX: Prevent a fatal error related to the Endpoint interface in certain environments. [#534](https://github.com/Charitable/Charitable/issues/534) | |
| 242 | -* FIX: Tweaked admin styles to avoid select fields getting cropped in some browsers. [#516](https://github.com/Charitable/Charitable/issues/516) | |
| 243 | -* FIX: Check for type of donation before displaying receipt to avoid clash with Recurring Donations. [#510](https://github.com/Charitable/Charitable/issues/510) | |
| 264 | +== Screenshots == | |
| 244 | 265 | |
| 245 | -= 1.5.11 = | |
| 246 | -* FIX: Preserve pre-existing donor data when editing donations. [#526](https://github.com/Charitable/Charitable/issues/526) | |
| 247 | -* FIX: Flush donation cache when transferring a donation from one campaign to another campaign. The stats of both the old and new campaigns should be updated automatically. [#527](https://github.com/Charitable/Charitable/issues/527) | |
| 248 | -* FIX: Improved the way the Javascript is structured to ensure better compatibility with pages containing multiple donation forms. In one specific scenario (using Stripe with Stripe Checkout enabled) this could prevent donation forms from processing on these pages. | |
| 266 | +1. Visual Campaign Builder: Drag-and-drop elements to build campaigns in minutes. | |
| 267 | +2. Campaign built with a visual builder template. | |
| 268 | +3. Select a template: Choose from pre-built templates or start from scratch. | |
| 269 | +4. Dashboard: Shows recent donations, top campaigns, important notices, and more. | |
| 270 | +5. A grid of donation form campaigns, added using the `[campaigns]` shortcode. | |
| 271 | +6. Setting up Charitable Donation Forms: The General settings area. | |
| 249 | 272 | |
| 250 | -= 1.5.10 = | |
| 251 | -* FIX: Ensure that campaigns without end dates are saved with the correct value of 0 for the end date meta field. [#524](https://github.com/Charitable/Charitable/issues/524) | |
| 273 | +== Changelog == | |
| 252 | 274 | |
| 253 | -= 1.5.9 = | |
| 254 | -* NEW: Added `Charitable_Campaign_Processor` class in preparation for new version of Charitable Ambassadors. | |
| 255 | -* NEW: Added `Charitable_Data_Processor` class in preparation for new version of Charitable Ambassadors. This will also be used eventually by other forms in Charitable core. | |
| 256 | -* NEW: Allow `Charitable_Deprecated` class to be extended by plugins. [#503](https://github.com/Charitable/Charitable/issues/503) | |
| 257 | -* NEW: Added support for showing helper text in Charitable's admin forms/meta boxes. [#511](https://github.com/Charitable/Charitable/pull/511) | |
| 258 | -* FIX: Tweaked Donor role in Charitable, ensuring it does not take away permissions from users who are already registered. [#522](https://github.com/Charitable/Charitable/issues/522) | |
| 259 | -* FIX: Ensured that custom donation fields with a checkbox are correctly saved. [#500](https://github.com/Charitable/Charitable/issues/500) | |
| 260 | -* FIX: Improved styling of links within frontend Charitable notices. [#519](https://github.com/Charitable/Charitable/issues/519) | |
| 261 | -* FIX: Always direct the donor to the main donation form when they submit the Donate widget. [#515](https://github.com/Charitable/Charitable/issues/515) | |
| 262 | -* FIX: Made sure the Charitable loading gif has a transparent background to avoid display issues. [#518](https://github.com/Charitable/Charitable/issues/518) | |
| 263 | -* FIX: Fixed a bug that broke the filtering of donations by date in the admin donations table in some non-English languages. [#506](https://github.com/Charitable/Charitable/issues/506) | |
| 264 | -* FIX: Remove the "Send an email receipt..." checkbox when adding donations manually if the donation receipt email is disabled. [#490](https://github.com/Charitable/Charitable/issues/490) | |
| 265 | -* FIX: Preserve redirection URL when proceeding to registration page from login page. [#504](https://github.com/Charitable/Charitable/issues/504) | |
| 266 | -* FIX: Allow `charitable_template_from_session` to receive a different class name, to allow extensions to re-use it. [#509](https://github.com/Charitable/Charitable/issues/509) | |
| 267 | -* FIX: Removed object caching for admin list of pages; we're using a single-request cache instead. [#505](https://github.com/Charitable/Charitable/issues/505) | |
| 268 | -* FIX: Added namespace to Charitable icons to avoid clashes with other plugins/themes, including Redux. [#499](https://github.com/Charitable/Charitable/issues/499) | |
| 269 | -* FIX: Re-order Forgot Password, Reset Password and Registration endpoints. [#502](https://github.com/Charitable/Charitable/issues/502) | |
| 270 | -* FIX: Avoid fatal error with A2 Optimized fork of W3TC. [#496](https://github.com/Charitable/Charitable/issues/496) | |
| 271 | -* FIX: Ensured that filters run as expected when checking what the current endpoint is. [#501](https://github.com/Charitable/Charitable/issues/501) | |
| 275 | += Donation Form & Fundraising Campaigns v1.8.13 = | |
| 276 | +* NEW: (AI) Charitable now works with AI assistants. On WordPress 6.9 or later, connect Claude or ChatGPT using the free WPVibe plugin, or any MCP client, to build and restyle campaigns, log donations that arrived by post, and report on your fundraising. 24+ operations, all permission-checked. [More Information](https://www.wpcharitable.com/ai/) | |
| 277 | +* NEW: (AI) New panel at Charitable > Tools > AI MCP. Write access starts OFF, an AI Activity list records every change and every refusal, and an assistant must confirm explicitly before trashing or unpublishing a campaign that already has donations. | |
| 278 | +* FIX: Resolved issue involving campaign progress bars showing incorrect percentages when a goal contained separators in certain scenarios. | |
| 279 | +* FIX: Resolved issue when a campaign with a goal but no end date showed no progress bar in the Campaigns list. | |
| 280 | +* FIX: A campaign end date entered as a plain date, for example 2027-01-31, could be mis-read and saved incorrectly in certain scenarios in admin. | |
| 281 | +* FIX: Reports, the donations CSV export, and the Dashboard's date-range dropdown and latest-donations list could leave today's donations out for part of each day, on sites whose timezone is ahead of UTC. | |
| 282 | +* FIX: Security: on a page using the [charitable_donate_button] shortcode without a campaign resolved issue where a crafted link could run script in a visitor's browser when they clicked the donate button under certain conditions. | |
| 272 | 283 | |
| 273 | -= 1.5.8 = | |
| 274 | -* FIX: Updated the data that is sent to PayPal to provide better compatibility with IPNs. | |
| 284 | += Donation Form & Fundraising Campaigns v1.8.12.4 = | |
| 285 | +* FIX: Previewing a campaign from the Campaigns list, or more than a day after your last save in the campaign builder, could show an empty campaign. The preview now falls back to your last saved version. | |
| 286 | +* FIX: Campaign template stylesheets now accept only valid hex characters in their colour values, so an invalid colour can no longer reach the stylesheet. | |
| 287 | +* FIX: The Preview button in the campaign builder did nothing at all for a campaign awaiting review, scheduled, or set to private. It now saves and opens the preview as it does for any other campaign. | |
| 288 | +* FIX: Campaigns awaiting review, scheduled, or set to private rendered as an empty campaign wherever they appeared. They now display for the campaign's author and for users who can edit campaigns, and stay hidden from everyone else. | |
| 289 | +* FIX: Security: campaign previews now require permission to edit the campaign being previewed. Previously a preview link could be altered to display a different campaign's content, including campaigns that were not published. | |
| 290 | +* FIX: On a campaign preview page, an excerpt of any other post shown alongside the campaign (in a posts list or query loop, for example) was replaced by a copy of the campaign. Excerpts now display normally. | |
| 291 | +* FIX: Previewing a campaign could fail with a memory error on sites running an SEO plugin. The preview no longer rebuilds the entire campaign every time a plugin asks for the page summary, and the summary it hands back is now the campaign's own description. | |
| 292 | +* FIX: Picture upload fields no longer accept uploads from logged-out visitors by default, and accept image files only. Sites that intentionally allow guest image uploads can re-enable them with the new `charitable_allow_anonymous_picture_uploads` filter, and the accepted image types can be adjusted with the new `charitable_picture_upload_allowed_mimes` filter. | |
| 293 | +* IMPROVED: Picture upload fields now accept WebP images. | |
| 275 | 294 | |
| 276 | -= 1.5.7 = | |
| 277 | -* NEW: Added a new optional masonry layout for the `[campaigns]` shortcode. To use it, just add `masonry=1` to the shortcode. [#326](https://github.com/Charitable/Charitable/issues/326) | |
| 278 | -* NEW: Additional donor meta like their address and phone number are automatically populated when a new manual donation is created for someone who donated previously. [#472](https://github.com/Charitable/Charitable/issues/472) | |
| 279 | -* NEW: Allowed email verification to be disabled for registrations. With this off, the email verification process can still be initiated by the donor from the My Donations page (i.e. the output of `[charitable_my_donations]`). [#482](https://github.com/Charitable/Charitable/issues/482) | |
| 280 | -* NEW: Added the username in the output of [charitable_profile]. [#325](https://github.com/Charitable/Charitable/issues/325) | |
| 281 | -* FIX: Resending the offline donation notification for admins previously sent the regular donation notification instead of the offline one. Bug squashed. [#481](https://github.com/Charitable/Charitable/issues/481) | |
| 282 | -* FIX: When custom donations are turned off, donors could proceed through the donation form without selecting a suggested amount. This is fixed now. [#478](https://github.com/Charitable/Charitable/issues/478) | |
| 283 | -* FIX: Prevented errors when overriding template functions. [#488](https://github.com/Charitable/Charitable/issues/488) | |
| 284 | -* FIX: For Charitable customers, correctly show lifetime licenses as having no expiry. [#479](https://github.com/Charitable/Charitable/issues/479) | |
| 285 | -* FIX: The Donors widget only showed the 10 most recent campaigns. It now correctly shows all. [#480](https://github.com/Charitable/Charitable/issues/480) | |
| 286 | -* FIX: Improved inconsistencies in the way shortcodes are set up under the hood. [#454](https://github.com/Charitable/Charitable/issues/454) | |
| 287 | -* FIX: Fixed an issue with the custom donation amount input extending outside the edge of the donate widget in the Storefront theme (and possibly other themes). [#488](https://github.com/Charitable/Charitable/issues/488) | |
| 295 | += Donation Form & Fundraising Campaigns v1.8.12.3 = | |
| 296 | +* FIX: Improved support for Campaign builder text fields and non-Latin characters such as Japanese, Chinese, Korean, etc. | |
| 297 | +* FIX: Updates involving campaign headline color in the builder and resolved builder preview memory issue, which was happening in some scenarios. | |
| 298 | +* FIX: Improved Donate Button block's label in terms of readability in certain scenarios. | |
| 288 | 299 | |
| 289 | -= 1.5.6 = | |
| 290 | -* NEW: Allow a default donation amount to be set via the `charitable_default_donation_amount` filter. [#470](https://github.com/Charitable/Charitable/issues/470) | |
| 291 | -* NEW: Made the list of resendable donation emails a filterable list, using the `charitable_resendable_donation_emails` filter. [#476](https://github.com/Charitable/Charitable/issues/476) | |
| 292 | -* FIX: Fixed an incorrect PayPal URL that prevented IPNs from working correctly. | |
| 293 | -* FIX: Prevents Charitable from co-opting the forgot password page in WooCommerce. [#473](https://github.com/Charitable/Charitable/issues/473) | |
| 294 | -* FIX: Minor styling update to improve theme compatibility for [campaigns] display. [#475](https://github.com/Charitable/Charitable/issues/475) | |
| 300 | += Donation Form & Fundraising Campaigns v1.8.12.2 = | |
| 301 | +* FIX: Reports > Overview no longer times out on long date ranges. If a report does fail, the figures are cleared and an error shown. | |
| 302 | +* FIX: The Refunds and Net columns in the Reports > Overview breakdown read zero for ranges outside the current year, and merged refunds across years. | |
| 303 | +* FIX: The optional description beside each suggested donation amount now appears in the Donate Amount block. | |
| 304 | +* FIX: Campaign template stylesheets now locate their shared helper reliably, so a campaign's colours no longer depend on the server's working directory. | |
| 305 | +* FIX: Security: the sort setting on the donor list shortcode is now restricted to standard sort directions, so it cannot be used to read information from the database. | |
| 306 | +* FIX: The setup wizard no longer says you have been logged out when its final step cannot reach your site. It now explains what happened and offers to retry or finish from the dashboard. | |
| 307 | +* FIX: A campaign embedding a shortcode that points back at itself, or two campaigns referencing each other, no longer loops until memory runs out. | |
| 308 | +* FIX: Removed PHP warnings and general cleanup. | |
| 295 | 309 | |
| 296 | -= 1.5.5 = | |
| 297 | -* FIX: Fixes fatal error in the campaign submission form in Ambassadors. [#471](https://github.com/Charitable/Charitable/issues/471) | |
| 310 | += Donation Form & Fundraising Campaigns v1.8.12.1 = | |
| 311 | +* NEW: Added a `charitable_campaign_description_limit` filter so developers can change the word limit on the campaign description shown on the campaign page. | |
| 312 | +* IMPROVED: More consistent brand colors in admin UI. | |
| 313 | +* FIX: The 24-hour limit on re-running Site Analysis is no longer reset by clearing Charitable's cache from Settings > Advanced, or by changing a setting, a campaign, or an add-on. | |
| 314 | +* FIX: Site Analysis now tells you that you have reached the analysis limit when the service is rate-limiting your site, instead of reporting that the service is unavailable and inviting a retry that keeps the limit in place. | |
| 315 | +* FIX: Security: links on Site Analysis recommendations are now restricted to standard web addresses, so a spoofed or compromised response cannot place a script link on the screen. | |
| 316 | +* FIX: Donation CSV export no longer shows inflated "Donation Total" and "Donation Subtotal" amounts (such as 10 178,00 instead of 101,78) on sites that use a comma as the decimal separator. | |
| 317 | +* FIX: Campaign Hero background images now appear on the front end for every campaign template. | |
| 318 | +* FIX: Campaigns created with a duplicate title now have the campaign ID appended, so the two can be told apart. | |
| 319 | +* FIX: Removed PHP warnings logged the first time a campaign containing a Progress Bar block was saved. | |
| 320 | +* FIX: The fundraising progress bar now displays correctly with themes that apply their own global progress bar styles (for example Avada). | |
| 321 | +* FIX: The login prompt on the donation form now returns a failed login to your custom Charitable login page instead of the default WordPress login screen. | |
| 298 | 322 | |
| 299 | -= 1.5.4 = | |
| 300 | -* NEW: You can now display campaign categories or tags in a dropdown through the Campaign Categories / Tags widget. [#408](https://github.com/Charitable/Charitable/issues/408) | |
| 301 | -* NEW: The donation status is now shown in the output of `[charitable_my_donations]`. [#287](https://github.com/Charitable/Charitable/issues/287) | |
| 302 | -* NEW: Added `Charitable_Donation_Log` class as a single purpose class designed to interact with all log entries related to a donation. | |
| 303 | -* NEW: Users with the `edit_products` capability can now access the WordPress dashboard. This improves compatibility with Easy Digital Downloads and WooCommerce. [#468](https://github.com/Charitable/Charitable/issues/468) | |
| 304 | -* NEW: Added index to the `donor_id` column in the `charitable_campaign_donations` table. Prevents a sub-optimal query using a full table scan. [#465](https://github.com/Charitable/Charitable/issues/465) | |
| 305 | -* NEW: Added `unsigned` to columns in both the `charitable_campaign_donations` and `charitable_donors` tables. | |
| 306 | -* NEW: Removed the PayPal sandbox test tool. This can now be downloaded separately as a utility plugin from [GitHub](https://github.com/Charitable/Charitable-PayPal-Tester/). [#418](https://github.com/Charitable/Charitable/issues/418) | |
| 307 | -* FIX: Set site base country as default for Country field in Donation Form. [#463](https://github.com/Charitable/Charitable/issues/463) | |
| 308 | -* FIX: Fixed SQL error in donor count queries. [#467](https://github.com/Charitable/Charitable/issues/467) | |
| 309 | -* FIX: Avoid fatal error when adding certain shortcodes to pages while Yoast SEO is installed. [#387](https://github.com/Charitable/Charitable/issues/387) | |
| 310 | -* FIX: Also avoided similar fatal errors when running the Relevanssi build index. [#397](https://github.com/Charitable/Charitable/issues/397) | |
| 311 | -* FIX: Improved backwards compatibility. The solution added in 1.5.1/1.5.2 did not work in all cases. [#469](https://github.com/Charitable/Charitable/issues/469) | |
| 312 | -* FIX: Prevent WP Super Cache caching pages that should not be cached (login, donation form, forgot password, etc.). [#398](https://github.com/Charitable/Charitable/issues/398) | |
| 323 | += Donation Form & Fundraising Campaigns v1.8.12 = | |
| 324 | +* NEW: Beacon (2 Columns) campaign template - includes Campaign Hero block and Mini Donation Widget (used internally). | |
| 325 | +* NEW: Free Site Analysis (Reports > Site Analysis). Get a free Fundraising Score across four areas (Activation, Health, Growth, and Optimization) with specific, prioritized recommendations. | |
| 326 | +* IMPROVED: Campaign builder rows now support a `background_image` property (renders as a CSS background on the row wrapper) and a `locked` property (prevents the row and its contents from being moved or deleted in the builder). | |
| 327 | +* IMPROVED: Live-preview updates for campaign-hero settings — background image, logo, title, accent (theme primary), donation amounts, and donate button all reflect in the builder preview as you edit. | |
| 328 | +* IMPROVED: Cross-tab goal sync — changing the campaign goal in the Settings tab updates the Campaign Hero raised band in the Design tab preview, even before saving. | |
| 329 | +* FIX: Square — donations and refunds now handle zero-decimal currencies, and dashboard-initiated refunds are logged in the site currency. | |
| 330 | +* FIX: Donation forms on block themes now honor the `amount` and `period` URL parameters. | |
| 331 | +* FIX: Security hardening across the addon installer, campaign builder debug endpoint, and donation import/donor-lookup handling. | |
| 332 | +* FIX: Square (Core) - unsigned webhooks are now rejected, closing a donation-status forgery on sites with no signing secret stored. | |
| 313 | 333 | |
| 314 | -= 1.5.3 = | |
| 315 | -* FIX: Properly handles differing site date formats when editing donations. [#461](https://github.com/Charitable/Charitable/issues/461) | |
| 334 | += Donation Form & Fundraising Campaigns v1.8.11.3 = | |
| 335 | +* FIX: Hardened Square (Core) payment webhook processing. | |
| 316 | 336 | |
| 317 | -= 1.5.2 = | |
| 318 | -* NEW: Automatically set a user's display name to their name when they update their profile through Charitable. [#437](https://github.com/Charitable/Charitable/issues/437) | |
| 319 | -* NEW: Adds a third parameter to the `charitable_template` function allowing extension developers to leverage this function. [#451](https://github.com/Charitable/Charitable/issues/451) | |
| 320 | -* NEW: Allow email send logs to be saved in user meta as well as post meta. | |
| 321 | -* FIX: Cleans up problems with themes like Charity Home and Giving Hand that yesterday's fix didn't quite solve. | |
| 322 | -* FIX: You can now specify a comma-separated list of categories or tags in the `[campaigns]` shortcode to include campaigns from multiple categories/tags. [#452](https://github.com/Charitable/Charitable/issues/452) | |
| 323 | -* FIX: Improves the layout of the campaign summary block on mobile. Kudos to [@kkoppenhaver](https://github.com/kkoppenhaver) for his contribution. [#315](https://github.com/Charitable/Charitable/issues/315) | |
| 337 | += Donation Form & Fundraising Campaigns v1.8.11.2 = | |
| 338 | +* FIX: Hardened profile avatar handling to prevent unauthorized attachment deletion. | |
| 339 | +* FIX: PayPal Commerce onboarding reliability improvements. | |
| 324 | 340 | |
| 325 | -= 1.5.1 = | |
| 326 | -* FIX: Resolves a backwards compatibility problem that we had not accounted for. This specifically affected users of certain themes, including (but probably not limited to) Charity Home and Giving Hand. | |
| 341 | += Donation Form & Fundraising Campaigns v1.8.11.1 = | |
| 342 | +* IMPROVED: Polished PayPal Settings screen, adding notice and improving readability. | |
| 327 | 343 | |
| 328 | -= 1.5.0 = | |
| 329 | -* NEW: Added a `[charitable_donation_form]` shortcode. Display a campaign's donation form anywhere like this: [charitable_donation_form campaign_id=123]. [#136](https://github.com/Charitable/Charitable/issues/136) | |
| 330 | -* NEW: Added a `[charitable_donors]` shortcode. [#129](https://github.com/Charitable/Charitable/issues/129) | |
| 331 | -* NEW: Create and edit donations in the WordPress dashboard. No more adding mock donations through the Offline payment method. You can easily change donor details, add notes or change the amount/campaign of the donation. [#18](https://github.com/Charitable/Charitable/issues/18), [#241](https://github.com/Charitable/Charitable/issues/241), [#172](https://github.com/Charitable/Charitable/issues/172) | |
| 332 | -* NEW: Resend receipts & admin notifications for donations from the WordPress dashboard. [#165](https://github.com/Charitable/Charitable/issues/165) | |
| 333 | -* NEW: Added new emails specifically for Offline donations. You can now set up an admin notification and donation receipt that are sent for Offline donations while they are still pending. Also added `[charitable_email show=offline_instructions]` email field to include the Offline payment instructions in Offline donation receipts. [#33](https://github.com/Charitable/Charitable/issues/33), [#324](https://github.com/Charitable/Charitable/issues/324) | |
| 334 | -* NEW: Added email verification step to donor registration. After email verification is complete, donors are automatically able to see all donations they made under the same email address. [#385](https://github.com/Charitable/Charitable/issues/385), [#409](https://github.com/Charitable/Charitable/issues/409), [#222](https://github.com/Charitable/Charitable/issues/222) | |
| 335 | -* NEW: Added `[charitable_logout]` shortcode. A logout link is also shown on login and registration forms when the user is logged in. [#431](https://github.com/Charitable/Charitable/issues/431) | |
| 336 | -* NEW: Added Donation Fields API for easy registering of custom donation fields. [#402](https://github.com/Charitable/Charitable/issues/402) | |
| 337 | -* NEW: Added Form View API to separate how forms are rendered from how they are set up. [#401](https://github.com/Charitable/Charitable/issues/401) | |
| 338 | -* NEW: Added Endpoints API to provide developers with an infrastructure for registering custom endpoints in Charitable. [#306](https://github.com/Charitable/Charitable/issues/306) | |
| 339 | -* NEW: Added `Charitable_Email_Fields` class for registering email fields and getting their values in emails. [#393](https://github.com/Charitable/Charitable/issues/393) | |
| 340 | -* NEW: Added `charitable_minimum_donation_amount` filter to easily change the minimum donation amount. [#298](https://github.com/Charitable/Charitable/issues/298) | |
| 341 | -* NEW: Added `can_receive_donations()` method to the `Charitable_Campaign` class. The return value can be filtered with the `charitable_campaign_can_receive_donations`, providing a programmatic way to mark certain campaigns as no longer being able to receive donations. [#447](https://github.com/Charitable/Charitable/issues/447) | |
| 342 | -* NEW: Added an autoloader. Kudos to [@helgatheviking](https://github.com/helgatheviking). [#404](https://github.com/Charitable/Charitable/issues/404) | |
| 343 | -* NEW: The Forgot Password & Reset Password pages will automatically inherit the page template of their parent page (i.e. the Login page). [#379](https://github.com/Charitable/Charitable/issues/379) | |
| 344 | -* NEW: Added a `count` option to the `Charitable_Query` class, providing an easy way to user the query classes to get the number of donations, donors, etc. [#322](https://github.com/Charitable/Charitable/issues/322) | |
| 345 | -* NEW: Added `charitable_monetary_amount` filter to tweak how monetary amounts are formatted. [#308](https://github.com/Charitable/Charitable/issues/308) | |
| 346 | -* NEW: Added `charitable_sanitize_value_{$section}_{$key}` filter to sanitize individual settings fields. [#352](https://github.com/Charitable/Charitable/issues/352) | |
| 347 | -* NEW: Added basic styling for the `datepicker` form field. [#317](https://github.com/Charitable/Charitable/issues/317) | |
| 348 | -* NEW: Improved the Campaigns table in the admin to provide more helpful information at a glance, such as the current campaign status, end date and total funds raised. [#417](https://github.com/Charitable/Charitable/issues/417) | |
| 349 | -* NEW: Removed deprecated PayPal variables (cbt and no_note). Kudos to [@bscottx](https://github.com/bscottx). [#413](https://github.com/Charitable/Charitable/issues/413) | |
| 350 | -* FIX: Sessions have been improved to work alongside full page caching solutions like Varnish. Previously these caused problems with things like the donation receipt becoming inaccessible to donors after they donated. [#383](https://github.com/Charitable/Charitable/issues/383) | |
| 351 | -* FIX: Avoid creating records in `wp_options` for sessions that have no data. [#399](https://github.com/Charitable/Charitable/pull/399) | |
| 352 | -* FIX: Significantly improved the speed of Charitable settings pages. [#236](https://github.com/Charitable/Charitable/issues/236) | |
| 353 | -* FIX: The thousands separator for currencies can now be set to None, which will result in no spaces/commas/decimals appearing in large numbers such as 100000. [#448](https://github.com/Charitable/Charitable/issues/448) | |
| 354 | -* FIX: The donation log now displays log times in local time, not UTC. [#446](https://github.com/Charitable/Charitable/issues/446) | |
| 355 | -* FIX: Resolved a database error that broke the donation search function. [#407](https://github.com/Charitable/Charitable/issues/407) | |
| 356 | -* FIX: Changed login prompt text in donation form to something more logical. [#384](https://github.com/Charitable/Charitable/issues/384) | |
| 357 | -* FIX: Close modals with the ESC key. [#191](https://github.com/Charitable/Charitable/issues/191) | |
| 358 | -* FIX: Removed the drag drop field in the picture field on mobile devices. [#373](https://github.com/Charitable/Charitable/issues/373) | |
| 359 | -* FIX: A bug in Mobile Safari broke the picture field. [#370](https://github.com/Charitable/Charitable/issues/370), [#259](https://github.com/Charitable/Charitable/issues/259) | |
| 360 | -* FIX: In certain cases, hitting return key in form fields opened a file upload prompt. [#363](https://github.com/Charitable/Charitable/issues/363) | |
| 361 | -* FIX: Uploading more than max uploads to picture field works in certain cases. [#376](https://github.com/Charitable/Charitable/issues/376) | |
| 362 | -* FIX: Display Read More link in campaign loop for expired campaigns. [#381](https://github.com/Charitable/Charitable/issues/381) | |
| 363 | -* FIX: On email or gateway settings pages, provide a link back to the parent settings page. [#351](https://github.com/Charitable/Charitable/issues/351) | |
| 364 | -* FIX: When Stripe Checkout is closed/cancelled, donation form submission afterwards failed. [#378](https://github.com/Charitable/Charitable/issues/378) | |
| 365 | -* FIX: Fixed styling issue in REHub theme. [#406](https://github.com/Charitable/Charitable/issues/406) | |
| 366 | -* FIX: Campaign metabox tabs broke with Social Warfare activated. [#364](https://github.com/Charitable/Charitable/issues/364) | |
| 344 | += Donation Form & Fundraising Campaigns v1.8.11 = | |
| 345 | +* NEW: PayPal Commerce gateway - accept one-time donations via PayPal wallet (Venmo, Pay Later) and inline credit/debit card (Advanced Card Processing). | |
| 346 | +* NEW: Site-level PayPal tier lock allows new installs and Commerce-tier sites see PayPal Commerce; existing PayPal Standard sites keep using the legacy gateway. | |
| 347 | +* NEW: Help icons next to each payment gateway in admin settings, linking to documentation. | |
| 348 | +* IMPROVED: Test Mode toggle now has descriptive help text explaining sandbox routing. | |
| 349 | +* IMPROVED: Stripe donation flow now self-heals when a previously stored PaymentIntent becomes unreachable (e.g. after a gateway reconnect). | |
| 367 | 350 | |
| 368 | -= 1.4.20 = | |
| 369 | -* Improve how plugin updates are shown for Charitable extensions. [#382](https://github.com/Charitable/Charitable/issues/382) | |
| 351 | += Donation Form & Fundraising Campaigns v1.8.10.5 = | |
| 352 | +* NEW: Redesigned the "What's New" splash screen with a new hero section, video, and upgrade buttons. | |
| 353 | +* NEW: Added a Form navigation icon in the campaign builder with an upgrade prompt for the Charitable Pro visual form builder. | |
| 354 | +* IMPROVED: System Info now includes a Hosting Environment section. | |
| 355 | +* FIX: Hardened input handling in the donations admin search to improve query safety. | |
| 356 | +* FIX: Resolved a custom donation amount parsing issue with the decimal separator on non-US currency sites in certain scenarios. | |
| 370 | 357 | |
| 371 | -= 1.4.19 = | |
| 372 | -* Fixed a bug that prevented suggested donations with cents from showing correctly in sites where a comma is used for the decimal separator (i.e. 9,50). [#356](https://github.com/Charitable/Charitable/issues/356) | |
| 358 | += Donation Form & Fundraising Campaigns v1.8.10.4 = | |
| 359 | +* FIX: Fixed an issue where multiple Stripe webhook endpoints could accumulate over time, causing donation webhook events to fail signature verification in certain scenarios. | |
| 373 | 360 | |
| 374 | -= 1.4.18 = | |
| 375 | -* Added an end time when editing campaigns to make it clearer when a campaign ends. Previously, a campaign's end time was ambiguous and this caused confusion for some users. [#335](https://github.com/Charitable/Charitable/issues/335) | |
| 376 | -* Add space as a thousands separator for countries where `12 500,00` would be the correct way to format an amount. [#332](https://github.com/Charitable/Charitable/issues/332) | |
| 377 | -* Add campaign edit link as email shortcode option for campaign-related emails. [#345](https://github.com/Charitable/Charitable/issues/345) | |
| 378 | -* Fixed multiple HTML validation issues in Charitable forms and the campaigns widget. [#344](https://github.com/Charitable/Charitable/issues/344) and [#349](https://github.com/Charitable/Charitable/issues/349) | |
| 379 | -* Prevent a bug where the donated amount on a campaign is completely wrong after a site changes its decimal/thousands separators. [#279](https://github.com/Charitable/Charitable/issues/279) | |
| 380 | -* Flush the campaign donation cache in popular caching plugins (WP Super Cache, W3 Total Cache, WP Rocket and WP Fastest Cache). [#186](https://github.com/Charitable/Charitable/issues/186) | |
| 381 | -* Fixed an error during donation processing that prevented donations when database caching is enabled in W3 Total Cache. [#347](https://github.com/Charitable/Charitable/issues/347) | |
| 382 | -* Improved the way upgrades are run to ensure they are not re-run unneccesarily and store the minimum required information about each upgrade. | |
| 383 | - | |
| 384 | -= 1.4.17 = | |
| 385 | -* **THANK YOU**: Thanks to first-time contributor [@qriouslad](https://github.com/qriouslad) for his contribution to this release! | |
| 386 | -* When using Stripe Checkout, amounts over $999 were sometimes incorrectly sent to the Stripe modal. [#339](https://github.com/Charitable/Charitable/issues/339) | |
| 387 | -* Avoid fatal error in rare instances (only encountered in the Layers theme by Obox) when the donation form scripts are loaded through an admin AJAX request. [#340](https://github.com/Charitable/Charitable/issues/340) | |
| 388 | -* Added support for linking to campaign donated to from donation-related emails. [#341](https://github.com/Charitable/Charitable/issues/341) | |
| 389 | -* Improved i18n for dates. | |
| 390 | -* Introduced unit testing for Javascript, using QUnit. Developers, this is only available with the full package download from [GitHub](github.com/Charitable/Charitable/). | |
| 391 | -* Sanitize result of queries for campaign totals and total number of site donations. | |
| 392 | -* Avoid error that happens in situations where Divi and Yoast SEO are both installed alongside Charitable. [#316](https://github.com/Charitable/Charitable/issues/316) | |
| 393 | -* Better formatting of code commenting to improve compatibility with WordPress coding standards. | |
| 361 | += Donation Form & Fundraising Campaigns v1.8.10.3 = | |
| 362 | +* IMPROVED: Sync Pending Stripe Donations now uses AJAX processing with new dry run and email options. | |
| 363 | +* FIX: Improved Stripe webhook reliability, signing secret handling, and notice wording in certain scenarios. | |
| 364 | +* FIX: Fixed refund checkbox not appearing when changing donation status to Refunded in certain scenarios. | |
| 394 | 365 | |
| 395 | -= 1.4.16 = | |
| 396 | -* Updated bundled version of WP Session Manager library to latest version (1.2.2). | |
| 366 | += Donation Form & Fundraising Campaigns v1.8.10.2 = | |
| 367 | +* NEW: Added Sync Pending Stripe Donations tool to gateway settings (beta). | |
| 368 | +* FIX: Fixed minor CSS issues on dashboard. | |
| 369 | +* FIX: Fixed some PHP warnings. | |
| 370 | +* FIX: Fixed a fatal error involving Stripe webhook migration on sites without an active Stripe connection in certain scenarios. | |
| 397 | 371 | |
| 398 | -= 1.4.15 = | |
| 399 | -* Add recurring donations support to Offline gateway. [#329](https://github.com/Charitable/Charitable/issues/329) | |
| 372 | += Donation Form & Fundraising Campaigns v1.8.10.1 = | |
| 373 | +* FIX: Improved Stripe webhook verification and resolved several issues with signing secret setup and auto-migration. | |
| 374 | +* FIX: Improved license detection on WordPress multisite subsites. | |
| 375 | +* FIX: Resolved PHP 8.3 compatibility issue in Stripe gateway. | |
| 376 | +* FIX: Fixed Cloudflare Turnstile action string exceeding character limit on password retrieval form. | |
| 377 | +* FIX: Fixed padding and alignment in dashboard tab content area for addon status messages. | |
| 400 | 378 | |
| 401 | -= 1.4.14 = | |
| 402 | -* After submitting the donate widget, redirect to the actual donation form on the page. [#328](https://github.com/Charitable/Charitable/issues/328) | |
| 403 | -* Improved compatibility for the donate widget with Recurring Donations. | |
| 379 | += Donation Form & Fundraising Campaigns v1.8.10 = | |
| 380 | +* NEW: Expanded Import tools with sub-tabs for Charitable, GiveWP, and GiveButter imports including CSV donations import and GiveWP Migration Tool (Beta). | |
| 381 | +* NEW: Redesigned blank slate pages for campaigns and donations. | |
| 382 | +* IMPROVED: Strengthened Stripe webhook processing with additional verification. | |
| 383 | +* FIX: Restored campaign grid column widths for the [campaigns] shortcode. | |
| 384 | +* FIX: Improved email reliability when processing certain recipient formats. | |
| 385 | +* FIX: Improved error diagnostics in System Info. | |
| 404 | 386 | |
| 405 | -= 1.4.13 = | |
| 406 | -* Added `tag` parameter to the [campaigns] shortcode. [#313](https://github.com/Charitable/Charitable/issues/313) | |
| 407 | -* We cleaned up another bug involving our [Easy Digital Downloads Connect extension](https://www.wpcharitable.com/extensions/charitable-easy-digital-downloads-connect/?utm_source=readme&utm_medium=changelog-tab&utm_campaign=edd-connect), which resulted in being unable to set an end date for contribution rules when the campaign doesn't have an end date. [#310](https://github.com/Charitable/Charitable/issues/310) | |
| 408 | -* Persist un-rendered notices across page loads. [#314](https://github.com/Charitable/Charitable/issues/314) | |
| 409 | -* Hide radio inputs when Javascript is enabled. [#312](https://github.com/Charitable/Charitable/issues/312) | |
| 410 | -* We made some minor improvements to how the donation form submission is processed in Javascript. Needed for improvements to Stripe extension. | |
| 387 | += Donation Form & Fundraising Campaigns v1.8.9.7 = | |
| 388 | +* NEW: Charitable will add social meta to campaign pages for improved sharing on some social networks (SEO plugins can override this). | |
| 389 | +* FIX: Fixed broken social share URLs for Twitter/X, Pinterest, and improved share link defaults. | |
| 390 | +* FIX: Corrected sanitization issue that resulted in incorrect display of code in "time left" display for campaigns in certain scenarios. | |
| 411 | 391 | |
| 412 | -= 1.4.12 = | |
| 413 | -* If you were using our [Easy Digital Downloads Connect extension](https://www.wpcharitable.com/extensions/charitable-easy-digital-downloads-connect/?utm_source=readme&utm_medium=changelog-tab&utm_campaign=edd-connect) and your site language is not English, you may have had problems with end dates for your benefactor relationships not saving correctly. We've fixed up that bug now. [#305](https://github.com/Charitable/Charitable/issues/305) | |
| 392 | += Donation Form & Fundraising Campaigns v1.8.9.6 = | |
| 393 | +* IMPROVED: Enhanced license validation process with improved performance when downloading Charitable Pro automatically. | |
| 394 | +* FIX: Improved email reliability in certain scenarios, especially with certain aggressive WordPress themes. | |
| 395 | +* FIX: Updated translation strings and minor updates to PHP and CSS regarding best practices. | |
| 414 | 396 | |
| 415 | -= 1.4.11 = | |
| 416 | -* Corrected a problem that caused newly created/saved campaigns without an end date to stop showing in the `[campaigns]` shortcode output. [#301](https://github.com/Charitable/Charitable/issues/301) | |
| 417 | -* Fixed an issue that resulted in PayPal donations left as Pending when `allow_url_fopen` was turned off on the server. [#302](https://github.com/Charitable/Charitable/issues/302) | |
| 418 | -* Avoid displaying the donation form & campaign information outside of the loop (this caused weird issues in the Layers theme). [#303](https://github.com/Charitable/Charitable/issues/303) | |
| 419 | -* Provided a more flexible API for toggling settings based on other setting values. | |
| 397 | += Donation Form & Fundraising Campaigns v1.8.9.5 = | |
| 398 | +* FIX: Added additional checks to resolved issue with Stripe webhook that was causing a fatal error a certain scenario. | |
| 399 | +* FIX: Allow more international characters into campaign title fields in campaign visual builder. | |
| 400 | +* IMPROVED: Email shortcode processing with recursion prevention for better reliability. | |
| 401 | +* IMPROVED: Added additional enhanced email error logging and diagnostics. | |
| 420 | 402 | |
| 421 | -= 1.4.10 = | |
| 422 | -* Correctly filter donations by date in the CSV export. This was broken in certain non-English languages. [#299](https://github.com/Charitable/Charitable/issues/299) | |
| 423 | -* Fixed an issue that prevented the custom donation amount from being picked up on sites using our new [Recurring Donations extension](https://www.wpcharitable.com/extensions/charitable-recurring-donations/?utm_source=readme&utm_medium=changelog-tab&utm_campaign=recurring-donations). | |
| 403 | += Donation Form & Fundraising Campaigns v1.8.9.4 = | |
| 404 | +* FIX: Resolved seemingly missing social media icons in some campaign builder template previews in certain scenarios. | |
| 405 | +* UPDATE: Improved campaign builder templates for cache busting. | |
| 424 | 406 | |
| 425 | -= 1.4.9 = | |
| 426 | -* Added Ghanaian Cedi and Egyptian Pound to currencies. [#288](https://github.com/Charitable/Charitable/issues/288) and [#282](https://github.com/Charitable/Charitable/issues/282) | |
| 427 | -* Remove `$wp_version` global. [#294](https://github.com/Charitable/Charitable/pull/294) | |
| 428 | -* Miscellaneous accessibility improvements. [#291](https://github.com/Charitable/Charitable/pull/291), [#292](https://github.com/Charitable/Charitable/pull/292) and [#293](https://github.com/Charitable/Charitable/pull/293) | |
| 407 | += Donation Form & Fundraising Campaigns v1.8.9.3 = | |
| 408 | +* FIX: Resolved onboarding redirect issue in some scenarios. | |
| 429 | 409 | |
| 430 | -= 1.4.8 = | |
| 431 | -* Removed some code left over from plugin testing. | |
| 410 | += Donation Form & Fundraising Campaigns v1.8.9.2 = | |
| 411 | +* NEW: Email and donation form debugging tools in "System Info" in Charitable Tools. | |
| 412 | +* UPDATE: Campaign template CSS now loads via REST API endpoint to resolve 500 errors on servers that block direct PHP file access. | |
| 413 | +* FIX: Adjustments for PHP 8.4 and PHP 8.5 for better compatibility. | |
| 414 | +* FIX: Adjustment in how email emails are registered and loaded for better potential compatibility in certain server configurations. | |
| 415 | +* FIX: Minor translation and coding updates. | |
| 432 | 416 | |
| 433 | -= 1.4.7 = | |
| 434 | -* Avoid issues with PayPal IPNs missing the 'invoice' parameter in certain cases — likely a bug on the PayPal end. This resulted in donations remaining stuck as Pending. We have reworked how IPNs are processed to avoid reliance on this and avoid further issues. [#289](https://github.com/Charitable/Charitable/issues/289) | |
| 435 | -* Store the PayPal transaction ID for donations after an IPN has been received. [#270](https://github.com/Charitable/Charitable/issues/270) | |
| 436 | -* Add a notice to the donation form when viewed by site admin to remind them that Test Mode is enabled. [#233](https://github.com/Charitable/Charitable/issues/233) | |
| 437 | -* Improve styling for the donation receipt summary. [#214](https://github.com/Charitable/Charitable/issues/214) | |
| 438 | -* Make sure that donor count and donors widget both include donations to child campaigns. [#263](https://github.com/Charitable/Charitable/issues/263) and [#264](https://github.com/Charitable/Charitable/issues/264) | |
| 439 | -* Correctly show the donor count in the Donation Stats widget, not the number of donations. [#268](https://github.com/Charitable/Charitable/issues/268) | |
| 440 | -* Show a blank field for formatted addresses in the donation export or admin donation pages when no address details were provided. Previously, the donor's name was shown. [#255](https://github.com/Charitable/Charitable/issues/255) and [#256](https://github.com/Charitable/Charitable/issues/256) | |
| 441 | -* Fix client-side credit card validation. [#280](https://github.com/Charitable/Charitable/issues/280) | |
| 442 | -* Fix issue causing incorrect donation status to be displayed in admin notification email and donation receipt. [#261](https://github.com/Charitable/Charitable/issues/261) | |
| 443 | -* Remove the Licenses tab from the Settings area when you don't have any extensions installed. [#249](https://github.com/Charitable/Charitable/issues/249) | |
| 444 | -* Miscellaneous other minor, under-the-hood improvements and tweaks. | |
| 417 | += Donation Form & Fundraising Campaigns v1.8.9.1 = | |
| 418 | +* FIX: Resolved issue where blank state screens were not displaying on campaigns and donations list pages when no items exist. | |
| 419 | +* FIX: Fixed help button in campaign builder not navigating to documentation URL. | |
| 445 | 420 | |
| 446 | -= 1.4.6 = | |
| 447 | -* Properly activate Charitable on all sites when it is network activated. Also makes sure that Charitable is correctly installed when a new site is added to a network that has Charitable network-activated. [#225](https://github.com/Charitable/Charitable/issues/225) | |
| 448 | -* Display success messages to the user after settings are updated in the admin. [#54](https://github.com/Charitable/Charitable/issues/54) | |
| 449 | -* Fixes a bug that prevented donations from being displayed in the admin when filtering by campaign. [#242](https://github.com/Charitable/Charitable/issues/242) | |
| 450 | -* Removes PHP warnings that were displayed on the Charitable donations page in the dashboard when there are no donations. [#232](https://github.com/Charitable/Charitable/issues/232) | |
| 451 | -* Changed the hook that the Donation Receipt and Donation Notification emails are sent on from `save_post` to `charitable-completed_donation`. [#217](https://github.com/Charitable/Charitable/issues/217) | |
| 452 | -* Added a `CHARITABLE_DEBUG` constant for error logging. Currently, enabling this only logs the IPN responses that are received from PayPal after donations are made. [#229](https://github.com/Charitable/Charitable/issues/229) | |
| 453 | -* Ensure that the donation form script is always loaded for the campaign donation widget. [#239](https://github.com/Charitable/Charitable/issues/239) | |
| 454 | -* Fixes a bug that prevented the password reset from working correctly. [#238](https://github.com/Charitable/Charitable/issues/238) | |
| 455 | -* Refer to campaigns as campaigns instead of posts in admin update messages. [#234](https://github.com/Charitable/Charitable/issues/234) | |
| 421 | += Donation Form & Fundraising Campaigns v1.8.9 = | |
| 422 | +* NEW: Captcha security settings in security tab. Supports Google reCAPTCHA (Invisible V2), Google reCAPTCHA v3 (Invisible), hCaptcha, Cloudflare Turnstile. | |
| 456 | 423 | |
| 457 | -= 1.4.5 = | |
| 458 | -* The permissions for accessing Donations and Campaigns in the WordPress dashboard has changed. Users who are set up as Campaign Managers can access both Donations and Campaigns, but cannot access Charitable settings. This permission is reserved for admin users. In addition, the `manage_charitable_settings` permission has been removed from Campaign Managers. [#209](https://github.com/Charitable/Charitable/issues/209) | |
| 459 | -* Fixes the way donations are processed in Javascript to avoid issues when the donation is *not* processed with AJAX (currently, this is only the case if you're using the Easy Digital Downloads extension, Pronamic iDEAL or an old version of one of our premium payment gateway extensions). [#223](https://github.com/Charitable/Charitable/issues/223) | |
| 460 | -* Fixes the registration form shortcode, which was being printed out too early on the page. [#224](https://github.com/Charitable/Charitable/issues/224) | |
| 461 | -* Adds a new filter for the list of active payment gateways: `charitable_active_gateways`. See `Charitable_Gateways::get_active_gateways()`. | |
| 462 | -* Three new methods have been added to the `Charitable_Donation` abstract class: `get_donation_type()` retrieves the type of donation; `get_donation_plan_id()` returns the ID of the recurring donation plan (to be used by the Recurring Donations extension); `get_donation_plan()` returns the recurring donation object. [PR #215](https://github.com/Charitable/Charitable/pull/215) | |
| 463 | -* Export files now include the type of export (note: this does not work if you are on PHP 5.2). [#200](https://github.com/Charitable/Charitable/issues/200) | |
| 464 | -* The `custom` parameter for PayPal donations now accepts a JSON string. [PR #198](https://github.com/Charitable/Charitable/pull/198) | |
| 424 | += Donation Form & Fundraising Campaigns v1.8.8.6 = | |
| 425 | +* NEW: Added include_children to the stat shortcode. | |
| 426 | +* FIX: Resolved issue relating to onboarding screen overriding a number of other WordPress admin screens. | |
| 427 | +* FIX: Updated code related to translations and PHP standards. | |
| 428 | +* UPDATE: Campaign frontend CSS system revised. | |
| 465 | 429 | |
| 466 | -= 1.4.4 = | |
| 467 | -* Resolves a new issue related to the donation form validation introduced in version 1.4.3, which prevented the donation widget form from being submitted. [#221](https://github.com/Charitable/Charitable/issues/204) and [#205](https://github.com/Charitable/Charitable/issues/221) | |
| 468 | -* Fixes a bug that resulted in logged in users who had never made a donation being able to see a list of all donations with the `[charitable_my_donations]` shortcode. No personal donor data was displayed, and the donation receipts remained inaccessible to the users. All they could see was the date of the donation, the campaign donated to and the amount of the donation. [#220](https://github.com/Charitable/Charitable/issues/204) and [#205](https://github.com/Charitable/Charitable/issues/220) | |
| 430 | += Donation Form & Fundraising Campaigns v1.8.8.5 = | |
| 431 | +* FIX: Resolved bug regarding manual donation edit and time resetting to midnight. | |
| 432 | +* FIX: Insured proper sanitization of user input in database queries in some scenarios. | |
| 433 | +* FIX: Updated code related to translations and PHP standards. | |
| 469 | 434 | |
| 470 | -= 1.4.3 = | |
| 471 | -* Added a new sandbox testing tool to allow you to test your PayPal donation flow. If you're using PayPal, you should test this as soon as you can to avoid disruption, as PayPal is making some security upgrades to its platform which may cause problems for certain sites. [Read more about how PayPal's upgrades will affect you](https://www.wpcharitable.com/how-paypals-ssl-certificate-upgrade-will-affect-you-and-how-you-can-prepare-for-it/?utm_source=notice&utm_medium=wordpress-dashboard&utm_campaign=paypal-ssl-upgrade&utm_content=blog-post) | |
| 472 | -* Added honeypot form validation for the donation form and registration, password reset, forgot password and profile forms. This is an anti-spam measure designed to prevent fake donations from being created by bots. | |
| 473 | -* Prevent donations from being created if an invalid email address or payment gateway is used. | |
| 474 | -* Ensure that client-side validation is always performed for donations, even when the gateway integration has not been updated for compatibility with the AJAX-driven donations introduced in version 1.3. The only gateway that we know of that falls into this category is Pronamic iDEAL, so this is a nice update if you are using Pronamic iDEAL. | |
| 435 | += Donation Form & Fundraising Campaigns v1.8.8.4 = | |
| 436 | +* FIX: Fixed compatibility issue in admin action processing that could cause errors when managing recurring donations. | |
| 437 | +* FIX: Improved caching of dashboard blog posts. | |
| 438 | +* FIX: Updated code related to translations and PHP standards. | |
| 439 | +* UPDATE: Updated text on dashboard widgets. | |
| 475 | 440 | |
| 476 | -= 1.4.2 = | |
| 477 | -* Added a link to the registration form from the login form and vice versa. [#204](https://github.com/Charitable/Charitable/issues/204) and [#205](https://github.com/Charitable/Charitable/issues/205) | |
| 478 | -* Included two new parameters in the `[charitable_registration]` shortcode: `redirect` sets the default page that people should be redirect to after registering, and `login_link_text` sets the text of the login link (see above). [#208](https://github.com/Charitable/Charitable/issues/208) and [#205](https://github.com/Charitable/Charitable/issues/205) | |
| 479 | -* Also included a new parameter in the `[charitable_login]` shortcode: `registration_link_text` sets the text of the login link (see above). [#204](https://github.com/Charitable/Charitable/issues/204) | |
| 480 | -* Added a column for the campaign creator to the campaigns page in the WordPress dashboard. [#166](https://github.com/Charitable/Charitable/issues/166) | |
| 481 | -* Added three new fields that can be displayed in donation-related emails, like the donation receipt or admin notification: the total amount donated, the campaign(s) that received the donation and the categories of the campaign(s) that received the donation. [#202](https://github.com/Charitable/Charitable/issues/202) and [#203](https://github.com/Charitable/Charitable/issues/203) | |
| 482 | -* Made sure that setting the `order` parameter in the `[campaigns]` shortcode works with lowercase and uppercase. `ASC`, `DESC`, `asc` and `desc` are all valid options now. [#206](https://github.com/Charitable/Charitable/issues/206) | |
| 483 | -* Fixed a bug that prevented the campaign end date from saving when using Charitable in a non-English installation. [#201](https://github.com/Charitable/Charitable/issues/201) | |
| 484 | -* Fixed a bug that prevented the comments section from appearing on campaigns when modal donations were enabled. [#210](https://github.com/Charitable/Charitable/issues/210) | |
| 485 | -* Fixed a bug that caused a PHP warning when trying to use the `site_url` email shortcode parameter in emails. | |
| 441 | += Donation Form & Fundraising Campaigns v1.8.8.3 = | |
| 442 | +* FIX: Resolved application fee calculation issue for zero-decimal currencies in Stripe payments in certain scenarios. | |
| 443 | +* FIX: Updated code related to improve security and PHP standards compliance. | |
| 486 | 444 | |
| 487 | -= 1.4.1 = | |
| 488 | -* The donor address is split over multiple columns in the donation export. [#194](https://github.com/Charitable/Charitable/issues/194) | |
| 489 | -* In certain cases, credit card validation was getting triggered for non-credit card donations (i.e. PayPal or Offline). This bug has been fixed. [#189](https://github.com/Charitable/Charitable/issues/189) | |
| 490 | -* After a donor makes a successful donation is made, their session is cleared as expected. [#181](https://github.com/Charitable/Charitable/issues/181) | |
| 491 | -* Pending and draft campaigns are now included in the filtering options on the Donations page. [#187](https://github.com/Charitable/Charitable/issues/187) | |
| 492 | -* The Bolivian Boliviano currency (BOB) has been added. [#193](https://github.com/Charitable/Charitable/issues/193) | |
| 445 | += Donation Form & Fundraising Campaigns v1.8.8.2 = | |
| 446 | +* FIX: Resolve PHP error causing issues with dashboard fully loading in some scenarios. | |
| 447 | +* FIX: Improved front-end detection of tabs in visual campaigns. | |
| 493 | 448 | |
| 494 | -= 1.4.0 = | |
| 495 | -* Added the `[charitable_my_donations]` shortcode. Use this shortcode to allow logged in users to view a history of their donations, including links to the donation receipts. [#14](https://github.com/Charitable/Charitable/issues/14) | |
| 496 | -* Scale the campaign grid gracefully when viewing on smaller screens. The `[campaigns]` shortcode now supports a `responsive` paramater, which is enabled by default. You can set it to a specific px/em amount to change the breakpoint, or set it to `0` to disable responsive styling. [#88](https://github.com/Charitable/Charitable/issues/88) | |
| 497 | -* Also provided appropriately responsive styling for suggested donation amounts on small screens. [#159](https://github.com/Charitable/Charitable/issues/159) | |
| 498 | -* Added client-side validation for the donation form. This checks whether donors have filled out all the required fields, whether they're donating more than $0 (because seriously, a $0 donation won't go far :)) and whether they have used a valid credit card (if you're using our Stripe or Authorize.Net extensions). [#176](https://github.com/Charitable/Charitable/issues/176) and [#63](https://github.com/Charitable/Charitable/issues/63) | |
| 499 | -* Added a password reset process to provide a complete user-facing login and registration workflow. [#89](https://github.com/Charitable/Charitable/issues/89) | |
| 500 | -* Include an `order` paramater for the `[campaigns]` shortcode, to reverse the direction in which campaigns are displayed. [#64](https://github.com/Charitable/Charitable/issues/64) | |
| 501 | -* Allow campaigns in the `[campaigns]` shortcode to be ordered by any of the orderby options for [`WP_Query`](https://codex.wordpress.org/Class_Reference/WP_Query#Order_.26_Orderby_Parameters). | |
| 502 | -* Added drag and drop support for the Picture form field, which is used in the User Avatar and Ambassadors extensions. [#111](https://github.com/Charitable/Charitable/issues/111) | |
| 503 | -* Improved how the plugin checks for updates to Charitable extensions, to keep the WordPress dashboard running smoothly. [#133](https://github.com/Charitable/Charitable/issues/133) | |
| 504 | -* Added a `charitable_create_donation()` function for developers who want to create donations programatically. [#109](https://github.com/Charitable/Charitable/issues/109) | |
| 505 | -* Added a new `Charitable_Donations_Query` class, which can be used by developers to retrieve donations from the database. [#155](https://github.com/Charitable/Charitable/issues/155) | |
| 506 | -* Added a new `Charitable_Deprecated` class, which is used to record any incorrect usage of Charitable functions or methods. | |
| 507 | -* Switched to using the built-in edit.php admin page for listing Charitable donations, instead of relying on a custom admin page with a custom posts table. While there, we also simplified the interface and added colour-coding to the donation statuses. [#110](https://github.com/Charitable/Charitable/issues/110) | |
| 508 | -* Include the donor's phone number, address and the payment method in the donations export CSV. [#154](https://github.com/Charitable/Charitable/issues/154) | |
| 509 | -* When multiple gateways are enabled, the default one is listed first in the donation form. [#139](https://github.com/Charitable/Charitable/issues/139) | |
| 510 | -* Automatically cancel a donation when the donor returns from the gateway before completing it. This works with PayPal, PayUMoney and PayFast. [#90](https://github.com/Charitable/Charitable/issues/90) and [#117](https://github.com/Charitable/Charitable/issues/117) | |
| 511 | -* Added a `Charitable_Donor::__toString()` method, so that echoing the object simply prints out the donor name. | |
| 512 | -* Added `charitable_sanitize_amount()` function to convert any amount of type string into a float. | |
| 513 | -* Trim the currency symbol from monetary amounts to prevent the symbol being treated as part of the amount. [#145](https://github.com/Charitable/Charitable/pull/145) | |
| 514 | -* Trim the currency symbol from the suggested donation amounts when saving a campaign. [#147](https://github.com/Charitable/Charitable/issues/147) | |
| 515 | -* When a donation fails and the user is redirected back to the donation form, they can re-attempt the same donation. Previously, a new donation would have been created, leaving a phantom pending donation behind. [#106](https://github.com/Charitable/Charitable/issues/106) | |
| 516 | -* Prevent duplicate donations caused by clicking the donate button repeatedly. [#164](https://github.com/Charitable/Charitable/issues/164) | |
| 517 | -* Fixed a bug related to empty content in the Layers theme. [#9](https://github.com/Charitable/Charitable/issues/9) | |
| 449 | += Donation Form & Fundraising Campaigns v1.8.8.1 = | |
| 450 | +* FIX: Fixed some CSS issues in certain areas in the admin when a license was not activated. | |
| 451 | +* UPDATE: Minor dashboard visual updates when a license is activated. | |
| 518 | 452 | |
| 519 | -= 1.3.7 = | |
| 520 | -* Makes `Charitable_Currency::get_currency_symbol()` a publicly accessible method. | |
| 521 | -* Allow email shortcode values to be dynamically generated without being registered first. This simplifies the process of displaying dynamic data within emails if there is no existing shortcode output for it. [#134](https://github.com/Charitable/Charitable/issues/134) | |
| 522 | -* Provide a consistent api for determining the status of a campaign. Developers can use `$campaign->get_status_key()` (where `$campaign` is a `Charitable_Campaign` object) to check whether a campaign is inactive, ended, ended and successfully funded, ended and not successfully funded, ending soon, or active. | |
| 523 | -* Reset the positioning and styling of the modal when window or modal change in size. This prevents the modal from growing larger than the size of the window without having scrollbars. [#135](https://github.com/Charitable/Charitable/issues/135) | |
| 453 | += Donation Form & Fundraising Campaigns v1.8.8 = | |
| 454 | +* NEW: New dashboard design with top campaigns, latest donations, top donors, and comments. New "30 Day" period added. | |
| 455 | +* NEW: Added 'charitable_donor_query_skip_donation_filters' for donor query to make including donors without donations more flexible. | |
| 456 | +* NEW: Added 'charitable_admin_donation_form_donor_list' to control donor retreval in the admin. | |
| 457 | +* NEW: Test Mode Alert now shows in admin pages, links to Charitable's payment methods settings screen. | |
| 458 | +* NEW: Updated plugin screen design. | |
| 459 | +* NEW: About Us menu that includes "Getting Started" page for the Charitable Checklist, Lite vs Pro page, and more. | |
| 524 | 460 | |
| 525 | -= 1.3.6 = | |
| 526 | -* Prevented campaigns being created with no suggested donation amounts and custom donations disabled. This results in $0 donations. [#127](https://github.com/Charitable/Charitable/issues/127) | |
| 527 | -* Fixed errors when exporting donations with errors set to display. [#128](https://github.com/Charitable/Charitable/issues/128) | |
| 528 | -* Deprecated `Charitable_Email::return_value_if_has_valid_donation()` method, since this was completely broken and should not be used. | |
| 461 | += Donation Form & Fundraising Campaigns v1.8.7.4 = | |
| 462 | +* FIX: Resolve a fatal error in PHP 8.0 in campaign visual builder in certain scenarios. | |
| 529 | 463 | |
| 530 | -= 1.3.5 = | |
| 531 | -* Added `is_preview()` method to `Charitable_Email` class. | |
| 532 | -* Added `get_donations()` method to `Charitable_Donor` class. | |
| 533 | -* Improved custom post status labels. | |
| 534 | -* Only include completed payments in the Donation Statistics dashboard widget, for the period summaries. | |
| 535 | -* Fixed PHP notices in email previews. | |
| 536 | -* Deprecated `Charitable_Session::get_session_id()`. We are no longer using a public session ID. | |
| 464 | += Donation Form & Fundraising Campaigns v1.8.7.3 = | |
| 465 | +* FIX: Updated code related to translations and PHP standards. | |
| 466 | +* FIX: Bug in license detection to display certain text in certain scenarios. | |
| 467 | +* FIX: JavaScript errors related to campaign visual builder when Charitable is in debug mode. | |
| 537 | 468 | |
| 538 | -= 1.3.4 = | |
| 539 | -* Added selective refresh support for Charitable widgets. | |
| 540 | -* Added support for passing multiple campaign IDs to campaign donation queries. [#112](https://github.com/Charitable/Charitable/issues/112) | |
| 541 | -* Fixed a bug where donors without a completed donation were included in the donor count in the Donation Stats widget. [#114](https://github.com/Charitable/Charitable/issues/114) | |
| 542 | -* Fixed a bug that incorrectly set the from address for emails to always be the site email address, instead of using the provided settings. [#113](https://github.com/Charitable/Charitable/issues/113) | |
| 543 | -* Fixed a bug that stopped the cron scheduler from being activated in any new installs. | |
| 544 | -* Fixed display issues in the Charitable settings area with number fields. | |
| 545 | -* Deprecated usage of `shortcode_atts()` for the email shortcode, in favor of `wp_parse_args()`. If you relied on the `shortcode_atts_charitable_email` filter, this will no longer do anything and you should test & update your code. | |
| 469 | += Donation Form & Fundraising Campaigns v1.8.7.2 = | |
| 470 | +* FIX: CSS tweaks to notifications displays and admin settings. | |
| 471 | +* UPDATE: Notification alert dot in header shows number of notifications. | |
| 546 | 472 | |
| 547 | -= 1.3.3 = | |
| 548 | -* Fixes a bug that prevented donors being able to access their donation receipts after making their donation. | |
| 549 | -* Flush rewrite rules after installation to avoid "Page not found" errors. | |
| 473 | += Donation Form & Fundraising Campaigns v1.8.7.1 = | |
| 474 | +* FIX: Minor CSS issues in CTA areas. | |
| 475 | +* FIX: Resolved an issue with Elementor embedded campaigns with the modal donation form setting selected. | |
| 550 | 476 | |
| 551 | -= 1.3.2 = | |
| 552 | -* Fixed a bug that turned comments off everywhere. [#104](https://github.com/Charitable/Charitable/issues/104) | |
| 553 | -* Added a better fallback for donations for users with Javascript enabled, when using the modal donation forms. [#60](https://github.com/Charitable/Charitable/issues/60) | |
| 554 | -* Avoid sending donation notifications & receipts multiple times when a donation's status is toggled on/off Paid. [#96](https://github.com/Charitable/Charitable/issues/96) | |
| 555 | -* Donate button in campaign grids links to the campaign page when the donation form is set up to show on the same page as the campaign. [#107](https://github.com/Charitable/Charitable/issues/107) | |
| 556 | -* Fixed a bug that caused invalid shortcode options to show for custom emails sub-classing `Charitable_Email`. [#95](https://github.com/Charitable/Charitable/issues/95) | |
| 477 | += Donation Form & Fundraising Campaigns v1.8.7 = | |
| 478 | +* NEW: Square added as a default payment gateway. [More Information](https://www.wpcharitable.com/get-started/square/) | |
| 479 | +* NEW: ErrorHandler class that will suppress _load_textdomain_just_in_time messages. | |
| 480 | +* FIX: Updated code related to translations and PHP standards. | |
| 557 | 481 | |
| 558 | -= 1.3.1 = | |
| 559 | -* **APOLOGIES**: 1.3.0 introduced a couple of bugs that we failed to pick up on before releasing the update. We have fixed those bugs now and are working on improving the process around how we push out updates, to avoid issues like this in the future. | |
| 560 | -* Removes leftover testing code that prevented campaigns from being created or edited. | |
| 561 | -* Format the donation amount so that PayPal can understand it (PayPal doesn't like amounts with more than two decimal places). [See issue](https://github.com/Charitable/Charitable/issues/102) | |
| 562 | -* Prevent PHP notice when making a donation. [See issue](https://github.com/Charitable/Charitable/issues/100) | |
| 563 | -* Fixes a bug that prevented the Donate widget from working as expected. | |
| 482 | += Donation Form & Fundraising Campaigns v1.8.6.2 = | |
| 483 | +* NEW: Add ‘allow_unfiltered’ setting for CHARITABLE_ADMIN javascript variables for use in campaign builder. | |
| 484 | +* FIX: Improved realiablity of some license checks. | |
| 485 | +* FIX: Updated code related to improve security and PHP standards. | |
| 564 | 486 | |
| 565 | -= 1.3.0 = | |
| 566 | -* **THANK YOU**: A massive thank you to the following contributors who have contributed to Charitable 1.3: [@helgatheviking](https://github.com/helgatheviking), [@rafecolton](https://github.com/rafecolton), [@ciegovolador](https://github.com/ciegovolador), [@ElStupid](https://github.com/ElStupid) and [@altatof](httsp://github.com/altatof). | |
| 567 | -* NEW: Export donations to CSV via the WordPress dashboard. Go to Charitable > Donations and click on the Export button to generate your report. | |
| 568 | -* NEW: Donations are now processed via AJAX, which results in a smoother donation flow, particularly if you're using modal donations. [See issue](https://github.com/Charitable/Charitable/issues/41) | |
| 569 | -* NEW: Added an `id` parameter to the `[campaigns]` shortcode to show just a single campaign's widget. | |
| 570 | -* NEW: Dutch & French translations! Major props to @ElStupid (Dutch translation) and @altatof (French translation). | |
| 571 | -* NEW: Added custom body classes for the following templates: donation receipt, donation processing and email preview. All body classes are added via a single function: `charitable_add_body_classes()`. | |
| 572 | -* Added ARS currency. | |
| 573 | -* Fixed a bug that prevented donations with cents from being stored/displayed correctly when using commas for the currency decimal. [See issue](https://github.com/Charitable/Charitable/issues/57) | |
| 574 | -* Fixed a bug that let to donations being saved with the incorrect donation time. Run the upgrade routines to fix this in all your existing donations. | |
| 575 | -* Removed `charitable_templates_start` hook and deprecated all methods in the `Charitable_Templates` class. If you were calling any of these directly or using the `charitable_templates_start` hook, update your application code. All templates are now loaded via a single method: `Charitable_Templates::template_loader()`. All custom body classes are added via `charitable_add_body_classes()`. `Charitable_Templates::remove_admin_bar_from_widget_template()` has been replaced with `charitable_hide_admin_bar()`. | |
| 576 | -* Fixes a styling bug that caused the progress bar to extend beyond the campaign widget when more than 100% of a campaign's has been raised. [See issue](https://github.com/Charitable/Charitable/issues/47) | |
| 577 | -* Fixes a Javascript bug that prevented the $ variable (jQuery) from being defined in certain cases in the admin scripts. | |
| 578 | -* Fixes a clash with Cart66. | |
| 579 | -* Fixed a bug in modal donation window. [See issue](https://github.com/Charitable/Charitable/issues/43) | |
| 580 | -* Changed the `amount` column in the `wp_charitable_campaign_donations` table to a DECIMAL, instead of FLOAT. [See issue](https://github.com/Charitable/Charitable/issues/56) | |
| 487 | += Donation Form & Fundraising Campaigns v1.8.6.1 = | |
| 488 | +* FIX: Resolve security issue with public checkbox template. | |
| 489 | +* FIX: Resolve fatal error involving Elementor constants. | |
| 490 | +* FIX: Resolve issue involving some non-english translations and the campaign builder payment page. | |
| 491 | +* FIX: Resolved a CSS rendering issue with Youth Sports campaign template. | |
| 581 | 492 | |
| 582 | -= 1.2.4 = | |
| 583 | -* Updated for compatibility with WordPress 4.4. | |
| 584 | -* Improves the API for dealing with the donation processor. Both the `charitable_before_process_donation_form` and `charitable_before_process_donation_amount_form` hooks now pass the donation form object as a second parameter. | |
| 585 | -* Fixes a bug that prevented you from being able to select the donation amount inside a modal opened via AJAX. | |
| 586 | -* Fixes a bug that prevented the donation form display option from being set correctly when changed via the Customizer. | |
| 587 | -* Fixes a bug in the form submission handler. | |
| 493 | += Donation Form & Fundraising Campaigns v1.8.6 = | |
| 494 | +* NEW: Admins can directly reply to donors via donation notification emails. | |
| 495 | +* NEW: Four new Elementor widgets: Campaign, Donor Form, Donor Button, Campaign List. | |
| 496 | +* NEW: Ability to round donations in the campaign builder's progress bar. | |
| 497 | +* FIX: Resolved issue when tabs in visual campaigns not appearing in certain scenarios. | |
| 498 | +* FIX: Resolved issue with loading of frontend scripts in certain scenarios. | |
| 499 | +* FIX: Resolved Facebook sharing w/ sharing button on campaigns. | |
| 500 | +* FIX: Updated code related to translations, CSS, UI, and PHP standards. | |
| 588 | 501 | |
| 589 | -= 1.2.3 = | |
| 590 | -* NEW: The `[campaigns]` widget now supports a new `button` argument, so you can specify whether you would like to show a "Read more" link, a "Donate" button, or nothing at all. [See the documentation](https://www.wpcharitable.com/documentation/the-campaigns-shortcode/?utm_source=readme&utm_medium=changelog-tab&utm_campaign=plugin-page-referrals&utm_content=1-2-3-release) for details on how to use the new argument. | |
| 591 | -* Improved styling for the modal donation form. | |
| 592 | -* Added method to retrieve all donation IDs for a particular campaign. | |
| 593 | -* Fixes a bug that blocked donations with a dollar sign in the amount field. | |
| 594 | -* Fixes a bug that prevented template functions from being "pluggable" in themes. | |
| 595 | -* Fixes a bug that stopped the profile form from displaying the user's saved address fields. | |
| 596 | -* Fixes a bug that prevented form submission validating when submitting a value of 0 for required fields. | |
| 502 | += Donation Form & Fundraising Campaigns v1.8.5.3 = | |
| 503 | +* NEW: Added dialog box upon entering license that activates Pro if already installed. | |
| 504 | +* FIX: Improve sanitization of donor widget and video alt text in campaign builder. | |
| 505 | +* FIX: Tweak first/last/email field CSS on a "minimal" format form. | |
| 597 | 506 | |
| 598 | -= 1.2.2 = | |
| 599 | -* Fixes a bug that prevented the donation form from working correctly when the donor is not logged in. | |
| 507 | += Donation Form & Fundraising Campaigns v1.8.5.2 = | |
| 508 | +* FIX: Improved sanitation in decimal count in admin general settings. | |
| 509 | +* FIX: Improved support for certain currency settings when auto formatting certain fields in the campaign builder. | |
| 510 | +* FIX: Addressed some PHP notices that involved translations. | |
| 600 | 511 | |
| 601 | -= 1.2.1 = | |
| 602 | -* Including missing files from 1.2.0 release. | |
| 512 | += Donation Form & Fundraising Campaigns v1.8.5.1 = | |
| 513 | +* FIX: Resolved fatal error in some scenarios upon activation/deactivation of license and installing Pro with third-party plugins. | |
| 514 | +* FIX: Resolved a JS error in settings due to incorrect sanitization. | |
| 515 | +* UPDATED: CTA related updates, including Marketing and Security tabs. | |
| 603 | 516 | |
| 604 | -= 1.2.0 = | |
| 605 | -* [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). | |
| 606 | -* NEW: Change the highlight colour via the WordPress Customizer. You can preview your changes as you make them. | |
| 607 | -* NEW: There is a shiny new dashboard widget when you log into the WordPress dashboard to highlight your donation stats. | |
| 608 | -* NEW: You can now limit the donation form to only display required user fields. | |
| 609 | -* NEW: Create a static page with the [donation_receipt] shortcode to customize your donation receipt. | |
| 610 | -* NEW: All donation data is now displayed in the admin donation page. | |
| 611 | -* NEW: You can now change the campaign creator via the Campaign management page. | |
| 612 | -* NEW: Adds a login link to the donation form when donors are not logged in. | |
| 613 | -* NEW: When a user is logged in but has not filled out all required fields, they are presented with all the user fields. | |
| 614 | -* Removed the 'charitable_after_update_donation' hook. To respond to updates to a donation, use the 'save_post_donation'. | |
| 615 | -* Fixed a bug that resulted in `[campaigns orderby=popular]` to include non-complete donations when determining the order of campaigns. | |
| 616 | -* Fixed a bug that prevented donors from receiving their donation receipt after a donation is updated directly on the donation page. | |
| 617 | -* 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. | |
| 618 | -* Fixes bugs in the Donation Stats and Donors widget that causes them to include pending donations in the total. | |
| 619 | -* Fixes a bug in the Benefactors addon that caused fixed contribution amounts to not be saved. | |
| 620 | -* Major performance improvements in the WordPress dashboard. | |
| 621 | -* Better PHP 5.2 compatibility. | |
| 517 | += Donation Form & Fundraising Campaigns v1.8.5.0 = | |
| 518 | +* NEW: Compatibility with new Charitable Pro plugin (including automatic upgrading when entering a license). | |
| 519 | +* NEW: "charitable_export_data" and "charitable_export_columns" filters for control in Charitable exporting in the admin. | |
| 520 | +* UPDATED: CSS tweaks to admin and donation form UI. | |
| 521 | +* FIX: Updated code related to translations, CSS, UI, and PHP standards. | |
| 622 | 522 | |
| 623 | -= 1.1.5 = | |
| 624 | -* Fixes a bug that allowed people to make a donation without entering required details, or with an amount of $0 or less. | |
| 523 | += Donation Form & Fundraising Campaigns v1.8.4.8 = | |
| 524 | +* FIX: Resolved security issue involving the logout template. | |
| 625 | 525 | |
| 626 | -= 1.1.4 = | |
| 627 | -* Fixes a critical bug that resulted in PayPal donations not working if you didn't have any other gateways installed. | |
| 628 | -* Fixes an error when trying to retrieve a donor name for a donation that does not have a matching donor. | |
| 526 | += Donation Form & Fundraising Campaigns v1.8.4.7 = | |
| 527 | +* UPDATED: Terms and consent options are also now under "Privacy" settings and any Charitable settings in WordPress customizer are depreciated and will soon be removed. | |
| 528 | +* FIX: Made headers and spacing more consistent in settings area, along with tweaks in character output. | |
| 629 | 529 | |
| 630 | -= 1.1.3 = | |
| 631 | -* Enhancement: Added the ability to change the dimensions of the user avatars added using Charitable User Avatar, with a PHP filter function. | |
| 632 | -* Fixes an issue where only having one active gateway meant that those gateway's donation form fields would not show. | |
| 633 | -* Fixes a problem with the permalinks structure that prevented you being able to create pages with slugs of "/donate/" or "/widget". | |
| 634 | -* Fixes the WP Editor form field template to prevent the text from being wrapped in HTML tags. | |
| 530 | += Donation Form & Fundraising Campaigns v1.8.4.6 = | |
| 531 | +* FIX: Resolved an issue involving escaped text on addons page. | |
| 532 | +* FIX: Tweaks to UI on certain element defaults in campaign builder. | |
| 635 | 533 | |
| 636 | -= 1.1.2 = | |
| 637 | -* Security Fix: Prevent unauthorized users accessing your donation receipt. | |
| 638 | -* Fix: Localization with the .po/.mo files now really does work correctly. For real this time. | |
| 534 | += Donation Form & Fundraising Campaigns v1.8.4.5 = | |
| 535 | +* NEW: A minimum number of characters is now required for a password for user registeration. Customize via the 'charitable_minimum_password_length' filter. | |
| 536 | +* FIX: Resolved issues related to the campaign visual builder and several UI elements. | |
| 537 | +* FIX: Improved methods of exporting and importing donations via Tools. | |
| 538 | +* FIX: Updated code related to opt-in data collection, translations, CSS, UI, typos, and PHP standards. | |
| 639 | 539 | |
| 640 | -= 1.1.1 = | |
| 641 | -* Fix: Emails will now correctly be sent with the body, headline and subject you set, instead of the default. | |
| 540 | += Donation Form & Fundraising Campaigns v1.8.4.4 = | |
| 541 | +* FIX: Adjusted escaping of setting labels resolving an issue rendering HTML beta tags. | |
| 542 | +* FIX: CSS adjustments to display banners on some admin screens. | |
| 543 | +* FIX: Resolved a bug with dashboard notifications. | |
| 642 | 544 | |
| 643 | -= 1.1.0 = | |
| 644 | -* Enhancement: Added a new email that can be sent when a campaign has finished. | |
| 545 | += Donation Form & Fundraising Campaigns v1.8.4.3 = | |
| 546 | +* NEW: (Visual Campaign Builder) New options for Social Links and Social Sharing fields include YouTube (links only), Threads, and Bluesky. | |
| 547 | +* FIX: (Visual Campaign Builder) Visual tweaks to campaigns on "narrow content" themes. | |
| 548 | +* FIX: Adding additional check to resolve several JavaScript errors in some scenarios in the campaign builder. | |
| 549 | +* FIX: Resolved issue involving default fields appearing in visual builder for campaign summary. | |
| 550 | +* FIX: Resolved an issue regarding rendering HTML in emails in some scenarios. | |
| 551 | +* FIX: Updated code related to opt-in data collection, translations, CSS, UI, and PHP standards. | |
| 645 | 552 | |
| 646 | -* Fix: Localization with the .po/.mo files now works correctly. | |
| 647 | -* Fix: Chrome 45 bug when clicking directly on suggested amount inputs is resolved. | |
| 553 | += Donation Form & Fundraising Campaigns v1.8.4.2 = | |
| 554 | +* NEW: (Visual Campaign Builder) Changing button color in "advanced" will automatically adjust donation button text for contrast. | |
| 555 | +* FIX: (Visual Campaign Builder) Updated documentation links. | |
| 556 | +* FIX: (Visual Campaign Builder) Adjustments and tweaks to campaigns in visual builder (admin and frontend). | |
| 557 | +* FIX: Resolved issue involving sanitization of non-english dates in some scenarios resulting in incorrect "days until" calculations. | |
| 558 | +* FIX: Updated code related to opt-in data collection, translations, CSS, UI, and PHP standards. | |
| 648 | 559 | |
| 649 | -= 1.0.3 = | |
| 650 | -* Improvement: Using `wp_list_pluck` instead of `array_column` for compatibility with versions of PHP prior to 5.5. | |
| 651 | -* PHP 5.2 Compatibility: Avoid T_PAAMAYIM_NEKUDOTAYIM error in older versions of PHP. | |
| 560 | += Donation Form & Fundraising Campaigns v1.8.4.1 = | |
| 561 | +* FIX: Resolved an issue involving the "Use This Template" button in visual campaign when choosing campaigns in some scenarios. | |
| 562 | +* FIX: Resolved an internal server issue when attempting to fetch CSS when campaign builder was viewing the Club template. | |
| 563 | +* FIX: Minor adjustments and tweaks to campaign templates including word breaking and word wrapping in the visual builder. | |
| 564 | +* FIX: Updated code related to typos, translations and PHP standards. | |
| 652 | 565 | |
| 653 | -= 1.0.2 = | |
| 654 | -* Fix: Added missing file into the repo. | |
| 566 | += Donation Form & Fundraising Campaigns v1.8.4 = | |
| 567 | +* NEW: Onboarding wizard on first install that guides you through setting up basic settings, gateways, plugins, and your first campaign! | |
| 568 | +* NEW: You can now opt-in into data collection to improve Charitable. See "advanced settings" screen for details. | |
| 569 | +* UPDATED: Revised output of the "Your Donations" title that was causing issues for those adding HTML via the 'charitable_donation_amount_legend' filter. | |
| 570 | +* FIX: Updated code related to translations, CSS, UI, and PHP standards. | |
| 655 | 571 | |
| 656 | -= 1.0.1 = | |
| 657 | -* Improvement: Moved the user dashboard functionality into the core of the plugin, so that it is always available. | |
| 658 | -* Fix: The installation routine now flushes permalinks correctly -- no more "Page not Found" problems! | |
| 572 | += Donation Form & Fundraising Campaigns v1.8.3.7 = | |
| 573 | +* NEW: Stripe Gateway allows single or multiple credit card field layout (beta). [More Information](https://www.wpcharitable.com/documentation/credit-card-multiple-fields/) | |
| 574 | +* FIX: Ensured some additional settings are added to the database upon a new install. | |
| 659 | 575 | |
| 660 | -= 1.0.0 = | |
| 661 | -* Initial release | |
| 576 | += Donation Form & Fundraising Campaigns v1.8.3.6 = | |
| 577 | +* NEW: Form templates (beta) - standard/default and "minimal" - selectable in donation form settings in the "general" settings tab. [More Information](https://www.wpcharitable.com/documentation/donation-form-templates/) | |
| 578 | +* NEW: Added 'charitable_donation_amount_legend' filter to allow easier customization of "Your Donations" on donation form. | |
| 579 | +* NEW: Added beta global 'CHARITABLE_DISABLE_SHOW_CURRENT_DONATION_AMOUNT' to change behavior of showing a donation already "in session" on donation form. | |
| 580 | +* UPDATED: Turning off 'disable legacy mode' will now make more "add new" link for campaigns default to making new legacy campaigns. | |
| 581 | +* UPDATED: Donation buttons in visual campaign for campaigns that no longer accept donations will show a 'no longer accepting donations message' while button is disabled. | |
| 582 | +* FIX: Changed santitization of a url in Charitable upgrades which should allow upgrade to complete and prevent notice from appearing. | |
| 583 | +* FIX: Improved notifications and dashboard display in the admin for ltr displays. | |
| 584 | +* FIX: Resolved issue when donation module in campaign wasn't matching donation amount in modal triggered by donation button on same page. | |
| 585 | +* FIX: CSS adjustments to campaign templates: wrapper element, donation buttons, and tweaks to donation suggested amounts. | |
| 586 | +* FIX: Updated code related to translations and PHP standards. | |
| 587 | + | |
| 588 | += Donation Form & Fundraising Campaigns v1.8.3.5 = | |
| 589 | +* NEW: Added a 'charitable_gateway_fields_after_selector' action hook to insert content between gateway selectors and gateway fields on donation forms. | |
| 590 | +* UPDATED: Provided a 'campaign_categories' attribute to stat and donor shortcodes to help filter by Charitable campaign categories. | |
| 591 | +* FIX: Resolves PHP notices that appeared after WordPress 6.7.0 was released. | |
| 592 | +* FIX: Improved front-end buttons and CSS of several campaign templates. | |
| 593 | +* FIX: Remove notifications HTML when printing from a browser in the WordPress admin. | |
| 594 | +* FIX: Updated code related to translations and PHP standards. | |
| 595 | + | |
| 596 | += Donation Form & Fundraising Campaigns v1.8.3.4 = | |
| 597 | +* NEW: Added a new setting on privacy screen to allow the consent field to be required before submitting a donation. | |
| 598 | +* NEW: Added a 'charitable_redirection_after_gateway_processing' filter which helps override the URL that the donor should be redirected to after a donation in certain scenarios. | |
| 599 | +* FIX: Resolved an issue involving formatting a donation amount in non-English languages on the Charitable dashboard. | |
| 600 | +* UPDATED: Compatibility with WordPress 6.7.1. | |
| 601 | + | |
| 602 | += Donation Form & Fundraising Campaigns v1.8.3.3 = | |
| 603 | +* FIX: Resolved an issue when a button appeared unresponsive when verifying/disconnecting a license on the general settings tab. | |
| 604 | +* FIX: Updated translation strings and improved string output for email password reset email body. | |
| 605 | +* FIX: Resolved incorrect form field name on the privacy page for contact consent. | |
| 606 | + | |
| 607 | += Donation Form & Fundraising Campaigns v1.8.3.2 = | |
| 608 | +* UPDATED: To improve performance and security, user list for assigning campaign ownership in campaign settings checks for users with proper permissions. | |
| 609 | +* UPDATED: New filter 'charitable_campaign_builder_settings_general_users' to customize the updated user list. | |
| 610 | +* FIX: campaign_link() function returns $link rather than false. | |
| 611 | +* FIX: Visiting the settings page will attempt to double check licenses for any expiring or expired subscriptions. | |
| 612 | +* FIX: Notification tweaks including upgrading from older versions and showing UI even if feed is empty. | |
| 613 | +* FIX: Donation amount from custom donation field in a campaign page should now be carried to the donation page even with currency symbols included. | |
| 614 | +* FIX: Updated code related to translations, CSS, UI, and PHP standards. | |
| 615 | + | |
| 616 | += Donation Form & Fundraising Campaigns v1.8.3.1 = | |
| 617 | +* UPDATED: "Disable Legacy Campaign Mode" is set to on for new installs of the plugin. [More Information](https://www.wpcharitable.com/documentation/legacy-campaigns/) | |
| 618 | +* UPDATED: Plugin notification slide out UI can be closed by also clicking outside of the notification area. | |
| 619 | +* FIX: Addressed security issue on the donations list screen. | |
| 620 | +* FIX: Updated code related to translations, CSS, UI, and PHP standards. | |
| 621 | + | |
| 622 | += Donation Form & Fundraising Campaigns v1.8.3 = | |
| 623 | +* NEW: WordPress editor block: "Campaigns". Displays multiple Charitable campaigns in a grid. | |
| 624 | +* NEW: WordPress editor block: "Donations". Display a simple donation widget for a campaign. | |
| 625 | +* NEW: WordPress editor block: "Donors". Display a list of donors to one or all of your campaigns. | |
| 626 | +* NEW: WordPress editor block: "Campaign Stats". Allows various statistics to be dynamically calculated and displayed on a page. | |
| 627 | +* NEW: WordPress editor block: "Donation Button". Displays a donation button for a particular campaign. | |
| 628 | +* NEW: WordPress editor block: "Campaign Progress Bar". Displays a live progress bar for a particular campaign. | |
| 629 | +* NEW: WordPress editor block: "My Donations". Displayss a list of donations for the current logged in user. | |
| 630 | +* NEW: Added a new notifications engine to keep you informed of all important updates, license information, and news. New inbox icon and notifications menu items will alert when new notifications are available. | |
| 631 | +* NEW: Updated charitable.pot. | |
| 632 | +* UPDATED: Additional minification of JS and CSS to increase performance. | |
| 633 | +* FIX: Resolved an issue regarding campaign descriptions not displaying properly with the campaign shortcode in some scenarios. | |
| 634 | +* FIX: Fixed alt-text of a LinkedIn share icon in visual campaign builder. | |
| 635 | +* FIX: Code tweaks related to translations, CSS, UI, and PHP warnings. | |
| 636 | + | |
| 637 | += Donation Form & Fundraising Campaigns v1.8.2 = | |
| 638 | +* NEW: "Charitable Checklist" so new users can check vital settings, connect gateways, and get to building their first campaign. | |
| 639 | +* NEW: Warning messages for admin users - in gateway settings page and viewing donation forms (as admins) - if Stripe is enabled, but no keys are detected. | |
| 640 | +* NEW: Dashboard notifications for important messages and notices. | |
| 641 | +* NEW: Added 'charitable_email_fields_donation_field_value' filter which can help with output of custom field values in emails. | |
| 642 | +* NEW: Campaigns shortcode now has a new "description_limit" parameter that limits words displayed from campaign description. | |
| 643 | +* NEW: Added a donation button shortcode. [More Information](https://www.wpcharitable.com/documentation/donation-button-shortcode/) | |
| 644 | +* NEW: Added both a filter and an option (in beta) in the general setting tab to disable showing a login form or registeration reminder on donation forms. [More Information](https://www.wpcharitable.com/documentation/hiding-the-login-register-form-on-donation-forms/) | |
| 645 | +* UPDATED: Improved tour guide for visual campaign builder with more interactivity and showing more elements. | |
| 646 | +* UPDATED: Campaigns shortcode now displays a photo and campaign description from campaigns built with the visual builder. | |
| 647 | +* UPDATED: Moved "Categories", "Tags", and "Customize" menus from main menu. Now found in the Charitable -> "Tools" page. | |
| 648 | +* FIX: Adjusted appearance of the donation button in Youth Sports campaign theme when modal button setting was on. | |
| 649 | +* FIX: Resolved an issue with the donation summary field for the visual campaign builder involving showing/hiding items. | |
| 650 | +* FIX: Resolved several instances where donation amounts were not being formatted currently in non-English languages in the reporting screens. | |
| 651 | +* FIX: Improved loading for the WordPress dashboard widget. | |
| 652 | +* FIX: Adjustments to CSS on the Dashboard page. | |
| 653 | +* FIX: Minor translation, misc CSS, UI, and PHP coding updates. | |
| 654 | + | |
| 655 | +**[View entire donation form and fundraising platform changelog](https://plugins.svn.wordpress.org/charitable/trunk/CHANGELOG.md)** | |
