/ez-consent

🍪 Minimal & vanilla JS only cookie consent banner with no dependencies.

Primary LanguageJavaScriptMIT LicenseMIT

ez-consent

🍪 Minimal & vanilla JS only cookie consent banner with no dependencies.

Auto-versioned by bump-everywhere

  • Vanilla JavaScript only ✔️
  • It does not track you ✔️
  • Very lightweight with no dependencies ✔️
  • Single line to get going ✔️

Live example 1, Live example 2, CodePen examples

Usage

  1. Import
  2. Initialize
  3. Style

1. Import the script

Option A: CDN

It's the simplest way. Just add it to your page:

<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/ez-consent@1/dist/ez-consent.min.js"></script>

Option B: Install

  • Using NPM: npm install ez-consent --save
  • Or using yarn: yarn add ez-consent
  • Or as a git submodule (not recommended):
    • Go to the folder you wish to have the repository
    • Run git submodule add https://github.com/undergroundwires/safe-email

Add it to your page:

<script type="text/javascript" src="/node_modules/ez-consent/dist/ez-consent.min.js"></script>

Or you can import ez_consent as a module:

<script type="module">
  import { ez_consent } from './ez-consent/src/ez-consent.js'; // /node_modules/ez-consent/ez-consent.js ...
  ez_consent.init();
</script>

Or import it via webpack, gulp, rollup etc.:

import { ez_consent } from "./node_modules/ez-consent/src/ez-consent"

top↑

2. Initialize the script

ez_consent.init();

or with all optional options:

ez_consent.init(
  {
    is_always_visible: false,       // Always shows banner on load, default: false
    privacy_url: "/privacy",        // URL that "more" button goes to, default: "/privacy/"
    more_button: {
      target_attribute : "_blank",  // Determines what the behavior of the 'more' button is, default: "_blank", opens the privacy page in a new tab
      is_consenting: true           // Determines whether clicking on 'more' button gives consent and removes the banner, default: true
    },
    texts: {
      main: "We use cookies",       // The text that's shown on the banner, default: "This website uses cookies & similar."
      buttons:
      {
        ok: "ok",                   // OK button to hide the text, default: "ok"
        more: "more"                // More button that shows the privacy policy, default "more"
      }
    }
  });

The banner will be shown if the user has not yet agreed to read & understand the information. You can also force to show banner always by having force-consent query parameter in URL. E.g. : test.com/fest?force-consent

top↑

3. Style

Existing themes

You can choose one of the following existing theme to get going:

box-bottom-left.css

box-bottom-left

Source file | See it live | Preview on CodePen

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/ez-consent@1/dist/themes/box-bottom-left.min.css">
subtle-bottom-right.css

subtle-bottom-right subtle-bottom-right-dark

Source file | See it live | Preview on CodePen

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/ez-consent@1/dist/themes/subtle-bottom-right.min.css">

Custom themes

Or you can create your own theme & import it. Check example themes at existing themes. The HTML uses only a few classes using BEM naming convention.

You're welcome to contribute your theme to the project in ./src/themes folder by creating a pull request 👍.

top↑

Distributed files

The repository and deployed packages includes a dist/ folder that adds polyfills to the files and distributes them as:

  • minified (.min.js, .min.css) files for production usage
  • non-minified (.js, .css) files for debugging

top↑

GitOps

CI/CD is fully automated for this repo using different Git events & GitHub actions.

ez-consent continuous integration and deployment flow

top↑