In dieser Anleitung erfährst du, wie du individuelle Anpassungen mit dem "ThemeWare® Customizing Plugin" vornehmen kannst.
Last updated
© 2024 by ThemeWare® | Made with 💙 by TC-Innovations GmbH
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.
Tipp: Das erstellen eines ThemeWare® Duplikates ist für SCSS- bzw. Template-Anpassungen nicht notwendig.
Hinweis: Nutze in der Shopware 6 Cloud bitte die "ThemeWare® Customizing App".
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:
Tipp: Bist du unerfahren im Umgang mit SCSS und Twig empfehlen wir dir Unterstützung zu suchen. Gern können wir dich natürlich auch bei individuellen Anpassungen unterstützen: Anpassungen anfragen
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:
Lade die Zip-Datei unserer Erweiterung herunter
Entpacke die Zip-Datei mit "Hier entpacken"
SCSS-Anpassungen
SCSS-Datei(en)
Erstelle eine neue SCSS-Datei und importiere diese über die Datei "base.scss"
Pfad: "src/Resources/app/storefront/src/scss"
Tipp: Orientiere dich bezüglich Datei-Name und -Pfad einfach an den Quelldateien.
Hinweis: Erstelle benötigte oder fehlende Ordner.
Du kannst deinen SCSS-Code auch direkt in der "base.scss" hinterlegen.
Füge deinen gewünschten SCSS-Code ein
Speichere die Änderung der Datei(en)
Template-Anpassungen
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.
Hinweis: Erstelle benötigte oder fehlende Ordner.
Füge deinen gewünschten Twig-Code ein
Speichere die Änderung der Datei
Deaktiviere und deinstalliere das "ThemeWare® Customizing Plugin" falls du dies bereits installiert und aktiviert hast
Zippe den Ordner "TcinnCustomizing"
Lade die Erweiterung über Shopware 6 Erweiterungs-Verwaltung in deinen Shop
Installiere und aktiviere die Erweiterung danach
Ö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
Mac: Command (⌘) + Shift (⇧) + R oder Command (⌘) + Option/Alt (⌥) + R
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: