Zum Inhalt

Installation – Widerrufs-Button

Es gibt zwei Wege, das Plugin zu installieren – beide ergeben am Ende den gleichen aktiven Zustand. Welcher passt, hängt davon ab, ob Du den Shopware-Store-Kanal nutzt oder eine eigenständige ZIP einspielst.

Voraussetzungen

Punkt Anforderung
Shopware-Version 6.5.x, 6.6.x oder 6.7.x
PHP ≥ 8.1 (gleicher Stand wie Shopware)
Sales-Channel mindestens ein Storefront-Kanal mit konfigurierter Domain
Schreibrechte custom/plugins/, var/cache/, var/log/ (wie üblich)
Mail-Versand funktionierender Symfony-Mailer / Shopware-Mail (sonst keine Eingangsbestätigung)

Variante A: Über den Shopware Store (empfohlen)

Der Weg für Self-Hosted-Shops und Cloud-Shops gleichermaßen.

  1. Im Shop-Admin Erweiterungen → Im Store öffnen.
  2. Nach „Widerrufsbutton" suchen oder direkt zur Plugin-Store-Seite wechseln.
  3. Plan auswählen (monatlich oder jährlich) und kaufen.
  4. Im Admin unter Erweiterungen → Meine Erweiterungen den Widerrufsbutton finden und installieren.
  5. Nach der Installation: Plugin aktivieren (Schalter rechts oben).
  6. Shopware räumt anschließend automatisch den Cache, das Plugin ist sofort einsatzbereit.
Cloud-Shop?

Bei Shopware Cloud läuft der Store-Bezug identisch über das Erweiterungs-Modul. Composer-Aufrufe brauchst Du nicht – das Plugin enthält keine externen Abhängigkeiten.

Variante B: ZIP-Upload (für Test- oder Staging-Installationen)

Wenn Du eine spezielle Version testen möchtest oder die Installation außerhalb des Stores brauchst.

  1. ZIP-Datei beschaffen – entweder aus dem Store-Download-Bereich oder als direkter Lizenz-Download von kommora.de.
  2. Im Admin Erweiterungen → Meine Erweiterungen → Erweiterung hochladen.
  3. ZIP auswählen, hochladen.
  4. Plugin installieren und anschließend aktivieren.
  5. Per Console (Self-Hosted, optional): bin/console cache:clear.
CLI-Variante für Self-Hosted 
# ZIP nach custom/plugins/ entpacken
cd /var/www/shopware/custom/plugins
unzip /pfad/zu/KommoraWithdrawalButton-1.2.0.zip

# Plugin laden und aktivieren
cd /var/www/shopware
php bin/console plugin:refresh
php bin/console plugin:install --activate KommoraWithdrawalButton
php bin/console cache:clear

Update von einer Vorgänger-Version

Vorher Nachher Vorgehen
1.1.x 1.2.0 Standardweg über Store-Update. Neue DB-Spalte external_order_identifier wird via Migration automatisch ergänzt.
1.0.x 1.2.0 Gleicher Weg, mehrere Migrations laufen nacheinander. Vorab mysqldump empfohlen, weil State-Machine-Status withdrawn registriert wird.

Nach einem Update immer prüfen:

  • Plugin-Konfig ist noch da (Standardeinstellungen werden nicht überschrieben).
  • Mail-Templates sind unverändert (eigene Anpassungen bleiben erhalten).
  • Bestehende Widerrufe in der Liste sind sichtbar (keine Migration-Fehler).

Deinstallation

Das Plugin lässt sich sauber deinstallieren – mit oder ohne Datenerhalt.

Mit Datenerhalt (Standard)

Standardweg im Admin. Plugin wird deaktiviert und das Plugin-Verzeichnis entfernt – die Datenbank-Tabelle kommora_withdrawal mit allen Widerrufen bleibt erhalten. Wieder-Installieren stellt alles wieder her.

Mit kompletter Datenlöschung

Beim Deinstallieren das Häkchen „Daten löschen" setzen. Dann werden entfernt:

  • Tabelle kommora_withdrawal (alle Widerrufe)
  • Tabelle kommora_withdrawal_state_machine_history
  • Order-State-Machine-Eintrag withdrawn (sofern keine fremden Verweise mehr darauf bestehen)
  • Plugin-spezifische Einträge in system_config
  • Plugin-spezifische Mail-Templates (sofern unverändert)
Vor der Datenlöschung

Falls Du noch nicht abgeschlossene Widerrufe hast, exportiere sie vorher über das Admin-Modul als CSV.

Test nach der Installation

  1. Storefront der konfigurierten Sales-Channel-Domain im Browser öffnen.
  2. Bis ans Footer-Ende scrollen – der Widerrufs-Button erscheint dort.
  3. Klicken → das Widerrufsformular öffnet sich auf /kommora/withdrawal.
  4. Im Admin Einstellungen → System → Plugins → Widerrufsbutton öffnen und konfigurieren (Anleitung).

Wenn der Footer-Eintrag nicht erscheint:

  • Cache leeren: bin/console cache:clear
  • Bundle dumpen: bin/console bundle:dump
  • Storefront-Theme neu kompilieren: bin/build-storefront.sh

Detaillierter unter Troubleshooting.