Problembeschreibung

Du hast einen Lizenzkey zum Entfernen des Brandings (Theme by-Hinweis) über den Lizenzkey-Generator erstellt, aber das Branding wird trotzdem weiterhin angezeigt.

Falls du keinen Zugang zum Lizenzkey-Generator hast, dann kannst du dich hier mit uns in Verbindung setzen: https://service.tc-innovations.de/themeware/ticket-general?request=theme-branding 

Mögliche Ursachen

Bitte prüfen Sie die folgenden Ursachen:

1. Cache nicht geleert und/oder Theme nicht kompiliert

Du musst alle Caches leeren und das Theme kompilieren, damit der Lizenzkey erkannt wird: https://service.tc-innovations.de/themeware/sw5/article/2078-cache-leeren-und-theme-kompilieren 

2. Lizenzkey nicht in der Plugin Konfiguration eingetragen

Der Lizenzkey muss in der Plugin-Konfiguration von ThemeWare^® hinterlegt werden. Diese findest du im Backend unter "Einstellungen" > "Plugin Manager > "Installiert", indem du rechts neben dem Eintrag von ThemeWare^® auf das Stift-Symbol klickst. Im Bereich "Konfiguration" kannst du nun unten rechts den Lizenzkey hinterlegen.

Hinweis: Achte darauf, dass du beim Eintragen des Lizenzkey nicht versehentlich ein Leerzeichen am

Du musst alle Caches leeren und das Theme kompilieren, damit der Lizenzkey erkannt wird: https://service.tc-innovations.de/themeware/sw5/article/2078-cache-leeren-und-theme-kompilieren

3. Lizenzkey mit Leerzeichen kopiert

Es kommt vor, dass beim Kopieren des Lizenzkeys ein Leerzeichen am Ende mitgenommen wird. Prüfe in der Plugin-Konfiguration, ob dies bei dir der Fall ist und entferne dieses gegebenenfalls.

4. Falscher Host zur Generierung verwendet

Der Lizenzkey wird an Hand des Hosts des Hauptshops deiner Shopware Installation generiert. Trage diesen daher unbedingt korrekt in den Lizenzkey-Generator ein. Du benötigst jedoch keinen eigenen Lizenzkey für Subshops.

5. Lizenzkey für falsche ThemeWare Version generiert

In dem Lizenzkey-Generator hast du die Möglichkeit die deine ThemeWare Version auszuwählen. Die Lizenzkeys und -prüfungen bis ThemeWare Version 2.3.2 bzw. ab 2.3.3 unterscheiden sich grundlegend, daher ist es wichtig, hier die richtige Version auszuwählen.

6. Anderes Problem

Falls du das Problem nicht lösen konntest, dann kannst du dich hier mit uns in Verbindung setzen: https://service.tc-innovations.de/themeware/ticket-general?request=theme-branding 

Fehlerbeschreibung

Im Frontend (häufig im Checkout, im Accountbereich oder bei der Newsletter-Anmeldung) wird eine Fehlermeldung ausgegeben oder du erhälst diese Information per E-Mail-Benachrichtigung. Die Fehlermeldung kann wie folgt lauten: "The provided X_CSRF-Token for path "/checkout" is invalid".

Ursache

Es liegt entweder ein Problem mit einem Plugin vor (selten) oder die Meldung ist gewollt (häufig).

Lösung

Ein CSRF-Token-Fehler ist nicht immer ein Grund zu Beunruhigung. Die Prüfung auf den CSRF-Token verhindert beispielsweise, dass sich automatisierte Programme in den Newsletter eintragen oder Bestellungen durchführen können. Es ist also eine Sicherheitsfunktion von Shopware. Diese arbeitet so, dass der Fehler ausgelöst wird, um die ungewollte Bestellung, Registrierung oder die Eintragung in den Newsletter zu verhindern. Der Fehler ist in diesem Fall also ein gewolltes Ereignis.

So lange die Fehlermeldung "/newsletter" anzeigt besteht keinerlei Handlungsbedarf. Sollte der Checkout oder der Account-Bereich betroffen sein, bitte deinen technischen Ansprechpartner die Fehlermeldung zu überprüfen.

Problembeschreibung

Die Einkaufswelt wird im Shop auf der Startseite oder in der Produkt-Kategorie nicht angezeigt.

Mögliche Ursachen

Bitte prüfen Sie die folgenden Ursachen:

1. Keine Einkaufswelt aus der Vorlage erstellt

Nach der Installation von ThemeWare müssen Sie die Einkaufswelt aus der installierten Vorlage erstellen:

https://service.tc-innovations.de/themeware/sw5/article/2070-einkaufswelt-aus-der-vorlage-preset-erstellen

2. Einkaufswelt ist nicht der richtigen Kategorie zugewiesen

Bitte stellen Sie sicher, dass Sie die Einkaufswelt wirklich der richtigen Kategorie zugewiesen haben.

3. Einkaufswelt ist nicht aktiv

Eine weitere Ursache kann sein, dass die Einkaufswelt nicht aktiv ist.

4. Der Einkaufswelt ist der falsche Shop zugewiesen (nur ab Shopware 5.5.)

Eine Einkaufswelt kann auf einen Shop beschränkt werden. Hier muss in der "Shop Auswahl" entweder der richtige Shop oder kein Shop ausgewählt werden.

5. Der Kategorie, in der sich die Einkaufswelt befindet, sind keine Artikel zugewiesen

Wenn sich in der Kategorie, die der Einkaufswelt zugewiesen ist, keine Artikel befinden, dann müssen Sie in der Einkaufswelt den Haken bei "Produkte unter Inhalt anzeigen" deaktivieren.

6. Es sind nicht alle Geräte-Größen aktiviert

In einigen Szenarien tritt dieses Problem auf, wenn unter "Device-Einstellungen" nicht alle Geräte-Größen aktiviert sind.

7. Die Kategorie wird mit einem Seitenparameter ?p=x aufgerufen

Wenn Sie eine Kategorie mit einer Einkaufswelt über einen Link aufrufen, an dem am Ende ein ?p=x angehangen ist (z.b. http://ihre-domain.de/kategorie/?p=1), dann wird die Einkaufswelt nicht anzeigt. Dies ist das Standardverhalten von Shopware und wird nicht durch ThemeWare verursacht. Sie können das Verhalten mit dem folgenden Plugin anpassen: https://store.shopware.com/hpr1821353849428/einkaufswelten-auf-allen-kategorieseiten.html

8. Fehler in Theme oder Plugin

Sollte das Problem nicht durch die obenstehenden Ursachen ausgelöst worden sein, folgen Sie bitte der nachfolgenden Anleitung zur Eingrenzung des Fehlers: https://service.tc-innovations.de/themeware/sw5/debugging

Problembeschreibung

Die Einstellung für die Spaltenanzahl im Listing (Tab "Layoutoptionen" > Tab "Inhalt" > Bereich "Kategorielisting" > Spalten Desktop/Tablet/Phone Viewport) wird im Frontend des Shops nicht berücksichtigt.

Ursache/Lösung

Sie haben mit ThemeWare die Möglichkeit die Anzahl der Spalten im Listing individuell einzustellen.

Diese Einstellung kann jedoch nur für Kategorien berücksichtigt werden, denen das Produkt Layout "Nur wichtige Informationen" zugewiesen ist.  Das Produkt Layout einer Kategorie stellen Sie in Ihrem Backend hier ein: Artikel > Kategorien > Produkt Layout.

Bitte beachten Sie grundsätzlich die Hilfetexte (blaues Fragezeichen) an den Konfigurationsfeldern.

Problem

Die Leftbar wird auf einigen Unterseiten nicht angezeigt.

Lösung

Damit die Leftbar angezeigt wird, muss diese in der Theme-Konfiguration im Bereich Tab "Layoutoptionen" => Tab "Leftbar" => Bereich "Leftbar auf Desktop anzeigen"  und Tab "Layoutoptionen" => Tab "Leftbar" => Bereich "Leftbar auf Tablet anzeigen" aktiviert werden.

Eine Ausnahme gibt es bei Einkaufswelten. In Verbindung mit einer Einkaufswelt kann die Leftbar nicht angezeigt werden, wenn in den Einkaufswelt-Einstellungen unter Layout => Layout-Einstellugen der Haken bei Vollflächig gesetzt ist.

Fehlerbeschreibung

Nach dem Update auf Shopware 5.6.x werden im Footer die Links im Bereich "Shop Service" und "Informationen" nicht mehr angezeigt.

Ursache

Mit Shopware 5.5 wurde ein neues Format für die Template-Keys der Shopseiten-Gruppen eingeführt. Dieses Update sollte eigentlich auch alle Template-Keys richtig umbenennen, sodass diese dem neuen Format entsprechen. Leider hat dies bei vielen Shops nicht funktioniert.

In Shopware 5.5 war ein Fallback implementiert, deswegen es dort häufig nicht auffiel, wenn die Template-Keys noch das alte Format besaßen. Dieser Fallback wurde nun mit Shopware 5.6 entfernt, sodass der - eigentlich schon vorher vorhandene - Fehler sichtbar wird.

Lösung

Shopware schreibt dazu im Changelog von Shopware 5.6.:

Shopseiten-Gruppen Template-Keys

Die Unterstützung für die alten Shopseiten-Template-Keys "gLeft”, "gBottom” und "gBottom2” wurde entfernt. Die Shopseiten-Template-Keys müssen zu "left”, "bottom” und "bottom2" umbenannt werden.

Die Einstellung finden Sie hier: Einstellungen > Grundeinstellungen > Shopeinstellungen > Shopseiten-Gruppen

Beachten Sie bitte, dass die "Haupt-Shopseiten-Gruppen" (z.B. left, bottom, bottom2) keine "Zuordnung" haben dürfen. Außerdem ist es erforderlich, dass das ThemeWare Plugin installiert und aktiviert ist.

Gegebenenfalls müssen Sie auch den Wert bei folgender ThemeWare Einstellung anpassen: Tab "Layoutoptionen" => Tab "Footer" => Bereich "Footer Navigation" => Shopseiten-Gruppen Template-Key.

Weitere Informationen zu den Shopseiten-Gruppen finden Sie in der Shopware Dokumentation: https://docs.shopware.com/de/shopware-5-de/inhalte-und-medien/shopseiten#shopseiten-gruppen

Fehlerbeschreibung

Die einzelnen Navigations-Layer des erweiterten Menüs öffnen sich nicht immer, wenn die Navigationspunkte mit der Maus berührt werden.

Lösung

Bitte stellen Sie die sogenannte Hover-Verzögerung innerhalb des Plugin-Einstellung des "Erweiterten Menüs" auf 0ms. Die Plugin-Einstellungen des erweiterten Menüs können Sie über die Plugin Manager öffnen.

Fehlerbeschreibung

• Ein Artikel wird in den Warenkorb gelegt, aber der Offcanvas Warenkorb öffnet sich nicht. Stattdessen erscheint manchmal ein Ladesymbol
• Die Filter im Artikel-Listing oder in der Leftbar lassen sich nicht mehr aufklappen oder auswählen
• Das Infinite Scrolling im Listing funktioniert nicht

Lösungsmöglichkeiten

Der Fehler kann verschiedene Ursachen haben. Bitte versuche die nachfolgenden Lösungswege.

SSL in Shopeinstellungen prüfen

Bitte öffne in deinem Backend Grundeinstellungen > Shops und wähle dort deinen Shop aus.

Wenn dein Shop über SSL (https://) erreichbar ist, so stelle sicher, dass der Haken SSL verwenden gesetzt ist.

Verwendest du kein SSL, darf der Haken nicht gesetzt sein.

Filtereinstellungen in Theme-Konfiguration prüfen

Bitte öffne unter Einstellungen den Theme-Manager, wähle dein aktives Theme und öffne die Theme-Konfiguration.

Wechsle nun in den Bereich Tab "Layoutoptionen" => Tab "Inhalt" => Bereich "Kategorielisting".

Prüfe hier, ob die Einstellung Filter (Leftbar / Content) auf "false" steht. Wenn ja, wähle einen anderen Wert und speichere die Theme-Konfiguration.

Kompiliere das Theme nun, leere den Cache und prüfe, ob das Problem gelöst ist.

Falls dies nicht funktioniert, ändere den Wert einmal auf eine andere Option, speichere und kompiliere das Theme und prüfe erneut, ob das Problem gelöst.

Drittanbieterplugins prüfen und ggf. Info an ThemeWare Support

Sollten die obenstehenden Lösungswege das Problem nicht gelöst haben, so fahre bitte mit dem nachfolgend verlinkten Prozess fort, um festzustellen, welches Drittanbieterplugin der Verursacher ist.

Bitte fahre hier fort: https://service.tc-innovations.de/themeware/sw5/debugging

Problembeschreibung

Die Popups bzw. Layer (oftmals auch Lightbox genannt) für AGB, Datenschutz, etc., die sich im Checkout kurz vor dem Bestellabschluss befinden, öffnen den falschen Link. Oftmals wird einfach die Startseite des Shops angezeigt.

Mögliche Ursache

Im Textbaustein wurde innerhalb des Links zusätzlicher HTML- und/oder CSS-Code verwendet. Dieser muss entfernt werden.

Problembeschreibung

Die Ladezeit des Shops ist sehr hoch, es dauert sehr lange, bis einzelne Unterseiten geladen werden.

Schaue dir ergänzend zu diesem Artikel auch die Performance Tipps von Shopware an: https://docs.shopware.com/de/shopware-5-de/tutorials-und-faq/performance-tipps?category=shopware-5-de/tutorials-und-faq

Mögliche Ursachen

Die Ladezeit eines Shopware Shops wird durch viele Faktoren beeinflusst. Aus diesem Grund ist es in einigen Fällen relativ aufwändig, die Ursache einer zu langen Ladezeit zu finden. Nachfolgend listen wir die häufigsten Ursachen auf, sodass du diese im Sinne einer Checkliste nach und nach prüfen kannst.

Shopware Konfiguration

Die nachfolgenden Ursachen kannst du selber prüfen und in deinem Shopware Backend beheben.

Shop im Produktivmodus verwenden

Der Produktivmodus kann im Bereich "Einstellungen > Caches/Perfomance (anklicken) > Start" aktiviert werden.

Verwendung des HTTP-Caches

Den HTTP-Cache können Sie über das Performance-Modul aktivieren ("Einstellungen > Caches/Performance (anklicken) > Einstellungen > HTTP-Cache").

Compiler Caching aktivieren

Unter "Einstellungen > Theme Manager > Einstellungen" kann das sogenannte Compiler Caching aktiviert werden. Außerdem sollte hier eingestellt werden, dass CSS- und JS-Dateien komprimiert werden.

CSS Source Map deaktivieren 

Unter "Einstellungen > Theme Manager > Einstellungen" sollte die CSS Source Map deaktiviert werden.

Cache aufwärmen

Wenn du den Cache geleert hast, muss sich dieser erst einmal neu aufbauen. Aus diesem Grund dauert es manchmal etwas länger, wenn man das erste Mal eine Seite des Shops aufruft. Mit der Funktion "Cache aufwärmen" unter "Einstellungen > Caches/Performance (anklicken) > Einstellungen > HTTP-Cache" kannst du den Cache für jeden Shop aufwärmen.

Einkaufswelten

Die nachfolgenden Ursachen kannst du selber prüfen und in deinem Shopware Backend im Bereich der Einkaufswelten beheben.

Bilder

Ein häufiger Grund für lange Ladezeiten sind große Bilddateien, die geladen werden müssen. Dies ist besonders häufig in Einkaufswelten der Fall. Hinterlege  Bilder nach dem Motto "so große wie nötig, so klein wie möglich".

Die beiden folgenden Plugins können dabei ggf. unterstützen:

• https://store.shopware.com/ies6685271780164/lazy-loading.html 
• https://store.shopware.com/pix5121012767035/tinypng-u.-tinyjpg-fuer-shopware.html 

ThemeWare

Die folgenden Punkte können in ThemeWare eingestellt werden.

SVG Icons

Aktiviere die SVG Dateien für Icons: Tab "Layoutoptionen" => Tab "Allgemein" => Bereich "Allgemein" => SVG-Dateien verwenden

Lokale Schriftart

Binde Schriftarten lokal ein, falls diese die Ladezeit verzögern: https://service.tc-innovations.de/themeware/sw5/article/2040-google-web-fonts-oder-eigene-fonts-dsgvo-konform-lokal-einbinden

Bilder

Häufig sind Bilder viel größer hinterlegt, als dies nötig wäre. Das kann zu massiven Performance-Einbußen führen. 

Die beiden folgenden Plugins können dabei ggf. unterstützen:

• https://store.shopware.com/ies6685271780164/lazy-loading.html 
• https://store.shopware.com/pix5121012767035/tinypng-u.-tinyjpg-fuer-shopware.html 

Hosting

Die nachfolgenden Ursachen solltest du mit Ihrem Hoster klären.

PHP-Version

Shopware empfiehlt den Einsatz von PHP ab der Version 7, da diese im Vergleich zur Vorgängerversion PHP 5 wesentlich performanter ist. Shopware benötigt ab Version 5.6 mindestens PHP 7.2.

MySQL-Version

Shopware empfiehlt den Einsatz von MySQL ab Version 5.6. Shopware benötigt ab Version 5.6 mindestens MySQL 5.7.

Erweitertes Caching

Durch ein erweitertes Caching mit ZendOP oder APCu kann die Ausführung des sogenanten PHP-Stacks um bis zu 25% beschleunigt werden.

Komprimierung der Übertragung

DU kannst auf deinem Server die GZIP Komprimierung für die Übertragung der Daten aktivieren. Ob dies bereits aktiviert ist kannst du mit diesem Tool prüfen: https://www.giftofspeed.com/gzip-test/

Server-Leistung

Ein weiterer Grund kann sein, dass einfach die Leistung des Servers nicht ausreicht. Dein Hoster kann dies auf Nachfrage prüfen und Ihnen ggf. mehr Leistung freischalten oder eine Alternative anbieten.

Problem

Nach der Installation oder einem Theme Update kann es vorkommen sein, dass das Frontend nicht wie gewünscht aussieht. Das liegt in der Regel daran, dass im Anschluss an das Update die Shopware Caches nicht geleert und/oder das Theme nicht neu kompilieren worden ist. Du solltest dies nach jedem Update durchführen.

Lösung

Gehe bitte wie folgt vor:

1. Öffne im Backend "Einstellungen" > "Caches / Performance" > Tab "Caches"
2. Wählen alle Häkchen an und klicke auf "Löschen"
3. Führe die Kompilierung des Themes durch
4. Laden das Frontend mit Browser-Refresh neu
   • Windows: [STRG] + [F5]
   • Mac: [SHIFT] + [CMD] + [R]

Sollte bei der Kompilierung im Backend eine Fehlermeldung mit dem Inhalt "variable @xyz is undefined" erscheinen, dann lese bitte hier weiter: https://service.tc-innovations.de/themeware/sw5/article/2016-fehler-variable-xyz-is-undefined-in-file

Schaue nun, ob dein Shop wieder wie gewünscht aussieht. Ist dies nicht der Fall, dann führe bitte den Prozess zur Fehlerbehebung durch: https://service.tc-innovations.de/themeware/sw5/debugging 

Fehlerbeschreibung

Nach dem Update auf Shopware 5.6.7 funktioniert der Warenkorb eines oder mehrer Sprach-Shops nicht mehr. 

Du erhälst im Frontend die Fehlermeldung "Uncaught TypeError: Return value of Shopware_Controllers_Frontend_Checkout::isShippingAllowed() must be of the type bool [...]".

Ursache

Der Fehler steht unmittelbar mit dem Shopware Update im Zusammenhang und wird nicht durch ThemeWare verursacht. Ursache sind alte Übersetzungszustände.

Lösung

Zu dem Fehler gibt es bereits mehrere Einträge im Shopware Forum, z.B. hier: https://forum.shopware.com/discussion/69249/aufruf-des-warenkorbs-im-en-sprachhop-gibt-seit-update-auf-5-6-7-fehler

1. Lösungsmöglichkeit

Öffne und speichere alle Länder-Übersetzungen unter "Grundeinstellungen > Shopeinstellungen > Länder > Deutschland etc. > Übersetzung von Name".

2. Lösungsmöglichkeit

Passe die Methode isShippingAllowed() in dem Frontend Controller an. Füge dazu nach diesen Zeilen folgenden Code ein:

if (!array_key_exists('allow_shipping', $countryTranslations[$countryId])) {
  return $allowedByDefault;
}

private function isShippingAllowed(int $countryId): bool
{
  $queryBuilder = $this->get('dbal_connection')->createQueryBuilder();

  $allowedByDefault = (bool) $queryBuilder->select('allow_shipping')
    ->from('s_core_countries', 'countries')
    ->where('countries.id = :countryId')
    ->setParameter(':countryId', $countryId)
    ->execute()
    ->fetchColumn();

  $countryTranslations = $this->get('modules')->sAdmin()->sGetCountryTranslation();

  if (!$countryTranslations) {
    return $allowedByDefault;
  }

  if (!array_key_exists($countryId, $countryTranslations)) {
    return $allowedByDefault;
  }

  if (!array_key_exists('allow_shipping', $countryTranslations[$countryId])) {
    return $allowedByDefault;
  }

  return $countryTranslations[$countryId]['allow_shipping'];
}

Fehlerbeschreibung

Textbauseine des Themes werden in einer falschen Sprache im Frontend angezeigt. Beispiel: Texte der USP-Leiste oder Vorteile im Checkout.

Ursache

Platzhalter werden in der ThemeWare-Konfiguration für die jeweilige Sprache des Backend geladen und entsprechend im Frontend angezeigt. Werden diese Platzhalter nicht individuell angepasst oder einmal bearbeiten und gespeichert, werden diese in der jeweiligen Sprache des Backend auch im Frontend angezeigt.

Lösung

1. ThemeWare-Konfiguration in der jeweils anderen Backend-Sprache erneut öffneten und den Cache leeren. 
2. ThemeWare-Konfiguration öffnen und das jeweilige Konfigurationsfeld anpassen, speichern und Cache leeren.
3. Textbausteine anhand unserer Auflistung direkt in Shopware anpassen: https://service.tc-innovations.de/themeware/sw5/article/2037-themeware-uebersetzen-textbausteine