Better Giving Wordpress plugin documentation
Installing the WordPress Better Giving Donation Form Plugin
- Download the Better Giving Wordpress Plugin (ZIP file).
SHA256 Checksum: 34f1aa11ab99e691e290b128d11d019cc9f7cb29f14f01f921b03835316880ce
- Install the plugin by uploading the ZIP file to your Wordpress server, via the WP-Admin interface.
- Activate the Better Giving Donation Form plugin
Using and configuring Better Giving Donation Form Shortcode
The shortcode used to insert a Better Giving donation form into your wordpress blocks, pages and/or posts is bg_donation_form.
At a minimum, the following MUST be provided for the shortcode to work correctly and render the donation form: a Nonprofit Account ID. This is the number that was assigned to your nonprofit when you signed up with Better Giving and is unique to it (ex. 121).
NOTE: If you do not know your Nonprofit Account number, you can easily locate by navigating to the Marketplace and searching for your nonprofit by name. The account number is found at the end of the link to your profile on it's marketplace card (ex: https://better.giving/marketplace/121).Below is an example of the minimum Better Giving donation form shortcode that would be needed in order to render a working component in Wordpress. With the minimum code, all optional settings will set to their defaults.
[bg_donation_form id=121]
The following are additional, optional configuration arguments that may be passed to further customize and configure your Donation Form settings and appearance from the default:
| Name | Description | Allowed Values | Example |
|---|---|---|---|
currentsplitpct | Set a percentage of a to be split to the current account. Donors can still adjust the split from this starting suggested value. Defaults to 50%. | 0-100 | currentsplitpct=20 |
splitdisabled | Locks split to current percentage, preventing donors from changing it. This will hide the split slider screen. Defaults to 0. | 0 (not disabled) OR 1 (disabled) | splitdisabled=1 |
showdescription | Show or hide the description text. Defaults to shown. | 0 (not shown) OR 1 (shown) | showdescription=0 |
showtitle | Show or hide the title text. Defaults to shown. | 0 (not shown) OR 1 (shown) | showtitle=0 |
description | Custom description text to show under the title. | description="Custom description..." | |
title | Custom title text to show at the top of the donation form. | title="Custom title" | |
methods | Define the payment method tabs to show and their order via a comma separated string. | Valid methods: "stocks", "daf", "stripe" (ie. credit cards), "crypto" | methods="crypto,stripe" |
accentprimary | Set the primary accent color to your Nonprofit's brand color. | HEX color 3 or 6 digits (must start with '#') | accentprimary=#dd8943" |
accentsecondary | Set the secondary accent color to your Nonprofit's brand color. | HEX color 3 or 6 digits (must start with '#') | accentsecondary="#dd8943" |