Deutsche Version

Back to overview

Klaro Cookie Consent: Troubleshooting

This documentation always describes the latest published version.

Known limitations

No API Platform endpoint: The consent logic (KlaroConfigBuilder) is currently wired for the Twig storefront only. A headless frontend (React, Vue, ...) would need to build its own consent UI, since the finished configuration is not reachable over the Shop API.

Only MySQL/MariaDB tested: The migrations are written with the Doctrine Schema API and carry no platform guard, but other databases have not been verified.

Troubleshooting

Banner does not appear on a channel

Symptom: No cookie banner, no footer link on a channel's storefront.

Check:

• Does this channel even have a row under MMKreativ Plugins > Klaro settings?
• Is enabled turned on for that row?
• Was bin/console mmd:klaro-consent:setup run after installation (do the tables exist)?

Solution: Create or enable the channel configuration, then clear the cache. If the tables are missing, run the setup command; until then the storefront silently renders nothing.

Setup command aborts

Symptom: bin/console mmd:klaro-consent:setup reports that prerequisite migrations are still open.

Check: bin/console doctrine:migrations:status for open Sylius core migrations.

Solution: Run bin/console doctrine:migrations:migrate for the open host/core migrations first, then call the setup command again.

Admin menu item "Klaro settings" is missing

Symptom: No entry for Klaro appears under "MMKreativ Plugins".

Check: Is the bundle registered in config/bundles.php? Are the admin routes imported (see Installation)?

Solution: Complete both steps, then run bin/console cache:clear.

Google Consent Mode does not behave as expected

Symptom: A Google tag appears to fire unchanged despite active Consent Mode.

Check: Is googleConsentMode enabled for this channel? Does the affected service have a purpose that is actually mapped (analytics, marketing, functional)? security and other are intentionally left unmapped. Is googleConsentModeWaitForUpdate active, in case the tag fires very early?

Solution: Correct the service's purpose, or enable googleConsentModeWaitForUpdate so Google tags wait the 500 ms delay for the first consent decision.

FAQ

General

What happens on a channel with no settings row?
It behaves as if the plugin were not installed: nothing loads, nothing renders.

How do I reopen the dialog from a custom place?
With a link whose href ends in #mmd-klaro-cookie-settings.

Configuration

How do I delete cookies on opt-out?
In the service's cookies field, one rule per line, optionally as pattern:path:domain.

Can a service apply to only some channels?
Yes, via the service's channel assignment; left empty it applies to all channels.

Compatibility

Does the plugin work headless, over the Shop API?
Not currently, see "Known limitations" above.

Which databases are supported?
Only MySQL 8 and MariaDB are tested.