Zum Hauptinhalt springen

Troubleshooting

HTTP 500 nach Aktivierung​

Symptom: Jede Seite des Shops liefert HTTP 500, direkt nach der Plugin-Aktivierung.

Ursache: Der Symfony-DI-Container konnte nach der Aktivierung nicht neu kompiliert werden — oder eine veraltete, inkompatible Plugin-Version wurde installiert.

Lösungen:

  1. Cache manuell leeren: 
    bin/console cache:clear
  2. Plugin-Version prüfen: Admin → Erweiterungen → Meine Erweiterungen → angezeigte Version mit der aktuellen Version vergleichen. Bei veralteter Version: deinstallieren, aktuelle ZIP-Datei hochladen und neu installieren.
  3. Fehlerlog prüfen: var/log/prod-YYYY-MM-DD.log im Shopware-Hauptverzeichnis — der Stack Trace zeigt die genaue Ursache.
  4. PHP-Fehlerlog des Servers (Apache/Nginx/FPM) prüfen.

Standard-Checkout statt One-Page-Checkout​

UrsacheLösung
Plugin deaktiviertAdmin → Erweiterungen → Aktivieren
„Checkout aktivieren" auf AUSPlugin-Konfiguration → Allgemein → Toggle einschalten
Cache veraltetCache leeren
Anderes Checkout-Plugin überschreibt TemplatesKonkurrierendes Plugin deaktivieren

Doppelter Header / Layout-Bruch​

Ursache: Ein zweites Plugin überschreibt dieselben Twig-Blöcke (checkout-header, checkout-footer oder _page.html.twig).

Lösung:

  1. Alle Checkout-bezogenen Plugins nacheinander deaktivieren, bis das Layout korrekt ist
  2. Das Konflikt-Plugin bleibt deaktiviert oder muss angepasst werden
  3. Danach Theme neu kompilieren: 
    bin/console theme:compile

Styles / CSS werden nicht geladen​

Symptom: Checkout-Layout erscheint ohne Formatierung oder mit falschem Styling.

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

Danach Browser-Cache leeren oder Inkognito-Fenster verwenden.

Floating Labels funktionieren nicht​

Symptom: Labels erscheinen nicht schwebend, oder Label und Placeholder-Text überlagern sich.

UrsacheLösung
Plugin nicht aktivAktivierungsstatus prüfen
JavaScript-FehlerBrowser-Devtools → Console-Tab prüfen
Drittanbieter-Plugin injiziert Felder nachträglichDHL-Plugin: enthält 1,2-Sekunden-Fallback — bei anderen Plugins Support kontaktieren
Theme-CSS überschreibt ::placeholderCSS-Spezifität prüfen

PayPal Express-Button erscheint nicht​

  • SwagPayPal installiert und aktiv?
  • API-Zugangsdaten in SwagPayPal hinterlegt und getestet?
  • „Express Checkout" in den SwagPayPal-Einstellungen aktiviert?
  • Plugin-Konfiguration: Allgemein → Express Checkout anzeigen = ✅?
  • Sandbox-Modus: im Sandbox-Modus sind andere Credentials erforderlich als im Live-Modus

Payment Icons werden nicht angezeigt​

  1. Zahlungsart hat kein Bild konfiguriert → generisches Kreditkarten-Icon erscheint als Fallback (kein Fehler)
  2. Bild zu groß / falsches Format → PNG oder SVG verwenden
  3. SVG ohne height-Attribut → Plugin setzt automatisch height: auto
  4. Cache nach Bild-Änderung leeren

Logo oder Farben werden nicht übernommen​

  1. Konfiguration gespeichert? (Speichern-Button geklickt)
  2. Cache geleert? (Einstellungen → Caches & Indizes → Alle leeren)
  3. Browser-Cache geleert? → Inkognito-Tab testen
  4. Logo-Datei: PNG oder SVG mit transparentem Hintergrund empfohlen

DHL Packstation: Felder ohne Floating Labels​

Das DHL-Plugin lädt seine Felder asynchron nach. Das Plugin enthält einen 1,2-Sekunden-Fallback-Timer, der nach dem initialen DOM-Load greift.

Falls Felder weiterhin nicht transformiert werden:

  • Shopware-Cache leeren
  • DHL-Plugin-Version prüfen
  • Support kontaktieren mit DHL-Plugin-Version und Shopware-Version

Versandmethoden fehlen oder werden nicht angezeigt​

  • Versandmethode in Shopware aktiv?
  • Verfügbarkeitsregeln (Rule Builder) korrekt konfiguriert?
  • Mindestbestellwert der Versandmethode erreicht?
  • Lieferland des Kunden in der Versandmethode erlaubt?
  • Test über Admin → Bestellungen → Bestellung erstellen (dort wird der Rule Builder ebenfalls ausgewertet)

Reservierungstimer läuft sofort ab​

Ursache: Sehr kurzes Server-Session-Timeout. Der Timer selbst läuft 10 Minuten — falls die Session kürzer ist, kann der Timer abweichen.

Lösung: Hosting-Provider oder Server-Konfiguration: session.gc_maxlifetime auf mindestens 3600 (Sekunden) setzen.

Oder: Timer in der Plugin-Konfiguration deaktivieren.

Gutscheincode wird abgelehnt​

  1. Gutschein-Feld in der Konfiguration aktiviert?
  2. Gutschein-Code gültig und nicht abgelaufen?
  3. Gutschein-Code im Standard-Shopware-Checkout testen — falls er dort auch nicht funktioniert, liegt der Fehler in der Shopware-Konfiguration, nicht im Plugin

Kontakt & Support​

E-Mail: info@qubix.de — Antwortzeit in der Regel innerhalb eines Werktags (DE und EN)

Bitte folgende Informationen mitschicken:

  • Shopware-Version
  • Plugin-Version
  • Fehlermeldung aus var/log/prod-YYYY-MM-DD.log
  • Screenshot des Fehlers
  • Liste aller aktiven Plugins