包简介

livewire cookie consent modals with laravel livewire

README 文档

README

This package is no longer actively maintained. This package was built for Laravel 9/10 with Jetstream and Livewire v2 (created in late 2022). While it may continue to work with current Laravel/Livewire versions, I'm not providing regular updates or bug fixes. Feel free to fork the repository if you need ongoing maintenance or want to contribute improvements.

👆 Consider upgrading to the new lightweight Laravel Cookie Consent Plugin instead!

🆕 Alternative: Simple GDPR Cookie Consent Available!

🚀 Try the lightweight Laravel Cookie Consent Plugin

Looking for something simpler? This alternative plugin offers:

✅ Framework-independent - no Laravel or JavaScript framework dependencies
✅ Ultra-lightweight - minimal footprint, maximum performance
✅ GDPR-compliant out-of-the-box - automatically blocks Google Analytics until consent
✅ Dead simple setup - just add your Google Analytics ID and you're done
✅ User-friendly modals - clean, responsive consent interface
✅ Persistent user control - footer link allows users to change preferences anytime

Perfect for projects that need straightforward cookie consent without complex dependencies or extensive configuration. Ideal if you want to get GDPR compliance up and running in minutes.

Laravel Livewire Cookie-Consent Modal

With this package there will be set no (Google Marketing & Analytics) Cookies on your website, until the user has accepted the Cookie Policy. (Except essential and funtionality cookies). All of this, because of the crazy EU Cookie Law.

Livewire Cookie Consent is a Livewire component that provides Opt-In Cookie Modals. The user can choose between

Essential and functional cookies
Analytical cookies
Marketing cookies

Special:

No Analytical or Marketing cookies are set before the Opt-In decision of the user (European laws).
User can open the modal with link in page-footer to reconfigure his cookie consent selections.
You can connect this component to Google Tag Manager if you want to. GTM example Script is included.
You can add in your Google Tag Manager triggers for every other Cookie, you wish to control.

Requirements

Laravel 9/10
Laravel Jetstream with Livewire v2
PHP 8.0+

Jetstream should only be installed into new Laravel applications. Attempting to install Jetstream into an existing Laravel application will result in unexpected behavior and issues

Installation

If you haven't installed Jetstream and Livewire

composer require laravel/jetstream

php artisan jetstream:install livewire

And now install the package

composer require martinschenk/livewire-cookie-consent

Register the package in /config/app.php

return [
    /*
     * Application Service Providers...
     */
    
    App\Providers\AppServiceProvider::class,
    ...
    Martinschenk\LivewireCookieConsent\CookieConsentModalServiceProvider::class,
    
];

Finalizing The Installation

After installing Jetstream, you should install and build your NPM dependencies and migrate your database:

npm install
npm run build
php artisan migrate

Include Livewire and vite directives

Include this into your welcome.blade.php, landing page or any other base template you use.

<html>
<head>
    ...
    @livewireStyles
    @vite(['resources/css/app.css', 'resources/js/app.js'])
</head>
<body>
    ...
    @livewireScripts
    @livewire('livewire-ui-modal')
    @include('livewire-cookie-consent::cookieconsent')
</body>
</html>

Include link

Normaly in the footer of your web-page, include this link. It will open the cookie modal to change preferences.

<a class='underline' href="#" 
   onclick="Livewire.emit('openModal', 'cookie-consent-edit')">
        {{ __('Cookie Config') }}
</a>

Publish the views and logo

The design is done with Tailwind. You can edit and adapt the files. You will find the views in resources/views/vendor/livewire-cookie-consent

php artisan vendor:publish --provider="Martinschenk\LivewireCookieConsent\CookieConsentModalServiceProvider" --tag="views"

Now it should work

Do just

   php artisan optimize:clear
   npm run dev

and you should see popup the modal if you reload your webpage.

Publish the rest if you want to

Dialog texts and languages

If you want to modify the text shown in the dialog you can publish the lang-files with this command:

php artisan vendor:publish --provider="Martinschenk\LivewireCookieConsent\CookieConsentModalServiceProvider" --tag="lang"

This will publish the f.e. english language file to lang/vendor/livewire-cookie-consent/en/texts.php .

return [
    'alert_accept' => 'Accept all cookies',
    'alert_essentials_only' => 'Accept only necessary cookies',
    'alert_settings' => 'Adjust your preferences',
    ...
];

Config file

Be careful changing the config values, because the Google Tag Manager is using them. Only change them if you know what you do.

php artisan vendor:publish --provider="Martinschenk\LivewireCookieConsent\CookieConsentModalServiceProvider" --tag="config"

This is the content of the published config-file. You'll find it in /config/livewire-cookie-consent.php

return 

    'cookie_name' => 'cookie-consent',

    'cookie_value_analytics' => '2',
    'cookie_value_marketing' => '3',
    'cookie_value_both' => 'true',
    'cookie_value_none' => 'false',

    'consent_cookie_lifetime' => 60 * 24 * 365,
    'refuse_cookie_lifetime' => 60 * 24 * 30,

];

Configure Google Tag Manager

If you want to use Google Tag Manager, you will find an example Container script for configuration of GTM here

Example Container for GTM:

{
    "exportFormatVersion": 2,
    "exportTime": "2022-11-25 20:49:55",
    "containerVersion": {
        "path": "accounts/6060538801/containers/95560929/versions/16",
        "accountId": "6060538801",
        "containerId": "95560929",
        "containerVersionId": "16",
        "name": "cookie consent v1.0",
        "container": {
            "path": "accounts/6060538801/containers/95560929",
            "accountId": "6060538801",
            "containerId": "95560929",
            "name": "www.vissit.io",
            "publicId": "GTM-YOUR-CODE",

You can import or merge this GTM Container into your GTM account. Here you can find the GTM Documentation for importing a Container. Its possible that you have to change the GTM-Code in the GTM Container to your own GTM-Code.

Once configured your Google Tag Manager, you have to insert the Google Tag Manager Code in the HEAD section of your website this way (between @livewireStyles and @vite...):

    @livewireStyles
    HERE THE GOOGLE TAG MANAGER CODE
    @vite(['resources/css/app.css', 'resources/js/app.js'])

Example:

<head>
    
    ...
    @livewireStyles 

    <!-- Google Tag Manager -->
    <script>
        window.dataLayer = window.dataLayer || [];
    </script>
    
    <script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
            new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
        j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
        'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
    })(window,document,'script','dataLayer','GTM-YOURKEY');</script>
    <!-- End Google Tag Manager -->

    @vite(['resources/css/app.css', 'resources/js/app.js'])
</head>

Replace GTM-YOURKEY with your Google Tag Manager Key.

Security

If you discover any security related issues, please email mschenk.pda@gmail.com instead of using the issue tracker.

Credits

This package is based on the one from spatie: https://github.com/spatie/laravel-cookie-consent and on statikbe: https://github.com/statikbe/laravel-cookie-consent

License

The MIT License (MIT). Please see License File for more information.

martinschenk/livewire-cookie-consent 适用场景与选型建议

martinschenk/livewire-cookie-consent 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 346 次下载、GitHub Stars 达 26，最近一次更新时间为 2022 年 12 月 04 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「laravel」「cookie」「modal」「consent」「cookie-consent」「livewire」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 martinschenk/livewire-cookie-consent 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 martinschenk/livewire-cookie-consent 我们能提供哪些服务？

定制开发 / 二次开发

基于 martinschenk/livewire-cookie-consent 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 martinschenk/livewire-cookie-consent 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

adigital/cookie-consent-banner 11

Add a configurable cookie consent banner to the website.

levmyshkin/micromodal 0

Fork from ghosh/Micromodal. Tiny, dependency-free javascript library for creating accessible modal dialogs.

sanzgrapher/filament-draggable-modal 18

Make Filament modals draggable.

yousefaman/filament-modal-repeater 17

A Filament form component that displays repeater items in a table with modal-based editing.

ahmed-hussain/hasmany-to-modal 1

A Laravel Nova field. To create a modal for creating or viewing related HasMany records without leaving the index page

antkaz/yii2-ajax 2

martinschenk/livewire-cookie-consent

包简介

关键字：