English Version

Zurück zur Übersicht

Sylius Media Alt Text: Installation

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

Installation

Composer (Packeton)

Private Repositories werden über Packeton verwaltet (https://packeton.markus-michalski.net). Zugangsdaten gibt es nach Lizenzkauf bzw. Freigabe.

Packeton als Repository in der composer.json eintragen:

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

composer require mmd/sylius-media-alt-text-plugin

Danach in dieser Reihenfolge:

1. Bundle in config/bundles.php registrieren:

   Mmd\SyliusMediaAltTextPlugin\MmdSyliusMediaAltTextPlugin::class => ['all' => true],
   

2. Admin-Route in config/routes/mmd_sylius_media_alt_text.yaml importieren:

   mmd_sylius_media_alt_text_admin:
       resource: "@MmdSyliusMediaAltTextPlugin/config/routes/admin.yaml"
   

3. Tabellen anlegen:

   bin/console mmd:media-alt-text:setup
   

Eigene Assets bringt das Plugin nicht mit, assets:install ist nicht nötig. Doctrine-Mapping, Migrationen, API-Platform-Mapping, Twig-Hooks, Template-Overrides und das Form-Theme registriert das Bundle selbst.

Der Setup-Befehl

mmd:media-alt-text:setup ersetzt doctrine:migrations:migrate. Er hat keine Optionen und tut Folgendes:

• führt nur die offenen Migrationen dieses Plugins aus, nichts von der App oder von anderen Plugins
• ist idempotent: Ohne neue Migration passiert nichts, er ist nach jedem composer update gefahrlos
• prüft, ob die Route aus Schritt 2 importiert ist, und gibt sonst den fertigen YAML-Schnipsel aus (er schreibt nie in config/)
• bricht ab, wenn Migrationen des Plugins anstehen, aber Migrationen von Sylius selbst noch offen sind, mit dem Hinweis, zuerst doctrine:migrations:migrate auszuführen
• übernimmt die Interaktivität des Aufrufs: Die Doctrine-Rückfrage vor dem Ausführen erscheint, in Skripten gibst Du --no-interaction mit

Ohne den Routen-Import in Schritt 2 fehlt der Menüeintrag im Admin. Die Sidebar bricht dabei nicht, der Eintrag wird einfach weggelassen.

Update

composer update mmd/sylius-media-alt-text-plugin
bin/console mmd:media-alt-text:setup
bin/console cache:clear

Deinstallation

Die Reihenfolge ist wichtig, die Migrationen müssen zurückgerollt werden, solange das Bundle noch registriert ist:

1. Eigene Templates entfernen, die mmd_image_alt aufrufen (sonst schlägt das Rendern ohne das Plugin fehl, siehe Storefront)

2. Migrationen zurückrollen, die neueste zuerst:

   bin/console doctrine:migrations:execute --down 'Mmd\SyliusMediaAltTextPlugin\Migrations\Version20261025110000'
   bin/console doctrine:migrations:execute --down 'Mmd\SyliusMediaAltTextPlugin\Migrations\Version20261025100000'
   

3. Routen-Import und Bundle-Eintrag entfernen

4. composer remove mmd/sylius-media-alt-text-plugin

Das Zurückrollen löscht alle gepflegten Alt-Texte und die Einstellung. Sichere die Tabellen vorher, wenn Du die Texte behalten willst.