Alle Seiten
Bereitgestellt von GitBook
1 von 1

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.7 – Das musst du wissen | ThemeWare® Service PortalThemeWare®
    Logo
    ThemeWare® Utilities kostenlos anfordern | ThemeWare® Service PortalThemeWare®
    ThemeWare® Utilities
    ThemeWare® Utilities kostenlos anfordern | ThemeWare® Service PortalThemeWare®
    ThemeWare® Utilities
    Logo
    Logo
    Shopware 6.5 | ThemeWare® Service PortalThemeWare®
    Logo