Skip to content

kitconcept/volto-dsgvo-banner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

d15ce58 · Oct 29, 2024

History

86 Commits
Jan 11, 2024
Feb 13, 2023
Oct 29, 2024
Feb 13, 2023
Oct 29, 2024
Jan 12, 2024
Jan 12, 2024
Apr 20, 2022
Sep 2, 2022
Feb 13, 2023
Jan 12, 2024
Mar 30, 2022
Mar 30, 2022
Jul 26, 2023
Jan 11, 2024
Mar 30, 2022
Mar 30, 2022
Apr 20, 2022
Mar 30, 2022
Oct 29, 2024
Jan 12, 2024
Mar 30, 2022
Jul 26, 2023
Oct 29, 2024

Repository files navigation

Volto DSGVO Banner

NPM Build Status Build Status Build Status

kitconcept GmbH

The Volto DSGVO Banner addon gives the user the possibility to accept certain cookies.

Screenshots

When you visit the website for the first time you will get the following overlay:

Accept

If you select "Adjust Privacy Settings" you can select which cookies you want to accept:

Settings

If you view a piece of content where you haven't accepted the cookie for you will be notified and have the option to change the cookies.

Message

There is also a block which you can insert on your data protection page to adjust the settings there.

Block

Installation

Create a new Volto project (you can skip this step if you already have one):

npm install -g yo @plone/generator-volto
yo @plone/volto my-volto-project --addon @kitconcept/volto-dsgvo-banner
cd my-volto-project

Add @kitconcept/volto-dsgvo-bannerto your package.json:

"addons": [
    "@kitconcept/volto-dsgvo-banner"
],

"dependencies": {
    "@kitconcept/volto-dsgvo-banner": "*"
}

Download and install the new add-on by running:

yarn install

Start Volto with:

yarn start

Go to http://localhost:3000, and the cookie confirmation screen will popup.

Compatibility

From 2.0.0 version on, it supports Google Analytics 4 and deprecates version 3. If you are still using GA3, you should use a version of this package of the 1.x.x series.

Version GA version
>=2.0.0 GA4
<2.0.0 GA3

Customization

You can customize your Google Analytics tracking id, the url where your privacy page is located and the modules you want to enable.

config.settings.DSGVOBanner = {
  ...(config.settings.DSGVOBanner || {}),
  trackingId: 'UA-123456789-1',
  modules: ['tracking', 'youtube', 'facebook'],
  privacy_url: '/privacy',
};

If you want to use Matomo instead of Google Analytics:

config.settings.DSGVOBanner = {
  ...(config.settings.DSGVOBanner || {}),
  tracker: {
    type: 'matomo',
    id: 3,
    urlBase: "https://matomo.example.com/"
  },
  modules: ['tracking', 'youtube', 'facebook'],
  privacy_url: '/privacy',
};

You can customize the style of the modal buttons

config.settings.DSGVOBanner.cssClasses = {
  bannerAgreeButton: "branded olive",
  bannerAdjustButton: "branded blue",
}

Or something like

config.settings.DSGVOBanner.cssClasses = {
  bannerAgreeButton: "red",
  bannerAdjustButton: "pink",
}

Keep in mind though, that the 'Adjust privacy Setting' Button will always stay inverted

By default, the banner to configure cookies will be shown in an overlay the first time a user visits the site. You can disable this by setting the useBanner setting to false. In this case, you must add the "DSGVO Banner" block to a page (such as a privacy settings page) to allow users to configure their cookies.

config.settings.DSGVOBanner.showBanner = false ;

You can also hide the greyed-out 'Technically required' option.

config.settings.DSGVOBanner.showTechnicallyRequired = false ;

Supported Modules

Per default only the 'tracking' , 'youtube' , 'facebook' and 'google' Modules are enabled. However, the following List contains all supported Modules :

  • 'tracking'
  • 'youtube'
  • 'facebook'
  • 'google'
  • 'twitter'
  • 'vimeo'

License

The project is licensed under the MIT license.