0.4.0 • Published 2 years ago

@remindgmbh/cookieconsenter v0.4.0

Weekly downloads
-
License
BSD-3-Clause
Repository
github
Last release
2 years ago

CookieConsenter

travis-img codecov-img github-issues-img contrib-welcome-img license-img

Blah blah


Installation

npm i @remindgmbh/cookieconsenter

API

The wrapper api consists of modules that can be assigned to the cookieconsent choice types.

import { Consenter, Iframe } from '@reindgmbh/cookieconsenter'

const consenter: Consenter = new Consenter()

const iframe: Iframe = new Iframe()

consenter.add('marketing', iframe)

consenter.enable()

Modules

YouTube

Create placeholder element with params.

<div
    data-yt-consent="id"
    data-yt-params="query params"></div>

Api will create iframe in its place

<iframe
    style="border-style: none;"
    width="100%"
    height="100%"
    src="https://www.youtube-nocookie.com/embed/id?params"
    allowfullscreen></iframe>

Iframe

Create placeholder element with params.

<div
    data-iframe-url="https://my.url.domain/"
    data-iframe-width="50%"
    data-iframe-height="50%"
    data-iframe-uid="some-id"></div>

Api will create this iframe

<iframe
    style="border-style: none;"
    width="50%"
    height="50%"
    src="https://my.url.domain/"
    name="iframe-some-id"
    allowfullscreen></iframe>

Custom Modules

Any functionality not provided by the base modules can be implemented by creating your own module.

import { Consenter, Module } from '@remindgmbh/cookieconsenter'

/**
 * Create your own module by extending the module class.
 */
class MyModule extends Module {

    /**
     * This method will be called by the api to run your code.
     */
    public run(): void {
        // custom code
    }
}

/* Create a new consenter instance */
const consenter = new Consenter()

/* Create an instance of your module */
const myMod = new MyModule()

/* Add your module to the consenter using whatever consent level you require */
consenter.add('necessary', myMod)

/* Enable the consenter and watch what happens when you consent */
consenter.enable()

Contributing

0.4.0

2 years ago

0.3.0

3 years ago

0.2.0

3 years ago

0.1.0

3 years ago