Simple Razoo Donations WordPress Plugin
Why is the Simple Razoo Donations Plugin Helpful?
- You can easily include the Razoo Donation Widget on your website and start accepting donations without typing any code at all.
- You can place the donation form into the middle of any post or page using a button within the WordPress editor. The donation form is added right into the editor as a WordPress shortcode that looks like “[razoo_donation_form]“.
- The detailed settings page allows you to easily update the content, design and donation options.
- Since the donation form is embedded within the settings page, you can see any adjustments immediately after making updates and saving your changes.
- We include simple instructions on how to get up and running to start accepting donations online.
- You can use shortcode attributes to customize individual donation forms for different locations on your website.
- We promise to respond to every support request, period.
Clearing Up Confusion About the Term “Widget”
We want to clear up any confusion about the name given to the donation form by Razoo. The name “Razoo Donation Widget” includes the word widget, but that does not refer to a WordPress widget. There is no widget functionality included with this plugin.
How Do I Install the Plugin?
The easiest way to install the Simple Razoo Donations plugin is to go to Plugins >> Add New in the WordPress backend and search for “Simple Razoo Donations.” On the far right side of the search results, click “Install.” If this doesn’t work follow the steps below.
- Download the Simple Razoo Donations plugin and unzip the files.
- Upload the simple-razoo-donations folder to the /wp-content/plugins/ directory.
- Activate the Simple Razoo Donations plugin through the “Plugins” menu in WordPress.
How Do I Add the Donation Form to My Website?
Now that you’ve installed the plugin you’re ready to add the donation form to your website. To do so, follow the steps outlined here.
- Configure your donation form settings by going to Settings >> Simple Razoo Donations in the WordPress backend.
- Place your cursor within the WordPress editor’s text where you want the Razoo donation form to be added.
- Click the Razoo icon in the WordPress editor toolbar (looks like a globe broken into pieces). The Razoo shortcode reading “[razoo_donation_form]“ will be added in the editor.
- Click the blue “Publish” or “Update” button to save your changes and add the Razoo donation form to your live website.
Frequently Asked Questions
Here are some frequently asked questions about how to use the plugin.
How do I customize the donation form for different pages?
If you want to put different versions of the donation form on different pages of your website, you can use shortcode attributes to override the default options you provided on the settings page. You only need to include attributes for the defaults you wish to override. For example, if every donation should go to the same organization, you will never need to use the “id” attribute in your shortcode. An example shortcode with all attributes looks like this:
[razoo_donation_form id="United-Way-of-America" title="Support United Way" short_description="Help us help the community" long_description="United Way has been supporting communities since the late 1800s and now supports communities in countries around the world." color="#000000" image="true" donation_options="20=Donor|30=Sponsor|50=All Star Contributor"]
Here is a breakdown of how to use each attribute:
- id: The ID for your organization according to Razoo. When on your organization’s landing page it’s the text that comes right after “/story/” in the URL. For example, the United Way of America’s ID is “United-Way-Of-America”. You can view their ID at http://www.razoo.com/story/United-Way-Of-America.
- title: The title will show up in big letters at the top of the donation form.
- short_description: A short description of your organization or an ask for people to donate. This text shows up just below the title.
- long_description: This is also called the “more info” section and can be much longer, describing more about your organization and where the donors’ money will go. This text shows up when users click the “More info” link on the donation form.
- color: Provide the color you want for the donation form in hexadecimal format (#000000). You should match this closely to your website’s colors.
- image: use “true” to show the main image for your organization on the donation form.
- donation_options: Add the donation options you want to offer potential donors within a pipe (|) separated list of values and labels (ie. donation_options=”20=Donor|30=Sponsor|50=All Star Contributor”)
How do I use the shortcode in a template file?
To add the shortcode directly to a template file use the code:
<?php echo do_shortcode('[razoo_donation_form]'); ?>
Download Simple Razoo Donations
You can download Simple Razoo Donations in the WordPress Plugin Repository at http://wordpress.org/extend/plugins/simple-razoo-donations/.
For support please visit the WordPress support forum for this plugin and we’ll get back to you as soon as we can.
The Simple Razoo Donations WordPress plugin requires WordPress 2.8 and has been tested up to WordPress 3.4.2.
Here is a list of all the versions of the plugin we’ve released and what changes we’ve made with each release.
- Fixed “Settings” link on plugins page to point correctly.
- Initial release