praiadeseselle/site/modules/PrivacyWire
2024-04-16 11:51:21 +02:00
..
.github/workflows Engadidos novos modulos 2024-04-16 11:51:21 +02:00
css Engadidos novos modulos 2024-04-16 11:51:21 +02:00
js Engadidos novos modulos 2024-04-16 11:51:21 +02:00
src Engadidos novos modulos 2024-04-16 11:51:21 +02:00
.babelrc Engadidos novos modulos 2024-04-16 11:51:21 +02:00
.gitattributes Engadidos novos modulos 2024-04-16 11:51:21 +02:00
.gitignore Engadidos novos modulos 2024-04-16 11:51:21 +02:00
CHANGELOG.md Engadidos novos modulos 2024-04-16 11:51:21 +02:00
composer.json Engadidos novos modulos 2024-04-16 11:51:21 +02:00
FutureFeatures.md Engadidos novos modulos 2024-04-16 11:51:21 +02:00
LICENSE Engadidos novos modulos 2024-04-16 11:51:21 +02:00
package-lock.json Engadidos novos modulos 2024-04-16 11:51:21 +02:00
package.json Engadidos novos modulos 2024-04-16 11:51:21 +02:00
PrivacyWire.module Engadidos novos modulos 2024-04-16 11:51:21 +02:00
PrivacyWireBanner.php Engadidos novos modulos 2024-04-16 11:51:21 +02:00
PrivacyWireConfig.php Engadidos novos modulos 2024-04-16 11:51:21 +02:00
PrivacyWireConsentBlueprint.php Engadidos novos modulos 2024-04-16 11:51:21 +02:00
README.md Engadidos novos modulos 2024-04-16 11:51:21 +02:00
rollup.config.mjs Engadidos novos modulos 2024-04-16 11:51:21 +02:00
TextformatterPrivacyWire.module Engadidos novos modulos 2024-04-16 11:51:21 +02:00
TextformatterPrivacyWireConfig.php Engadidos novos modulos 2024-04-16 11:51:21 +02:00

PrivacyWire

Cookie & Consent Manager for ProcessWire

This module adds the possibility to define cookie / consent groups and load corresponding elements only after the site visitor has given consent.
The following cookie groups are available (the frontend visible label is editable and translatable, this is just the technical name)

  • Necessary
  • Functional
  • Statistics
  • Marketing
  • External Media
  • (All Cookies)
    Necessary elements are always active. You can let the user decide, which individual cookie group(s) should be allowed, and/or add an „Allow all“ button.

You can insert basic styles via css or completely style it yourself. The PrivacyWire Core Javascript file is available both as ES6 as well as transpiled with Babel for IE11 support. Both versions have a very small footprint:

File Size Gzipped
PrivacyWire.js < 9 kb < 3 kb
PrivacyWire_legacy.js < 13 kb < 4 kb

To load scripts, frames, images or other elements only after the site visitor has given consent to that specific cookie group, use the following attributes:

<script type="text/plain" data-type="text/javascript" data-category="functional" class="require-consent">console.log("This script only runs after giving consent to functional cookies");</script>

You can even render and alternate Opt-In text instead of the element:

<iframe data-src="https://processwire.com/" data-category="marketing" data-ask-consent="1" class="require-consent" frameborder="0" height="400" width="400"></iframe>

Available attributes:

Attribute Info Description Type
class require-consent optional (required if config option enabled) If the config option "Detect consent windows by class require-consent instead of data-attribute" is enabled string
data-category required defines the assigned cookie group for this element string
data-type optional (required for scripts) replaces the type attribute after giving consent string
data-src optional (required for external scripts, images or iframes) replaces the src attribute after giving consent string
data-srset optional replaces the srcset attribute for images after giving consent string
data-ask-consent optional Replace element with Opt-In-Element bool 0/1

For script tags it is required to add type="text/plain", otherwise the script executes directly.

With PrivacyWire itself comes a Textformatter with the shortcode [[privacywire-choose-cookies]] to add a button to show the cookie group selection window.
To automatically include the Opt-In-Element for embedded videos via TextformatterVideoEmbed you can choose the cookie group in the Textformatter settings.

Multiple language support / i18n

The module uses the ProcessWire-integrated translation system.

Hookable methods

Most of the module methods are hookable! Have a look into PrivacyWire.module to find out more.