Documentation

Donation for WooCommerce Store Owner’s Guide – Basic Concepts

Installation Guide

↑ Back to top

Log in to your WordPress Admin Panel.
Navigate to the WordPress Admin Dashboard → Plugins → Add New.

Click on the Upload Plugin button on the top left corner of your screen.
Next, click the Choose file button in the box that appears below.
Select the zip file that you have downloaded and upload it.
Click on the Activate Plugin button.

Creating a new campaign

↑ Back to top

Campaign settings

↑ Back to top

How to add a new campaign?

Go to the ‘WC Donation’ tab
Click on the ‘Add New’ button
1. Give a ‘Title’ to your new campaign
2. Go to Campaign Settings Menu
3. Enter Amount in digits or decimal values (System will pick the donation value from here)
4. Give Label (It will be displayed at the donation dropdown value on the checkout page. The System will not pick the donation amount or any detail from here)
5. Select an ‘Amount Type’ from stated options where
  1. ‘Predefined’ will show the fixed value for donation.
  2. ‘Custom Value’ will give the option to your customer to enter the amount as per their desire.
  3. ‘Both’ options will serve to select the amount from the dropdown menu. You can also enter the amount but within a specified limit.
  4. Donation Level will add multiple amounts of a campaign with a fixed amount of donation.

Front-end view Screenshots

How to set up a donation campaign with a custom value (min and max limits)?

A donation campaign can be created with a ‘Custom Value’ where the admin can enter any amount between the minimum and maximum bracket.

Note* If the Minimum and Maximum amount is not defined b admin, the system will automatically set the donation amount limit from 0 to 1000

Click on ‘Add level’ to show multiple amounts in the donation dropdown menu.
1. Added levels can be deleted by clicking on the trash icon at the top right of each level.

2. Multiple predefined levels will be shown as:

Donation form settings

↑ Back to top

Go to “Form Settings” Menu
1. Admin can set the display settings from this option.
2. Set display type (it will change the donation ‘Label Display Style’ into ‘Dropdown’ or ‘Radio Button’ style)

Dropdown Style

Radio Button Style

Label Style

Currency Position will change the position of the currency sign.

Donation Label Field

Donation button label

Donation Button Text Color

Donation button color

Campaign List

↑ Back to top

How to view the campaign list?

Go to the wp-admin dashboard
Under the WC Donation menu, click on the “All Campaign” tab.

All the added campaigns can be seen in the ‘Campaign List’

In the campaign list, the admin can see the total no of donations against each campaign along with its total amount.

General Settings

↑ Back to top

General display settings

↑ Back to top

Go to “General Settings”
Enable the ‘Cart and Checkout donation’ option so that donation fields will appear simultaneously on the cart and checkout page.
Select ‘Campaign’ from the select list for both options. You can select multiple campaigns at a single time in each option. Amount and Label details will be utilized from the stated campaigns.

Cart Donation

↑ Back to top

You can enable or disable the cart donation by using the toggle switch.
Multiple Campaigns can be selected at a time.

Checkout Donation

↑ Back to top

You can enable or disable the Checkout Donation by using the switch toggle.
Multiple campaigns can be selected at a time.

Frontend Screenshots

Shortcode support

↑ Back to top

Copy the ShortCode from any campaign and place it on any page to display the donation form

How to add a shortcode on a new page?

Go to ‘Pages’
Click on ‘Add New’
Give your page a new ‘Title’ and add a WP Donation Block.
Select Campaign from the list.
Paste the shortcode on the block’s field and click on publish.

Front-end screenshots

Gutenberg Block support

↑ Back to top

Use the Gutenberg Block support to add and display your campaigns on any page or post.

Go to Pages > Add New
Select WP Donation Block from the block list
Select Campaign from the list.
Click Publish.

Orders tab

↑ Back to top

The Admin would go to the Admin Dashboard → WooCommerce → Orders.
Click on the “Orders” tab.
When we’re on the Edit Order page, all the details are available on this page.

Donations Tab

↑ Back to top

Navigate to WordPress Admin Dashboard → Pages → Add New.

A new page would open.
Add the Title of the page.

Click on the sign ➕ to add blocks.
Select the WC Donation Tabs element.

Once done, select any two campaigns in the Select Frist Campaign and Select Second Campaign option.

Now enter the titles of both campaigns in the Enter First Tab title and Enter Second Tab title option.

Once done, click on the Publish button.

Front-End Impact

Go to the website.
Go to the WC Donation Tabs page.
Both tabs will appear on the WC Donation Tabs page.

Select the campaign by clicking on the tabs available.

NOTE: If the Administrator does not enter the titles of both campaigns in the Enter First Tab title and Enter Second Tab title option.

The campaigns will not appear on the WC Donation Tabs page.

Donation API

↑ Back to top

Go to the bottom of the page and enable the WC Donation API toggle button.

Once done, click on the Save Changes button.

Synchronize Campaign Data

↑ Back to top

At the bottom of the page, a Synchronize Campaign Data option is present.

Click on the Synchronize button.
Clicking on this button will ensure that your donation order data is correctly synchronized. Use this option if you encounter incorrect campaign data.

MetaData functionality

↑ Back to top

Go to WooCommerce> Orders Tab
Metadata of previous orders are listed here
By clicking on any order, a pop-up message will appear that shows the details of particular order along with its respective ‘Donation Campaign.’

Credit card processing fee settings

↑ Back to top

You can charge credit card processing fees from your user’s donation payment by asking them promptly.

How to set up credit card processing fee feature?

Go to Admin Dashboard → WC Donation → General Settings.
Credit Card Processing Fees will be at the bottom of the page.
Toggle the “Credit Card Processing Fees” option to enable it.
Select the campaigns you want to charge the processing fee in the “Select Campaigns” option.

These two options are available in the Select Fees Type dropdown.

Percentage

Select the percentage type in the given dropdown menu.
The amount can be manually added.
Click on the Save Changes button

Front-end impact

The user will check the Credit Card Processing Fees option and read the text displayed in the Enter Processing Fees Text option beside the checkbox on the front-end.
Based on the user’s donation amount, a certain percentage of their donated amount would be charged additionally.

Fixed

Select the fixed type in the given dropdown menu.
The amount can be manually added.
Click on the Save Changes button

Front-end impact

Recurring Donation

↑ Back to top

Setting up recurring donations

↑ Back to top

Go to Recurring Donation Menu

To use Recurring Donation, you need to install and activate the WooCommerce Subscriptions plugin. Once the WooCommerce Subscriptions plugin is activated, the system will allow you to enable the Recurring Donations from campaign settings.
Open the dropdown option in ‘Display Type.’ Either you will disable it or Activate it by ‘Enable’ it from the dropdown selection option.

Display type

You can choose to disable the display of this option or enable it on the admin’s choice. Interval will be set from here. Admins can set the frequency as per their nature of business.

How to set the intervals for recurring donations?

There are different types of pre-defined intervals to choose from. The first dropdown list is to set the frequency of the recurring donation interval. Here are the following options that you can choose from:

‘Every’ (between 1 and 6)
‘Day/Week/Month/Year’
Till (length). If you select days, the maximum option that can be set is 90 days after the first purchase

The second and third dropdown list is to select the length of the interval:

“Week” – the maximum option that can be set is 52 weeks, after the first purchase
“Month” – the maximum option that can be set is 24 months after the first purchase
“Year” – the maximum option that can be set is 5 years after the first purchase.

Let’s suppose:

The admin has selected the frequency option to ‘Every’ and ‘Month’ followed by the option of ’5 months’.

In this scenario, the recurring donation will be placed in the customer’s name every month for the next five months after the purchase. After the time limit, the recurring donation interval will be ended.

Note: To receive recurring donations, you should connect a payment gateway like ‘PayPal’ or ‘Stripe.’

Front-end Screenshots

The admin will be able to see the details of each campaign in the ‘WooCommerce Subscription’ tab.

User-defined recurring donations

↑ Back to top

This will allow the user to select their own defined length of recurring donation payment(s). If they don’t want to opt for the recurring donation option, they can uncheck the option.

NOTE: To activate the Recurring Donation option, you need to install and activate the WooCommerce Subscriptions plugin.

How to set up a user-defined recurring donation option?

Go to Admin Dashboard → WC Donation → All Campaigns.
All the donation campaigns are present on this page.
Click on the Edit ( 🖉 ) sign in the Actions column.
Go to the Recurring Donations section.
In this section, go to the Display Type option,
1. Enable – Admins’ Choice
2. Enable – User’s Choice
Choose Enable – User’s Choice from the dropdown menu.
You can also set custom text for recurring donations in the Recurring Text option. The default text is: Enter Donation Recurring.
Click on the Update button to save changes.