Donorbox
Donorbox is a fundraising platform that enables organisations and creators to collect online donations through embeddable forms and hosted donation pages.
Key features include:
- Customisable donation forms
- Recurring and one-time donation options
- Multiple payment methods including Apple Pay and Venmo
- Campaign fundraising pages
- Donor management and reporting tools
Donorbox integrates with ShopWired by adding a tracking to the ShopWired theme or by embedding a donation form into website pages so you can collect donations directly from your website.
Account creation
Account creation
Create an account at Donorbox.
Once configured, Donorbox will allow you to create donation campaigns and generate the embed code required to add donation forms or pop-up widgets to your website.
Theme installation
Theme installation
Donorbox provides a pop-up widget script similar to the example shown below:
<script src="https://donorbox.org/install-popup-button.js" defer></script>
<a class="dbox-donation-button" href="https://donorbox.org/example">Donate</a>
The script shown above is provided as an example only. You must copy the exact script provided in your own account, as the script and any ID values will be unique to your website.
Adding the script to your theme will display the donation pop-up across your website.
- Navigate to Website > Themes
- Select the
code editoroption for the theme you want to edit - Open the
master.twigfile - Add the script just before the closing
</body>tag - Select Save changes
Adding a Donorbox embedded donation form to website pages
Adding a Donorbox embedded donation form to website pages
Donorbox provides embed code for donation forms similar to the example shown below.
<script type="module" src="https://donorbox.org/widgets.js" async></script>
<dbox-widget campaign="example-campaign" type="donation_form"></dbox-widget>
The code shown above is provided as an example only. You must copy the exact code provided in your Donorbox account.
- Navigate to Website > Themes
- Select
customise your theme - Select
add a new section - Select the
custom HTMLsection type - Paste the embed code into the Custom HTML setting
- Position the section where the donation form should appear
- Save your changes
If you want to add to a website page select the Tick here to enter additional custom HTML/JS/CSS setting to add the code.
Adding a Donorbox pop-up form to individual pages
Adding a Donorbox pop-up form to individual pages
The Donorbox pop-up widget can also be added to individual pages using a custom HTML section.
- Navigate to Website > Themes
- Select
customise your theme - Select
add a new section - Select the
custom HTMLsection type - Paste the pop-up widget code into the Custom HTML setting
- Position the section where the button or pop-up trigger should appear
- Save your changes
Recommendations
Recommendations
- Install the pop-up widget script only once within your theme
- Use embedded forms when you want the donation form displayed directly within page content
- Test donation forms on a draft theme before updating your live website
- Keep a record of any embed or widget code added to your theme