datareporter / module-webcare
Magento2 module to embed DataReporter WebCare elements (imprint, privacy notice, cookie banner)
Installs: 15 509
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 5
Forks: 2
Open Issues: 1
Type:magento2-module
Requires
- datareporter/module-core: ^1
- magento/framework: 101.*|102.*|103.*
Requires (Dev)
- composer/composer: *@dev
README
Magento2 module to embed DataReporter WebCare elements (imprint, privacy notice, cookie banner)
Installation
The easiest way to install the extension is to use Composer.
Run the following commands:
$ composer require datareporter/module-webcare
$ bin/magento module:enable DataReporter_Core
(if not already installed and enabled)$ bin/magento module:enable DataReporter_WebCare
$ bin/magento setup:upgrade && bin/magento setup:static-content:deploy
Features
Imprint
Use class \DataReporter\WebCare\Block\ImprintBlock
or embedd into CMS-Page/Block as Widget named 'WebCare - Imprint'
Privacy Notice
Use class \DataReporter\WebCare\Block\PrivacyNoticeBlock
or embedd into CMS-Page/Block as Widget named 'WebCare - Privacy Notice'
Cookie Banner
All needed blocks are placed within the layout-xml default.xml
.
If you need to add correct cookie handling if something was denied or allowed, contribute a js content to the container
datareporter.webcare.cookiebanner.allow-handling
or datareporter.webcare.cookiebanner.deny-handling
Configuration
- URL for the Webcache-Server, normally this is https://webcache-eu.datareporter.eu/c/ if the DataReporter-Suite is not self hosted
- Add Store configured language to the resource calls to override any other default language settings in DataReporter
- En-/Disabling of the Imprint-, Privacy Notice- and Cookie-Banner-Block to seperatelly controll if they are used
- En-/Disabling of Cookie Banner Custom Options, the default is no, as the standard method delivered by DataReporter are handling the denying of cookies quite well.
Example
- Widget selection within a CMS-Page/Block:
- Enhancing cookiebanner functions:
Create your own module or adapt your themes default.xml
and add following block instruction:
<referenceContainer name="datareporter.webcare.cookiebanner.allow-handling">
<block name="test-cookiebanner-allow" class="Magento\Framework\View\Element\Template" template="cookiebanner/test.phtml"/>
</referenceContainer>
<referenceContainer name="datareporter.webcare.cookiebanner.deny-handling">
<block name="test-cookiebanner-deny" class="Magento\Framework\View\Element\Template" template="cookiebanner/test.phtml"/>
</referenceContainer>
Content of test.phtml
:
console.log('current status for cookies('+chosenBefore+'): '+status);
This will output the status of the cookie banner user interaction and all according actions and adaptions can be made to comply with the GDPR according to cookies
Adding a custom redirect handling:
In the extended cookie banner with the corresponding selection of different pages (e.g. for languages) a callback function can be registered. This is used in Magento to correctly redirect the user to the according storeview with magento internal redirects (to correctly set and transfer data from one storeview to another). This feature can be activated in the configuration: Stores -> configuration -> DataReporter -> Settings -> WebCare -> Enable Cookie Banner custom redirect after consent
Custom behavior can be added by disabling the default block and adding a custom one with another logic:
<referenceContainer name="datareporter.webcare.cookiebanner.redirect-after-consent">
<block name="test-cookiebanner-redirects" class="Magento\Framework\View\Element\Template" template="cookiebanner/test.phtml"/>
</referenceContainer>
<referenceBlock name="datareporter.webcare.cookiebanner.storeswitch-redirect" remove="true"/>
Demo
Use following Demo-Credentials if you wanna try out the module, see Privacy -> Configuration
- Client-Id: 33f002cc-2586-42b6-987d-548b2953c7b8
- Organisation-Id: R5spy6ZYDqA