@dirkpersky/dp_cookieconsent
v2.3.0
Published
This Plugin includes the most popular solution to the EU Cookie law JavaScript Plugin Cookie Consent. Extended with an Script and iFrame helper, so it works with the ePrivacy law.
Downloads
86
Maintainers
Readme
DP Cookie Consent
This Plugin includes the most popular solution to the EU Cookie law JavaScript Plugin Cookie Consent. I extended it with Script and iFrame helper, so it works with the ePrivacy law.
Though don't care about the latest EU laws and handle you Cookies with this Plugins.
npm i @dirkpersky/dp_cookieconsent
Config
window.cookieconsent_options.
| Property | Description | Options | Default | |---------------------------|----------------------------------------------------------|----------------------------------------|---------------:| | content.href | URL to Data Protection | | | | content.target | Link target of read more link | | _blank | | theme | Layout of the consent | edgeless | edgeless | | position | position of the consent | bottom, top, bottom-left, bottom-right | bottom-right | | dismissOnScroll | auto accecpt consent on scroll after XX px | | | | revokable | Some countries REQUIRE that a user can change their mind | true, false | true | | reloadOnRevoke | reload page after consent revoke (stop tracking) | true, false | false | | type | consent types (screenshot) | opt-in | opt-in | | checkboxes.statistics | pre check statistics in checkboxes layout | true, false | false | | checkboxes.marketing | pre check marketing in checkboxes layout | true, false | false | | overlay.notice | enable or disable overlay | true, false | false | | overlay.box.background | Overlay: Background color | rgba(), #hexa | rgba(0,0,0,.8) | | overlay.box.text | Overlay: text color | rgb(), #hexa | #fff | | overlay.button.background | Overlay: Button Background color | rgba(), #hexa | #b81839 | | overlay.button.text | Overlay: Button text color | rgb(), #hexa | #fff | | palette.popup.background | Consent Background color | rgba(), #hexa | rgba(0,0,0,.8) | | palette.popup.text | Consent Text color | rgb(), #hexa | #fff | | palette.button.background | Consent Button Background color | rgba(), #hexa | #f96332 | | palette.button.text | Consent Button Text color | rgb(), #hexa | #fff |
types
| opt-in | |----------------------------------------| | |
Features
load scripts after accepting
load script sources If you want to load JavaScript resources after the Cookie is accepted you can use this snipped
<script data-cookieconsent="statistics" type="text/plain" data-src="{YOUR_LINK_TO_JS}"></script>
load inline script If you want to load Inline JavaScript after the Cookie is accepted use this snipped.
<script data-cookieconsent="statistics" type="text/plain">
{YOUT_DYN_JS_CODE}
</script>
Checkboxe mode
You can extend the default cookie message with checkboxes, by activiating the layout in the TYPO3 constants window.cookieconsent_options.layout = dpextend
.
Now your customer can choose what types of scripts/cookies he want to allow.
This 3 types are possible and handled by the consent:
| Type | Description | example |
| ---------- | ---------------------------------------------------- |----------------------------------------------------------------|
| required | all normal script, will always called | <script type="text/javascript" ...
|
| statistics | scripts that will only run after consent handling | <script data-cookieconsent="statistics" type="text/plain"...
|
| marketing | scripts that will only run after consent handling | <script data-cookieconsent="marketing" type="text/plain"...
|
load iframe after accepting
If you want to load iFrame's (YouTube, GMap, ..) after the Cookie is accepted you can use this snipped
<iframe width="560" height="315"
data-cookieconsent="statistics"
data-src="https://www.youtube-nocookie.com/embed/XXXXXX?autoplay=1"
class="dp--iframe"
frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreenn >
</iframe>
With the class="dp--iframe"
the iFrame is hidden in default and would be shown after the cookie acceptioning.
iframe overlay
if you want to add an overlay to accept Cookies outside from the cookie hint
you also can modify the text in this hint individuel per iframe
<iframe
data-cookieconsent="statistics"
data-src="https://www.youtube-nocookie.com/embed/XXXXXX?autoplay=1"
class="dp--iframe"
data-cookieconsent-notice="Cookie Notice"
data-cookieconsent-description="Loading this...."
data-cookieconsent-btn="allow cookies and load this ...."
>
</iframe>
build your own overlay
or accept/deny cookies outside of the cookie hin, you can use the followed example
<button
onclick="window.DPCookieConsent.forceAccept(this)"
data-cookieconsent="statistics"
>allow cookies and play video</button>
allow cookies
window.DPCookieConsent.forceAccept(this)
deny cookies
window.DPCookieConsent.forceDeny(this)
load content after accepting
if you want to add contents that will only be visible if the consent hint is accepted
Your HTML markup for this is
<dp-content
data-cookieconsent="statistics"
class="dp--iframe"
data-cookieconsent-notice="Cookie Notice"
data-cookieconsent-description="Loading this...."
data-cookieconsent-btn="allow cookies and load this ...."
>
YOUR CONTENT
</dp-content>
if you want load ajax content into the content add the data-src="URL"
attribute.
Events
| Event | Description | Options | | ------------------------- | --------------------------------------------- | ----------------------------------------- | | dp--cookie-init | fire event when initialize process is done | | | dp--cookie-fire | fire after a consent script/iframe is loaded | event.detail.$el | | dp--cookie-accept | fire when the consent is accepted | | | dp--cookie-accept-init | fire accepted event on revisited | | | dp--cookie-deny | fire when the consend is denied | | | dp--cookie-revoke | fire when the consent is revoked | |
document.addEventListener('dp--cookie-fire', function (e) {
console.log('dp--cookie-fire', e.detail.$el);
});
document.addEventListener('dp--cookie-accept', function (e) {
console.log('dp--cookie-accept', e);
});
document.addEventListener('dp--cookie-deny', function (e) {
console.log('dp--cookie-deny', e);
});
document.addEventListener('dp--cookie-revoke', function (e) {
console.log('dp--cookie-deny', e);
});
Custom Design
<script type="text/plain" data-dp-cookiedesc="layout">
{{message}}
<a aria-label="learn more about cookies"
role=button tabindex="0"
class="cc-link"
href="{{href}}"
rel="noopener noreferrer nofollow"
target="{{target}}"
>
{{link}}
</a>
</script>
<script type="text/plain" data-dp-cookieselect="layout">
<div class="dp--cookie-check" xmlns:f="http://www.w3.org/1999/html">
<label for="dp--cookie-require">
<input type="checkbox" id="dp--cookie-require" class="dp--check-box" checked="checked" disabled="disabled" />
{{dpRequire}}
</label>
<label for="dp--cookie-statistics">
<input type="checkbox" id="dp--cookie-statistics" class="dp--check-box" {{checked.statistics}} value="" />
{{dpStatistik}}
</label>
<label for="dp--cookie-marketing">
<input type="checkbox" id="dp--cookie-marketing" class="dp--check-box" {{checked.marketing}} value="" />
{{dpMarketing}}
</label>
</div>
</script>
<script type="text/plain" data-dp-cookierevoke="layout">
<div class="cc-revoke dp--revoke {{classes}}">
<i class="dp--icon-fingerprint"></i>
<span class="dp--sr-only">{{policy}}</span>
</div>
</script>
<script type="text/plain" data-dp-cookieIframe="layout">
<div class="dp--overlay-inner">
<div class="dp--overlay-header">{{notice}}</div>
<div class="dp--overlay-description">
{{desc}}
<a aria-label="learn more about cookies" role=button tabindex="0" class="cc-link" href="{{href}}" rel="noopener noreferrer nofollow" target="{{target}}">{{link}}</a>
</div>
<div class="dp--overlay-button">
<button class="db--overlay-submit" onclick="window.DPCookieConsent.forceAccept(this)"
data-cookieconsent="{{type}}" {{style}}>
{{btn}}
</button>
</div>
</div>
</script>
Dynamic Checkboxes
With this feature you can add or modify the checkbox types by configuration. All you have to do is setting your new checkbox in TS and add it to the partial template:
<script type="text/plain" data-dp-cookieselect="layout">
...
<label for="dp--cookie-statistics">
<input type="checkbox" id="dp--cookie-thirdparty" class="dp--check-box" {{checked.thirdparty}} value="" />
TEXT
</label>
...
</script>
window.cookieconsent_options.checkboxes = {
statistics = true
marketing = false
thirdparty = false
}
change Cookie Settings
you can overwrite the cookie settings with a global definition
window.cookieconsent_options_cookie = {
// This is the url path that the cookie 'name' belongs to. The cookie can only be read at this location
path: '/',
// This is the domain that the cookie 'name' belongs to. The cookie can only be read on this domain.
// - Guide to cookie domains - https://www.mxsasha.eu/blog/2014/03/04/definitive-guide-to-cookie-domains/
domain: '',
// The cookies expire date, specified in days (specify -1 for no expiry)
expiryDays: 30,
// If true the cookie will be created with the secure flag. Secure cookies will only be transmitted via HTTPS.
secure: false
}
Please give me feedback
I would appreciate any kind of feedback or ideas for further developments to keep improving the extension for your needs.
Say thanks! and support me
You like this extension? Get something for me (surprise!) from my wishlist on Amazon or the next pizza. Thanks a lot!