hivedrops / hive-consent
本包旨在帮助您生成符合GDPR(通用数据保护条例)的cookie横幅。使用本包,您可以轻松地在网站上集成cookie横幅,确保在收集和管理用户个人数据方面的法律合规性。
1.2.1
2024-07-23 11:14 UTC
Requires
- php: ^8.0
- illuminate/support: *
README
Hive Consent包允许您向Laravel应用程序添加cookie同意横幅。该包易于使用,便于自定义。
特性
- cookie同意横幅
- 可自定义视图
- 可自定义配置
- 可自定义分析工具(默认:Google Analytics)
- 浅色和深色模式
- 多语言支持(英语和法语)
- 易于使用
如何升级
要升级到最新版本,只需一个命令!
composer update hivedrops/hive-consent
安装
先决条件
- PHP >= 7.2
- TAILWIND CSS >= 2.0
步骤1:通过Composer安装包
您可以通过composer安装此包
composer require hivedrops/hive-consent
步骤2:使用包
您可以通过添加以下代码在视图中使用此包
<head>
@include('hive-consent::hive-consent-script')
</head>
<body>
@include('hive-consent::hive-consent-banner')
{{-- Your code here --}}
</body>
可选:发布视图资产
如果您想自定义视图,可以发布视图
php artisan hive-consent:publish-views
在您的resources/views/vendor
目录中创建一个hive-consent
目录。
可选:发布配置文件
您可以使用环境变量中的变量编辑隐私政策和服务条款的URL
HIVE_CONSENT_URL="/cookie-policy" // You can change this to your own url HIVE_CONSENT_LANGUAGE="en" // You can change this for "fr" if you want to use the french version HIVE_CONSENT_GOOGLE_ANALYTICS="G-XXXXXXXXXX" // You can change this to your own Google Analytics ID
如果您想更改默认配置,可以发布配置文件
php artisan hive-consent:publish-config
可选:发布语言资产
如果您想自定义语言,可以发布语言
php artisan hive-consent:publish-lang
在您的resources/lang/vendor
目录中创建一个hive-consent
目录。
安装后使用
此包将使您能够在浏览器中生成cookie,因此您需要调整代码以考虑不同用户的选择。
以下是在会话中自动创建的cookie
cookies_accepted
:当用户接受cookie时,将创建此cookie。necessary_cookies
:当用户接受必要cookie时,将创建此cookie。analytics_cookies
:当用户接受分析cookie时,将创建此cookie。- 如果用户接受分析cookie,页面将添加Google Analytics脚本。请确保在
.env
文件中添加您的Google Analytics ID。
- 如果用户接受分析cookie,页面将添加Google Analytics脚本。请确保在
advertising_cookies
:当用户接受广告cookie时,将创建此cookie。
如果想要检查用户是否已接受cookie,可以使用以下代码
@if(request()->cookie('cookies_accepted') == true)
{{-- Your code here --}}
@endif
许可证
Hive Consent是开源包,许可协议为MIT License。
鸣谢
- Hivedrops - 网络开发公司