t3g/symfony-usercentrics-bundle

Integration of usercentrics.com for Symfony

2.0.0 2024-09-09 08:05 UTC

Requires

• php: ^8.0
• symfony/dependency-injection: ^5.4 || ^6.4
• symfony/twig-bundle: ^5.4 || ^6.4

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.0
• overtrue/phplint: ^3.0 || ^4.0 || ^5.0
• symfony/phpunit-bridge: ^5.4 || ^6.4

MIT

README

This bundle provides a usercentrics.com implementation into Symfony.

Installation

Install this bundle via composer: composer req t3g/symfony-usercentrics-bundle

Configuration

Create a file config/packages/usercentrics.yaml that contains the following configuration:

usercentrics:
  id: xxxxxxxxx

Usage in Templates

At first, the usercentrics main library must be included. For this, the Twig function usercentrics() may be invoked without any additional arguments:

{{ usercentrics() }}

After that, additional Data Service Providers (DSP) may be included as well. See the following example for Google Analytics:

{{ usercentrics('Google Analytics', {async: true, src: 'https://www.googletagmanager.com/gtag/js?id=UA-XXXXXXXX-X'}) }}
{{ usercentrics(
    'Google Analytics',
    {},
    '
        window.dataLayer = window.dataLayer || [];
        function gtag(){dataLayer.push(arguments);}
        gtag(\'js\', new Date());

        gtag(\'config\', \'UA-XXXXXXXX-X\');
    '
) }}