PHPackages                             t3g/usercentrics - 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. t3g/usercentrics

ActiveTypo3-cms-extension

t3g/usercentrics
================

This extension provides a usercentrics integration into TYPO3.

10.0.4(5y ago)417.0k↓100%6[7 issues](https://github.com/TYPO3GmbH/ext-usercentrics/issues)[2 PRs](https://github.com/TYPO3GmbH/ext-usercentrics/pulls)GPL-2.0-or-laterPHPPHP ^7.2

Since Apr 28Pushed 10mo ago8 watchersCompare

[ Source](https://github.com/TYPO3GmbH/ext-usercentrics)[ Packagist](https://packagist.org/packages/t3g/usercentrics)[ Docs](https://extensions.typo3.org/extension/usercentrics/)[ RSS](/packages/t3g-usercentrics/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelog (4)Dependencies (6)Versions (14)Used By (0)

Usercentrics Integration for TYPO3
==================================

[](#usercentrics-integration-for-typo3)

This extension integrates Usercentrics (Compliance and Consent Management) into TYPO3.

Installation and Configuration
------------------------------

[](#installation-and-configuration)

1. Download and install the extension from the TER or via composer:

    - TER:
    - Composer: composer require t3g/usercentrics
2. Activate the extension in the extension manager
3. On every site where you want to use the extension, include the static TypoScript setup
4. Configure your Usercentrics ID by setting `plugin.tx_usercentrics.settingsId = ` in your TypoScript setup
5. Configure the JS Files to be handled by Usercentrics:

```
plugin.tx_usercentrics {
    settingsId = {$plugin.tx_usercentrics.settingsId}
    jsFiles {

        # Path to JS File (required)
        10.file = EXT:site/Resources/Public/JavaScriyt/MyScriptFile.js

        # Identifier to use in Usercentrics (required)
        10.dataProcessingService = My Data Processing Service

        20.file = secondFile.js
        20.dataProcessingService = My other Data Processing Service

        # attributes for the script tag (optional)
        20.attributes {
            async = async
        }

        # options for the TYPO3 AssetCollector
        # setting priority will render the script in the head instead of the footer section
        20.options {
            priority = 1
        }
    }

    jsInline {
      10.value (
        alert(123);
      )
      10.dataProcessingService = My Data Processing Service
      10.attributes {
        custom = attribute
      }
    }
}

```

Note that the configured identifiers need to match your Usercentrics configuration.

You do not need to set the `type` or `data-usercentrics` attributes for the script tags, the extension will handle that for you.

Usage in Fluid
--------------

[](#usage-in-fluid)

The extension comes with a custom view helper which can be used to add scripts via Fluid:

```

   alert('hello world');

```

Integrate Usercentrics with PHP
-------------------------------

[](#integrate-usercentrics-with-php)

Since TYPO3 v10 the AssetCollector is part of the TYPO3 Core API. To add scripts managed by Usercentrics via PHP, replace your previous calls to the `PageRenderer` with `AssetCollector` calls and make sure to set the attributes `type=text/plain` and `data-usercentrics=identifer`.

Example:

```
    $dataProcessingService = 'My Data Processing Service';
    $identifier = \TYPO3\CMS\Core\Utility\StringUtility::getUniqueId($dataProcessingService . '-');
    $file = 'EXT:site/Resources/Public/JavaScript/Scripts.js';
    $attributes = [
        'type' => 'text/plain',
        'data-usercentrics' => $dataProcessingService
    ];
    $assetCollector = GeneralUtility::makeInstance(AssetCollector::class);
    $assetCollector->addJavaScript($identifier, $file, $attributes);

```

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity32

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~27 days

Recently: every ~41 days

Total

12

Last Release

1905d ago

Major Versions

9.0.0 → 10.0.12020-08-06

9.0.1 → 10.0.22020-08-26

9.0.3 → 10.0.32020-09-10

PHP version history (2 changes)10.0.0PHP ^7.2

9.0.0PHP ^7.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/63373213aae432ce35282f7b1f0843556ca1127c9e2ea39dbeffd990c41c4427?d=identicon)[typo3com](/maintainers/typo3com)

---

Top Contributors

[![susannemoog](https://avatars.githubusercontent.com/u/321804?v=4)](https://github.com/susannemoog "susannemoog (16 commits)")[![andreaskienast](https://avatars.githubusercontent.com/u/1787983?v=4)](https://github.com/andreaskienast "andreaskienast (11 commits)")[![NeoBlack](https://avatars.githubusercontent.com/u/1128085?v=4)](https://github.com/NeoBlack "NeoBlack (6 commits)")[![benjaminkott](https://avatars.githubusercontent.com/u/3243119?v=4)](https://github.com/benjaminkott "benjaminkott (2 commits)")[![georgringer](https://avatars.githubusercontent.com/u/1905663?v=4)](https://github.com/georgringer "georgringer (1 commits)")

---

Tags

consentconsent-managementtypo3usercentrics

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/t3g-usercentrics/health.svg)

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

###  Alternatives

[netresearch/rte-ckeditor-image

Image support in CKEditor for the TYPO3 ecosystem - by Netresearch

63991.3k4](/packages/netresearch-rte-ckeditor-image)[christophlehmann/imageoptimizer

Optimize uploaded/processed images with binaries of your choice

46501.8k](/packages/christophlehmann-imageoptimizer)[b13/assetcollector

Add CSS and SVG files and strings as inline style tag/inline svg to the html code.

10118.4k](/packages/b13-assetcollector)[causal/fal-protect

Protect everything within /fileadmin/ based on associated folder and file restrictions (visibility, user groups and dates of publication).

1269.5k](/packages/causal-fal-protect)

PHPackages © 2026

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