ccgtm

Ekino cookie consent module

• Goal
• Installation
• Usage
• Options

Goal

The goal of ccgtm is to provide a very simple API to implement the required cookie consent banner. You can read this European Comission article about cookie consent to know more about it in general.

Also, ccgtm will automatically dialog with google tag manager (TMS of your choice soon) in order to communicate about the consented categories by the final user.

Installation

Execute this command to install ccgtm

$ npm install --save-dev ccgtm

Using our cdn

<script type="text/javascript" src="https://du3x2bs1mu69t.cloudfront.net/ccgtm/ccgtm.js"></script>

Usage

import ccgtm from 'ccgtm';

ccgtm.initialize({
  settings: {
    validateOnClose: false,
    pushTop: true,
    pushPop: false,
    fixBottom: false,
    disableAcceptAll: false,
    pushTopHideOnScroll: false,
    mobileOffCanvas: false,
    moreLink: '',
    domain: null,
    timeout: 0,
    daysBeforeExpiry: 396
  },
  i18n: {
    popinClose: 'Close'
  }
});

Options

validateOnClose - {Boolean} (default: false) Validate the consent when the user closes the popin without any modification in the settings

if set to false, the popin closes without launching acceptance

when banner mode is enabled, this setting controls both the banner and parameter popin

pushTop - {Boolean} (default: true) The banner will appear on top of the page an push the content

pushPop - {Boolean} (default: false) The modal will open automatically

fixBottom - {Boolean} (default: false) The banner will appear at the bottom of the page

if neither pushTop, pushPop or fixBottom are enabled, the default is pushTop (top banner)

if pushPop is enabled and either or both fixBottom and pushTop are enabled too, the default is pushPop (popin)

disableAcceptAll - {Boolean} (default: false) Disables the "Accept and Continue" button (banner or popin)

pushTopHideOnScroll - {Boolean} (default: false) This will hide the banner if the users scrolls

mobileOffCanvas - {Boolean} (default: false) Controls mobile rendering mode, default is popin

moreLink - {String} (default: "") Indicates the url of the link to know more about cookie consent

domain - {String} (default: "") Specify a specific domain to associate the cookie with

daysBeforeExpiry - {Number} (default: 396) Number of days before the cookie expires

debugMode - {Boolean} (default: false) Not an option in itself, default is set to false, enables debug by cleaning cookie at each reload

Version

Current version is 1.1.1 - see CHANGELOG for infos