Documentation Category: Customization

  • How to refund a donation

    Unfortunately, you will probably need to refund a donation sooner or later. When that happens, Charitable has your back with an easy way to refund donations in your WordPress dashboard. You can also refund donations (including partial refunds) through your payment gateway account. Refund from the WordPress dashboard If you need to refund a donation,…

  • How to Fix “Page Not Found” Errors

    If you are getting a “Page Not Found” or 404 error, it may be a permalinks issue. Try this to fix it:  ​In your WordPress dashboard, go to Settings > Permalinks Without changing any settings, click on Save Changes After doing this, the problem should be resolved. 

  • How to Change ‘Donate’ Button Text

    There are a couple ways you can change the text in Charitable. You could use a translation plugin like TranslatePress, or you can use a little bit of code. Here is a code snippet you can adapt: https://library.wpcode.com/snippet/32j0vx5l/ How to add a code snippet If you are new to PHP or WordPress development, we recommend adding these…

  • 3 Ways to Add Code Customizations to Your Site

    One of the key benefits of using Charitable is that it provides many ways in which you can customize. We manage a growing library of code snippets at https://library.wpcode.com/profile/wpcharitable/ which show different ways that you can tailor Charitable to your needs. But if you want to add a bit of code to your site, how…

  • How to Add a Donate Link to Your Menu

    If you would like to add a Donate link or button in your menu, there are a couple ways of achieving this. Option 1: Link to a separate donation page You can add a link to your donation page while editing your menu at Appearance > Menus. In the left hand column, look for the “Custom Links” option.…

  • How to Set a Minimum Donation Amount

    By default, Charitable will accept any donation over $0. You can customize the minimum donation amount with a little bit of code, using the charitable_minimum_donation_amount filter: add_filter( ‘charitable_minimum_donation_amount’, function() { return 2; } ); The above code sets a minimum donation amount of $2; any donation of $2 or more will be accepted. Permitting $0 donations…

  • Offline Donation Emails

    As of Charitable 1.5, there are two emails that apply specifically to offline donations: Offline Donation Receipt Offline Donation Notification These emails are only sent for offline donations which are pending. To activate these emails, go to Charitable > Settings > Emails, and click Enable Email for both of these. Offline Payment Instructions In the…

  • Add Your Donation Form to a Page

    With Charitable 1.5, there is an easy way to embed a donation form in a page with the [charitable_donation_form] shortcode. Simply create your campaign (if you’re not sure how, see this documentation), then find the ID of the campaign by going to Charitable > Campaigns. You will see the ID listed before the campaign name. Now…

  • How to create and edit donations in the WordPress dashboard

    Received a cheque in the mail from a donor and want to add it to Charitable? No problems! With Charitable, you can easily create and edit donations through your WordPress dashboard. Create a new donation To create a new donation from the Dashboard, go to Charitable > Donations, and click the Add Donation button at…

  • How to resend donation emails

    Need to resend a donation receipt to your donor? With Charitable, you can do that easily through the WordPress dashboard. Which emails can you resend? Charitable allows you to resend any donation-related email. Out of the box, this includes the Donation Receipt for donors, and the New Donation Notification email, which is sent to site…

  • Remove Amount Raised & Donor Count

    You can remove the percentage raised, amount raised, and donor count from the stats summary block on all campaign pages by adding some custom code. The following code will work with most WordPress themes: How to remove the stats in Reach If you are using the Reach theme, you can remove the campaign stats with…

  • Remove Stats Summary Block from Campaign Page

    You can remove the stats summary block from all campaign pages by adding some custom code. Here is a snippet of code you can use: https://library.wpcode.com/snippet/ro8mwk2w/ To remove the stats summary block from a specific campaign, you can use this code snippet: https://library.wpcode.com/snippet/r2m31r5d/ You will need to specify which campaign by replacing ‘325’ with the…

  • How Do I Create a PayPal Sandbox Account?

    When you are first getting started with accepting donations through PayPal, it is useful to be able to test that everything works correctly without using live payments. Enter the PayPal sandbox. This is a tool designed to help developers and merchants test their integration with PayPal. We strongly recommend setting up an account and testing that…

  • How to Remove Avatars from the Donors Widget

    You can remove the avatars from the donors widget by creating a custom template for the donors widget. To do that, create a new file in your theme or child theme at charitable/widgets/donors.php. Next, copy and paste the contents of the charitable/templates/widgets/donors.php template file (this is in the Charitable plugin directory) into this file. You can then make…

  • How to Remove a Field from a Form

    Here is a code snippet that provides a general guide to removing fields from forms. It lists the ‘hooks’ you should use for each form, as well as all of the fields that are included in those forms. See this page at WPCode.com for details on how to add a code snippet to your site…