Individuelle Anpassungen mit dem ThemeWare® Customizing Plugin

Wie du das Erscheinungsbild von ThemeWare® in Shopware 6 (self-managed) mittels einer individuellen Anpassung und mit unserem kostenfreien "ThemeWare® Customizing Plugin" verändern kannst, erfährst du in diesem Artikel.

Einleitung

Für individuelle Anpassungen brauchst du in Shopware 6 ein eigenes Theme oder eine separate Erweiterung (Plugin oder App) und nicht – wie bei Shopware 5 – eine Theme-Ableitung.

• Prüfe ob es im Shopware Community Store bereits eine passende Erweiterung gibt.

• Alternativ kannst du die folgende Methode mit dem "ThemeWare® Customizing Plugin" nutzen.

Nachfolgend erklären wir dir den Weg über unser "ThemeWare® Customizing Plugin".

Dieser Artikel richtet sich an erfahrene Anwender. Wir gehen in diesem Artikel daher davon aus, dass du die Grundlagen für Anpassungen via SCSS und Twig bereits verinnerlichst hast.

Falls du nicht erfahren im Umgang mit SCSS und Twig bist findest du hilfreiche Grundlagen zum Thema individuelle SCSS- und Template-Anpassungen findest du in den folgenden Artikeln:

In Shopware 6 fehlt derzeit ein vollwertiges Child-Theme über welches man Dateien einbinden und Änderungen vornehmen kann (wie z.B. bei Shopware 5). Wir haben als Workaround ein kleines kostenfreies "ThemeWare® Customizing Plugin" für die Integration von individuellen Anpassungen und eigenen Dateien in Shopware 6 (self-hosted) entwickelt.

Alle Informationen zum "ThemeWare® Customizing Plugin", der Installation und den Download-Link findest du im folgenden Artikel:

1. Lade die Zip-Datei unserer Erweiterung herunter

2. Entpacke die Zip-Datei mit "Hier entpacken"

Im Ordner TcinnCustomizing findest du alle Dateien der Erweiterung.

SCSS-Anpassungen

1. SCSS-Datei(en)

   1. Erstelle eine neue SCSS-Datei und importiere diese über die Datei "base.scss"

      • Pfad: "src/Resources/app/storefront/src/scss

Template-Anpassungen

1. Erstelle eine neue Template-Datei und leite darin die gewünschte Quelldatei ab

   • Pfad: "src/Resources/views/storefront"

   • Tipp: Orientiere dich bezüglich Datei-Benennung einfach an der Quelldatei.

1. Deaktiviere und deinstalliere das "ThemeWare® Customizing Plugin" falls du dies bereits installiert und aktiviert hast

2. Zippe den Ordner "TcinnCustomizing"

3. Lade die Erweiterung über Shopware 6 Erweiterungs-Verwaltung in deinen Shop

• Öffne das aktive ThemeWare® in der Theme-Verwaltung und speichere die Einstellungen unverändert ab, damit das Theme kompiliert wird und deine Änderungen in die Storefront übertragen werden.

• Leere den Shopware Cache in den Shopware Einstellungen ("Einstellungen" => "System" => "Caches & Indizes" > "Caches leeren").

• Leeren den Browser-Cache

  • Windows: Strg + F5

Die Änderung sollte nun in deiner Storefront sichtbar sein.

Du kannst die Erweiterung auch direkt auf dem FTP bearbeiten. Deaktiviere dieses bevor du Änderungen vornimmst und aktiviere es wieder wenn du fertig.

Möchtest du zu einem späteren Zeitpunkt Änderungen vornehmen, deaktiviere die Erweiterung über die Erweiterungs-Verwaltung vor dem Upload und aktiviere es wieder wenn du fertig.

Hinweis: Es kann nötig sein, dass du die Erweiterung auch einmal deinstallierst damit Änderungen in die Storefront übernommen werden.

Du kannst die CSS-Hierarchie beim Überschreiben von CSS/SCSS-Anweisungen ganz einfach mit der "Body-Klasse" in der ThemeWare® Konfiguration beeinflussen. Dadurch kannst du unschöne !important Anweisungen vermeiden.

Mehr Informationen dazu findest du in folgender Anleitung:

Seit Shopware 6.4.12 kann man mit der Methode getTemplatePriority() die Renderreihenfolge von Erweiterungen bestimmen (Default: -1).

Damit du mit dem "Customizing Plugin" andere Erweiterungen überschreiben kannst, musst du die Priorität über eine Funktion in der TcinnCustomizing.php ändern: