Warning/Error Message for Plugin URL

Warning/Error Message for Plugin URL

Overview: 

We want to check to make sure your Double the Donation search tool is installed correctly on your website so we created an automated scanning process.

In your account settings within Plugin Settings, you'll see a field labeled "Plugin URL" for the matching gifts webpage where you have embedded our search tool. 



When you paste a specific URL of where you installed our matching gift plugin, our software scrapes the page where you have embedded our plugin and scans the HTML code to try to verify that the plugin was installed correctly. We also scan this URL every night to make sure everything is working as expected. 

What you should put in that field:

Please put the exact page URL of where you installed your Double the Donation search tool.

This needs to be a publicly accessible URL that anyone can access. For example, you should put in a URL like the following sample dedicated matching gift pages where it's a specific URL :
  1. https://www.catrescueclub.org/matching-gifts/
  2. https://www.lls.org/ways-to-help/corporate-matching-gifts

What you should not put in that field?

You're able to add our matching gift plugin anywhere you'd like on your site (in up to five locations), but for our automated screening to make sure the plugin is working correctly, do not put it on:
  1. Your website's homepage (unless you have our matching gift tool installed on your homepage)
  2. A page with our matching gift tool that is behind a login screen
  3. A page with out matching gift tool that comes after a donation (like a donation confirmation page) 
You'll get a warning message as our automated scan of that page will not be able to see our matching gift plugin.

Help! I'm getting a warning message.

Most of the time when organizations get a warning message it's because of one of a few reasons:
  1. The URL that you entered doesn't have our matching gift plugin on it
  2. You're linking to a page our automated system can't access.
  3. There's a "Splash Screen" or pop-up/promotion that covers your webpage before the page is fully loaded. If that's the case, you can ignore the warning message.
We always recommend that you open up the URL in an incognito window and visually verify that you can see the full Double the Donation plugin on that specific page and the search is working correctly.

Specific warning messages and what to do:

Flag: PLUGIN_HTTPS

Message: The plugin URL should begin with https:// or http://.

How to Resolve: Add https:// or http:// to the beginning of the plugin URL, depending on if your website’s URL begins with https:// or http://.


Flag: PLUGIN_IFRAME 

Message: The plugin appears to be installed as an iFrame on the page. The iFrame implementation is highly discouraged for 360MatchPro users because it disables email click tracking.

How to Resolve: 360MatchPro clients should use either our full HTML/JavaScript plugin or WordPress Plugin on your dedicated matching gift page. This will enable full tracking and automation within 360MatchPro.


Flag: PLUGIN_KEY 

Message: Our automated scanner isn't able to detect the proper public API key for your account. Please make sure the public API key that you added is correct.

How to Resolve: With the support of a technical person on your team (if needed), visit your matching gift page, press F-12, navigate to the console tab, type DDCONF, and then press enter.  If your public key is visible, then you are squared away and the automated scanner generated a false negative.  If the public key is not visible, add the following line of code somewhere in the HTML of your page: <script> var DDCONF = {API_KEY: "your public api key"}</script>

Reasons why our scanner may be wrong:

  • Your matching gift page has a blocker (eg. pop-up, reCAPTCHA, etc.) that prevents the scanner from parsing the HTML on your page.

  • The DDCONF variable that contains your public key is included in another JavaScript file that you created.  Our scanner only parses your main page’s HTML code.


Flag: PLUGIN_JS 

Message: Our automated scanner is having a tough time finding the Double the Donation plugin on your webpage. If our plugin is appearing and working correctly, please disregard this warning. For additional technical context, our automated scanner is looking at your HTML code in search of the ddplugin.js file but couldn't find it. It's possible that the browser downloaded the ddplugin.js file via JavaScript instead of an HTML <script> tag, and that's OK!

How to resolve: With the support of a technical person on your team (if needed), visit your matching gift page, press F-12, navigate to the console tab, type doublethedonation, and then press enter.  If a console error is not generated and you see the plugin on your page, then Double the Donation’s script was installed on your website and you are likely squared away.  Our scanner likely produced a false negative.  If a console error is generated (i.e. ReferenceError), please go to your current Double the Donation account and re-copy and re-paste the full plugin code.

Reasons why our scanner may be wrong:

  • The code in our ddplugin.js file was copied to your server, and that file from your server was loaded into your website.  Be careful if you do this since copying our code to your server will prevent you from automatically receiving software updates.

  • You prefer the iFrame installation.  Instead of using our standard iFrame implementation, your iFrame is pointing to another site that has our plugin on it.   Our scanner does not recursively search iFrames that point to other sites.


Flag: PLUGIN_CONTAINER

Message: Our automated scanner is having a tough time finding the Double the Donation plugin on your webpage. If our plugin is appearing correctly and working correctly, please disregard this warning. For additional technical context, our automated scanner is looking at your HTML code in search of the <div> tag with an id attribute of 'container' but couldn't find it. It's possible that the <div> tag is injected into the HTML asynchronously (after our scanner parses your HTML), and that's OK!

How to resolve: If you see the plugin on your site, then you are likely squared away.  Our scanner generated a false negative. If you don’t see our plugin on your site, add the following in your page’s HTML where you would like the plugin to render: <div id=”container”></div>

Reasons why our scanner may be wrong:

  • The <div id=”container”></div> element was injected into the page via JavaScript.  This often occurs when using frameworks such as React and Angular.


Flag: PLUGIN_DTDSITE
Message: The page on Double the Donation's site works well! But we do recommend you embed our matching gift plugin directly on your organization's own website. It's more effective as organizations typically see the best matching gift results and best donor experience when our matching gift tools are embedded directly on their own website.
How to Resolve: Don't worry, everything is working fine! Although, organizations typically see the best matching gift results and best donor experience when our matching gift tools are embedded directly on their own website so we recommend it. Learn how to embed our plugin on your site.

Flag: READ TIME OUT
Message: This means that our automated scanner tried to retrieve and parse the HTML on the matching gift page, but it took longer than five seconds to establish a connection to the page so the scanner stopped trying. 
How to Resolve: If you see the plugin on your site, then you are likely squared away.

FAQ:

Q: I think everything is working! But I'm still getting a warning message?
A: Our automated screening isn't perfect. Some nonprofit's developers will do something unconventional (but technically correct), like taking our JavaScript code, dumpling it in an arbitrary JavaScript file, and loading that instead. Or maybe you have a splash screen / pop-up that gets loaded that prevents our automated scanner from being able to verify our plugin is on your page. In these and other instances where you feel comfortable things are working as expected you can ignore the message. 

Q: Can I still put Double the Donation's plugin on a webpage that is behind a login screen?
A: Yes, just don't put the URL into the field or accept the fact that we'll display a warning message.

Q: Can I still put Double the Donation's plugin on a donation confirmation page?
A: Absolutely! We encourage you to put our matching gift plugin in multiple spots including a dedicated matching gift page and the donation confirmation page.

Read through this article and still can't figure out what's causing the warning message?

Please email us at support@doublethedonation.com. Make sure to include a link to the specific URL where you installed our matching gift plugin.