SmartDONATE OLX is our auto-configuring add-on for Blackbaud OLX donation forms. It allows you to specify amount (any amount), gift type and attribute values via a URL when linking to an OLX page.
Installation is very simple as long as you are familiar with how to place an OLX donation form on a page (please refer to
Blackbaud Guides for help on this if unsure).
Step 1 - Create your snippet
The first step is to create your snippet. To do this you:
Enter your license details from the SmartDONATE OLX trial email
Click 'Get Script'
This will give you something like the below snippet which you need to copy for Step 2.
<script>var SmartDONATEOLXSettings = {"product":"SmartDONATEOLX","client":"XXXXXXXXX"}</script><!--
(c) 2017 The SmartTHING Limited
File smartdonateolx-display provided under license to XXXXXXXXX
Last updated 06/30/2017 05:01:41 pm
-->
<script src="https://www.smartthing2.com/download/file.php?jsformat=1&f=-js.html&c=XXXXXXXXX&k=XXXXXXXXX" type="text/javascript"></script>
Step 2 - Install the script on your website
You just need to paste your SmartDONATE snippet after your OLX snippet so you will have something like the below instead of just the normal OLX snippet:
<div id="bbox-root"></div>
<script type="text/javascript">
window.bboxInit = function () {
bbox.showForm('XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX');
};
(function () {
var e = document.createElement('script'); e.async = true;
e.src = 'https://bbox.blackbaudhosting.com/webforms/bbox-min.js';
document.getElementsByTagName('head')[0].appendChild(e);
} ());
</script><script>var SmartDONATEOLXSettings = {"product":"SmartDONATEOLX","client":"XXXXXXXXX"}</script><!--
(c) 2017 The SmartTHING Limited
File smartdonateolx-display provided under license to XXXXXXXXX
Last updated 06/30/2017 05:01:41 pm
-->
<script src="https://www.smartthing2.com/download/file.php?jsformat=1&f=-js.html&c=XXXXXXXXX&k=XXXXXXXXX" type="text/javascript"></script>
Step 3 - Using SmartDONATE - Creating links to your donation page
You can specify various values in your web links. In the end you will have something like this:
Options include:
Gift amount: amount=[amount] i.e. amount=12.50
Gift type: type=[one off|regular|monthly] (note: monthly just selects regular and if present the first monthly option)
Attributes: attr1=[label of attribute]&attr1value=[value to put in field]&attr2=[label of attribute]&attr2value=[value to put in field]...