Does Double the Donation integrate with Blackbaud's Luminate Online?

Does Double the Donation integrate with Blackbaud's Luminate Online?

Step-by-Step: Integrate Double the Donation's 360MatchPro into Luminate Online

Phase 1: Create a new test donation form to setup 360MatchPro

Navigate to "Donation Management" and click "Create a Donation Form." Our plugin will work on any type of form or template. 





We will create a custom field to store the company that the user searches for. Name the element exactly as follows: Double the Donation Company ID



Select the new field (Double the Donation Company ID), and move it to the column on the right by clicking the "Add" button in the middle. Then click "Save Order and Edit Selected." Uncheck the box next to "Yes, this field is visible." Then click "Finish." 



This adds an invisible element to the page that we will use to store the companies that users search for. 

Phase 2: Determining the value of the custom field

The next steps are to determine what custom field the "Double the Donation Company ID" field corresponds to in your Luminate Online pages. This will allow us to use the correct values on the confirmation page. Please follow the instructions illustrated below.













Copy / make a note of the string that appears that looks like [[S120:dc:custom:custom_stringXXX]]. This is the string that you will need to populate the confirmation page with the company information that the donor has searched for.

Be sure to delete the code blocks that were inserted at the end. You only need the [[S120:dc:custom:custom_stringXXX]] text.

Phase 3: Set up Double the Donation code snippets in Luminate Pages

You will need to setup three different reusable code snippets to use on multiple forms. Create the following three Luminate Reusable Pages with the corresponding code. Make sure to replace the bolded segments with your unique API Key, which was provided in the 360MatchPro setup document you should have received from us. 

Also, make sure to replace the [[S120:dc:custom:custom_string13]] with the actual value determined in the previous section. Instructions for creating the reusable pages themselves can be found after the table. 

Reusable Page Name

Code

reus_360matchpro_donation_widget

<script src="https://doublethedonation.com/api/js/ddplugin.js"></script>

<link href="https://doublethedonation.com/api/css/ddplugin.css" rel="stylesheet" />

<p>Does your employer have a matching gift program? Please use the field below to find out.</p>

<div id="dd-company-name-input"></div>

<script type="text/javascript">// <![CDATA[

Y.use('jquery-noconflict', function() {


jQuery(document).ready(function(){


if(!window.doublethedonation) {
jQuery("#dd-company-name-input").html("<div class='form-row'><div class='form-content'><input type='text'/></div></div>");
}

jQuery(document).on("doublethedonation_company_id", function () {




var dtd_company_id = jQuery('input[name="doublethedonation_company_id"]').val();




jQuery("#double_the_donation_company_idhidden").val(dtd_company_id);



});


});

});

// ]]></script>

reus_360matchpro_plugin

<script type="text/javascript">// <![CDATA[

var DDCONF = { API_KEY: "360MatchPro Public Key" };

// ]]></script>

<script src="https://doublethedonation.com/api/js/ddplugin.js"></script>

<link href="https://doublethedonation.com/api/css/ddplugin.css" rel="stylesheet" />

<div id="dd-container"></div>

reus_360matchpro_confirmation_page

<script type="text/javascript">// <![CDATA[

Y.use('jquery-noconflict', function (Y) {

   //hides monthly giving duration options; and sets duration to no end date

   jQuery(document).ready(function () {


       var domain = doublethedonation.integrations.core.strip_domain("[[S120:dc:email]]");

       doublethedonation.plugin.load_config();

       doublethedonation.plugin.set_donation_id("[[S120:dc:transactionID]]");

       doublethedonation.plugin.set_donation_campaign("[[S120:dc:donationFormName]]");

       doublethedonation.plugin.email_domain(domain);

       if ("[[S120:dc:custom:custom_string13]]") {

           doublethedonation.plugin.set_company("[[S120:dc:custom:custom_string13]]");

       }


       doublethedonation.integrations.core.register_donation({

           "360matchpro_public_key": "360MatchPro Public Key",

           "campaign": "[[S120:dc:donationFormName]]",

           "donation_identifier": "[[S120:dc:transactionID]]",

           "donation_amount": "[[S120:dc:giftAmount]]",

           "donor_first_name": "[[S120:dc:firstName]]",

           "donor_last_name": "[[S120:dc:lastName]]",

           "donor_email": "[[S120:dc:email]]",

           "doublethedonation_company_id": "[[S120:dc:custom:custom_string13]]",            "doublethedonation_status": null

       });

   });



});

// ]]></script>


The steps to add each reusable page are illustrated below.
















Phase 4: Adding a streamlined company search on the donation form

Navigate to the form you wan to put the donation form on, then edit the "Donation Form."



In the editor, move the "Double the Donation Company ID" custom field to the column on the right (in any order). Click on "Save Order and Edit Selected." Make sure to uncheck the box next to "Yes, this field is visible."



Add an "HTML Caption" field and add the reusable page titled "reus_360matchpro_donation_widget." Place this field where you want the streamlined search to appear. We recommend including it somewhere in the billing section of your form. 



Save this page and preview it. Make sure that the plugin appears on the form. If it doesn't, contact support@doublethedonation.com.

Phase 5: Embedding the matching gift widget on the confirmation page (Thank You Page)

In this phase, you will add the code to show our matching gift widget and the code to submit the donation information to 360MatchPro. Navigate to "Design Donor Screens" and then click "Edit" on the "Thank You Page."



Then click "Use Plain Text Editor."



In the plain text editor, navigate the cursor to where you want the Double the Donation plugin to appear. Then add the reusable code for our plugin.





Finally, add the Double the Donation submission code right next to this with the same process.





This completes the integration. We recommend you Test Drive the form and check that data is properly flowing into the 360MatchPro portal at https://doublethedonation.com/360matchpro/.

Blackbaud Luminate Online - Double the Donation FAQs

Q: I don't have a 360MatchPro account. How do I get one? 
A: Visit https://360matchpro.com/demo-request/ to request a demo! Make sure you mention that you use Blackbaud Luminate Online in your demo request form.

Q: I integrate with Luminate and Blackbaud RE-NXT CRM. How can I prevent Luminate donations from being duplicated in 360MatchPro?
A: You can set a custom filter so only non-Luminate records are imported from RE-NXT. Following the instructions here, set a filter for “Gift: Luminate Online Gift ID (custom field)” is missing. The following filter should then be visible in your 360MatchPro account under Integrations → Manage:



Q: Where else can I embed Double the Donation's plugin?
A: We recommend you create a dedicated matching gift page on your website to place matching gift information in the path of every website visitor, not just those already on your confirmation page. On this page, you can explain what matching gift programs are and provide donors with a chance to look up their employer’s program forms, guidelines, and instructions. Your dedicated matching gift page will become a useful resource to include in emails, newsletters, and direct messages.

To install Double the Donation’s matching gift search tool anywhere on your website, simply copy and paste the same Embed Code that you used before. Take a look at an example from the Cat Rescue Club:



    • Related Articles

    • Does Double the Donation integrate with Blackbaud Checkout through Luminate Online?

      360MatchPro is the industry-leading matching gifts automation solution for nonprofits and educational institutions to identify more matching gift revenue opportunities and drive more matches to completion. You’ll need a 360MatchPro account to ...

    • Does Double the Donation integrate with WordPress?

      Step-by-Step: Integrate Double the Donation's Matching Gift Plugin into WordPress 360MatchPro is the industry-leading matching gifts automation solution for nonprofits and educational institutions to identify more matching gift revenue opportunities ...

    • Does Double the Donation integrate with Blackbaud Online Express?

      360MatchPro is the industry-leading matching gifts automation solution for nonprofits and educational institutions to identify more matching gift revenue opportunities and drive more matches to completion. You’ll need a 360MatchPro account to ...

    • Does Double the Donation offer an API?

      Yes, Double the Donation offers multiple APIs to meet the needs of our software platform partners. We also offer additional robust matching gift functionality not featured on our website. If you're interested in learning more about Double the ...

    • Does Double the Donation integrate with iModules®?

      Step-by-Step: Integrate Double the Donation's 360MatchPro into Encompass from iModules 360MatchPro is the industry-leading matching gifts automation solution for nonprofits and educational institutions to identify more matching gift revenue ...