Ctrlk
FreeThemeSupport
For the complete documentation index, see llms.txt. This page is also available as Markdown.
Als PDF exportieren

Fehlerbehebung

Wenn du auf ein Problem in deinem Shop stößt, ist es wichtig, zunächst die Fehlerquelle einzugrenzen, bevor du den Support kontaktierst. Viele vermeintliche Theme-Probleme entstehen durch andere Ursachen wie Extensions, individuelle Anpassungen oder Shopware-Konfigurationen.

Diese Anleitung führt dich systematisch durch die Fehlereingrenzung, damit du schnell eine Lösung findest.

Ziel dieser Anleitung: Fehlerquelle identifizieren und eingrenzen – ist es FreeTheme One, eine Extension, eine Anpassung oder Shopware selbst?

Schritt 1: Fehler lokalisieren

Zunächst musst du feststellen, wo der Fehler auftritt:

Storefront (Frontend)

Der Fehler ist im Shop-Frontend sichtbar (was Kunden sehen)?

  • Darstellungsprobleme, Layout-Fehler, fehlende Elemente

  • Funktionen wie Warenkorb, Produktseiten, Checkout betroffen

  • Responsive-Darstellung auf Mobilgeräten fehlerhaft

→ Weiter mit Schritt 2

Administration (Backend)

Der Fehler tritt nur in der Shop-Administration auf?

  • Theme-Konfiguration lässt sich nicht speichern

  • Fehler beim Zuweisen des Themes

  • Theme Manager zeigt Fehler

→ Weiter mit Schritt 2

Wichtig: Notiere dir genau, wo und wann der Fehler auftritt. Screenshots und genaue Beschreibungen helfen bei der Fehlersuche.

Schritt 2: Cache leeren & Storefront kompilieren

Viele Probleme lassen sich durch das Leeren des Caches und Neukompilieren der Storefront beheben.

Cache über Administration leeren

  1. Öffne die Administration deines Shops

  2. Navigiere zu "Einstellungen" → "System" → "Caches & Indizes"

  3. Klicke auf "Caches löschen"

  4. Warte, bis der Vorgang abgeschlossen ist

Theme neu kompilieren

  1. Navigiere zu "Inhalte" → "Themes"

  2. Wähle FreeTheme One aus

  3. Öffne das Kontextmenü (drei Punkte)

  4. Klicke auf "Theme kompilieren"

Cache über CLI leeren (Optional)

Für Self-hosted Shops kannst du den Cache auch per CLI leeren:

Problem gelöst?

  • ✅ Ja → Der Fehler lag am Cache. Keine weiteren Schritte nötig.

  • ❌ Nein → Weiter mit Schritt 3

Schritt 3: Browser-Cache leeren

Manchmal werden Darstellungsprobleme durch den Browser-Cache verursacht.

Browser-Cache leeren

Chrome/Edge/Brave:

  1. Drücke Strg + Shift + Entf (Windows) oder Cmd + Shift + Delete (Mac)

  2. Wähle "Bilder und Dateien im Cache"

  3. Klicke auf "Daten löschen"

Firefox:

  1. Drücke Strg + Shift + Entf (Windows) oder Cmd + Shift + Delete (Mac)

  2. Wähle "Cache"

  3. Klicke auf "Jetzt löschen"

Safari:

  1. Drücke Cmd + Alt + E

  2. Lade die Seite neu

Hard Reload durchführen

Alternativ kannst du einen Hard Reload durchführen:

  • Windows: Strg + F5 oder Strg + Shift + R

  • Mac: Cmd + Shift + R

Inkognito-Modus testen

Öffne deinen Shop im Inkognito-/Privat-Modus des Browsers:

  • Chrome/Edge: Strg + Shift + N

  • Firefox: Strg + Shift + P

  • Safari: Cmd + Shift + N

Problem gelöst?

  • ✅ Ja → Der Fehler lag am Browser-Cache. Keine weiteren Schritte nötig.

  • ❌ Nein → Weiter mit Schritt 4

Schritt 4: Shopware Standard Theme testen

Jetzt testest du, ob das Problem auch im Shopware Standard Theme auftritt. Dies zeigt, ob der Fehler von FreeTheme One oder von Shopware selbst kommt.

Standard Theme zuweisen

  1. Öffne die Administration

  2. Navigiere zu "Inhalte" → "Themes"

  3. Wähle das Shopware Standard Theme aus (nicht FreeTheme One)

  4. Weise es dem betroffenen Verkaufskanal zu

  5. Bestätige die Zuweisung

  6. Leere den Cache (siehe Schritt 2)

  7. Teste, ob der Fehler weiterhin auftritt

Ergebnis der Prüfung:

  • ✅ Fehler tritt AUCH im Standard Theme auf → Der Fehler liegt nicht an FreeTheme One, sondern an Shopware, einer Extension oder Konfiguration. Weiter mit Schritt 5.

  • ❌ Fehler tritt NICHT im Standard Theme auf → Der Fehler liegt wahrscheinlich an FreeTheme One oder einer Theme-spezifischen Anpassung. Weiter mit Schritt 6.

Wichtig: Notiere dir das Ergebnis dieses Tests für eine spätere Support-Anfrage!

Schritt 5: Extensions deaktivieren

Wenn der Fehler auch im Standard Theme auftritt, liegt er wahrscheinlich an einer Extension (Plugin/App).

Extensions systematisch deaktivieren

  1. Öffne die Administration

  2. Navigiere zu "Erweiterungen" → "Meine Erweiterungen"

  3. Wechsel zum Reiter "Apps" und/oder "Plugins"

  4. Deaktiviere alle Extensions (außer FreeTheme One und Shopware-Standard-Extensions)

  5. Leere den Cache (siehe Schritt 2)

  6. Teste, ob der Fehler weiterhin auftritt

Problem gelöst?

  • ✅ Ja → Der Fehler wurde durch eine Extension verursacht. Aktiviere Extensions einzeln wieder, bis du die fehlerhafte Extension gefunden hast.

  • ❌ Nein → Der Fehler liegt wahrscheinlich an Shopware-Konfigurationen, Server-Einstellungen oder individuellen Code-Anpassungen. Kontaktiere den Shopware-Support oder deine Agentur.

Extension-Konflikt identifizieren

Wenn das Deaktivieren aller Extensions den Fehler behebt:

  1. Aktiviere Extensions einzeln nacheinander wieder

  2. Leere nach jeder Aktivierung den Cache

  3. Teste, ob der Fehler wieder auftritt

  4. Die zuletzt aktivierte Extension ist die Fehlerquelle

Hinweis: Notiere dir die fehlerhafte Extension für eine Support-Anfrage an deren Hersteller.

Schritt 6: Individuelle Anpassungen prüfen

Wenn der Fehler nur bei FreeTheme One auftritt (nicht im Standard Theme), könnte er durch individuelle Template-Anpassungen verursacht werden.

Template-Anpassungen identifizieren

Hast du individuelle Anpassungen vorgenommen?

  • Custom CSS-Code über den Theme Manager eingefügt?

  • Template-Dateien (Twig) überschrieben?

  • JavaScript-Code hinzugefügt?

  • Theme über ein Child-Theme erweitert?

Custom CSS deaktivieren

Falls du Custom CSS über den Theme Manager eingefügt hast:

  1. Öffne die Theme-Konfiguration von FreeTheme One

  2. Navigiere zu Tab "Weiteres" → "Experten-Einstellungen"

  3. Deaktiviere "CSS-Code laden" (falls aktiviert)

  4. Entferne vorübergehend den Inhalt aus "Individueller CSS-Code"

  5. Speichere die Änderungen

  6. Leere den Cache und teste

Problem gelöst?

  • ✅ Ja → Der Fehler lag am Custom CSS. Überprüfe deinen CSS-Code.

  • ❌ Nein → Weiter prüfen

Template-Overrides prüfen

Falls du Twig-Templates überschrieben hast:

  1. Prüfe dein Theme-Verzeichnis auf überschriebene Templates

  2. Benenne überschriebene Templates vorübergehend um (z.B. page.html.twig → page.html.twig.backup)

  3. Leere den Cache und teste

Child-Theme prüfen

Falls du ein Child-Theme verwendest:

  1. Weise vorübergehend das Haupt-FreeTheme One Theme zu (ohne Child-Theme)

  2. Teste, ob der Fehler weiterhin auftritt

  3. Wenn der Fehler verschwindet, liegt er am Child-Theme

Checkliste für Support-Anfrage

Wenn du nach allen Schritten immer noch ein Problem hast und der Fehler nachweislich durch FreeTheme One verursacht wird, bereite folgende Informationen vor:

System-Informationen

Fehler-Details

Durchgeführte Schritte

Welche Schritte aus dieser Anleitung hast du bereits durchgeführt?

Zusätzliche Informationen

Support kontaktieren

Nachdem du die Fehlerquelle eingegrenzt hast:

Fehler liegt an FreeTheme One

Wenn der Fehler nur bei FreeTheme One auftritt und du alle Schritte durchgeführt hast:

  1. Erstelle ein Support-Ticket im Shopware Account

  2. Verwende die Checkliste oben, um alle relevanten Informationen bereitzustellen

  3. Füge Screenshots und Fehlermeldungen hinzu

Support-Zugang: Melde dich in deinem Shopware Account an und erstelle ein Support-Ticket für FreeTheme One.

Fehler liegt an Extension

Wenn der Fehler durch eine Extension verursacht wird:

  • Kontaktiere den Support des Extension-Herstellers

  • Teile die Informationen aus deiner Fehlereingrenzung mit

Fehler liegt an Shopware

Wenn der Fehler auch im Standard Theme auftritt:

  • Kontaktiere den Shopware-Support

  • Beschreibe, dass der Fehler unabhängig vom Theme auftritt

Fehler liegt an Anpassungen

Wenn der Fehler durch individuelle Anpassungen verursacht wird:

  • Kontaktiere deine Agentur oder Entwickler

  • Überprüfe Custom CSS, Template-Overrides oder Child-Theme-Code

Tipp: Eine systematische Fehlereingrenzung spart Zeit und ermöglicht schnellere Lösungen. Je mehr Informationen du bereitstellst, desto schneller kann dir geholfen werden.

VorherigeChangelog

Zuletzt aktualisiert