Setting up a New Donation Campaign
Adding Multiple Donation Campaigns
Go to WooCommerce > Donations > Campaigns to create a new donation campaign. You can view a complete list of donation campaigns in a log.
Click on “Add New Campaign” and configure the following options to get started:
Adding a New Campaign:
Campaign Settings:
Campaign Type: Choose a campaign type from the following options:
- Create a Donation Product
- Add as Fee in Cart
If you select “Create a Donation Product” as a campaign type, then provide the following details:
Product Data: Specify whether the donation product should be virtual, downloadable, or both:
- Virtual
- Downloadable
Donation Amount Levels: Define specific donation amounts to display on the frontend for customer selection.
Click on “Add Option(s)”, and specify the following:
- Amount in Number
- Amount in Words
Open Amount Field: Select the “Open Amount Field” checkbox to allow customers to manually enter donation amounts.
Donation Amount Limitations: Set minimum and maximum donation amounts. If no goal is set, the default maximum value is $1000.
- Any Amount Less Then Goal Amount
- Custom Range
If you select “Add as Fee in Cart” as a campaign type, then provide the following details:
Fee Type: Select from the following:
- Credit Card Fee
- Round Off Fee
- Normal Fee
Select Fee: Select the fee as:
- Percentage
- Fixed Amount
Enter Fix Amount Of Fee: Specify the fee amount.
Fee Message: Enter a message related to the fee.
Location Settings:
Specify where the campaign should appear:
Checkout Location: Allow the campaign to display on the checkout page.
Cart Location: Allow the campaign to display on the cart page.
Campaign Goal:
Campaign Type: Choose the type of campaign goal:
- Campaign with Goal
- Campaign with No Goal Amount
If setting a goal:
Goal Amount: Define the target amount. If empty, the default goal value will be $1000.
Progress Bar Display: Enable the progress bar and select its type:
- None
- Amount Donated
- Percentage of Target
- Number of Donations
End Donation: Select when to close the donation campaign:
- Amount Raised: Close donation when the goal amount is raised.
- Number Of Donations: Close donation when X number of donations are made.
- Number Of Days: Close donation after X days.
- Date: Close donation on a specific date.
- Manual: The admin will manually close the donation using the “Close Donation” checkbox below.
Close Campaign: If any of the target conditions are met, this checkbox will be automatically checked. However, the admin can manually check this box to close the donation campaign.
Close Donation Message: Enter the closing message for the campaign.
Donation Cause:
Provide information about the cause associated with the campaign:
Cause Name: Enter the name of the cause.
Cause Description: Describe the cause.
Cause Thumbnail: Upload an image representing the cause.
After providing the cause details, click on “Add Cause” to finalize.
Post Attributes:
Order: Specify the order of this donation campaign.
Viewing Donation Campaign Details
Go to WooCommerce > Donations > Dashboard. From the dashboard, you can get detailed insights into all donation campaigns.
From the dashboard, you can see the Total Donation Amount at the top. The dashboard provides a donation graph that can be filtered based on donation names and dates. Additionally, you can view the following details of the campaign in a grid:
- Campaign Name
- Target
- Recurring
- Closing Date
Customizing the Donation Campaign on Your Store
Go to WooCommerce > Settings > Donation. Here, you can configure the general settings and customize the donation campaign on your store.
Disabling Any Table Column
General Settings:
Disable Specific Table Column: Checkmark to disable any column of the table format:
- Disable Thumbnail
- Disable Description
- Disable Causes
Customizing Cart to Add Donation Campaign
Cart Settings:
Choose Location: Select where to display campaigns:
- After Cart Table
- Before Cart Table
- After Cart
Display Type (Campaigns): Choose how to display campaigns on the cart page:
- On-Page
- On Pop Up
Pop Up Heading: Add the heading of the pop-up screen.
Display Format (Popup): Choose how to display the campaign:
- Auto Show
- Show Button
Show Popup Button Text: Add text for the button displayed on the page to open the popup.
Choose Format: Select the campaign display format:
- Table
- Flex
- List
Personalizing the Checkout Page to Display the Campaign
Checkout Settings:
Choose Location: Decide where to show campaigns:
- Review Order Before Payment
- Review Order After Payment
Display Type (Campaigns): Choose how to display campaigns on the checkout page:
- On-Page
- On Pop Up
Pop Up Heading: Add the heading of the pop-up screen.
Display Format (Popup): Choose how to display the campaign:
- Auto Show
- Show Button
Show Popup Button Text: Add text for the button displayed on the page to open the popup.
Choose Format: Choose the campaign display format:
- Table
- Flex
- List
Styling the Progress Bar and Donation Button
Styling:
Progress Bar Color: Choose the color of the donation bar.
Bar Font Color: Choose the font color of the progress bar.
Donate Button Text: Specify the text for the Donate button.
Donate Button Color: Select the background color of the Donate button.
Donate Button Font Color: Choose the font color of the Donate button.
Open Popup Button Color: Set the color of the button displayed on the page to open the popup for donation.
Open Popup Button Font Color: Specify the font color of the button to open the donation popup.
Adding a Shortcode to Display Campaigns
Shortcode: Utilize the shortcode below to display donation options anywhere on your store:
[af_donation_campaigns ids = display_type = display_format = ]
| Attributes | Description |
| Ids display_type display_format | Specify the campaign ID(s) you want to display.Choose how to display the campaign(s) (page, auto_popup, popup_button).Select the display format (table, flex, list). |
Example Usage:
[af_donation_campaigns ids=”11,12,20″ display_type=”popup” display_format=”list”]
Setting a Custom Success Message to Notify Customers
Customize the notification message to be displayed to customers upon successful donation.
Notification Message: Enter the desired notification message with {campaign_name} placeholder to dynamically insert the campaign name.
