Download the PHP package edulazaro/wirecookies without Composer

Wirecookies

Drop-in cookie consent banner and preferences modal for Laravel, Livewire and Alpine. Pure CSS, no Tailwind. Themeable through the wire* family CSS variables, so it shares its look with wiremodal and wiretoast. GDPR / AEPD friendly: granular categories, re-openable preferences, multilingual, and it tracks nothing of its own.

Requirements

• PHP 8.2+
• Laravel 11 or 12
• Alpine.js (already shipped with Livewire)
• edulazaro/wiremodal — pulled in automatically; it powers the preferences modal and provides the shared theme tokens.

Features

• Bottom banner and an accessible preferences modal from a single <x-wirecookies /> tag.
• Granular categories (essential always on; analytics / marketing / functional opt-in), persisted in localStorage.
• Re-openable: a floating button lets users change or withdraw consent at any time (AEPD requirement).
• Works standalone with a clean light default; optionally set data-wire-theme (with wiremodal/wiretoast loaded) and it adopts that theme so banner, modal and toasts match.
• Multilingual: ships Spanish and English; every string is translatable and overridable per prop.
• Configurable policy link: a single URL or one per locale.
• Emits a wirecookies-saved event and writes a plain localStorage object you can read from anywhere.

Install

The service provider is auto-discovered.

Wirecookies ships a single stylesheet (wirecookies.css) and no JS of its own — it relies on Alpine and on wiremodal's JS for the modal.

Styles (Vite)

Import the stylesheet from your resources/css/app.css, after a wire* family base (wiremodal or wiretoast) that defines the theme tokens:

Bundle wiremodal's JS too (needed to open/close the preferences modal):

Prefer a copy you can edit? Publish the CSS into your app and @import that instead:

Publish config, translations and views (optional)

Usage

Drop the component once, near the end of your layout:

First-time visitors get the banner. Once they choose, the banner is replaced by a floating button that reopens the preferences modal.

Theming

Wirecookies styles itself: its CSS ships sensible light defaults, so it looks right on its own with nothing else loaded. Each token is also wired to the shared --wire-* family variables, so if you set data-wire-theme on a parent — with wiremodal or wiretoast loaded, since they define those variables — wirecookies automatically adopts that theme and matches your modals and toasts:

Without it, the built-in defaults apply. Wirecookies doesn't ship its own named theme catalog — it borrows the family's. See wiremodal/wiretoast for the available themes.

Configuration

Edit config/wirecookies.php after publishing it:

Reading consent

Preferences are a plain object in localStorage, and they are broadcast whenever the user saves:

Internationalization

Wirecookies ships Spanish (es) and English (en). Strings follow app()->getLocale() and fall back to app.fallback_locale.

• Override one string at render time by passing the matching prop (:title, :accept-all, …).

• Customize the bundled copy by publishing the translations:

  Then edit lang/vendor/wirecookies/{locale}/wirecookies.php. Add a new language by creating its file in the same folder.

Component props

All props are optional. Text props default to the translation; pass one to override it for that render.

Sponsors

Wirecookies is supported by the following sponsors. Thank you for keeping it growing:

Kenodo     AndorraDev

Author

Created by Edu Lazaro

License

Wirecookies is open-sourced software licensed under the MIT license.