FAQ & Troubleshooting

Häufige Fragen und konkrete Lösungswege.

Installation & Setup

Beim Installieren erscheint „SQLSTATE 1826 Duplicate foreign key constraint name“

Reste eines früheren Installations-Versuchs in der DB. Die aktuelle Migration räumt alte generische FK-Constraints (fk_set_project, fk_item_set) defensiv auf. Falls die ganze Tabelle samt FK noch vom Alt-Plugin existiert, manuell aufräumen:

DROP TABLE IF EXISTS sven_miet_booking, sven_miet_damage_log,
    sven_miet_set_status_log, sven_miet_project_status_log,
    sven_miet_set_item, sven_miet_set, sven_miet_project;

Danach bin/console plugin:install --activate SvenDasMiet erneut.

„EACCES: permission denied, mkdir /Resources/public“ beim Theme-Build

Der Container-User (z. B. www-data) hat keinen Schreibzugriff auf das Plugin-Verzeichnis. Lösung — Ordner vorab anlegen:

mkdir -p custom/plugins/SvenDasMiet/src/Resources/public
chmod 777 custom/plugins/SvenDasMiet/src/Resources/public

Plugin erscheint nicht im Admin-Hauptmenü

Plugin ist installiert, aber nicht aktiviert. Lösung:

bin/console plugin:activate SvenDasMiet
bin/console cache:clear

Customer-Bereich

Der Bookmark-Button erscheint nicht im Storefront

Mögliche Ursachen:

Plugin nicht aktiv im Sales-Channel — Erweiterungen → DasMiet → Konfiguration → enabled prüfen
Kunde nicht eingeloggt — Bookmark-Button gibt's nur für eingeloggte Kunden; nicht-Guests sehen einen Login-Link

Theme nicht neu kompiliert nach Twig-Änderung:

bin/console cache:clear
bin/console theme:compile

Datum-Felder erscheinen bei reiner Kauf-Liste

Das sollte nicht passieren. Prüfe, ob das Custom-Field sven_miet_is_rental bei allen Produkten der Liste konsistent auf false steht — und zwar in allen Sprach-Übersetzungen. CLI-Sync hilft:

bin/console sven-das-miet:set-rental-flag

Absenden funktioniert nicht: „Bitte ein Abholdatum angeben“

Mind. einer der Artikel in der Liste ist als Mietartikel markiert. Lösungen:

Datum eintragen, falls beabsichtigt
Oder den Mietartikel entfernen, falls eine reine Kaufanfrage gewollt ist
Oder das Custom-Field bei dem Artikel auf false stellen, falls es eigentlich kein Mietartikel sein soll

Liste hat unerwartet zwei „Sets“ statt einer

Trat in frühen 1.0.0-Versionen auf, wenn beim Quick-Add per Produktseite ein Doppel-Set angelegt wurde. Aktuell behoben. Bestehende Alt-Listen: leeres Set manuell aus sven_miet_set entfernen, oder die Liste löschen und neu anlegen.

Verfügbarkeit & Buchungen

Konflikt-Modal blockt das Absenden — auch wenn nichts überlappt

Wahrscheinliche Ursachen:

Pufferzeiten verlängern den belegten Zeitraum. Wenn eine andere Anfrage bis Freitag geht und der globale Nach-Puffer 2 Tage beträgt, ist das Equipment effektiv bis Sonntag belegt.
Alte „requested"-Buchungen vom Testen, die nie auf cancelled gesetzt wurden. Test-Reset:
```
bin/console sven-das-miet:reset --confirm
```
Flottenkapazität (product.stock) zu niedrig gesetzt. Bei stock = 1 ist nur eine parallele Vermietung möglich.

Kaufartikel werden bei der Verfügbarkeitsprüfung berücksichtigt

Sollte nicht passieren — Kaufartikel werden komplett übersprungen. Falls doch: prüfe ob sven_miet_is_rental = false in den Produkt-Custom-Fields gesetzt ist (und nicht nur leer). Im Zweifel:

bin/console sven-das-miet:set-rental-flag --all=false  # zunächst alle false
# Dann gezielt die echten Mietartikel im Admin auf true setzen

E-Mail-Versand

Status-Mails kommen nicht an

Mail-Versand in Shopware-Settings prüfen — Test-Mail aus dem Admin schicken
Mail-Templates unter „Einstellungen → E-Mail-Vorlagen" prüfen — sind die sven_miet_*-Templates vorhanden und aktiv?
Empfänger-Adresse in der Admin-Mail-Konfiguration prüfen

Mail-Templates wurden nach Plugin-Update überschrieben

Bekanntes Verhalten — beim Update werden Plugin-Templates mit den Default-Inhalten neu angelegt. Empfehlung für die Zukunft: vor dem Update über die Shopware-Standard-Funktion „E-Mail-Vorlagen → Exportieren" sichern, nach dem Update zurückimportieren.

Order-Erzeugung

Beim Bestätigen wird keine Order angelegt

Prüfen:

Plugin-Setting createOrderOnConfirm aktiv?
Falls Order-Anlage fehlschlägt: Warning im Admin-Detail sichtbar? → Fehlertext sagt meist, was fehlt (Zahlungsmethode, Versandart, Adresse)
Log-File var/log/dev.log bzw. var/log/prod.log nach Stack-Trace durchsuchen

Order hat falsche Preise (Tagesstaffel auf Kaufartikel)

Tritt in Versionen vor 1.0.0 noch auf. In 1.0.0 ist der Pricing-Branch eingebaut: Mietartikel rechnen mit Tagesstaffel × Tage × Menge, Kaufartikel mit Standard-Produktpreis × Menge. Falls doch fehlerhaft: Custom-Field-Wert beim betroffenen Produkt prüfen.

Sonstiges

Feiertage werden nicht berücksichtigt

Liste der Feiertage in der Plugin-Konfiguration prüfen oder per CLI anzeigen:

bin/console sven-das-miet:holidays

Falls leer: Import laufen lassen mit --import. Falls voll, aber bei Berechnung trotzdem ignoriert: Setting countHolidaysAsWorkingDays prüfen — falls auf true, werden Feiertage doch als Arbeitstage gewertet.

Scheduled Task läuft nicht

Cron muss eingerichtet sein. Manuell aktivieren:

bin/console scheduled-task:register
bin/console scheduled-task:list  # zeigt sven_miet_setlist.import_holidays

Cron-Konfiguration des Hosters prüfen — Shopware-Standard ist bin/console messenger:consume scheduler --time-limit=60 alle 1–5 Minuten.

Wo bekomme ich Support?

Per E-Mail an trogus@webdesignhamburg.net oder über das Kontaktformular. Reaktionszeit i. d. R. innerhalb von 2 Werktagen, bei kritischen Fehlern unverzüglicher Hotfix.

← Administration Weiter: Changelog →