Die Installation dauert nur ein paar Minuten und läuft komplett in der Shopware-Administration ab – ohne Programmierung. Wenn du das Plugin schon im Shopware Store gekauft hast, ist der erste Teil sogar automatisch erledigt.

Schritt für Schritt in der Administration

Melde dich in deiner Shopware-Administration an (der Adminbereich deines Shops, meist unter …/admin).
Öffne links im Menü Erweiterungen → Meine Erweiterungen.
Suche in der Liste Alt-Text Optimizer Pro.
- Hast du das Plugin über den Shopware Store gekauft, erscheint es hier automatisch. Klicke auf Installieren.
- Hast du eine .zip-Datei von uns erhalten, klicke zuerst oben auf Erweiterung hochladen, wähle die Datei aus und installiere sie dann.
Schiebe nach der Installation den Schalter beim Plugin auf „an“, um es zu aktivieren.

Das war’s – das Plugin ist jetzt einsatzbereit.

Nach der Aktivierung findest du die Einstellungen über das …-Menü (drei Punkte) neben dem Plugin unter Konfiguration. Den dort benötigten OpenAI-Schlüssel richtest du im nächsten Schritt ein.

Wo finde ich das Plugin nach der Installation?

Alt-Text Optimizer Pro bekommt einen eigenen Menüpunkt. Du erreichst ihn in der Administration unter Inhalte → Alt-Text Optimizer Pro. Dort generierst du später deine Alt-Texte. Wie das genau funktioniert, steht im Kapitel Alt-Texte generieren.

Was bei der Installation im Hintergrund passiert

Beim Installieren legt das Plugin ein unsichtbares Markierungsfeld an (ai_alttext_generated). Damit merkt sich Shopware, welche Alt-Texte von der KI erstellt wurden – so kannst du diese später jederzeit gesammelt wiederfinden, prüfen oder neu generieren. Bereits vorhandene Alt-Texte bleiben dabei unverändert.

Ohne gültigen OpenAI-Schlüssel kann das Plugin noch keine Alt-Texte erzeugen. Richte als Nächstes deinen OpenAI API-Key ein – das ist der einzige Schritt, der einmalig etwas Vorbereitung braucht.

Für Entwickler: Installation über die Konsole

Diesen Abschnitt brauchst du nur, wenn du das Plugin per Kommandozeile auf dem Server einspielst (z. B. in einem Deployment). Für den normalen Betrieb ist er nicht nötig.

Lege das Plugin unter custom/plugins/VioveAltTextOptimizerPro ab (oder installiere es via Composer) und führe aus:

# Plugin-Liste aktualisieren
bin/console plugin:refresh

# Plugin installieren und aktivieren
bin/console plugin:install --activate VioveAltTextOptimizerPro

# Caches leeren
bin/console cache:clear

Damit die Administration die neuen Oberflächen-Elemente kennt, baue anschließend das Admin-Bundle neu:

bin/build-administration.sh