The package includes a script & styling for a cookie banner and a modal where the visitor can select his/her cookie preferences.
This package is mainly based on the one from spatie: https://github.com/spatie/laravel-cookie-consent
With the only exception that you can choose which cookies you enable. This only works when Google Tag Manager is correctly configured (some regex config based on the value set in the cookie).
- Upgrading
- Installation
- Usage
- Customizing the dialog texts
- Configure Google Tag Manager
- Security
- License
You can install the package via composer:
composer require infernalmedia/laravel-cookie-consent
The package will automatically register itself.
php artisan vendor:publish --provider="Infernalmedia\CookieConsent\CookieConsentServiceProvider" --tag="public" --tag="config"
Edit app/Http/Kernel.php
class Kernel extends HttpKernel
{
protected $middleware = [
// ...
\Infernalmedia\CookieConsent\CookieConsentMiddleware::class,
];
// ...
}
First of all you need to publish the javascript and css files:
php artisan vendor:publish --provider="Infernalmedia\CookieConsent\CookieConsentServiceProvider" --tag="public"
Instead of including a snippet in your view, we will automatically add it. This is done using middleware using two methods:
- The first option: include it in your entire project using the kernel:
// app/Http/Kernel.php
class Kernel extends HttpKernel
{
protected $middleware = [
// ...
\Infernalmedia\CookieConsent\CookieConsentMiddleware::class,
];
// ...
}
- The second option: include it as a route middleware and add this to any route you want.
// app/Http/Kernel.php
class Kernel extends HttpKernel
{
// ...
protected $routeMiddleware = [
// ...
'cookie-consent' => \Infernalmedia\CookieConsent\CookieConsentMiddleware::class,
];
}
// routes/web.php
Route::group([
'middleware' => ['cookie-consent']
], function(){
// ...
});
This will add cookieConsent::head
to the content of your response right before the closing head tag.
This will add cookieConsent::index
to the content of your response right before the closing body tag.
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="Infernalmedia\CookieConsent\CookieConsentServiceProvider" --tag="lang"
This will publish this file to resources/lang/vendor/cookieConsent/en/texts.php
.
return [
'alert_title' => 'Deze website gebruikt cookies',
'setting_analytics' => 'Analytische cookies',
];
If you want to translate the values to, for example, English, just copy that file over to resources/lang/vendor/cookieConsent/fr/texts.php
and fill in the English translations.
If you need full control over the contents of the dialog. You can publish the views of the package:
php artisan vendor:publish --provider="Infernalmedia\CookieConsent\CookieConsentServiceProvider" --tag="views"
This will copy the index
view file over to resources/views/vendor/cookieConsent
.
The cookie-settings
view file is just a snippet you need to place somewhere onto your page. Most preferably in the footer next to the url of your cookie policy.
<a href="javascript:void(0)" class="js-lcc-settings-toggle">@lang('cookie-consent::texts.alert_settings')</a>
This gives your visitor the opportunity to change the settings again.
php artisan vendor:publish --provider="Infernalmedia\CookieConsent\CookieConsentServiceProvider" --tag="config"
This is the contents of the published config-file: This will read the policy urls from your env.
return [
'cookie_key' => '__cookie_consent',
'cookie_value_analytics' => '2',
'cookie_value_marketing' => '3',
'cookie_value_both' => 'true',
'cookie_value_none' => 'false',
'cookie_expiration_days' => '365',
'gtm_event' => 'pageview',
'ignored_paths' => [],
'policy_url_en' => env('COOKIE_POLICY_URL_EN', null),
'policy_url_fr' => env('COOKIE_POLICY_URL_FR', null),
'policy_url_nl' => env('COOKIE_POLICY_URL_NL', null),
'facebook_pixel_code' => env('FACEBOOK_PIXEL_CODE', null),
];
You can customize some settings that work with your GTM and Facebook Pixel.
If you don't want the modal to be shown on certain pages you can add the relative url to the ignored paths setting. This also accepts wildcards (see the Laravel Str::is()
helper).
'ignored_paths => ['/en/cookie-policy', '/api/documentation*'];
php artisan vendor:publish --provider="Infernalmedia\CookieConsent\CookieConsentServiceProvider" --tag="lang"
php artisan vendor:publish --provider="Infernalmedia\CookieConsent\CookieConsentServiceProvider" --tag="views"
All the steps to configure your Google Tag Manager can be found here.
Please see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.