ThemeWare® Customizing App (Cloud)

Individuelle Anpassungen müssen bei Shopware 6 mit einem eigenen Theme oder einer Erweiterung (Plugin oder App) umgesetzt werden.

Für die Integration von individuellen Anpassungen kannst du eine Erweiterung aus dem Shopware Community Store oder unsere kostenfreie "ThemeWare® Customizing App" (eine Erweiterung auf Basis des App-Systems von Shopware 6) einsetzen.

Download

Den Download-Link für die kostenlose "Customizing App" erhältst du über die ThemeWare® Utilities:

Installation

Die App muss über die Administration von Shopware unter "Erweiterungen" => "Meine Erweiterungen" über den Button "Erweiterung hochladen" hochgeladen werden.

Installiere und aktiviere die App danach.

Es kann vorkommen, dass bei der Aktivierung der Fehler "Undefined variable $twt-color-brand-secondary-light" erscheint. Die App wird aber dennoch aktiviert.

Unable to compile the theme "Storefront". Undefined variable $twt-color-brand-secondary-light...

Kompiliere nach der Aktivierung einmal dein ThemeWare® Theme neu (speichere dazu beispielsweise einfach die Theme-Konfiguration unverändert ab) und leere einmal den Shopware-Cache.

Mehr Informationen zur manuellen Installation von Erweiterungen findest du im Artikel:

Wurde die Erweiterung erfolgreich installiert, erscheinen Beispiel-Implementierungen (eine JavaScript "Testnachricht" und ein "Testbanner") in der Storefront:

Ab Version 4.0 kannst du in den App-Einstellungen die Beispiel-Implementierungen (z.B. den "Testbanner") aktivieren bzw. deaktivieren.

Durch die "ThemeWare® Customizing App" ist es möglich individuelle Anpassungen hinterlegen zu können. Die nachfolgenden Ordner und Dateien sind dabei relevant.

• Datei "base.scss":

  • Basis für alle Anpassungen mit CSS/SCSS

  • Ordner: Resources/app/storefront/src/scss

Da die App kostenfrei und nicht über den Shopware Store erhältlich ist, gibt es derzeit keine automatische Update-Möglichkeit.

Den Download-Link für die neueste Version erhältst du stets über die ThemeWare® Utilities. Falls erforderlich, registriere dich einfach erneut:

Deaktiviere die App bevor du ein Shopware-Update durchführst. Informationen zum manuellen aktualisieren deiner App findest du nachfolgend:

Da bei einem Update von Erweiterungen alle Änderungen auf Datei-Ebene überschrieben werden ist es wichtig den Ordner custom/apps/TcinnCustomizingApp/src vor einem Update zu sichern und nach dem Update wieder hochzuladen.

Nachfolgend findest du Hinweise zu manuellen Update-Möglichkeiten für die letzten Shopware 6 Major-Releases:

Die Customizing-App für Shopware 6.6 ist bereits kompatibel mit Shopware 6.7.

Die einzige Änderung die nötig ist betrifft den Twig-Block für unsere Beispielanpassung, diesen Block hast du aber vermutlich bereits entfernt oder aus kommentiert:

Mehr Informationen zu den umfangreichen Änderungen der Storefront in Shopware 6.7 findest du im ThemeWare® Service Portal:

Um die Customizing-App kompatibel für Shopware 6.6 zu machen musst du folgende Änderungen vornehmen:

Falls du es nicht bereits für Shopware 6.5 gemacht hast, aktualisiere bitte die Datei "_messagebox.scss":

Darüber hinaus wurde die Integration von JavaScript-Plugins in die Storefront mit Shopware 6.6 geändert. Lösche bitte alle Scripte im Ordner Resources\app\storefront\dist\storefront\js und baue die Storefront einmal neu (z.B. mit build-storefront.sh).

Mehr Informationen zu den umfangreichen Änderungen der Storefront in Shopware 6.6 findest du im Service Portal:

Um das Customizing-Plugin grundsätzlich kompatibel für Shopware 6.5 zu machen, reicht es die benötigte Shopware Version in der Datei "_messagebox.scss" wie folgt zu modifizieren:

Dadurch wird die Erweiterung mit Shopware 6.5 kompatibel und braucht nicht aktualisiert werden.

Stand: Shopware 6.6.0