Lightweight Cookie Banner: setup and help
Quick start
- Upload the ZIP in Modules > Module Manager after resolving any active MPR Cookies Revolution conflict.
- Open Configure and keep Enable Cookie Banner on.
- Set Banner Position, Button Layout and Privacy Policy URL.
- Edit Banner text and button/link wording in every shop language.
- Review the appearance colors detected from your theme.
- Set Enable Google Consent Mode v2 and Default consent state, then save.
- In a fresh browser session, test Accept and Deny, inspect mprcookie_consent and reload.
Requires PrestaShop 1.6 or later and PHP 7.1 or later.
Setup manual
Install and open settings
- Check whether MPR Cookies Revolution is active. Installation refuses to proceed while that module is installed and enabled.
- Open Modules > Module Manager > Upload a module and upload the Lightweight Cookie Banner ZIP.
- Open Configure to reach Settings.
- Set your text and policy link, review appearance and consent settings, then save.
- Open the storefront in a browser without a saved consent choice and test Accept and Deny.
Requires PrestaShop 1.6 or later and PHP 7.1 or later.
General settings
| Setting | Installed default | What you do |
|---|---|---|
| Enable Cookie Banner | Yes | Turn off to suppress the banner and this module's Consent Mode emission. |
| Banner Position | Bottom Left Corner (bottom-left) |
Choose bottom, top, bottom-left, bottom-right, top-left, top-right, floating-bottom or center-modal. The last choice adds an overlay. |
| Button Layout | Side by Side (side-by-side) |
Choose stacked for Accept above Deny. accept-only hides the Deny button but keeps the close action as denial. |
| Cookie Expiry (days) | 365 | Set how long a newly saved choice lasts. Zero falls back to 365 in the browser script. This does not change an existing cookie's expiry. |
| Privacy Policy URL | Empty | Enter your policy URL. Leave empty to omit the link. |
Closing the notice records denial. Clicking the overlay in Center Modal also records denial.
Appearance
| Setting | Initial value | What it controls |
|---|---|---|
| Theme preset | dark |
The data-theme preset: dark, light or custom. Colors remain separately editable. |
| Banner background | Detected; fallback #232323 |
Banner background. |
| Banner text | Detected; fallback #f5f5f5 |
Message color, rather than the wording field with the same label. |
| Accept button background | Detected; fallback #2196f3 |
Accept fill and policy-link color. |
| Accept button text | Detected; fallback #ffffff |
Accept text color. |
| Deny button background | transparent |
Set a color or keep a text-style denial action. |
| Deny button text | Detected; fallback #cccccc |
Deny text color. |
On installation, the module reads theme CSS, including custom and theme CSS, Bootstrap properties and button/header rules. Detected theme colors take precedence over the fallback hex values. Change the settings after checking contrast in your store.
Google Consent Mode
| Setting | Default | What it does |
|---|---|---|
| Enable Google Consent Mode v2 | Yes | Emits the consent bootstrap and updates when this module owns Consent Mode emission. |
| Default consent state | Denied until accepted (denied) |
Used only without a valid saved choice. The alternative is Granted until denied (granted). |
The header bootstrap reads the browser's valid saved mprcookie_consent choice first. It uses that choice for the initial ad_storage, ad_user_data, ad_personalization and analytics_storage states. Without a valid cookie, it uses Default consent state. It initializes functionality_storage, personalization_storage and security_storage as granted.
Accept sends an update with the four ads and analytics states granted. Deny or close sends them denied. When the shared coordinator assigns Consent Mode to another owner, this module suppresses both its bootstrap and its updates; the settings page reports the owner.
The module records a choice and sends signals. It does not scan cookies, classify categories or automatically prevent every unrelated script from running. Configure your other scripts to respect the stored choice and consent signals.
Storefront behavior and verification
The module registers local assets through displayHeader and actionFrontControllerSetMedia. Banner markup uses displayFooter or displayFooterAfter, with a guard against duplicate rendering.
The markup is initially hidden. JavaScript shows it when there is no valid choice. Accept and Deny store granted or denied in mprcookie_consent on the shop host, with path=/, SameSite=Lax and Secure on HTTPS. A valid choice keeps the banner hidden on later visits until the cookie expires or is removed.
Test both choices in separate fresh sessions. Inspect the cookie and reload to verify the banner stays hidden. Inspect dataLayer to verify the initial state uses the saved choice and that clicking a button sends an update when this module owns Consent Mode.
If the banner does not appear, remove the consent cookie in your test browser, check Enable Cookie Banner, JavaScript errors and the footer hooks. Changing text or expiry does not invalidate visitors' existing choices. There is no policy-version setting or bulk consent-reset action in this module.
Integrate custom scripts and theme changes
The browser dispatches mprcookie:consent after a choice:
document.addEventListener('mprcookie:consent', function (event) {
if (event.detail.consent === 'granted') {
// Start your consent-dependent script here.
}
});
Also check the saved cookie when your custom script first starts. The event is not replayed on later pages for a visitor who already chose.
Use #mprcookiebanner, .mprcookie-policy-link, .mprcookie-accept and .mprcookie-deny for theme styling. Override markup at themes/your-theme/modules/mprcookiebanner/views/templates/hook/cookie-banner.tpl.
Disable or uninstall
Turn off Enable Cookie Banner to stop its output. Uninstall from Module Manager to remove its menu and module configuration. Uninstall does not clear cookies already stored in visitors' browsers. Existing tracking scripts belong to their own integrations and are not removed by this action.
Questions
1
Can I configure different Google Consent Mode defaults by country?
No. Lightweight Cookie Banner has one global default. When it owns Consent Mode output, it uses a valid saved choice first, otherwise your configured default. Accept grants the four ads and analytics states; Deny or close denies them. Functionality, personalization and security_storage start granted.
Known Issues
8
Saved consent applied too late
Banner startup failed on PrestaShop 1.6
PHP 7.1 loading compatibility
Missing storefront and administration assets
Module administration could fail to open
Banner assets incompatible with asset combining
Cookie banner did not appear
Missing translations
Feature Requests
5
Implemented
Theme-aware cookie banner
Multilingual consent configuration
Conflicting banner detection
Consent-mode coordination
Native default banner wording
Changelog
v1.2.152026-05-27
- AddedCertify cookie banner consent settings
- Addedcomplete FR/DE/ES/IT/PL translations
Older releases
v1.1.02026-04-20
- AddedV1.2.x — mutual exclusion with mprcookiesrevolution
- Addedself-healing integrity checks for automatic diagnostics and repair
- AddedLicense management tab with key management and renewal options
- Addedcomplete FR/DE/ES/IT/PL translations
v1.0.02026-01-20
- Initialrelease of Lightweight Cookie Banner
- InitialSimple cookie consent banner with Accept and Reject buttons
- InitialGoogle Consent Mode v2 integration: sends granted or denied signals to GTM before any tracking
- InitialConfigurable banner position: top bar, bottom bar, bottom-left corner, or bottom-right corner
- InitialCustomizable background color, text color, and button colors via back office
- InitialConsent preference stored in localStorage with configurable expiry in days
- InitialBanner auto-dismissed for returning visitors who have previously set a preference
- InitialMulti-language support for banner text, button labels, and optional privacy policy link
Demo
Test the full module before you buy
Buy a licence later and keep your settings.
- Your 30-day demo Test it on your own shop for 30 days from the first install.
- Ready demo shop Explore a ready demo shop in your browser.
- No registration No account, email or store domain needed.
By downloading, you accept the demo terms and privacy policy.
By opening this demo you accept the demo terms and the privacy policy.