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 ID, log in and open your nonprofit's dashboard. The ID is the number in its web address (ex: https://better.giving/admin/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" |