Drop-in Button

The GetFTR Drop-in Button makes it easier for discovery tools and other integrators to display GetFTR buttons directly on their websites - no backend or API integration required.

The client-side integration enables tools to add GetFTR buttons to search results, article pages, references etc with just a few lines of HTML and JavaScript.

Integration Steps

Before getting started, please contact your GetFTR representative (or email joinus@getfulltextresearch.com) to register for the Drop-in Button integration.

You’ll need to provide:

The domain(s) where the button will be embedded
Contact details for integration support

Once approved, you will receive a unique Integrator ID and gain access to the GetFTR Self-Service Portal, where you can manage your integration settings and monitor activity.

Add the Script to the website

Paste the following script tag into your HTML - ideally just before the closing </body> tag of your website:


<script type="text/javascript">
  (function (G, e, t, F, T, R) {
    G[t] = {};
    G[t][T] = R;
    s = e.createElement(F);
    s.async = 1;
    s.src = "http://dropin-button.getft.io/integrator/" + R;
    s.type = "text/javascript";
    q = e.getElementsByTagName(F)[0];
    q.parentNode.insertBefore(s, q);
  })(window, document, "getftr", "script", "integratorId", "{{INTEGRATOR_ID}}");
</script>

NOTE: Make sure you replaced {{ INTEGRATOR_ID }} with your actual integrator ID.

⚠️

IMPORTANT: If you have a Content Security Policy set up on your website, make sure to include at least these source expressions to ensure everything loads correctly and securely:

script-src — https://dropin-button.getft.io
connect-src — https://btn.prod.getft.io
style-src — 'unsafe-inline' AND https://fonts.googleapis.com

Add the Drop-in Button Markup

Anywhere you want to display the GetFTR button, add this HTML snippet:


<div data-getftr-dropin-button data-doi="{{DOI}}"></div>

This will render a GetFTR entitlement button based on the provided DOI.

NOTE: If a DOI is not available for a given piece of content, you can use metadata-based lookup instead by supplying any combination of the following attributes.

Attribute	Type	Example
data-preprintdoi	string	data-preprintdoi=“10.1010/1234.preprint”
data-title	string	data-title=“Document Title”
data-journal	string	data-journal=“Journal Name”
data-authors	Array of strings	data-authors=”[“Author 1”, “Author 2”]“
data-year	string	data-year=“2013”

Add organisation information (optional)

To provide organization information in GetFTR requests for subscription content, you may include <meta> tags within your HTML <head> section. This helps ensure more accurate entitlement resolution and usage tracking.


<meta name="getftr:entityID" content="urn:test:entity" />
<meta name="getftr:ipv4" content="10.20.30.40" />
<meta name="getftr:ipv6" content="2001:db8::7334" />