Individuelle Anpassungen mit dem ThemeWare® Customizing Plugin

In dieser Anleitung erfährst du, wie du individuelle Anpassungen mit dem "ThemeWare® Customizing Plugin" vornehmen kannst.

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".

---

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".

---

Hilfreiche Grundlagen

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:

Individuelle Anpassungen mittels SCSSIndividuelle Template-Anpassungen (Twig, HTML)

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

---

Anpassungen mit dem ThemeWare® Customizing Plugin integrieren (für erfahrende Anwender)

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:

ThemeWare® Customizing Plugin

1. Erweiterung vorbereiten (nur bei der ersten Verwendung nötig)

1. Lade die Zip-Datei unserer Erweiterung herunter

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

2. Anpassungen integrieren

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"

      • Tipp: Orientiere dich bezüglich Datei-Name und -Pfad einfach an den Quelldateien.

      • Hinweis: Erstelle benötigte oder fehlende Ordner.

   2. Du kannst deinen SCSS-Code auch direkt in der "base.scss" hinterlegen.

2. Füge deinen gewünschten SCSS-Code ein

3. Speichere die Änderung der Datei(en)

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.

   • Hinweis: Erstelle benötigte oder fehlende Ordner.

2. Füge deinen gewünschten Twig-Code ein

3. Speichere die Änderung der Datei

3. Erweiterung installieren/aktualisieren

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

4. Installiere und aktiviere die Erweiterung danach

4. Theme kompilieren (bei SCSS-Änderungen stets nötig)

• Ö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.

5. Cache leeren (bei Template-Änderungen stets nötig)

• 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.

---

Erweiterung "live" bearbeiten

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

---

Nachträgliche Änderungen

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.

---

Tipps

CSS-Hierarchie

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:

CSS-Hierarchie

Template-Hierarchie

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:

TcinnCustomizing.php

public function getTemplatePriority(): int
{
    return 100; // hohe Priorität
}

shopware/src/Core/Framework/Bundle.php at trunk · shopware/shopwareGitHub