hivedrops/hive-consent

本包旨在帮助您生成符合GDPR(通用数据保护条例)的cookie横幅。使用本包,您可以轻松地在网站上集成cookie横幅,确保在收集和管理用户个人数据方面的法律合规性。

安装: 16

依赖: 0

建议者: 0

安全: 0

星标: 0

关注者: 0

分支: 0

开放问题: 0

语言:Blade

1.2.1 2024-07-23 11:14 UTC

This package is auto-updated.

Last update: 2024-09-23 11:57:10 UTC


README

Hive Consent Banner

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。
  • advertising_cookies:当用户接受广告cookie时,将创建此cookie。

如果想要检查用户是否已接受cookie,可以使用以下代码

    @if(request()->cookie('cookies_accepted') == true)
        {{-- Your code here --}}
    @endif

许可证

Hive Consent是开源包,许可协议为MIT License

鸣谢