English Version

Zurück zur Übersicht

Klaro Cookie Consent: Installation

Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.

Installation

Hinweis: Dieses Plugin ist kommerziell und wird ausschließlich über Packeton verteilt (https://packeton.markus-michalski.net). Zugangsdaten erhältst du nach Lizenzkauf.

{ "repositories": [{ "type": "composer", "url": "https://packeton.markus-michalski.net" }] }

composer require mmd/sylius-klaro-consent-plugin

Danach, immer in dieser Reihenfolge:

1. Bundle registrieren in config/bundles.php:

   Mmd\SyliusKlaroConsentPlugin\MmdSyliusKlaroConsentPlugin::class => ['all' => true],
   

2. Admin-Routen importieren (die Storefront-Banner bringen keine eigenen Routen mit, nur der Admin-Bereich braucht einen Import):

   mmd_sylius_klaro_consent_admin:
       resource: "@MmdSyliusKlaroConsentPlugin/config/routes/admin.yaml"
   

3. Setup-Command ausführen:

   bin/console mmd:klaro-consent:setup
   

   Was der Befehl tut:
   • führt nur die noch offenen Migrationen dieses Plugins aus und legt dabei mmd_sylius_klaro_consent_service (+ Übersetzungstabelle, + Channel-Zuordnung) sowie mmd_sylius_klaro_channel_configuration an
   • ist idempotent: sind keine neuen Migrationen offen, meldet er das und ändert nichts
   • bricht ab, wenn Sylius-Core-Migrationen noch offen sind, mit dem Hinweis, zuerst doctrine:migrations:migrate auszuführen
   • prüft, ob die Admin-Routen aus Schritt 2 importiert sind, und gibt nur einen Hinweis aus, falls nicht; er schreibt nie selbst in config/
4. Assets installieren:

   bin/console assets:install public
   

Admin-Grids, Twig-Hooks und das Doctrine-Mapping registriert das Bundle selbst im Host-Container, dafür ist kein weiterer Import nötig.

Fehlen die Tabellen trotzdem, etwa weil der Setup-Command übersprungen wurde, rendert die Storefront kommentarlos keinen Banner und schreibt eine Warnung ins Log, statt mit einem Fehler abzubrechen.

Update

composer update mmd/sylius-klaro-consent-plugin

Danach den Setup-Command erneut ausführen (idempotent, siehe oben) und den Cache leeren:

bin/console mmd:klaro-consent:setup
bin/console cache:clear

Migrationen

Der Setup-Command führt ausschließlich die drei eigenen Migrationen dieses Plugins aus, nie die des Host-Projekts oder anderer Plugins. Das globale doctrine:migrations:migrate bleibt nutzbar und wird nur gebraucht, wenn der Setup-Command meldet, dass Sylius-Core-Migrationen noch offen sind.

Deinstallation

1. Eigene Overrides von Hooks/Templates entfernen, falls vorhanden
2. Migrationen zurückrollen, solange das Bundle noch registriert ist, neueste zuerst:

   bin/console doctrine:migrations:execute --down "Mmd\SyliusKlaroConsentPlugin\Migrations\Version20261003090000"
   bin/console doctrine:migrations:execute --down "Mmd\SyliusKlaroConsentPlugin\Migrations\Version20261002101014"
   bin/console doctrine:migrations:execute --down "Mmd\SyliusKlaroConsentPlugin\Migrations\Version20261002100417"
   

3. Den Routen-Import aus Schritt 2 und den Bundle-Eintrag aus config/bundles.php entfernen
4. composer remove mmd/sylius-klaro-consent-plugin