Barnardo's consent banner
Usage
Option 1: npm install / yarn add
Run npm install @barnardoswebteam/consent-banner
or yarn add @barnardoswebteam/consent-banner
.
In your code add the following:
const consentBanner = require('@barnardoswebteam/consent-banner');
consentBanner();
And add the GTM container ID in .env or as a config variable as GTM_CODE
.
Optionally add URLs for your privacy policy and cookie policy in .env as PRIVACY_URL
and COOKIE_URL
. If no privacy URL is declared it defaults to https://www.barnardos.org.uk/privacy-notice, and if no cookie URL is declared it defaults to https://www.barnardos.org.uk/cookie-notice.
Option 2: ESM
In your HTML add the following:
<script type="module" src="main.js"></script>
and in main.js:
import consentBanner from './path/to/consent-banner.esm.js';
consentBanner();
And add the GTM container ID in .env or as a config variable as GTM_CODE
.
Optionally add URLs for your privacy policy and cookie policy in .env as PRIVACY_URL
and COOKIE_URL
. If no privacy URL is declared it defaults to https://www.barnardos.org.uk/privacy-notice, and if no cookie URL is declared it defaults to https://www.barnardos.org.uk/cookie-notice.
Option 3: script element in HTML
Put the following near the end of the body element, replacing GTM-XXXXXX with the correct ID.
<script src="path/to/consent-banner.es5.js"></script>
<script>BarnardosConsent({'gtmCode':'GTM-XXXXXX'});</script>
Self hosting is recommended but if it's not possible you can use:
<script src="https://unpkg.com/@barnardoswebteam/consent-banner@latest/consent-banner.es5.js"></script>
<script>BarnardosConsent({'gtmCode':'GTM-XXXXXX'});</script>
Optionally add URLs for your privacy policy and cookie policy to the code like so:
<script>
BarnardosConsent(
{
'gtmCode': 'GTM-XXXXXX',
'privacyURL': 'https://your-domain/privacy-policy',
'cookieURL': 'https://your-domain/cookie-policy'
}
);
</script>
Both are optional, and if either it missing they will default to https://www.barnardos.org.uk/privacy-notice and https://www.barnardos.org.uk/cookie-notice respectively.
Updating
Cloning this repo as a git submodule is recommended if not using NPM or Yarn. Watch this repository and run git pull
from inside the submodule directory when there are changes. Otherwise watch this repository and perform manual updates.
Steps for creating a git submodule:
-
cd
to the directory the submodule will live. - Type
git submodule add -b main git@github.com:barnardos/consent-banner.git
and press enter to add the submodule. - Type
git submodule init
and press enter. -
cd
out of the submodule into the parent repository. - Add and commit the new files to the parent repository.