https://github.com/alex-d/cookies-eu-banner
1kb vanilla JS script which manages cookies consent banner display like asked by GDPR
https://github.com/alex-d/cookies-eu-banner
cookie gdpr gdpr-cookie google-analytics navigator rgpd
Last synced: 15 days ago
JSON representation
1kb vanilla JS script which manages cookies consent banner display like asked by GDPR
- Host: GitHub
- URL: https://github.com/alex-d/cookies-eu-banner
- Owner: Alex-D
- License: mit
- Created: 2015-01-20T14:57:17.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2023-05-23T22:25:35.000Z (about 2 years ago)
- Last Synced: 2025-05-16T09:01:56.875Z (15 days ago)
- Topics: cookie, gdpr, gdpr-cookie, google-analytics, navigator, rgpd
- Language: JavaScript
- Homepage: http://alex-d.github.io/Cookies-EU-banner/
- Size: 645 KB
- Stars: 442
- Watchers: 17
- Forks: 57
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Cookies EU banner
Screenshot
Supporting Cookies EU banner
Cookies EU banner is an MIT-licensed open source project and completely free to use.
You can support it's ongoing development by being a backer or a sponsor:
- [Become a backer or sponsor on Patreon](https://www.patreon.com/alexandredemode)
- [One-time donation via PayPal](https://www.paypal.me/demodealexandre/20eur)
-----
## Introduction
Cookies EU banner manage display of a banner which allows user to accept or reject cookies from tracking services like Google Analytics.
It is a GDPR-compliant way to get cookie consent from visitors.
- [Try Cookies EU banner demo in action](https://alex-d.github.io/Cookies-EU-banner/demo)
- [Go to presentation website](https://alex-d.github.io/Cookies-EU-banner/)
## Installation
### Get the script
- Using npm: `npm install cookies-eu-banner --save`
- Or using yarn: `yarn add cookies-eu-banner`
- Or using bower: `bower install cookies-eu-banner --save`
- Or [download the latest version](https://github.com/Alex-D/cookies-eu-banner/archive/master.zip).
### In your pages
Insert the banner before any content at the beginning of the `` element, with these IDs:
```html
By continuing to visit this site, you accept the use of cookies by Google Analytics for statistical purposes.
Read more
Reject
Accept
```
- `#cookies-eu-banner` is the div that contains all elements to be hidden after user accepts or declines the use of cookies;
- `#cookies-eu-more` is a link to a "Read more" page where you explain your use of cookies;
- `#cookies-eu-reject` and `#cookies-eu-accept` are the buttons used to reject/accept cookies.
Before the end of ``, or in a script file inserted at the same place, put the following code:
```html
new CookiesEuBanner(function () {
// Your code to launch when user accept cookies
});
```
Example for Google Analytics:
```html
new CookiesEuBanner(function () {
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
// Don't forget to put your own UA-XXXXXXXX-X code
ga('create', 'UA-XXXXXXXX-X', 'auto');
ga('send', 'pageview');
});
```
### Options
#### waitAccept
The second parameter (`true` in the example below) define if Cookie EU banner wait the user acceptation before hide the banner. Set to `false` by default.
```html
new CookiesEuBanner(function () {
// Your code to launch when user accept cookies
}, true);
```
#### useLocalStorage
If you really don't want save the consent in a cookie, you can use localStorage.
The third parameter (`true` in the example below) define if Cookie EU banner use localStorage (`true`) or cookie (`false`). Set to `false` by default.
*Note: the localStorage method is not as good as the cookie method since the localStorage cannot expires after 13 months as recommended.*
```html
new CookiesEuBanner(function () {
// Your code to launch when user accept cookies
}, false, true);
```
#### waitRemove
If you want add some transition on accept/reject, and want to prevent the premature deletion of the banner, you can add
`data-wait-remove` attribute to the banner, with the time to wait in milliseconds.
```html
```
## How does it work?
For a detailed explanation, see comments in the main file: [cookies-eu-banner.js](src/cookies-eu-banner.js).
In short:
1. Excludes bots, clients who have DoNotTrack activated, and users who have already declined;
2. Runs your custom function if user has already accepted;
3. Shows banner, then:
- if user accepts, run custom function and put a cookie to save this acceptance;
- if user declines, remove all Google Analytics cookies and put a cookie to save this rejection.
## Features
- Do Not Track detection (IE9+, Firefox, and all browsers compatible with the `navigator.doNotTrack` JavaScript variable);
- Disables banner when visitor is a bot: prevents SEO Engines to confuse your cookie advert message with the main content of your pages;
- Respects [all points imposed by CNIL (FR)](https://www.cnil.fr/fr/solutions-pour-les-cookies-de-mesure-daudience) and [these points](https://www.cnil.fr/fr/cookies-traceurs-que-dit-la-loi).
## Contribute
This project use Gulp.
To contribute, you need [Node.js](http://nodejs.org/) and npm (or yarn).
Then, in the Cookies EU banner folder, run these commands:
```console
npm install
npm run start
# or
yarn
yarn start
```
The first line install all dependencies.
The second line builds the min file and watch for changes to rebuild it on the fly.
## Supported browsers
All browsers desktop/mobile: IE8+, Edge, Firefox, Chrome, Safari, Opera, ...