# 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](https://store.shopware.com/erweiterungen/?shopwareVersion=6\&p=1) oder unser kostenfreies "ThemeWare® Customizing Plugin" (eine Erweiterung auf Basis des Plugin-Systems von Showpare 6) einsetzen.

{% hint style="info" %}
**Hinweis**: Nutze in der Shopware 6 Cloud bitte die "[ThemeWare® Customizing App](https://wiki.themeware.design/mehr-wissen/themeware-tools/themeware-customizing-app)".
{% endhint %}

***

## Download

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

{% embed url="<https://service.themeware.design/themeware-utilities>" %}
ThemeWare® Utilities
{% endembed %}

{% hint style="warning" %}
**Wichtig**: Bitte beachte, dass wir das "ThemeWare® Customizing Plugin" kostenfrei anbieten und für das Plugin oder individuelle Anpassungen **keinen Support** anbieten können.
{% endhint %}

***

## 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:

{% content-ref url="../../wissensdatenbank/shopware/konfiguration/erweiterungen/erweiterungen-manuell-installieren-1" %}
[erweiterungen-manuell-installieren-1](https://wiki.themeware.design/wissensdatenbank/shopware/konfiguration/erweiterungen/erweiterungen-manuell-installieren-1)
{% endcontent-ref %}

Wurde die Erweiterung erfolgreich installiert, erscheinen Beispiel-Implementierungen (ein "Testbanner") in der Storefront:

<figure><img src="https://2128686145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTCpdN4monqL7jrjwbCZL%2Fuploads%2F0hXr1eWTdskWAXx0HiKv%2Fimage.png?alt=media&#x26;token=46e970e3-3e27-47c9-92e9-93163c5cc4fd" alt=""><figcaption><p>ThemeWare® Customizing Plugin</p></figcaption></figure>

### Beispiel-Implementierungen aktivieren/deaktivieren

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

***

## Aufbau und Funktion

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`
  * **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`

{% hint style="info" %}
**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.
{% endhint %}

***

## Update

Da das Plugin kostenfrei und nicht über den Shopware Store erhältlich ist, gibt es derzeit keine automatische Update-Möglichkeit.&#x20;

Den **Download-Link für die neueste Version** erhältst du stets über die ThemeWare® Utilities. Falls erforderlich, registriere dich einfach erneut:

{% embed url="<https://service.themeware.design/themeware-utilities>" %}
ThemeWare® Utilities
{% endembed %}

{% hint style="warning" %}
**Wichtig**: Bitte beachte, dass wir das "ThemeWare® Customizing Plugin" kostenfrei anbieten und für das Plugin oder individuelle Anpassungen **keinen Support** anbieten können.
{% endhint %}

Deaktiviere das Plugin bevor du ein Shopware-Update durchführst. Informationen zum manuellen aktualisieren deines Plugins findest du nachfolgend:

### Manuelles Update

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.

{% hint style="info" %}
**Hinweis**: Eine aktuelle Version findest du in den [ThemeWare® Utilities](https://service.themeware.design/themeware-utilities).
{% endhint %}

Nachfolgend findest du Hinweise zu manuellen Update-Möglichkeiten für die letzten Shopware 6 Major-Releases:

### Shopware 6.7

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:

<pre class="language-json" data-title="composer.json"><code class="lang-json">"require": {
 "shopware/core": "6.6.*"
},

"require": {
<strong> "shopware/core": "6.7.*"
</strong>},
</code></pre>

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:

<pre class="language-twig" data-title="base.html.twig"><code class="lang-twig">{% block base_header %}
>>
<strong>{% block base_body_inner %}
</strong></code></pre>

{% hint style="info" %}
**Hinweis**: Bitte beachte, dass Deine individuellen Anpassungen ggf. ebenfalls kompatibel gemacht werden müssen.
{% endhint %}

Mehr Informationen zu den umfangreichen Änderungen der Storefront in Shopware 6.7 findest du im ThemeWare® Service Portal:

{% embed url="<https://service.themeware.design/news/20250519-shopware-6.7-das-musst-du-wissen>" %}

### Shopware 6.6

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:

<pre class="language-json" data-title="composer.json"><code class="lang-json">"require": {
 "shopware/core": "6.5.*"
},

"require": {
<strong> "shopware/core": "6.6.*"
</strong>},
</code></pre>

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

{% hint style="info" %}
**Hinweis**: Bitte beachte, dass Deine individuellen Anpassungen ggf. ebenfalls kompatibel gemacht werden müssen.
{% endhint %}

Mehr Informationen zu den umfangreichen Änderungen der Storefront in Shopware 6.6 findest du im Service Portal:

{% embed url="<https://service.themeware.design/news/20240308-shopware-6.6>" %}

### Shopware 6.5

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:

<pre class="language-json" data-title="composer.json"><code class="lang-json">"require": {
 "shopware/core": "6.4.*"
},

"require": {
<strong> "shopware/core": "6.5.*"
</strong>},
</code></pre>

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:

{% embed url="<https://service.themeware.design/news/20230417-shopware-6.5>" %}

### Shopware 6.4

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:

<pre class="language-json" data-title="composer.json"><code class="lang-json">"require": {
 "shopware/core": "6.3.*"
},

"require": {
<strong> "shopware/core": "6.4.*"
</strong>},
</code></pre>

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:

<pre class="language-twig"><code class="lang-twig">shopware.theme["..."] => theme_config('..')
>>
<strong>shopware.config.core... => config('core...')
</strong></code></pre>

> Stand: Shopware 6.6.0