Raise
Free donation plugin for Wordpress. Supports one-time and monthly payments, confirmation and notification-emails, webhooks, a newsletter checkbox, a tax deductibility checkbox, multiple purposes, custom colors, Javascript events, single form inheritance, sandbox mode, centralized settings and translations (German, French, Russian).
Accept donations via Stripe, PayPal, GoCardless, BitPay, Coinbase, Skrill or bank transfers.
Prerequisites
- PHP ≥5.6.3
- WordPress ≥4.8
Installation
For a manual installation, download this repository and follow the instructions for a manual install.
To receive updates, install Github Updater.
To embed the form in a page, use the shortcode [raise_form form="<form_name>" live="<true or false>"].
If the live parameter is set to false, the plugin will use the sandbox settings for each payment provider.
Configuration
Configuration is done in JSON. The plugin comes with a visual JSON editor.
Initially, the default settings are loaded from _parameters.js.php.dist. Once a modified version is saved, the plugin fetches settings from the database.
Full example
<pre>
{
"organization": {
"en": "Effective Altruism Foundation",
"de": "Stiftung für Effektiven Altruismus"
},
"forms": {
"my_form": {
"<a href="#inheritance">inherits</a>": "parent_form",
"amount": {
"button": [
10,
30
],
"button_monthly": [
5,
10
],
"custom": true,
"frequency": {
"default": "once"
},
"columns": 3, # use 1,2,3,4,6,12 for optiomal display
"currency": {
"eur": {
"pattern": "%amount% €",
"country_flag": "eu",
"minimum": 4.5
},
"usd": {
"pattern": "$%amount%",
"country_flag": "us",
"minimum": 5,
"minimum_monthly": 3,
"below_minimum_message": "Please donate more than %minimum_amount%."
}
},
"helper_texts": {
"average_amount_once": {
"en": "The average one-time donation is $84.",
"de": "Die durschnittliche Einmalspende beträgt €84."
},
"average_amount_monthly": {
"en": "The average monthly donation is $50.",
"de": "Die durschnittliche monatliche Spende beträgt €50."
},
"monthly_donation_teaser": {
"en": "popular",
"de": "beliebt"
}
}
},
"payment": {
"order": {
"purpose_first": false,
"checkboxes_last": false
},
"purpose": {
"my_org": "My organisation" # If first element has an empty key, no purpose is selected by default
},
"<a href="#payment-methods">provider</a>": {
"stripe": {
"account": "DE",
"live": {
"secret_key": "sk_live_mykey",
"public_key": "pk_live_mykey"
},
"sandbox": {
"secret_key": "sk_test_mykey",
"public_key": "pk_test_mykey"
}
},
"<a href="#bank-transfer">banktransfer</a>": [
{
"value": {
"account": "UK",
"details": {
"Beneficiary": "My Organization UK",
"Account number": 1234567,
"Sort code": "12-34-56",
"IBAN": "GB50 1234 1234 1234 1234 A",
"BIC/SWIFT": "LOYDGB2L",
"Bank": "Lloyds Bank Plc",
"Purpose": "%reference_number%"
},
"tooltip": {
"en": "No fees",
"de": "Gebührenfrei"
}
},
"if": {
"and": [
{
"===": [
{
"var": "country_code"
},
"GB"
]
},
{
"!!": [
{
"var": "tax_receipt"
}
]
}
]
}
},
{
"value": {
"account": "US",
"details": {
"Beneficiary": "My Organization USA",
"Account number": 123456789,
"Routing number": 123456789,
"Bank": "JPMorgan Chase Bank, 188 Spear St, Ste 190, San Francisco, CA 94105, United States",
"Purpose": "%reference_number%"
},
"tooltip": {
"en": "No fees",
"de": "Gebührenfrei"
}
},
"if": {
"===": [
{
"var": "country_code"
},
"US"
]
}
},
{
"value": {
"account": "DE",
"details": {
"Beneficiary": "My Organization Germany",
"IBAN CHF": "DE67 1234 1234 1234 1234 N",
"IBAN EUR": "DE20 1234 1234 1234 1234 D",
"IBAN USD": "DE79 1234 1234 1234 1234 F",
"IBAN GBP": "DE08 1234 1234 1234 1234 T",
"BIC/SWIFT": "DEUTINBBPBC",
"Bank": "Deutsche Bank",
"Purpose": "%reference_number%"
},
"tooltip": {
"en": "Banks may charge a fee for international transactions.",
"de": "Banken können Gebühren auf internationale Überweisungen erheben."
}
},
"if": true
}
]
},
"account_description": {
"DE": "Your donation will be received by Your Charity Germany, a German charitable association which collects donations on our behalf.",
"US": "Your donation will be received by Your Charity US, an American charitable association which collects donations on our behalf.",
"UK": "Your donation will be received directly by Your Charity UK, a registered charity in England and Wales (charity no. 123)."
},
"<a href="#reference-numbers">reference_number_prefix</a>": {
"my_org": "ORG",
"default": "XRG"
},
"<a href="#integration-with-fundraising-plugin">fundraiser</a>": 145,
"extra_fields": {
"country": false, # move country dropdown up to required fields
"anonymous": false, # add anonynmous checkbox
"comment": false # add comment textarea
},
"helper_texts": {
"donor_extra_info_start": {
"en": "To issue a tax receipt we need your address.",
"de": "Um Ihnen eine Spendenbescheinigung auszustellen, benötigen wir Ihre Adresse."
}
},
"country": {
"initial": "ipstack", # Initial value for country dropdown, e.g. "US". Default is "ipstack"
"ipstack_access_key": "abc1234", # Necessary if initial is "ipstack". See ipstack.com
"ipstack_fallback": "US" # Fallback country if ipstack API is not available
},
"recaptcha": {
"site_key": "my_recaptcha_site_key",
"secret_key": "my_secret_key"
},
"labels": {
"purpose": {
"en": "Charity",
"de": "Organisation"
}
},
"form_elements": {
"tip": [
{
"value": {
"label": {
"en": "Add 5% tip",
"de": "5% Trinkgeld hinzufügen"
},
"tip_percentage": 5,
"checked": true
},
"if": {
"in": [
{
"var": "purpose"
},
[
"purpose_1",
"purpose_2"
]
]
}
}
],
"gift_aid": [
{
"value": {
"label": {
"en": "I want to claim Gift Aid on this donation (and recurring instances of it).",
"de": "Ich möchte für diese Spende (und für wiederkehrende Spenden) Gift Aid beantragen."
}
},
"if": {
"in": [
{
"var": "country_code"
},
[
"GB"
]
]
}
}
],
"tax_receipt": [
{
"info": "DE: tax-deductible", // Label
"value": {
"label": {
"en": "I need a tax receipt for Germany.",
"de": "Ich benötige eine Steuerbescheinigung für Deutschland."
},
"checkbox_hidden": false,
},
"if": {
"===": [
{
"var": "country_code"
},
"DE"
]
}
},
{
"info": "not supported",
"value": {
"label": {
"en": "We currently don't offer tax receipts for %country%.",
"de": "Wir können zurzeit leider keine St
