Wissensdatenbank (SW5)
Hier findest du alle Artikel der ThemeWare® Wissensdatenbank für Shopware 5 – aufgeteilt in drei Kategorien.
Allgemein
Anleitungen und Artikel rund um ThemeWare® für Shopware 5.
Häufige Fragen
Antworten auf die häufigsten Fragen zu ThemeWare® für Shopware 5.
Die Einstellungen, die du während der Testphase vorgenommen hast, bleiben nach dem Erwerb der Kauf- oder Mietlizenz erhalten. Technisch gesehen wird nur die Lizenz getauscht.
Alle Einstellungen können jedoch verloren gehen, wenn du das ThemeWare® Plugin deinstallierst oder neu installierst. Dies ist für den Wechsel der Lizenz aber auch gar nicht nötig und sollte vermieden werden.
Ja, klar! Du findest in unserem Service Portal alle Informationen, wie du mit ThemeWare® startest, arbeitest, es konfigurierst, individuell anpasst, Fehler behebst, etc.
Schaue dich einfach um und navigiere in den Bereich, zu dem du Fragen hast.
Grundsätzlich ist es bei Lizenzen aus dem Shopware Store so, dass diese auch immer für alle Sprach- und Sub-Shops des registrierten Hauptshops gültig sind. Du kannst Plugins daher immer auch in deinen Sprach- und Subshops einsetzen.
In diesem Artikel zeigen wir dir, wo du die am häufigsten in ThemeWare® für Shopware 5 vermuteten Funktionen findest.
- Darstellung des Listings (Spaltenanzahl, Bildergröße, etc.): Die Darstellung wird über das Produkt Layout in den Kategorien festgelegt. In ThemeWare® findest du die Einstellung unter Tab „Layoutoptionen“ > „Inhalt“ > „Kategorielisting“.
- Layer-Menü: Aktiviere das kostenfreie Shopware Plugin „Erweitertes Menü“. ThemeWare® bietet dafür Farb- und Abstandseinstellungen.
- Gestaltung der Startseite: Die Startseite wird über eine Einkaufswelt gestaltet. ThemeWare® bietet ergänzende Konfigurationen.
- Newsletter: Die Newsletter-Registrierung im Footer kannst du in ThemeWare® unter „Erweiterungen“ > „Weitere“ deaktivieren.
- Service Hotline im Footer: Passe die Textbausteine
sFooterServiceHotlineundsFooterServiceHotlineHeadan. - Artikel Navigation: Einstellungen > Caches / Performance > Verschiedenes > „Artikel Navigation deaktivieren“.
Da die Lizenzierung von ThemeWare® vollständig von Shopware übernommen und verwaltet wird, haben wir leider keinen Einfluss auf die Lizenzen. Falls du dich nicht sofort für den Kauf entscheiden möchtest, dann kannst du ThemeWare® auch vorerst günstig mieten und weiter testen. Die Miete kann monatlich gekündigt werden.
Bei gewichtigen Gründen kann Shopware ausnahmsweise eine Testlizenz verlängern. Wende dich dazu bitte an Shopware.
Die Plugin-Lizenzen aus dem Shopware Store sind an die Domain eines Hauptshops gebunden und gelten immer nur für eine Shopware Installation. Pro Shopware Installation benötigst du einen Shop-Eintrag in deinem Shopware Account im Bereich „Shopbetreiberbereich“ > „Shops“.
Innerhalb einer Shopware Installation kannst du die Plugins aber für beliebig viele Sprach- und Subshops verwenden.
In ThemeWare® setzen wir bewusst nicht die üblichen Plugins der Plattformen (Facebook, etc.) ein. Stattdessen stellt ThemeWare® nur einen schön gestalteten Link mit einem Icon statt simplem Text zu einer Share-Unterseite von der jeweiligen Plattform dar.
Dadurch werden keine Daten an die Plattformen übertragen, bevor der Nutzer das jeweilige Icon anklickt. Es öffnet sich dann eine Share-Unterseite der jeweiligen Plattform.
Dies ist nach unserem Wissensstand datenschutzkonform.
Der Einsatz von ThemeWare® ist nicht an eine Shopware Lizenz gebunden. Das heißt, es spielt keine Rolle, ob du Shopware in der Community, Professional, Professional Plus oder Enterprise Edition einsetzt.
Solltest du eine kommerzielle Variante einsetzen wollen, dann wende dich gerne an uns. Als Shopware Partner Agentur können wir dir umgehend eine Lizenz zur Verfügung stellen und dich bei der Einrichtung unterstützen.
In deiner Administration ist kein Update von ThemeWare® verfügbar, obwohl im Shopware Store bereits eine neue Version aufgeführt wird?
Lösungen:
- Warte ein paar Stunden. Es kann etwas dauern, bis ein Update in deinem System ankommt.
- Prüfe ob du eine gültige Subscription für dein Theme hast und verlängere diese gegebenenfalls.
- Aktualisiere deine Shopware Installation auf die aktuellste Version (für SW 5.7 wird ThemeWare® 2.4.x benötigt, für SW 5.6 wird ThemeWare® 2.3.x benötigt).
Grundsätzlich empfehlen wir dir, immer die Bildgröße des jeweiligen Beispiel-Bildes, welches im Theme mitgeliefert wird, beizubehalten. Diese kannst du entweder der Bild-Datei direkt auf deinem Server oder der PSD-Datei im Bildvorlagen-Downloadpaket entnehmen.
Beispiele:
- Sidebar-Widget: 700x570 Pixel (B x H)
- Leftbar-Bild oben: 460x300 Pixel (B x H)
Die Bilder sind extra etwas größer angelegt, als sie im Theme angezeigt werden. Dadurch werden die Bilder auf allen Endgeräten scharf dargestellt.
Für ThemeWare® gelten in Bezug auf die PHP Version die gleichen Anforderungen wie an Shopware. Du kannst also jede PHP Version verwenden, die mit deiner eingesetzten Shopware Version kompatibel ist.
Du kannst die ThemeWare® Testversion in deinem Shop mittels des Plugin-Managers installieren:
- Öffne den Plugin Manager im Backend unter „Einstellungen“ > „Plugin Manager“
- Suche oben links nach „ThemeWare“ und wähle die passende Variante aus
- Gehe in den Tab „Testversion“ und klicke auf „Testversion herunterladen“
Wenn der Plugin-Manager Zugangsdaten fragt, gib die Zugangsdaten zu deinem Shopware Account ein.
In Shopware können fast alle Texte über die Textbausteine bearbeitet werden. Diesen Bereich findest du im Backend unter „Einstellungen“ > „Textbausteine“.
Dort findest du oben rechts ein Suchfeld. Suche nach dem Inhalt (z.B. „Service Hotline“) oder dem Namen eines Textbausteins. Die zugehörigen Textbausteine heißen:
sFooterServiceHotlinesFooterServiceHotlineHead
Wenn du ein Plugin über den Shopware Store kaufst oder mietest, dann ist Shopware dein Vertragspartner und nicht der jeweilige Hersteller. Aus diesem Grund erhältst du auch die Rechnung von Shopware.
Die Rechnungen findest du in deinem Shopware Account unter „Meine Firma“ > „Buchhaltung“. Die Rechnungen werden am Monatsende erstellt und enthalten alle Käufe/Mieten des jeweiligen Zeitraums.
Die Layer-Navigation kannst du mit dem kostenfreien Plugin „Erweitertes Menü“ von Shopware aktivieren.
Installation und Aktivierung: Das Plugin ist in Shopware 5 bereits vorhanden und muss über den Plugin Manager installiert und aktiviert werden.
Einrichtung: Öffne nach der Installation die Plugin-Konfiguration und setze den Wert „Hover Verzögerung“ auf 0. Innerhalb der ThemeWare® Theme-Konfiguration findest du einen eigenen Bereich unter Tab „Layoutoptionen“ > Tab „Header“ > „Zusatzkonfiguration für das Shopware Plugin Erweitertes Menü“.
Häufige Fehler
Lösungen für bekannte Fehler im Frontend und Backend von Shopware 5 mit ThemeWare®.
Frontend
Du hast einen Lizenzkey zum Entfernen des Brandings erstellt, aber das Branding wird trotzdem weiterhin angezeigt.
Mögliche Ursachen:
- Cache nicht geleert: Leere alle Caches und kompiliere das Theme.
- Lizenzkey nicht in Plugin-Konfiguration eingetragen: Der Lizenzkey muss unter „Einstellungen“ > „Plugin Manager“ > ThemeWare® > „Konfiguration“ hinterlegt werden.
- Lizenzkey mit Leerzeichen kopiert: Prüfe, ob beim Kopieren ein Leerzeichen am Ende übernommen wurde.
- Falscher Host verwendet: Der Lizenzkey wird anhand des Hosts des Hauptshops generiert.
- Falsche ThemeWare® Version: Wähle im Lizenzkey-Generator die richtige Version (bis 2.3.2 bzw. ab 2.3.3).
Im Frontend (häufig im Checkout oder bei der Newsletter-Anmeldung) erscheint die Fehlermeldung „The provided X_CSRF-Token for path … is invalid“.
Lösung: Ein CSRF-Token-Fehler ist nicht immer ein Grund zur Beunruhigung. Die Prüfung verhindert, dass automatisierte Programme Bestellungen durchführen oder sich in den Newsletter eintragen – es ist eine Sicherheitsfunktion von Shopware. Solange die Fehlermeldung „/newsletter“ anzeigt, besteht kein Handlungsbedarf. Ist der Checkout oder Account-Bereich betroffen, bitte deinen technischen Ansprechpartner die Meldung zu prüfen.
Die Einkaufswelt wird im Shop auf der Startseite oder in der Kategorie nicht angezeigt.
Mögliche Ursachen:
- Keine Einkaufswelt aus der Vorlage erstellt
- Einkaufswelt ist nicht der richtigen Kategorie zugewiesen
- Einkaufswelt ist nicht aktiv
- Der Einkaufswelt ist der falsche Shop zugewiesen (ab SW 5.5)
- Der Kategorie sind keine Artikel zugewiesen – deaktiviere „Produkte unter Inhalt anzeigen“
- Nicht alle Geräte-Größen unter „Device-Einstellungen“ aktiviert
- Die Kategorie wird mit einem Seitenparameter
?p=xaufgerufen (Standardverhalten von Shopware)
Die Einstellung für die Spaltenanzahl im Listing wird im Frontend nicht berücksichtigt.
Lösung: Die Spaltenanzahl-Einstellung in ThemeWare® kann nur für Kategorien berücksichtigt werden, denen das Produkt Layout „Nur wichtige Informationen“ zugewiesen ist. Das Produkt Layout stellst du unter „Artikel“ > „Kategorien“ > „Produkt Layout“ ein.
Die Leftbar wird auf einigen Unterseiten nicht angezeigt.
Lösung: Aktiviere die Leftbar in der Theme-Konfiguration unter Tab „Layoutoptionen“ > Tab „Leftbar“ > „Leftbar auf Desktop anzeigen“ und „Leftbar auf Tablet anzeigen“. Ausnahme: Bei Einkaufswelten mit der Einstellung „Vollflächig“ kann die Leftbar nicht angezeigt werden.
Nach dem Update auf Shopware 5.6.x werden die Links im Footer („Shop Service“ und „Informationen“) nicht mehr angezeigt.
Ursache: Mit Shopware 5.5 wurden neue Template-Keys eingeführt. Der Fallback wurde in 5.6 entfernt.
Lösung: Benenne die Shopseiten-Template-Keys unter „Einstellungen“ > „Grundeinstellungen“ > „Shopeinstellungen“ > „Shopseiten-Gruppen“ um: gLeft → left, gBottom → bottom, gBottom2 → bottom2.
Die einzelnen Navigations-Layer des erweiterten Menüs öffnen sich nicht immer.
Lösung: Stelle die Hover-Verzögerung innerhalb der Plugin-Einstellungen des „Erweiterten Menüs“ auf 0ms. Die Einstellungen findest du über den Plugin Manager.
Der Offcanvas Warenkorb öffnet sich nicht, Filter lassen sich nicht aufklappen oder Infinite Scrolling funktioniert nicht.
Lösungsmöglichkeiten:
- SSL prüfen: Unter „Grundeinstellungen“ > „Shops“ sicherstellen, dass „SSL verwenden“ korrekt gesetzt ist.
- Filter-Einstellungen: In der Theme-Konfiguration unter „Layoutoptionen“ > „Inhalt“ > „Kategorielisting“ prüfen, ob „Filter (Leftbar / Content)“ nicht auf „false“ steht.
- Drittanbieterplugins: Plugins einzeln deaktivieren, um den Verursacher zu finden.
Die Popups für AGB, Datenschutz, etc. im Checkout zeigen den falschen Inhalt (oft die Startseite).
Lösung: Im Textbaustein wurde innerhalb des Links zusätzlicher HTML- und/oder CSS-Code verwendet. Dieser muss entfernt werden.
Die Ladezeit des Shops ist sehr hoch.
Checkliste:
- Produktivmodus: Aktivieren unter „Einstellungen“ > „Caches/Performance“ > „Start“
- HTTP-Cache: Aktivieren unter „Caches/Performance“ > „Einstellungen“
- Compiler Caching: Aktivieren unter „Theme Manager“ > „Einstellungen“
- CSS Source Map: Deaktivieren unter „Theme Manager“ > „Einstellungen“
- Bilder optimieren: Einkaufswelt-Bilder so klein wie möglich halten
- SVG Icons: In ThemeWare® aktivieren (Tab „Layoutoptionen“ > „Allgemein“)
- Schriftarten lokal einbinden: Google Fonts lokal hosten
- Server: PHP 7+, MySQL 5.6+, GZIP-Komprimierung aktivieren
Nach der Installation oder einem Update sieht das Frontend nicht wie gewünscht aus.
Lösung:
- Öffne „Einstellungen“ > „Caches / Performance“ > Tab „Caches“
- Alle Häkchen anwählen und auf „Löschen“ klicken
- Theme kompilieren
- Frontend mit Browser-Refresh neu laden (Windows: Strg+F5, Mac: Shift+Cmd+R)
Nach dem Update auf Shopware 5.6.7 funktioniert der Warenkorb eines oder mehrerer Sprach-Shops nicht mehr.
Ursache: Der Fehler wird durch alte Übersetzungszustände verursacht (nicht durch ThemeWare®).
Lösung: Öffne und speichere alle Länder-Übersetzungen unter „Grundeinstellungen“ > „Shopeinstellungen“ > „Länder“ > „Deutschland etc.“ > „Übersetzung von Name“.
Textbausteine des Themes (z.B. USP-Leiste, Vorteile im Checkout) werden in einer falschen Sprache angezeigt.
Lösung:
- ThemeWare®-Konfiguration in der jeweils anderen Backend-Sprache öffnen und Cache leeren
- Konfigurationsfeld anpassen, speichern und Cache leeren
- Textbausteine direkt in Shopware anpassen
Backend
Der Theme Manager braucht sehr lange zum Laden.
Ursache: Zu viele Ableitungen (Themes) im Theme Manager. Shopware benötigt pro Ableitung mehr Rechenleistung.
Lösungen:
- Versuche mit möglichst wenig Ableitungen zu arbeiten (eine Ableitung ist nur nötig für Template-Customizings)
- Erhöhe die Server-Ressourcen:
memory_limitauf 512 MB+,max_execution_timeauf 60s+ - Die Theme-Konfiguration kann exportiert und importiert werden, um Ableitungen zu reduzieren
Im Theme Manager erscheint eine Fehlermeldung über ein nicht gefundenes übergeordnetes Theme.
Ursache: Das übergeordnete Theme (z.B. ThemeWare®) wurde deinstalliert, aber die Ableitung existiert noch.
Lösung: Installiere das ThemeWare® Plugin erneut. Zum vollständigen Entfernen: Lösche die Ableitungen per FTP vom Server, bevor du das Plugin deinstallierst.
Im Theme Manager tritt ein „500 Internal Server Error“ oder „0 communication failure“ auf und/oder es werden keine Themes angezeigt.
Ursache: Zu viele Themes/Ableitungen verbrauchen mehr Ressourcen als verfügbar.
Lösung: Prüfe den PHP Errorlog auf Hinweise zu memory_limit oder max_execution_time. Empfehlung: memory_limit = 512M, max_execution_time = 60. Optional: Ajax Timeout im Backend erhöhen unter „Einstellungen“ > „Grundeinstellungen“ > „System“ > „Backend“ > „Ajax Timeout“.
Beim Erstellen einer Ableitung erscheint eine Fehlermeldung („Duplicate entry …“).
Lösung: Die Fehlermeldung ist nicht kritisch – die Ableitung wurde trotzdem erfolgreich erstellt. Du kannst den Fehler ignorieren und wie gewohnt weiterarbeiten. Der Fehler kann auch bei Bare- oder Responsive-Theme auftreten und ist kein ThemeWare®-spezifisches Problem.
Bei der Theme-Kompilierung erscheint die Fehlermeldung „variable @xyz is undefined in file …“.
Lösung: Öffne den Theme Manager, leere alle Caches und führe die Kompilierung erneut aus. Dieser Fehler entsteht, wenn Shopware in seltenen Fällen mit neuen Variablen aus Updates nicht zurechtkommt.
Im Plugin Manager wird „Testversion“ angezeigt, obwohl ThemeWare® gekauft oder gemietet wurde.
Lösung: Die Kauf-/Mietlizenz wird erkannt, sobald die Testlizenz ausläuft. Du brauchst nichts weiter unternehmen. Besteht das Problem darüber hinaus, wende dich an Shopware.
Bei der Kompilierung tritt eine Fehlermeldung wie „error evaluating function `darken` …“ auf.
Ursache: In einem Theme oder Plugin wurde ein ungültiger Wert eingetragen, der durch eine LESS-Funktion nicht verarbeitet werden kann.
Lösung: Überprüfe die zuletzt geänderten Konfigurationsfelder auf ungültige Werte. Für eine detaillierte Fehlersuche kann Logging in /vendor/oyejorge/less.php/lib/Less/Tree/Call.php hinzugefügt werden, um die betroffene Variable zu identifizieren.
Bei der Kompilierung erscheint „ParseError: Unexpected input on line 1, column …“.
Ursache: Ein ungültiger Wert in einem Konfigurationsfeld oder einem Plugin.
Häufige Fehlerquellen:
- Farbwerte:
FFFFFF(# fehlt),#FFFFF(nur 5 Zeichen),#FFFFGF(ungültiges Zeichen) - LESS-Funktionen:
lighten(@brand-primary, 12%(schließende Klammer fehlt) - Abstände: Einheit
pxoder%vergessen
Beim Update von ThemeWare® 1.x auf 2.x erscheint eine SQL-Fehlermeldung.
Ursache: Abweichende Werte in der „Less-Konfiguration“ bei Sprach-Shops (wird von Shopware nicht unterstützt).
Lösung:
- Datenbank-Backup erstellen
- Inhalte des Feldes „Less-Konfiguration“ sichern
- In der Datenbank: Die zugehörigen Einträge in
s_core_config_valueslöschen (Element-ID übers_core_config_elementsmitname LIKE '%customlesscode%'ermitteln) - Update erneut ausführen
- Gesicherte Inhalte wieder eintragen