Donation For WooCommerce

Video Tutorial ↑ Back to top

Setup and Configuration ↑ Back to top

How To set up Donation For WooCommerce:

  • Download the .zip file from your WooCommerce account.
  • Go to WordPress Admin > Plugins > Add New and Upload Plugin.
  • Attach the downloaded file at ‘Choose File’ option
  • Click on ‘Install Now’
  • Now ‘Activate’ it

Getting Started ↑ Back to top

Campaign Settings:

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

Front-end View

  • Donation can be set as ‘Custom Value’ where admin can enter any amount between the minimum and maximum bracket

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

  • Click on ‘Add level’ to show multiple amounts in donation dropdown

  • Added levels can be deleted by clicking on trash icon at top right of each level

Multiple predefined levels will be shown as:

Form Settings ↑ Back to top

  • Go to Form Settings Menu

Admin can set the display settings from this option.

  • 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 currency sign

  • Donation Label Field

  • Donation button label

  • Donation Button Text Color

  • Donation button color

Recurring Donation ↑ Back to top

Go to Recurring Donation Menu

  • To use Recurring Donation, you need to install and activate WooCommerce Subscriptions plugin, once the WooCommerce Subscriptions plugin is activated 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 dropdown selection option.

Disable Option

Enable Option

  • Interval will be set from here. Admins can set the frequency as per their nature of business.

‘Every’ (1 to 6 of interval)
‘Day/Week/Month/Year’ (to select anyone frequency)
Till (length) ‘For days it will be 90 days’, ‘For week it will be 52 weeks’, ‘For Month it will be 24 months’ and ‘For year it will be 5 years’ after first purchase. Let’s suppose if admin has set the frequency as ‘Every’ then ‘Month’ so no of months will get displayed and admin has selected ’5 months’ so after executing the purchase, donation will keep deducted with an interval of ‘Every month till 5 months’ then it will automatically stop the deduction of donated amount.
Once your customer has purchased a product with recurring donation so the donation will automatically keep deducted according to mentioned frequency.

Note: For recurring donation, payment gateway must be activated like ‘PayPal’ or ‘Stripe’

Front-end Impact

  • While if the donation was recurring so admin can see the details of each campaign in ‘WooCommerce Subscription’ tab

User Define Recurring ↑ Back to top

This will allow the user to select their own defined length of recurring donation as well as if they don’t want a recurring donation they can uncheck the option on the front-end that will treat the donation as a one-time donation only.

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

BACK-END CONFIGURATION

  • 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. However, if you don’t want to set any text then by default Enter Donation Recurring would appear.

  • Click on the Update button to save changes.

FRONT-END IMPACT

  • The user will visit the website and select the donation.
  • The user will select the Donation level.
  • Checkmark the checkbox to make it a recurring payment.
  • Set the Intervals for the recurring payment cycles.

NOTE:

  • Every (1 to 6 interval)
  • Day/Week/Month/Year’ (to select anyone frequency)
  • Till (length) For days it will be 90 days, For a week it will be 52 weeks, For Month it will be 24 months and For a year it will be 5 years after first purchase. Let’s suppose if the user has set the frequency as ‘Every’ then ‘Month’ so no of months will get displayed and the user has selected 5 months so after executing the purchase, a donation will keep deducted with CONFIGURATION. Every month till 5 months then it will automatically stop the deduction of the donated amount.
  • Once your customer has purchased a product with a recurring donation so the donation will automatically keep deducted according to mentioned frequency.

  • Once done, click on the Donate button.

NOTE: Payment gateways like PayPal, Stripe, etc should be activated when doing the recurring payments. 

  • The user would be redirected to the Checkout page.
  • The user will enter the required credentials.
  • The user can view the recurring payments cycles in the Recurring totals section.

  • The user will click on the Sign up now button.

SUBSCRIPTIONS TAB

  • The Admin would go to the Admin Dashboard WooCommerce Subscriptions.

  • Click on the subscription number in the Subscription column.
  • In the image below, #400 is the subscription number.

  • Click on the subscriptions.
  • When we’re on the Edit Subscription page, on the right side of the page there is a Schedule section that will show the details of the Next Payment, End Date, and the Time zone.

ORDERS TAB

  • The Admin would go to the Admin Dashboard WooCommerce Orders.

  • Click on the Order.

  • When we’re on the Edit Order page, all the details are available on this page.

Donation Product ↑ Back to top

Image can be set for each donation type which will be displayed on cart

Display Donation Product on Page
Enable both the options if you want to show donations as a ‘Product’ on ‘Shop’ Page and ‘Single Product Page’

Note: If single product page is disabled then product shop page will not work.

Front-end of Single Product Page

Front-end of Donation Product on Shop Page

Shortcode ↑ Back to top

Copy the ShortCode from any campaign and place it at any page to show the donation form

Page Setting

  • Go to ‘Pages’
  • Click on ‘Add New’
  • Give ‘Title’ and ‘Paste Shortcode’

Front-end

  • Details of that specific campaign will be displayed whose shortcode has been posted

Publish the page

Campaign List ↑ Back to top

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

  • In campaign list admin can see total no of donation against each campaign along with its total amount

General Settings ↑ Back to top

Go to General Settings

  • Enable ‘Cart and Checkout donation’ option so that donation fields will appear at both places
  • Select ‘Campaign’ from the dropdown list for both options. Amount and Label details will be utilized from stated campaigns

Round off Donation ↑ Back to top

  • Next option is to set ‘Roundoff’ Donation. In this feature, users can round off their final payment values that appears in decimal. If the price of the product is in rational value and you are checking out for finalizing the transaction so a pop will appear with the suggested amount to donate for any listed campaign. Users can skip this process if they don’t want to round off the value
  • For that first you have to mark ‘Enable’ this option
  • Select campaign for ‘Roundoff Donation’. Roundoff campaign must be different from checkout or cart donation campaigns, otherwise transaction will not get executed.
  • Type the text that you want to display on roundoff popup
  • Enter cancel button text
  • Roundoff Multiplier: let’s suppose you are purchasing a product that has a value of $ 25 and then you are donating an amount of $ 2.5 for any listed or specified donation product then this transaction will take you to the round off value option in which your final payment can be settled as $ 28.

Round off Multiplier ↑ Back to top

Round off Multiplier (number should be greater than 0. If empty or other value than integer. Then it will be considered as 1)
How it works: suppose if you input a value as 8, then your cart total will be reached to the nearest number which will be divisible by 8.
Cart Total: 27.35

Round off multiplier : 8
Now after 27 your next number which will be divisible by 8 is 32

So, 32 – 27.35 = 4.65
Your donation will be 4.65.

**Note Round off will work only if your cart total is in decimal. if there are whole numbers in the cart and checkout page then round off functionality will ignore the whole numbers.

Front-end

Donation Goal Amount Based ↑ Back to top

In this feature, the donation goal is based on a donation fixed amount. Admin would be able to set Donation Goal amount from Campaign settings, after set donation goal amount from backend, donation goal will be displayed on front-end below the donation box along with goal progress bar admin also set progress bar color. Once the donation amount reaches the desired amount then the goal will be achieved.

Steps to set Donation Goal amount:

  1. Go to WC-Donation > All Campaigns then edit or create a campaign.
  2. Go to the Donation Goal tab.
  3. Enable Donation Goal to display on Front-End.
  4. Select Goal Type Amount Raised.

Front-End View

**Note: Donation Goal feature is not compatible with Round Off donation, to use Round Off donation you need to disable Donation Goal.

Donation Goal Percentage Based ↑ Back to top

In this feature, the donation goal is based on a fixed amount but it will show the donated amount in percentage below the donation box.

Admin would be able to set Donation Goal amount from Campaign settings. Once the donation amount reaches the desired amount, the goal will be achieved and also show the goal progress bar in Percentage (%).

Steps to set Donation Goal Percentage:

  1. Go to WC-Donation > All Campaigns then edit or create a campaign
  2. Go to the Donation Goal tab
  3. Enable Donation Goal to display on Front-End
  4. Select Goal Type Percentage Raised

Front-End View

Donation Goal, Number of Donations Based ↑ Back to top

In the number of donations goal, donations count on the behalf of the number of donations donated by donors as well the goal progress bar will increase in every donation. Let’s say the admin sets No. of Donations: 5, so whenever a donor donates the donations 5 times, the donation goal will be achieved.

Steps to set Number of Donations Goal:

  1. Go to WC-Donation > All Campaigns then edit or create a campaign
  2. Go to the Donation Goal tab
  3. Enable Donation Goal to display on Front-End
  4. Select Goal Type No. of Donations
  5. Enter No. of Donations

Front-End View

Donation Goal by Number of Days ↑ Back to top

In the number of Days donation goal, the goal will show until the selected dates chosen by the admin, Admin would be able to select the last date of Goal from Campaign settings once the date expires Goal will be achieved.

Steps to set Number of Days Goal:

  1. Go to WC-Donation > All Campaigns then edit or create a campaign
  2. Go to the Donation Goal tab
  3. Enable Donation Goal to display on Front-End
  4. Select Goal Type Number of Days
  5. Select or enter Date

Front-End View

Display Unique Donor count ↑ Back to top

Display unique donor counts the number of unique donors in numbers, it counts the numbers of donations donated by different username if someone donates with the same username multiple times it will not count the numbers of donors, donor count numbers will remain the same.

Steps to Enable Display Donor count: ↑ Back to top

  1. Go to WC-Donation > All Campaigns then edit or create a campaign
  2. Go to the Donation Goal tab
  3. Scroll down & Enable the Display Donor count option

Front-End View

Close Donation Form with Message ↑ Back to top

In this feature when the donation goal will be achieved, the donation form(donation box) automatically closes and displays the message, Admin would be able to set a custom message to show the customers.

Steps to Enable Form with Message:

  1. Go to WC-Donation > All Campaigns then edit or create a campaign
  2. Go to the Donation Goal tab
  3. Scroll down & Enable the Close Form checkbox
  4. Enter custom Message to display when goal achieved

Front-End View

 

Donation Cause ↑ Back to top

  • Donation causes refer to the principles a charity stands for. We have a list of Charities in a dropdown from which to choose after selecting the donation amount. In other words, we would first select the charity amount and then we would have an option to select from a list of charities in a dropdown.

BACK-END CONFIGURATION

  • 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 Donation Cause section.
  • Select the Enable radio button. 
  • Enter the Cause Name and Cause Description.
  • Select the Cause Thumbnail.
  • Once done, click on the Save button to save the donation cause.

  • Click on the Edit ( 🖉 ) sign to edit the donation cause.

  • Click on the Update button.

FRONT-END IMPACT

  • The Donation Cause will be visible to the user on the donation page.

  • The selected Donation Cause will also be highlighted on the Cart page.

 

Count Of Donation ↑ Back to top

  • Only orders with status (Processing and completed) will be counted as a total donation if there is any donation product in them. The total donation, Total Amount & Total Donor deducted on canceled & on-hold orders.
  • In the campaign list, the admin can see the total no. of donations against each campaign along with its total amount.

ON COMPLETE

  • The Admin would go to the Admin Dashboard WooCommerce Orders.

  • Orders with the status Completed will be counted as a total donation if there is any donation product in them.

ON PROCESSING

  • The Admin would go to the Admin Dashboard WooCommerce Orders.

  • Orders with the status Processing will be counted as a total donation if there is any donation product in them.

FRONT-END IMPACT – ON COMPLETE AND ON PROCESSING

ON HOLD

  • The Admin would go to the Admin Dashboard WooCommerce Orders.

  • Orders with the status On Hold will reduce the donation goal.

ON CANCELLED

  • The Admin would go to the Admin Dashboard WooCommerce Orders.

  • Orders with the status on Cancelled will reduce the donation goal.

FRONT-END IMPACT – ON HOLD AND ON CANCELLED

Widget Settings ↑ Back to top

  • Donation form can be displayed in widget
  • For that go to ‘Appearance Tab’
  • Then ‘Widgets’
  • Select ‘WC Donation’ dropdown and set the place where you want to place the widget form
  • Click on ‘Add Widget’

Note: Widget will fetch all the campaign details from backend settings that had configured by admin against each campaign

  • Finally go to ‘Sidebar Menu’
  • Give ‘Widget Title’
  • Select ‘Campaign’ from dropdown
  • Save it

Front-end

Front-end Functionality ↑ Back to top

  • Customer will go to ‘Shop’ page
  • Add any product in ‘Cart’
  • Customer can donate from cart

  • Customer can donate on checkout page

  • Upon proceeding towards checkout, If the amount is in decimal so a pop up will appear with automatic adjusted value to roundoff overall sum. Either customer can donate for it or can skip it.

  • Thus, order has been placed with roundoff amount

  • Donation can be placed from widget at front-end

  • Donation can be made from page

MetaData ↑ Back to top

  • Go to WooCommerce>Orders Tab
  • All meta data of previous orders will be listed

  • By clicking on any order, a pop up will appear that shows the details of particular order along with the ‘Donation Campaign’ in which donation has been made

Gutenberg Block support ↑ Back to top

Now you do not need to copy the campaign shortcode and paste it into the page, we have added the Gutenberg Block support once you created the new campaign it will appear in Gutenberg Block popup.

  1. Go to Pages –> Add New
  2. Select WP Donation Block from the block list
  3. Select Campaign from the list.
  4. Click Publish.

 

Credit Card Processing Fee ↑ Back to top

  • Processing fees charged on credit card payments would be paid by the user donating. This feature allows the admin to ask the end-user for the processing fees charged on credit card processing against the donation being received so that the user’s donation is sent to the admin and the processing fee is not deducted from the donation amount.

BACK-END CONFIGURATION:

  • 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 to Enable it.
  • Select the campaigns in which the Admin wants to charge this fee in the Select Campaigns option.
  • Enter the processing fees which will be charged in the Enter Percentage option. This will be in terms of percentage.
  • Enter the text which will be displayed for this fee in Enter Processing Fees Text option.

 

  • Click on the Save Changes button.

FRONT-END IMPACT

  • The user will checkmark the Credit Card Processing Fees option and text set in the Enter Processing Fees Text option would appear beside the checkbox on the front-end.
  • Based on the amount of donation, a certain percentage of them would be charged additionally which is set in the Enter Percentage option in the back-end configuration and will be added to the total amount.

 

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top