systemhaus / contao-cookiebot
Contao前端页面插入Cookiebot JS的包
Requires
- php: ^7.0 || ^8.0
- contao/core-bundle: ~4.4
Requires (Dev)
- contao/manager-plugin: ^2.0
- jakub-onderka/php-parallel-lint: ^1.0
- jakub-onderka/php-var-dump-check: ^0.3.0
- phpunit/phpcov: ^5.0
- slevomat/coding-standard: ~4.0
- squizlabs/php_codesniffer: ^3.2
Conflicts
- contao/core: *
- contao/manager-plugin: <2.0 || >=3.0
README
此Contao开源CMS扩展将Cookiebot的GDPR合规的cookie同意功能集成到网站前端。
注意:Cookiebot是一个付费解决方案。小型网站有免费计划,但条款可能随时更改。ETES不对Cookiebot服务负责,仅提供此扩展作为对社区的贡献。
先决条件
要在任何网站中使用Cookiebot,需要一个API密钥。您可以直接在Cookiebot注册或选择一个经销商。
特别说明:ETES将为通过我们购买Cookiebot订阅的每个用户提供许可证费用的百分比给Contao协会。更多信息。
安装
可以使用Contao Manager或composer安装此扩展。只需搜索“Cookiebot”或使用命令行
composer require systemhaus/contao-cookiebot
由于该扩展包含新的数据库字段,您需要通过Contao安装工具更新数据库。
工作原理
该扩展首先在您的网站源代码中加载Cookiebot JS。此脚本在用户同意之前阻止浏览器设置任何cookie。通过这样做,它符合欧盟立法(GDPR)和关于cookie的法院判决。
其次,像截图顶部所示的条形在网站内容上显示。此条的颜色和文本可以在线自定义。
该条包含用于网站上的不同类型cookie的交互式选择对话框。Cookiebot自动检测所有类型的cookie并将它们分类。对于每个cookie,用户都可以查看描述。
用户做出选择后,脚本将相应地允许或阻止cookie,条形消失。
对于以后更改用户的选择,应在网站的隐私页面上包含类似的表单。扩展为此提供了前端模块,可用于任何文章。
配置扩展
对于您的每个网站(页面结构中的根页面),您可以分别启用或禁用Cookiebot。Cookiebot需要API密钥才能运行。您可以在页面设置中输入此密钥。
如果密钥有效,Cookiebot条将自动显示在前端。您的密钥错误会在浏览器JavaScript控制台中显示。
如果您的网站包含法律或隐私页,您可以在其中包含Cookiebot前端模块。只需创建一个新的前端模块并将其插入到您选择的文章中。只有在您知道自己在做什么的情况下,才应在页面布局中包含前端模块!
如果您想手动进行cookie拦截,可以在页面设置中禁用自动cookie拦截。请阅读Cookiebot的手动实现指南,了解如何手动标记cookie设置脚本并在您的网站上正确实施Cookiebot。
如果您想设置固定语言,可以在页面设置中配置Cookiebot文化(两位或三位字母代码,例如en
)。请参阅支持说明。
Contao >= 4.8中的缓存
从Contao 4.8版本开始,新的页面缓存机制与旧版Contao版本对cookie的处理方式不同。为了使缓存按预期工作,Cookiebot的cookie CookieConsent
需要包含在该环境的全局允许列表中。需要手动操作。
有关详细信息,请参阅开发者文档中的COOKIE_ALLOW_LIST。
支持
作者:ETES GmbH和社区贡献者。非常感谢!
有关更多信息,请访问我们的网站。
有关错误,请在跟踪器中创建一个问题。