mediengarage / piwik-consent-manager
Requires
- typo3/cms-core: ^10.4 || ^11.5
Requires (Dev)
- typo3/testing-framework: ^6.8
Replaces
- typo3-ter/piwik_consent_manager: 0.2.4
README

PIWIK Consent Manager TYPO3 扩展
PIWIK Consent Manager 集成,以便使 TYPO3 内容元素符合 GDPR。
您可以点击本 readme 中的图片查看大图。
🤔 它做什么?
而不是展示对隐私有害的内容,将显示一个占位符给用户。
只有当用户在 PIWIK Consent Manager 上给出同意后,页面才会重新加载并显示实际内容。
📦 安装
-
安装扩展
-
Composer
composer req mediengarage/piwik-consent-manager:~0.1
-
非 Composer
如果您想在非 Composer 的 TYPO3 中安装,建议使用 TER。您可以直接从您的 TYPO3 实例的扩展管理器中下载和安装。
-
-
将静态模板包含到您的根 TypoScript 模板中,并 点击保存
-
从管理工具下的设置模块导航到 配置扩展
-
输入您的 PIWIK Pro 凭据。检查第 5 步以了解从何处获取这些值。请保密!
-
登录到您的 PIWIK Pro 账户,并导航到菜单 -> 管理。选择您的网站并点击安装标签页。
🚀 快速入门
快速入门展示了如何嵌入一个只有在用户给出同意时才显示的 YouTube 视频。如果没有设置同意或已拒绝,将显示占位符。
为了有一个用于演示的基本网站,快速入门指南使用了 https://github.com/benjaminkott/bootstrap_package。
-
在页面上任何位置创建一个新的内容元素,并从新的隐私选项卡中选择 YouTube
-
将嵌入标记粘贴到文本区域,并选择一个应对此元素的同意类型。响应意味着当用户对这种类型给出同意时,它将显示。默认占位符图像可以在每个内容元素的图像选项卡中重写。
-
登录到您的 PIWIK Pro 账户,并导航到菜单 -> 标签管理器。为所选的同意类型(本例中的自定义同意)创建一个异步标签,以便在收到同意时重新加载页面。别忘了保存并发布(或调试以在生产系统上测试)。
<script> location.reload(); </script>
🤓 自定义 TypoScript 条件
例如,要基于是否设置了同意来嵌入基于 JavaScript 的内容,可以使用自定义的 TypoScript 条件。
[ConsentAspect('custom_consent')]
page.includeJSFooter {
foo = EXT:bar/Resources/Public/JavaScript/script.js
}
[GLOBAL]
🛣 路线图
- 我们目前正在开发一种使用 AJAX 而不是重新加载整个页面的解决方案。
- readme 明显处于建设中 :)