gesagtgetan/cookiedialogue

Simple cookie dialogue plugin. See settings to set path to imprint page


Keywords
neoscms, package, plugin
License
CNRI-Python-GPL-Compatible

Documentation

Latest Stable Version Total Downloads License

GesagtGetan.CookieDialogue

Simple cookie dialogue plugin. There's one Fusion prototype available: GesagtGetan.CookieDialogue:Component. This prototype include also the styles and the javascript.

Version Neos
2.* 2.*
3.* 3.* + 4.*
4.* 4.* + 5.* + 7.*

Installation

Most of the time you have to make small adjustments to a package (e.g. configuration in Settings.yaml). Because of that, it is important to add the corresponding package to the composer from your theme package. Mostly this is the site packages located under Packages/Sites/. To install it correctly go to your theme package (e.g.Packages/Sites/GesagtGetan.Theme) and run following command:

composer require gesagtgetan/cookiedialogue --no-update

To install the package under Neos 3.* you have to enter

composer require "gesagtgetan/cookiedialogue:^3.0" --no-update

To install the package under Neos 2.* you have to enter

composer require "gesagtgetan/cookiedialogue:^2.6" --no-update

The --no-update command prevent the automatic update of the dependencies. After the package was added to your theme composer.json, go back to the root of the Neos installation and run composer update. Et voilà! Your desired package is now installed correctly.

How to set it up

In most cases, you just have to define the search query in the Settings.yaml from your theme package like that:

GesagtGetan:
  CookieDialogue:
    findQuery: '[instanceof Your.Package:ImprintNodeType]'

If the plugin doesn't include the markup you have to add this line of code to your document prototype:

prototype(Your.Package:DocumentNodeType) {
    cookieDialogue = GesagtGetan.CookieDialogue:Component {
        @position = 'before closingBodyTag'
    }
}

Interact

The event ggCookieDialogClosed is fired whenever the dialog is accepted. This can happen through manual user interaction by clicking the button, but also happens on each page load when the dialog has been accepted before and is therefor closed automatically.

Example usage:

document.addEventListener('ggCookieDialogClosed', function() {
    // this code is only executed after the dialog has been accepted at least once
});