Alle Seiten
Bereitgestellt von GitBook
1 von 4

Loading...

Loading...

Loading...

Loading...

ThemeWare® Customizing Plugin

In diesem Artikel erfährst du alles über das kostenfreie "ThemeWare® Customizing Plugin".

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 unser kostenfreies "ThemeWare® Customizing Plugin" (eine Erweiterung auf Basis des Plugin-Systems von Shopware 6) einsetzen.

Hinweis: Nutze in der Shopware 6 Cloud bitte die "".


Download

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

Wichtig: Bitte beachte, dass wir das "ThemeWare® Customizing Plugin" kostenfrei anbieten und für das Plugin oder individuelle Anpassungen keinen Support anbieten können.


Installation

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

Installiere und aktiviere die Erweiterung danach.

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 (ein "Testbanner") in der Storefront:

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


Durch das "ThemeWare® Customizing Plugin" 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: src/Resources/app/storefront/src/scss


Da das Plugin 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 das Plugin bevor du ein Shopware-Update durchführst. Informationen zum manuellen aktualisieren deines Plugins findest du nachfolgend:

Da bei einem Update von Erweiterungen alle Änderungen auf Datei-Ebene überschrieben werden ist es wichtig den Ordner custom/plugins/TcinnCustomizing/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:

Um das Customizing-Plugin kompatibel für Shopware 6.7 zu machen, reicht es die benötigte Shopware Version in der Datei "composer.json" wie folgt zu modifizieren:

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

Darüber hinaus ändert sich der 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 das Customizing-Plugin kompatibel für Shopware 6.6 zu machen, reicht es die benötigte Shopware Version in der Datei "composer.json" wie folgt zu modifizieren:

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

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 "composer.json" wie folgt zu modifizieren:

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

Bitte beachte, dass deine individuellen Anpassungen ggf. ebenfalls kompatibel gemacht werden müssen. Mehr Informationen zu den umfangreichen Änderungen der Storefront in Shopware 6.5 findest du im Service Portal:

Um das Customizing-Plugin grundsätzlich kompatibel für Shopware 6.4 zu machen, reicht es die Datei "main.scss" in "base.scss" um zu benennen und die benötigte Shopware Version in der Datei "composer.json" wie folgt zu modifizieren:

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

Bitte beachte, dass Deine individuellen Anpassungen ggf. ebenfalls kompatibel gemacht werden müssen. Die wichtigste Änderung in Shopware 6.4 ist der Abruf von Theme- bzw. Shopware Variablen:

Stand: Shopware 6.7.0

Hinweis: In der Datei sind Beispielanpassungen hinterlegt, die bearbeitet oder gelöscht werden können.

  • Datei "base.html.twig":

    • Beispiel für Template-Anpassungen mit Twig/HTML

    • Ordner: src/Resources/views/storefront

    • Hinweis: In der Datei sind Beispielanpassungen hinterlegt, die bearbeitet oder gelöscht werden können.

  • Assets

    • Ordner: src/Resources/public

  • composer.json
    "require": {
     "shopware/core": "6.6.*"
    },
    
    "require": {
     "shopware/core": "6.7.*"
    },
    base.html.twig
    {% block base_header %}
    
    >>
    {% block base_body_inner %}
    composer.json
    "require": {
     "shopware/core": "6.5.*"
    },
    
    "require": {
     "shopware/core": "6.6.*"
    },
    composer.json
    "require": {
     "shopware/core": "6.4.*"
    },
    
    "require": {
     "shopware/core": "6.5.*"
    },
    composer.json
    "require": {
     "shopware/core": "6.3.*"
    },
    
    "require": {
     "shopware/core": "6.4.*"
    },
    shopware.theme["..."] => theme_config('..')
    
    >>
    shopware.config.core... => config('core...')
    Erweiterungen manuell installieren
    ThemeWare® Customizing App
    ThemeWare® Customizing Plugin

    Beispiel-Implementierungen aktivieren/deaktivieren

    Aufbau und Funktion

    Hinweis: In der "base.scss" sowie der "base.html.twig" findest du Beispielanpassungen für den "Testbanner" im Header. Passe den Inhalt der Dateien an deine Wünsche an.

    Update

    Wichtig: Bitte beachte, dass wir das "ThemeWare® Customizing Plugin" kostenfrei anbieten und für das Plugin oder individuelle Anpassungen keinen Support anbieten können.

    Manuelles Update

    Hinweis: Eine aktuelle Version findest du in den ThemeWare® Utilities.

    Shopware 6.7

    Hinweis: Ob deine bisherige Version mit Shopware 6.7 weiterverwendet werden kann, hängt vor allem von deinen konkreten Anpassungen ab. Prüfe dies am besten zunächst in einer Test- bzw. Staging-Umgebung.

    Hinweis: Bitte beachte, dass Deine individuellen Anpassungen ggf. ebenfalls kompatibel gemacht werden müssen.

    Shopware 6.6

    Hinweis: Bitte beachte, dass Deine individuellen Anpassungen ggf. ebenfalls kompatibel gemacht werden müssen.

    Shopware 6.5

    Shopware 6.4

    Shopware 6.6: Ein Ausblick | ThemeWare® Service PortalThemeWare®
    Logo
    Shopware 6.5 | ThemeWare® Service PortalThemeWare®
    Shopware 6.7 – Das musst du wissen | ThemeWare® Service PortalThemeWare®
    Logo
    Logo

    ThemeWare® Erlebniswelten-Import (Plugin)

    In diesem Artikel erfährst du alles über das kostenfreie Plugin "ThemeWare® Erlebniswelten-Import".

    Damit du die Erlebniswelt deines Themes möglichst einfach installieren kannst, haben wir ein kostenloses 1-Klick-Import-Plugin für dich entwickelt.

    Die Erweiterung basiert auf dem Plugin-System von Shopware. Das bedeutet, sie wurde für die Nutzung in Self-hosted Shops entwickelt. Eine Nutzung in der Shopware Cloud ist nicht möglich.

    Hinweis: Nutzern der Shopware 6 Cloud empfehlen wir die Schritt-für-Schritt-Anleitung im PDF-Format aus unseren .

    Wir empfehlen das Plugin – nach Möglichkeit – nicht in Produktiv-Umgebungen zu nutzen sondern vor dem Livegang.


    Download

    Den Download-Link für das kostenlose Plugin "ThemeWare® Erlebniswelten-Import" erhältst du über die ThemeWare® Utilities:

    Stand: 05/2026 (v2.0.1)


    Die Zip-Datei der Erweiterung muss über die Administration von Shopware unter "Erweiterungen" (1) => "Meine Erweiterungen" (2) über den Button "Erweiterung hochladen" (3) hochgeladen werden.

    Installiere (4) und aktiviere (5) die Erweiterung danach.

    Beim Aktivieren des Plugins werden die verfügbaren Erlebniswelten und die nötigen Bilder importiert.

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

    Hinweis:

    Die Beispiel-Bilder werden in einen Unterordner ThemeWare® <Theme-Name> im Standard-Ordner "CMS Media" importiert. Erhältst du bei der Installation eine Fehlermeldung mit dem Hinweis "No default folder for entity "cms_page" found" fehlt dieser Ordner in deiner Administration.

    Erstelle bitten den entsprechenden Ordner damit die Installation funktioniert:


    Wurde die Erweiterung erfolgreich installiert und aktiviert findest du die entsprechende Erlebniswelt bzw. die entsprechenden Erlebniswelten in der Erlebniswelt-Verwaltung deines Shops.

    Die Erlebniswelt-Verwaltung findest du in der Administration von Shopware unter "Inhalte" (1) => "Erlebniswelten" (2).

    Die Layouts sind gesperrt und können nicht direkt modifiziert werden. Dupliziere (3, 4) als erstes das entsprechende Erlebniswelt-Layout und nutze das Duplikat dann für deine Anpassungen.

    Damit stellst du sicher, dass dein individuelles Layout nicht versehentlich deinstalliert wird und updatesicher ist.


    Die Erweiterung importiert beim Aktivieren automatisch die nötigen Vorschau-Bilder für die entsprechenden Erlebniswelten. Die Vorschau-Bilder findest du in der Medienverwaltung ("Inhalte" => "Medien") im Ordner CMS Media > ThemeWare® <Theme-Name>.

    Die ThemeWare® Erlebniswelten enthalten natürlich auch diverse Produkt-Slider. Nutzt du die Demodaten von Shopware, werden die Produkt-Slider automatisch mit Produkten aus den Demodaten befüllt. Nutzt du die Demodaten nicht, sind die Produkt-Slider leer und damit "unkonfiguriert". Füge in diesem Fall einfach Produkte aus deinem Shop hinzu.


    Beim Aktivieren werden:

    • die Erlebniswelt-Vorlagen dieses Themes in deinen Shop importiert

    • die zugehörigen Bilder in einen eigenen Media-Ordner ThemeWare® <Theme-Name> (unter "CMS Media") abgelegt

    • die importierten Erlebniswelten gegen versehentliches Bearbeiten gesperrt – siehe Hinweis weiter oben zum Duplizieren

    Du kannst das Plugin jederzeit deaktivieren und wieder aktivieren. Sind die Demodaten noch vorhanden, werden sie beim erneuten Aktivieren lediglich aktualisiert.

    Beim Deaktivieren passiert nichts an deinen Daten. Erlebniswelten, Bilder und Media-Ordner bleiben unverändert. Praktisch, wenn du das Plugin temporär abschalten möchtest, ohne Inhalte deines Shops zu verändern.

    Beim Deinstallieren bietet dir Shopware zwei Optionen:

    Standard (Haken bei "Alle App-Daten endgültig entfernen" nicht gesetzt)

    • Die Erlebniswelt-Vorlagen werden entfernt – sie sind reines Plugin-Eigentum und stünden sonst verwaist im Backend

    • Deine Duplikate der Erlebniswelt-Vorlagen bleiben erhalten

    • Bilder bleiben erhalten und können von dir weiterhin verwendet werden

    Mit Haken bei "Alle App-Daten endgültig entfernen"

    • Die Erlebniswelt-Vorlagen werden entfernt

    • Deine Duplikate der Erlebniswelt-Vorlagen bleiben erhalten

    • Die Bilder werden ebenfalls entfernt – aber nur die, die du nirgends mehr verwendest. Bilder, die du z.B. als Produktbild oder in einer eigenen Erlebniswelt eingebunden hast, bleiben automatisch erhalten


    Da das Plugin kostenfrei und nicht über den Shopware Store erhältlich ist, gibt es derzeit keine automatische Update-Möglichkeit. Deaktiviere das Plugin wenn du deine Erlebniswelt eingerichtet hast – spätestens bevor du ein Shopware-Update durchführst.

    Hinweis: Die aktuellste Version erhälst du stets über die ThemeWare® Utilities.

    Der Media-Ordner ThemeWare® <Theme-Name> bleibt bestehen, sofern er noch Bilder enthält
    Der Media-Ordner ThemeWare® <Theme-Name> wird gelöscht, sofern er leer ist
    Erweiterungen manuell installieren
    Standardordner für Medien erstellen
    ThemeWare® Utilities
    Erweiterungs-Verwaltung
    Erlebniswelt-Verwaltung

    Wichtig: Bitte beachte, dass wir das Plugin "ThemeWare® Erlebniswelten-Import" kostenfrei anbieten und für das Plugin keinen Support anbieten.

    Installation

    Wichtig: Bitte beachte das die Daten beim Aktivieren des Plugins importiert werden und ggf. bestehende Daten (früherer Imports) überschreiben.

    Hinweis: Das Installieren legt das Plugin in deinem Shop ab, importiert aber noch keine Demodaten. Erst beim Aktivieren werden Bilder und Erlebniswelten angelegt.

    Erlebniswelt bearbeiten

    Wichtig: Erlebniswelt-Vorlage duplizieren

    Bilder & Produkte

    Tipp: PSD-Vorlagen der Vorschaubilder erhältst du ebenfalls mit der ThemeWare® Utilities Mail.

    Aktivieren, Deaktivieren und Deinstallieren

    Aktivieren

    Deaktivieren

    Deinstallieren

    Update

    ThemeWare® Tools

    Mit ThemeWare® profitierst du vom kostenfreien Zugang zu den beliebten ThemeWare® Utilities. Diese hilfreichen Tools und Extras unterstützen dich Maßgeblich bei der Gestaltung und Optimierung deines Shops.

    Die ThemeWare® Tools umfassen nützliche Online-Assistenten sowie kostenlose Erweiterungen.

    Kostenfreie Online-Tools:

    • ThemeWare® Config-Finder

    Kostenlose Erweiterungen:

    In diesem Bereich der ThemeWare® Wissensdatenbank findest du alle Informationen zu diesen Erweiterungen. Suchst du spezifische Anleitungen schaue bitte in den Bereich "Anleitungen".


    Über folgenden Link erhältst einen kostenfreien Zugang zu den ThemeWare® Utilities für dein Theme. Diese werden dir sofort per E-Mail zugeschickt:

    ThemeWare® Fehlerbehebung (Debugging)
    ThemeWare® Suche
    ThemeWare® Verbesserungsvorschlag
    24/7 AI Support-Assistent
    ThemeWare® Customizing Plugin
    ThemeWare® Customizing App (Cloud)
    ThemeWare® Erlebniswelten-Import (Plugin)

    Download

    ThemeWare® Utilities kostenlos anfordern | ThemeWare® Service PortalThemeWare®
    ThemeWare® Utilities
    ThemeWare® Utilities kostenlos anfordern | ThemeWare® Service PortalThemeWare®
    ThemeWare® Utilities
    ThemeWare® Utilities kostenlos anfordern | ThemeWare® Service PortalThemeWare®
    ThemeWare® Utilities
    ThemeWare® Utilities kostenlos anfordern | ThemeWare® Service PortalThemeWare®
    ThemeWare® Service Portal > ThemeWare® Utilities
    Logo
    Logo
    Logo
    Logo

    ThemeWare® Customizing App (Cloud)

    In diesem Artikel erfährst du alles über die kostenfreie "ThemeWare® Customizing App".

    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.

    Hinweis: Nutze in der Shopware 6 (self-managed) bitte das "".


    Download

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

    ThemeWare® Utilities kostenlos anfordern | ThemeWare® Service PortalThemeWare®
    ThemeWare® Utilities

    Wichtig: Bitte beachte, dass wir die "ThemeWare® Customizing App" kostenfrei anbieten und für die App oder individuelle Anpassungen keinen Support anbieten können.


    Installation

    Wichtig: Die Möglichkeit Apps manuell in der Cloud installieren zu können ist noch ganz frisch und derzeit in der Beta-Phase!

    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

    Hinweis: In der Datei sind Beispielanpassungen hinterlegt, die bearbeitet oder gelöscht werden können.

  • Datei "base.html.twig":

    • Beispiel für Template-Anpassungen mit Twig/HTML

    • Ordner: Resources/views/storefront

    • Hinweis: In der Datei sind Beispielanpassungen hinterlegt, die bearbeitet oder gelöscht werden können.

  • Datei "custom.plugin.js":

    • Beispiel für ein JS-Plugin (wird über die Datei Resources/app/storefront/src/main.js importiert)

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

    • Hinweis: In der Datei ist ein Beispiel JS-Plugin hinterlegt, das bearbeitet oder gelöscht werden kann.

  • Assets

    • Ordner: Resources/public

  • base.html.twig
    {% block base_header %}
    
    >>
    {% block base_body_inner %}
    _messagebox.scss
    color: color-yiq($twt-color-brand-secondary-light);
    
    >>
    color: color-contrast($twt-color-brand-secondary-light);
    _messagebox.scss
    color: color-yiq($twt-color-brand-secondary-light);
    
    >>
    color: color-contrast($twt-color-brand-secondary-light);
    ThemeWare® Utilities kostenlos anfordern | ThemeWare® Service PortalThemeWare®
    ThemeWare® Utilities
    Shopware 6.7 – Das musst du wissen | ThemeWare® Service PortalThemeWare®
    Shopware 6.6: Ein Ausblick | ThemeWare® Service PortalThemeWare®
    Erweiterungen manuell installieren
    ThemeWare® Customizing Plugin
    ThemeWare® Customizing App

    Beispiel-Implementierungen aktivieren/deaktivieren

    Aufbau und Funktion

    Hinweis: In der "base.scss", der "base.html.twig" sowie der "custom.plugin.js" findest du Beispielanpassungen. Passe den Inhalt der Dateien an deine Wünsche an.

    Update

    Manuelles Update

    Hinweis: Eine aktuelle Version findest du in den ThemeWare® Utilities.

    Shopware 6.7

    Hinweis: Ob deine bisherige Version mit Shopware 6.7 weiterverwendet werden kann, hängt vor allem von deinen konkreten Anpassungen ab. Prüfe dies am besten zunächst in einer Test- bzw. Staging-Umgebung.

    Hinweis: Bitte beachte, dass Deine individuellen Anpassungen ggf. ebenfalls kompatibel gemacht werden müssen.

    Shopware 6.6

    SCSS

    JavaScript

    Hinweis: Bitte beachte, dass Deine individuellen Anpassungen ggf. ebenfalls kompatibel gemacht werden müssen.

    Shopware 6.5

    Logo
    Logo
    Logo
    Logo