A GDPR-compliant solution offering enterprise-grade compliance with fully customizable cookie banners for Laravel applications. Simplifies regulatory requirements while maintaining excellent user experience and complete customization capabilities.
- 🔥 One-Click Implementation – Simple installation via Composer with auto-loaded assets
- ⚡ Zero Performance Impact – Lightweight with lazy-loaded components
- 🌍 RTL & i18n Support – Full right-to-left compatibility + multilingual translations
- 🌙 Dark Mode Support – Auto dark/light mode matching system preferences
- 🛡 Granular Consent Control – Category-level cookie management (necessary/analytics/marketing)
- 📦 Complete Customization – Override every color, text, and layout via config
- 📱 Responsive Design – Perfectly adapts to all devices (mobile/tablet/desktop)
- 🧩 No Frontend Dependencies – No jQuery, Bootstrap, or Tailwind required — works everywhere effortlessly
To get started with Cookie Consent, follow these simple steps:
- Install the package via Composer:
composer require devrabiul/laravel-cookie-consent
- Publish the package resources by running: (Normal publish)
php artisan vendor:publish --provider="Devrabiul\CookieConsent\CookieConsentServiceProvider"
Include these components in your Blade templates:
- Add styles in the
<head>
section:
{!! CookieConsent::styles() !!}
- Add scripts before closing
</body>
:
{!! CookieConsent::scripts() !!}
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Your Page</title>
{!! CookieConsent::styles() !!}
</head>
<body>
<!-- Your content -->
{!! CookieConsent::scripts() !!}
</body>
</html>
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Your Page</title>
{!! CookieConsent::styles() !!}
</head>
<body>
<!-- Your content -->
{!! CookieConsent::scripts(options: [
'cookie_lifetime' => config('laravel-cookie-consent.cookie_lifetime', 7),
'reject_lifetime' => config('laravel-cookie-consent.reject_lifetime', 1),
'disable_page_interaction' => config('laravel-cookie-consent.disable_page_interaction', true),
'preferences_modal_enabled' => config('laravel-cookie-consent.preferences_modal_enabled', true),
'consent_modal_layout' => config('laravel-cookie-consent.consent_modal_layout', 'bar-inline'),
'flip_button' => config('laravel-cookie-consent.flip_button', true),
'theme' => config('laravel-cookie-consent.theme', 'default'),
'cookie_prefix' => config('laravel-cookie-consent.cookie_prefix', 'Laravel_App'),
'policy_links' => config('laravel-cookie-consent.policy_links', [
['text' => CookieConsent::translate('Privacy Policy'), 'link' => url('privacy-policy')],
['text' => CookieConsent::translate('Terms & Conditions'), 'link' => url('terms-and-conditions')],
]),
'cookie_categories' => config('laravel-cookie-consent.cookie_categories', [
'necessary' => [
'enabled' => true,
'locked' => true,
'js_action' => 'loadGoogleAnalytics',
'title' => CookieConsent::translate('Essential Cookies'),
'description' => CookieConsent::translate('These cookies are essential for the website to function properly.'),
],
'analytics' => [
'enabled' => env('COOKIE_CONSENT_ANALYTICS', false),
'locked' => false,
'title' => CookieConsent::translate('Analytics Cookies'),
'description' => CookieConsent::translate('These cookies help us understand how visitors interact with our website.'),
],
'marketing' => [
'enabled' => env('COOKIE_CONSENT_MARKETING', false),
'locked' => false,
'js_action' => 'loadFacebookPixel',
'title' => CookieConsent::translate('Marketing Cookies'),
'description' => CookieConsent::translate('These cookies are used for advertising and tracking purposes.'),
],
'preferences' => [
'enabled' => env('COOKIE_CONSENT_PREFERENCES', false),
'locked' => false,
'js_action' => 'loadPreferencesFunc',
'title' => CookieConsent::translate('Preferences Cookies'),
'description' => CookieConsent::translate('These cookies allow the website to remember user preferences.'),
],
]),
'cookie_title' => CookieConsent::translate('Cookie Disclaimer'),
'cookie_description' => CookieConsent::translate('This website uses cookies to enhance your browsing experience, analyze site traffic, and personalize content. By continuing to use this site, you consent to our use of cookies.'),
'cookie_modal_title' => CookieConsent::translate('Cookie Preferences'),
'cookie_modal_intro' => CookieConsent::translate('You can customize your cookie preferences below.'),
'cookie_accept_btn_text' => CookieConsent::translate('Accept All'),
'cookie_reject_btn_text' => CookieConsent::translate('Reject All'),
'cookie_preferences_btn_text' => CookieConsent::translate('Manage Preferences'),
'cookie_preferences_save_text' => CookieConsent::translate('Save Preferences'),
]) !!}
</body>
</html>
Add theme="dark"
to your <body>
tag to automatically enable dark mode.
<body theme="dark">
Add dir="rtl"
to your <body>
tag to enable right-to-left layout for RTL languages.
<body dir="rtl">
COOKIE_CONSENT_ENABLED=true
COOKIE_CONSENT_PREFERENCES_ENABLED=true
COOKIE_CONSENT_ANALYTICS=true
COOKIE_CONSENT_MARKETING=true
COOKIE_CONSENT_PREFERENCES=true
box
- Compact floating dialogbox-inline
- Inline positioned boxbox-wide
- Expanded floating dialogcloud
- Modern floating designcloud-inline
- Compact cloud variantbar
- Top/bottom bannerbar-inline
- Compact banner
Default: box-wide
bar
- Full-width layoutbox
- Centered popup
Default: bar
Edit config/cookie-consent.php
to modify:
- Cookie lifetimes
- Visual styles
- Text content
- Category settings
function loadGoogleAnalytics() {
// Please put your GA script in loadGoogleAnalytics()
// You can define function name from - {!! CookieConsent::scripts() !!}
window.dataLayer = window.dataLayer || [];
function gtag() {
dataLayer.push(arguments);
}
gtag('js', new Date());
gtag('config', 'YOUR_GA_ID');
// Load the GA script
const script = document.createElement('script');
script.src = 'https://www.googletagmanager.com/gtag/js?id=YOUR_GA_ID';
script.async = true;
document.head.appendChild(script);
}
function loadFacebookPixel() {
// Please put your marketing script in loadFacebookPixel()
// You can define function name from - {!! CookieConsent::scripts() !!}
!function (f, b, e, v, n, t, s) {
if (f.fbq) return;
n = f.fbq = function () {
n.callMethod ?
n.callMethod.apply(n, arguments) : n.queue.push(arguments)
};
if (!f._fbq) f._fbq = n;
n.push = n;
n.loaded = !0;
n.version = '2.0';
n.queue = [];
t = b.createElement(e);
t.async = !0;
t.src = v;
s = b.getElementsByTagName(e)[0];
s.parentNode.insertBefore(t, s)
}(window, document, 'script',
'https://connect.facebook.net/en_US/fbevents.js');
fbq('init', 'YOUR_PIXEL_ID');
fbq('track', 'PageView');
}
To comply with UK ICO and GDPR regulations, users must be able to revisit and update their cookie preferences at any time. This package now supports that functionality out of the box.
You can add a link anywhere on your site to let users open the cookie preferences modal again and update their choices:
<a onclick="showHideToggleCookiePreferencesModal()">Change Cookie Preferences</a>
Or use the class-based approach (useful if you want to attach event handlers via JavaScript or multiple links):
<a class="showHideToggleCookiePreferencesModal">Change Cookie Preferences</a>
- Clicking the link will show the cookie preferences modal, allowing the user to change their settings.
- This feature resets the consent banner/modal visibility so users can modify their choices in compliance with the ICO’s requirement.
- The modal respects existing preferences but allows full customization and saving new preferences.
This package is designed to help your Laravel application meet the requirements of the UK Information Commissioner’s Office (ICO) and the GDPR by:
- Providing explicit, granular cookie consent with customizable categories (e.g., necessary, analytics, marketing, preferences).
- Allowing users to easily revisit and change their cookie preferences at any time using the “Change Cookie Preferences” link.
- Supporting clear cookie banners and modals with translations and accessibility considerations.
- Enabling consent logging and event dispatching for auditing and analytics purposes.
For more details, please review the UK ICO guidance on cookies: ICO Guide to Cookies and Similar Technologies
Experience the magic of CookieConsent and enhance your Laravel applications with Cookie Consent.
🔗 GitHub: Laravel Cookie Consent
🔗 **Packagist:
** https://packagist.org/packages/devrabiul/laravel-cookie-consent
We welcome contributions to CookieConsent! If you would like to contribute, please fork the repository and submit a pull request. For any issues or feature requests, please open an issue on GitHub.
Please:
- Fork the repository
- Create your feature branch
- Submit a pull request
This package is open-sourced software licensed under the MIT license.
This package is Treeware. If you use it in production, then we ask that you buy the world a tree to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.
For support or inquiries, please reach out to us at Send Mail.