siwa_cookiebar

siwa_cookiebar is a JavaScript Module that displays a GDPR cookie consent bar to your visitors that complies with EU law. Requires Bootstrap 5

Table of Contents

• Installation
• Usage
• Customization
• License

Installation

Use the npm package manager to install siwa_cookiebar.

npm install siwa_cookiebar

Usage

Use as a Module

To use as a Module include window.siwa_cookiebar = siwa_cookiebar

import { siwa_cookiebar } from './cookiebar.js';
import { localeDE } from './lang/cookie-text.de.js';

// Override a Locale
const locales = Object.assign(localeDE, {
    'header': 'Datenschutz'
});

const constants = {
    DEBUG: true,
    FALLBACK_LOCALE: 'en',
    BANNER: true,
    DEFAULT_VALUE: true,
    DECLINE_BTN: true,
    SCRIPT_VIEW: true
};

const groups = {
    statistics: {
        scripts: {
            analytics: {
                'cookies': ['_ga', '_gat', '_gid', '__utma', '__utmb', '__utmc', '__utmt', '__utmz'],
                'name': 'Google Analytics',
                'url': 'https://developers.google.com/analytics/devguides/collection/analyticsjs/cookie-usage',
                'enabled': window['analyticsUa'] ? true : false,
                'js': 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', 'https://www.google-analytics.com/analytics.js', 'ga');

                    ga('create', 'UA-XXXXXX-X', 'auto');
                    ga('set', 'anonymizeIp', true);
                    ga('send', 'pageview');
                }
            },
            'nojs': function(){
                console.log('call when cookies are declined');
            }
        }
    }
};


// custom essential Scripts
siwa_cookiebar.cookies.essentials.scripts.push({
    cookies: [
        // cookie list
    ],
    script: function () {
        // do stuff
    }
});

if (typeof siwa_cookiebar !== 'undefined') {
    siwa_cookiebar.initialize(constants, groups, {
        de: locales
    });
}

window.siwa_cookiebar = siwa_cookiebar;

cookiebar.js

Customization

Constants

Available

Name | Description |Constant Name | default --- | --- | --- | --- Cookie Name | Name of the Cookie which is set in the Browser Cookies | COOKIE_NAME | siwa-cb Fallback Locale | Locale to which the cookiebar should fallback if the requested locale does not exist | FALLBACK_LOCALE | de Override Language | Is Overriding the Locale enabled | OVERRIDE_LANGUAGE | false Override Language Locale | Locale which to use to override. Only works if OVERRIDE_LANGUAGE = true | OVERRIDE_LANGUAGE_LOCALE | de Strict Mode | If enabled the modal cannot be dismissed. A value has to be set | STRICT_MODE | true Script View | Toggles the display mode | SCRIPT_VIEW | false Banner | Show Banner on initialization | BANNER | false Debug Mode | Enable Debug Mode with Console Logs | DEBUG | false Decline Button | Show a decline button | DECLINE_BTN | false Default Value | Are Checkboxes in Group View checked by default | DEFAULT_VALUE | false

Set a Constant

siwa_cookiebar.constants.<CONSTANT_NAME> = <CONSTANT_VALUE>

License

GPL-2.0+