This guide walks you through setting up a donation form using the LevCharity plugin. You’ll learn where to find the form builder, what each setting controls, and how to customize the form for your needs.
Getting Started #
After the LevCharity plugin is installed and activated, you’ll see a new menu item called Donations in the WordPress dashboard.
To create a new donation form: #
- Go to Donations > Add New
- Choose the Donations type (do not select Team or P2P)
- Fill in the form fields described below
- Click Publish when you’re ready to make it live
Section: Main #
Controls the internal title, public title, and message shown on the form.
| Field Name | Label | Type | Description |
|---|---|---|---|
title | Title (for admin use only) | text | Internal-only form title for admins. |
hide_donation_form_heading | Hide Donation Form Heading | toggle | Hides the title/subtitle of the donation form. |
donation_form_title | Frontend Form Title | text | Public-facing heading on the donation form. |
form_card_content | Frontend Form Subtitle | text | Short subheading under the title. |
donation_product_old_id | — | hidden | Tracks previous product ID if migrated. |
Section: Max / Min Donation #
Define the minimum and maximum donation amounts a user can give.
| Field Name | Label | Type | Description |
|---|---|---|---|
min_donation | Min Donation | number | Minimum amount a user can donate. |
max_donation | Max Donation | number | Maximum donation allowed. |
Section: Additional Fee #
Enable optional processing or admin fees as a part of the donation process.
| Field Name | Label | Type | Description |
|---|---|---|---|
fee_label | Fees label | text | Title for the extra fee section. |
additional_fees | Donation Fee | repeater | List of extra fee options. |
additional_fees_fee_name | Fee option name | text | Name of the fee. |
additional_fees_fee_type | Fee option type | select | Fixed or percentage fee. |
additional_fees_price | Fee option amount | text | Value or percent of the fee. |
Section: Form Style #
Select the overall layout and style of the donation form.
| Field Name | Label | Type | Description |
|---|---|---|---|
show_variations | Form Style | radio | Choose standard, variations, or sponsorship layout. |
Section: Currency Settings #
Manage currency behavior for the donation form.
| Field Name | Label | Type | Description |
|---|---|---|---|
hide_currency_switcher | Hide currency switcher | toggle | Disables ability to choose other currencies. |
base_currency | Default currency | select | Sets base currency for donations. |
Section: Donation Frequency Options #
Set donation type options users can select from.
| Field Name | Label | Type | Description |
|---|---|---|---|
form_frequency_option | Donation Frequency | radio | Choose between one-time, monthly, or installment options. |
Section: Amounts #
Customize the amount input, including predefined values and optional settings.
| Field Name | Label | Type | Description |
|---|---|---|---|
hide_predefined_amounts | Enable custom predefined amounts | toggle | Enable use of predefined amounts. |
predefined_title | Predefined Title | text | Custom title shown for predefined amounts. |
predefined_amounts | Predefined Amounts | repeater | List of amounts users can select. |
predefined_amounts_value | Predefined Value | number | Value for each preset amount. |
hide_other_amount | Hide Other Amount | checkbox | Removes “other” field for freeform donation. |
Section: Checkout Message #
Add custom content before and after the form.
| Field Name | Label | Type | Description |
|---|---|---|---|
donation_custom_amount_text | Checkout Header Text | editor | Header shown on confirmation. |
custom_code_editor_campaign | Checkout Custom Text | editor | Custom message shown after donation. |
Section: Show/Hide #
Manage optional features on the form interface.
| Field Name | Label | Type | Description |
|---|---|---|---|
donation_comment_box | Show a comment box | toggle | Enable/disable donor message input. |
hide_ccfee | Hide credit card fee | toggle | Hides the extra fee breakdown. |
Section: Sponsorships (if equipment module enabled) #
Manage sponsorship product integration with the form.
| Field Name | Label | Type | Description |
|---|---|---|---|
sponsorships_list | Sponsorship List | toggle list | Cross-sell options with grid view. |
equipments_donation_frequency | Sponsorship Subscription Frequency | toggle list | Per-sponsorship subscription option. |
show_sticky_bar | Show Sticky Bar | toggle | Enables sticky donation bar. |
add_donation_amount_with_equipments | Add donation amount with sponsorships | toggle | Combines sponsorships + donation. |
separated_sponsorship_prices | Show as ecommerce layout | toggle | Display per-sponsorship pricing. |
Enable_quantity_subscription | Enable quantities for subscriptions | toggle | Allow donors to choose quantity. |
post_title | Sponsorship Title | text | Title used for grouped sponsorships. |
post_content | Sponsorship Description | editor | Description of sponsorships. |
Section: Variations #
Add variation-based donation options, like t-shirt sizes or item bundles.
| Field Name | Label | Type | Description |
|---|---|---|---|
variations_label | Variations label | text | Heading above donation options. |
multiple_variations | Activate multiple select | toggle | Allow selecting multiple items. |
variation_items | Donation Variations | repeater | List of custom variation items. |
name | Title | text | Name of variation. |
price | Price | number | Optional fixed price. |
qty | Enable Quantity | toggle | Quantity input per variation. |
thumbnail_id | Featured Image | media | Image shown for variation. |
category | Category | select | Optional category grouping. |
Section: Confirmation Popup #
Configure the type of pop-up shown after a donation is submitted.
| Field Name | Label | Type | Description |
|---|---|---|---|
confirmation_popup_title | Popup Title | text | Title text for confirmation modal. |
confirmation_popup_image | Popup Image | media | Optional image shown on confirmation. |
confirmation_popup_content | Popup Content | editor | Rich text confirmation message. |
confirmation_agree_label | Agree Checkbox Label | text | Text for agree option. |
confirmation_disagree_label | Disagree Checkbox Label | text | Text for disagree option. |
Section: Tribute Fields #
Configure optional tribute fields for dedication-based giving.
| Field Name | Label | Type | Description |
|---|---|---|---|
hide_tribute_type | Hide tribute type | toggle | Hide/show type field. |
hide_tribute_name | Hide tribute name | toggle | Hide/show tributee’s name. |
hide_tribute_certificate_name | Hide tribute certificate name | toggle | Hide/show certificate name. |
hide_tribute_certificate_email | Hide tribute certificate email | toggle | Hide/show certificate recipient. |
hide_tribute_certificate_message | Hide tribute certificate message | toggle | Hide/show message field. |
