PHPackages                             pringuin/dataprivacybundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Templating & Views](/categories/templating)
4. /
5. pringuin/dataprivacybundle

ActivePimcore-bundle[Templating & Views](/categories/templating)

pringuin/dataprivacybundle
==========================

Dataprivacy Bundle for Pimcore

v2.8(1mo ago)123.5k3GPL-3.0-or-laterJavaScriptPHP ^8.0CI failing

Since May 15Pushed 1mo ago3 watchersCompare

[ Source](https://github.com/pringuin/dataprivacybundle)[ Packagist](https://packagist.org/packages/pringuin/dataprivacybundle)[ Docs](https://github.com/pringuin/dataprivacybundle)[ RSS](/packages/pringuin-dataprivacybundle/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (10)Dependencies (2)Versions (25)Used By (0)

Dataprivacy Bundle for Pimcore
==============================

[](#dataprivacy-bundle-for-pimcore)

Add dataprivacy features (GDPR / DSGVO) to Pimcore

> ℹ️ **Deprecation note** This project is for Pimcore 11 and if you do not use our Pimcore 11-lts version you already have security wholes in your pimcore instance. We will not update this bundle for Pimcore 12 due to licensing issues - we highly recommend switching to OpenDXP instead if you do not want to upgrade to pimcore 12. Our bundle is available for OpenDXP [here](https://github.com/pringuin/opendxp-dataprivacybundle)

Version 2.x can be used for Pimcore 11

Version 1.x can be used for Pimcore X, use Version 0.X for Pimcore 5/6. Note that 0.X and 1.X will not receive updates anymore.

Features
--------

[](#features)

- Does support multiple domains (using Pimcore sites)
- Easy installation in pimcore projects (drop-in-solution)
- Admin interface to configure trackers and tools
- Frontend with cookie and tracking consent features

[![Backend Interface](docs/img/localized_admin_interface.png)](docs/img/localized_admin_interface.png)

Dependencies
------------

[](#dependencies)

This bundle does include the [tarteaucitron.js](https://github.com/AmauriC/tarteaucitron.js) script in the `pringuin/DataprivacyBundle/Resources/public/js/tarteaucitron` folder.

Installation
------------

[](#installation)

### Composer Installation

[](#composer-installation)

1. Add code below to your `composer.json` or install it via command line

```
"require": {
"pringuin/dataprivacybundle" : "^2.0"
}
```

### Add the bundle

[](#add-the-bundle)

Add the bundle to your Kernel in src/Kernel.php like this:

```
public function registerBundlesToCollection(BundleCollection $collection): void
{
$collection->addBundle(new pringuinDataprivacyBundle(), 70);
}
```

You might also need to add it to pimcores config/bundles.php:

```
    \pringuin\DataprivacyBundle\pringuinDataprivacyBundle::class => ['all' => true],
```

### Install the assets

[](#install-the-assets)

After you have installed the Dataprivacy Bundle via composer:

- Execute: `$ bin/console assets:install`

### Configure trackers, tools and services

[](#configure-trackers-tools-and-services)

The backend configuration should now be available. below the search in your pimcore admin backend. You can set your tracking IDs (for example your UA-XXXXXXXX-X) there. This will generate files in the folder `PIMCOREINSTALLATION/config/pringuin_dataprivacy`. The file for the default site will be `siteconfig_default.yml`The next sites will follow the pimcore IDs and look like `siteconfig_1.yml`, `siteconfig_2.yml`. You can also change these files directly using your favorite IDE. They can be archived using git.

### Installation into your template

[](#installation-into-your-template)

To include the cookie consent into your frontend layout, you can use the following twig code. Simply insert it into your template (e.g. layout.html.twig) before the closing body Tag:

```
{{ render(controller('pringuin\\DataprivacyBundle\\Controller\\DefaultController::defaultAction', [])) }}
```

Hint: You can always override this template by implementing your own template in the folder `PIMCOREINSTALLATION/app/Resources/pringuinDataprivacyBundle/views/default/default.html.twig`

[![Default Frontend Interface](docs/img/frontend_locale_cookie_consent.png)](docs/img/frontend_locale_cookie_consent.png)

### Adaption of button colors

[](#adaption-of-button-colors)

You can always use your own css to override the default css of tarteaucitron. If you'd like to keep the default css but have all buttons in the same color (as required by TTDSG for example), you can use the following CSS:

```
html body #tarteaucitronRoot #tarteaucitron .tarteaucitronAllow, html body #tarteaucitronRoot #tarteaucitron .tarteaucitronDeny,
html body #tarteaucitronRoot #tarteaucitronAlertBig .tarteaucitronAllow, html body #tarteaucitronRoot #tarteaucitronAlertBig .tarteaucitronDeny, html body #tarteaucitronRoot #tarteaucitronAlertBig #tarteaucitronCloseAlert,
#tarteaucitronAlertBig #tarteaucitronCloseAlert, #tarteaucitronAlertBig #tarteaucitronPersonalize, .tarteaucitronCTAButton, #tarteaucitron #tarteaucitronPrivacyUrl, #tarteaucitron #tarteaucitronPrivacyUrlDialog, #tarteaucitronRoot .tarteaucitronDeny {
    background: black !important;
    color: white !important;
}
```

Supported Tackers and Tools
---------------------------

[](#supported-tackers-and-tools)

This package does currently ship with the following trackers/tools integrations:

- Crazy Egg
- eKomi
- eTracker
- Facebook Pixel
- Google Analytics (supporting different implementations)
- Google Adwords Remarketing
- Google Fonts
- Google Tag Manager
- Hubspot
- Matomo (formerly Piwik)
- Mautic
- Zopim
- YouTube
- Vimeo
- Dailymotion

Note that you'll take care of the implementation of your video brick to make YouTube, Vimeo and Daily Motion work.

Sample code by [breakone](https://github.com/breakone):

```
{% set autoplay = autoplay.isChecked() ? true : false %}
{% set loop = loop.isChecked() ? true : false %}
{% set mute = muted.isChecked ? true: false %}

{% set video = pimcore_video('video') %}

{% if video.getVideoType == 'youtube' %}

{% elseif video.getVideoType == 'vimeo' %}

{% elseif video.getVideoType == 'dailymotion' %}

{% else %}
  {{ video|raw }}
{% endif %}
```

### Add your own tracker or tool consent

[](#add-your-own-tracker-or-tool-consent)

If a tracker or tool is missing, please check if the tool is integrated into [tarteaucitron.js](https://github.com/AmauriC/tarteaucitron.js) first. You can do this using the source code or the official [tarteaucitron.js website](https://opt-out.ferank.eu/en/install/) using the installation guide.

If the tracker or tool **is not** included into the tarteaucitron.js package, please integrate it there first (they accept pull requests). Alternatively you can directly include your custom service using this example code from tarteaucitron.js:

```
tarteaucitron.services.mycustomservice = {
    "key": "mycustomservice",
    "type": "social|analytic|ads|video|support",
    "name": "MyCustomService",
    "needConsent": true,
    "cookies": ['cookie', 'cookie2'],
    "readmoreLink": "/custom_read_more", // If you want to change readmore link
    "js": function () {
        "use strict";
        // When user allow cookie
    },
    "fallback": function () {
        "use strict";
        // when use deny cookie
    }
};
(tarteaucitron.job = tarteaucitron.job || []).push('mycustomservice');
```

To get a tracker or tool which **is** included in the tarteaucitron.js package into this bundle, you'll have to do the following steps:

#### Add it to the default configuration

[](#add-it-to-the-default-configuration)

The default configuration is the base for all site specific configurations. Changes to the default configuration will also change your configuration files for the sites. The default configuration is located at Resources/var/defaultconfiguration.yml

#### Add the view output

[](#add-the-view-output)

The necessary code for the templates can be found in the [tarteaucitron.js installation instructions](https://opt-out.ferank.eu/en/install/) easily. Simply select Free manual installation and scroll down to the next step. Search for your service to get the installation code, typically looking like this:

```

    tarteaucitron.user.etracker = 'data-secure-code';
    (tarteaucitron.job = tarteaucitron.job || []).push('etracker');

```

Add it to the other codes in the `Resources/views/default/default.html.twig` file and replace dynamic parameters like the data-secude-code above with twig values as shown in the currently implemented trackers and tools.

#### Add a translation

[](#add-a-translation)

Finally add a backend translation entry in the file `Resources/translations/admin.en.yml` and/or `admin.de.yml`The key will be the same you used in the `defaultconfiguration.yml`. You can also append a `_helptext` to the key to insert a custom helptext for editors.

#### Final step

[](#final-step)

Test your implementation and please create a pull request in this repository so everybody can now use your newly implemented service, tracker or tool. Thanks!

Updating
--------

[](#updating)

### Updating from 1.0 to 2.0

[](#updating-from-10-to-20)

2.0 is the first release for Pimcore 11. Simply adapt your composer.json and run composer update as usually.

Execute: `$ bin/console assets:install` if it's not run by composer

You might also need to save your configuration again.

### Updating from 0.5 to 1.0

[](#updating-from-05-to-10)

1.0 is the first release for Pimcore X. Simply adapt your composer.json and run composer update as usually.

Since pimcore removed the pimcore\_action from the twig template, you'll have to adjust your template installation.

Before:

```
{{ pimcore_action('default', 'default', 'pringuinDataprivacyBundle', {}) }}
```

Now:

```
{{ render(controller('pringuin\\DataprivacyBundle\\Controller\\DefaultController::defaultAction', [])) }}
```

You might also need to save your configuration again.

### Updating from 0.4 to 0.5

[](#updating-from-04-to-05)

To update to 0.5 simply adapt your composer.json and run composer update as usually. Depending on your installation you might need to run the command `php bin/console assets:install web`to install the new tarteaucitron.js version (1.9.5 is now included) if you installed as hard copy. This release does also add a new defaultconfiguration setting. You might need to save your configuration again.

### Updating from initial version, 0.1, 0.2 or 0.3 to 0.4

[](#updating-from-initial-version-01-02-or-03-to-04)

To update from the first release or version 0.1/0.2 to 0.3 simply adapt your composer.json and run composer update as usually. Depending on your installation you might need to run the command `php bin/console assets:install web`to install the new tarteaucitron.js version (1.8.4 is now included) if you installed as hard copy.

Contributing
------------

[](#contributing)

While we consider this bundle stable and ready for productive use, we'd be very happy if you'd support us and the whole pimcore community by improving this bundle with pull requests. This is our first public pimcore bundle so constructive feedback would be very welcome as well!

Copyright and license
---------------------

[](#copyright-and-license)

Copyright: [PRinguin GbR](https://pringuin.de)
For licensing details please visit [LICENSE.md](LICENSE.md)

###  Health Score

55

—

FairBetter than 97% of packages

Maintenance91

Actively maintained with recent releases

Popularity28

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 91.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~107 days

Recently: every ~59 days

Total

22

Last Release

42d ago

Major Versions

v1.2 → v2.22024-05-13

v1.4 → v2.52025-07-04

v1.5 → v2.62025-11-14

v1.6 → v2.72026-01-26

v1.7 → v2.82026-07-08

PHP version history (2 changes)v0.1PHP ^7.0

v1.0PHP ^8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2771909?v=4)[Lennart Fries](/maintainers/Cruiser13)[@Cruiser13](https://github.com/Cruiser13)

---

Top Contributors

[![Cruiser13](https://avatars.githubusercontent.com/u/2771909?v=4)](https://github.com/Cruiser13 "Cruiser13 (34 commits)")[![breakone](https://avatars.githubusercontent.com/u/4848121?v=4)](https://github.com/breakone "breakone (1 commits)")[![HaaseIT](https://avatars.githubusercontent.com/u/7584444?v=4)](https://github.com/HaaseIT "HaaseIT (1 commits)")[![PRinguinDevs](https://avatars.githubusercontent.com/u/256159816?v=4)](https://github.com/PRinguinDevs "PRinguinDevs (1 commits)")

---

Tags

composerconsentcookiedataprivacy-bundlepimcoretrackertwigpimcoredataprivacy

### Embed Badge

![Health badge](/badges/pringuin-dataprivacybundle/health.svg)

```
[![Health](https://phpackages.com/badges/pringuin-dataprivacybundle/health.svg)](https://phpackages.com/packages/pringuin-dataprivacybundle)
```

###  Alternatives

[pimcore/skeleton

127202.6k](/packages/pimcore-skeleton)[coreshop/core-shop

CoreShop - Pimcore eCommerce

292207.3k12](/packages/coreshop-core-shop)[pimcore/data-importer

Adds a comprehensive import functionality to Pimcore Datahub

47889.0k6](/packages/pimcore-data-importer)[pimcore/studio-ui-bundle

Pimcore Studio Ui Bundle

30156.1k25](/packages/pimcore-studio-ui-bundle)[pimcore/studio-backend-bundle

Pimcore Studio Backend Bundle

20248.6k29](/packages/pimcore-studio-backend-bundle)[dachcom-digital/dynamic-search

Pimcore Dynamic Search Bundle

32160.5k5](/packages/dachcom-digital-dynamic-search)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)