# Individuelle Anpassungen mit der ThemeWare® Customizing App (Cloud)

Wie du das Erscheinungsbild von ThemeWare® in der Shopware 6 Cloud mittels einer **individuellen Anpassung** und mit unserer kostenfreien "ThemeWare® Customizing App" verändern kannst, erfährst du in diesem Artikel.

{% hint style="success" %}
**Tipp**: Das erstellen eines ThemeWare® Duplikates ist für SCSS- bzw. Template-Anpassungen nicht notwendig.
{% endhint %}

{% hint style="info" %}
**Hinweis**: Nutze in Shopware 6 (self-managed) bitte das "[ThemeWare® Customizing Plugin](https://wiki.themeware.design/wissensdatenbank/anleitungen/individuelle-anpassungen/individuelle-anpassungen-mit-dem-themeware-customizing-plugin)".
{% endhint %}

***

## 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](https://store.shopware.com/erweiterungen/?p=1\&o=12\&n=21\&shopwareVersion=6) bereits eine passende Erweiterung gibt.
* Alternativ kannst du die folgende Methode mit der "ThemeWare® Customizing App" nutzen.

Nachfolgend erklären wir dir den Weg über unsere "ThemeWare® Customizing App".

***

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

{% content-ref url="individuelle-anpassungen-mittels-scss" %}
[individuelle-anpassungen-mittels-scss](https://wiki.themeware.design/wissensdatenbank/anleitungen/individuelle-anpassungen/individuelle-anpassungen-mittels-scss)
{% endcontent-ref %}

{% content-ref url="individuelle-template-anpassungen-twig-html" %}
[individuelle-template-anpassungen-twig-html](https://wiki.themeware.design/wissensdatenbank/anleitungen/individuelle-anpassungen/individuelle-template-anpassungen-twig-html)
{% endcontent-ref %}

{% hint style="success" %}
**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](https://service.themeware.design/individuelle-anpassungen)
{% endhint %}

***

## Anpassungen mit der ThemeWare® Customizing App 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). Zudem hat man in der Cloud keinen Zugriff auf das Dateisystem. Wir haben als Workaround eine kleine kostenfreie "ThemeWare® Customizing App" für die Integration von individuellen Anpassungen und eigenen Dateien in der Shopware 6 Cloud entwickelt.

{% hint style="info" %}
**Hinweis**: Da in der Cloud kein direkter Zugriff auf das Dateisystem möglich ist, musst du die Customizing App **lokal bearbeiten** und anschließend über die Erweiterungsverwaltung **in Shopware hochladen**.
{% endhint %}

Alle Informationen zur "ThemeWare® Customizing App", der Installation und den Download-Link findest du im folgenden Artikel:

{% content-ref url="../../../mehr-wissen/themeware-tools/themeware-customizing-app" %}
[themeware-customizing-app](https://wiki.themeware.design/mehr-wissen/themeware-tools/themeware-customizing-app)
{% endcontent-ref %}

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

1. Lade die Zip-Datei unserer App herunter
2. Entpacke die Zip-Datei mit "Hier entpacken"

### 2. Anpassungen integrieren

Im Ordner `TcinnCustomizingApp` findest du alle Dateien der Erweiterung.

**SCSS-Anpassungen**

1. Öffne die Datei "**base.scss**"
   * **Pfad**: "`Resources/app/storefront/src/scss`"
2. Füge deinen gewünschten SCSS-Code ein
3. Speichere die Änderung der Datei

**Template-Anpassungen**

1. Erstelle eine neue Template-Datei und leite darin die gewünschte Quelldatei ab
   * **Pfad**: "`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. App installieren/aktualisieren

1. Deaktiviere und deinstalliere die "ThemeWare® Customizing App" falls du dies bereits installiert und aktiviert hast
2. Zippe den Ordner "`TcinnCustomizingApp`"
3. Lade die App über Shopware 6 Erweiterungs-Verwaltung in deinen Shop
4. Installiere und aktiviere die App danach

{% hint style="info" %}
**Hinweis**: Um Erweiterungen aktualisieren zu können muss die Versionsnummer in der `manifest.xml` höher sein, als die aktuelle Version. Durch das deinstallieren und wieder installieren, sparst du dir diesen Schritt.
{% endhint %}

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

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

***

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

{% content-ref url="css-hierarchie" %}
[css-hierarchie](https://wiki.themeware.design/wissensdatenbank/anleitungen/individuelle-anpassungen/css-hierarchie)
{% endcontent-ref %}

### Template-Hierarchie

Seit Shopware 6.4.12 kann man der Konfiguration `storefront.template-load-priority` die Renderreihenfolge von Erweiterungen bestimmen (Default: -1).

Damit du mit der "Customizing App" andere Erweiterungen überschreiben kannst, musst du die Priorität über eine Konfiguration in der `manifest.xml` ändern:

{% code title="manifest.xml" %}

```xml
<storefront>
    <template-load-priority>100</template-load-priority>
</storefront>
```

{% endcode %}

{% embed url="<https://github.com/shopware/shopware/blob/trunk/tests/unit/Storefront/Theme/fixtures/Apps/test/manifest.xml#L35-L37>" %}
