> For the complete documentation index, see [llms.txt](https://docs.rh-webdesign.com/theme-manager/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rh-webdesign.com/theme-manager/erste-schritte/installation.md).

# Installation & Aktivierung

So installierst und aktivierst du den Theme - Manager und prüfst, ob dein Theme unterstützt wird.

Der Theme - Manager ist eine Erweiterung für Shopware 6.7. Er bündelt die Einstellungen für Layout, Produkte und Verkaufsförderung deiner Storefront an einer Stelle in der Administration. Du installierst ihn wie jede andere Shopware-Erweiterung – danach findest du ihn im Menü unter **Inhalte › Theme - Einstellungen**.

Die Installation erledigst du in der Administration unter **Erweiterungen › Meine Erweiterungen**.

<figure><img src="https://2298866969-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7jsLHIar9cIHQMU8bdJQ%2Fuploads%2Fgit-blob-2514d2ba5f10294b99bea9e8f662f1f9f2a9a78a%2Finstallation-meine-erweiterungen.webp?alt=media" alt="Der Theme - Manager unter Meine Erweiterungen"><figcaption><p>Der Theme - Manager unter „Meine Erweiterungen“ – installiert und aktiv.</p></figcaption></figure>

{% hint style="success" %}
Nach der Aktivierung musst du nichts weiter einrichten und nichts von Hand kompilieren: Shopware baut die Storefront beim Aktivieren automatisch neu auf. Alle Einstellungen starten mit Standardwerten.
{% endhint %}

## Voraussetzungen

<table><thead><tr><th width="287">Voraussetzung</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Shopware 6.7</td><td>Der Theme - Manager läuft mit jeder Version von Shopware 6.7.</td></tr><tr><td>Verkaufskanal vom Typ Storefront</td><td>Der Theme - Manager gestaltet deine Storefront. Verkaufskanäle ohne Storefront, etwa ein Headless-Kanal, zeigen seine Funktionen nicht.</td></tr><tr><td>Unterstütztes Theme</td><td>Das Shopware-Standard-Theme oder ein kompatibles Theme von RH-Webdesign – siehe <strong>Für welche Themes der Theme - Manager gilt</strong> weiter unten.</td></tr><tr><td>Internetverbindung des Servers</td><td>Die Themes von RH-Webdesign unter <strong>Themes verwalten</strong> und den Changelog lädt die Administration aus dem Shopware Store. Dafür muss dein Server den Shopware Store erreichen können. Alle anderen Einstellungen funktionieren auch ohne.</td></tr></tbody></table>

## Installieren und aktivieren

1. Öffne in der Administration **Erweiterungen › Meine Erweiterungen**.
2. Sorge dafür, dass der Theme - Manager in der Liste steht:
   * **Im Shopware Store gekauft:** Öffne den Reiter **Shopware Account** und melde dich mit deinem Shopware Account an. Deine gekauften Erweiterungen erscheinen danach in der Liste.
   * **Als ZIP-Datei erhalten:** Klicke auf **Erweiterung hochladen** (1) und wähle die ZIP-Datei aus.
3. Klicke in der Zeile **Theme - Manager – Design & Conversion für deine Storefront** auf **Installieren**. Shopware installiert die Erweiterung, aktiviert sie direkt und lädt die Seite neu.
4. Prüfe den Schalter (2) links in der Zeile: Ist er eingeschaltet, ist der Theme - Manager aktiv.

<table><thead><tr><th width="287">Funktion</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Erweiterung hochladen (1)</td><td>Lädt eine Erweiterung als ZIP-Datei hoch. Das brauchst du nur, wenn du den Theme - Manager nicht über deinen Shopware Account beziehst.</td></tr><tr><td>Schalter (2)</td><td>Zeigt, ob die Erweiterung aktiv ist, und schaltet sie ein oder aus. Ausgeschaltet bleibt der Theme - Manager installiert, wirkt aber nicht mehr in deinem Shop.</td></tr><tr><td>Menü „…“ (3)</td><td>Weitere Aktionen zur Erweiterung, zum Beispiel <strong>Deinstallieren</strong>.</td></tr></tbody></table>

{% hint style="info" %}
Eine Seite „Konfigurieren“ gibt es für den Theme - Manager unter „Meine Erweiterungen“ nicht. Alle Einstellungen erreichst du über das Menü **Inhalte › Theme - Einstellungen**.
{% endhint %}

## Der neue Menüpunkt

Nach der Aktivierung steht unter **Inhalte** der Menüpunkt **Theme - Einstellungen** mit drei Unterpunkten.

<figure><img src="https://2298866969-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7jsLHIar9cIHQMU8bdJQ%2Fuploads%2Fgit-blob-3097ac0b5fbd8bd20a2b1033745f6d3b081c5620%2Finstallation-menue.webp?alt=media" alt="Menüpunkt Theme - Einstellungen unter Inhalte" width="300"><figcaption><p>Der Theme - Manager im Menü der Administration.</p></figcaption></figure>

<table><thead><tr><th width="287">Funktion</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Inhalte (1)</td><td>Der Menübereich von Shopware, unter dem der Theme - Manager steht.</td></tr><tr><td>Theme - Einstellungen (2)</td><td>Öffnet das Dashboard des Theme - Managers. Darunter stehen die drei Unterpunkte.</td></tr><tr><td>Dashboard (3)</td><td>Ebenfalls das Dashboard: Hier verwaltest du deine Themes und öffnest alle Einstellungen.</td></tr><tr><td>Changelog (4)</td><td>Zeigt, was sich in den einzelnen Versionen des Theme - Managers geändert hat.</td></tr><tr><td>Support (5)</td><td>Hier erreichst du den Entwickler per Support-Ticket oder E-Mail.</td></tr></tbody></table>

{% hint style="info" %}
Öffnest du die Theme - Einstellungen, klappt Shopware sein Hauptmenü zu einer schmalen Symbolleiste zusammen, damit mehr Platz für die Einstellungen bleibt. Mit einem Klick auf das Shopware-Logo oben links (**Menü ausklappen**) klappst du es wieder auf.
{% endhint %}

## Für welche Themes der Theme - Manager gilt

Der Theme - Manager verändert deine Storefront nur auf Verkaufskanälen, denen ein unterstütztes Theme zugewiesen ist:

* das Shopware-Standard-Theme – in der Administration heißt es **Shopware default theme**,
* ausgewählte Themes von RH-Webdesign, die auf dem Theme - Manager aufbauen,
* Duplikate dieser Themes, die du in Shopware unter **Inhalte › Themes** erstellst.

Alle anderen Themes werden nicht unterstützt – auch dann nicht, wenn sie auf dem Shopware-Standard-Theme aufbauen. Ob ein Theme kompatibel ist, zeigt dir der Theme - Manager selbst an (siehe unten).

Nutzt ein Verkaufskanal ein nicht unterstütztes Theme, hält sich der Theme - Manager dort vollständig heraus, damit er dem fremden Theme nicht in die Quere kommt: Seine Funktionen erscheinen nicht im Shop, seine Gestaltung und Skripte werden nicht geladen und seine eigenen Shop-Seiten sind nicht erreichbar. Die Einstellungen kannst du trotzdem bearbeiten – sie wirken, sobald der Verkaufskanal ein unterstütztes Theme nutzt.

### So prüfst du dein Theme

1. Öffne **Inhalte › Theme - Einstellungen**. Das Dashboard startet mit **Themes verwalten**.
2. Sieh dir unter **Zugewiesene Themes** die Karte deines Verkaufskanals an: Die Kennzeichnung (2) zeigt, ob das Theme unterstützt wird.
3. Fahre mit der Maus über den farbigen Punkt (1) neben **Themes verwalten**. Er fasst den Stand aller Verkaufskanäle zusammen.

<figure><img src="https://2298866969-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7jsLHIar9cIHQMU8bdJQ%2Fuploads%2Fgit-blob-35256d8a69583822460d54ea8872d9d7916b0ce6%2Finstallation-theme-kompatibel.webp?alt=media" alt="Unterstütztes Theme mit grünem Status-Punkt"><figcaption><p>Das Shopware-Standard-Theme ist kompatibel – der Punkt ist grün.</p></figcaption></figure>

<figure><img src="https://2298866969-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7jsLHIar9cIHQMU8bdJQ%2Fuploads%2Fgit-blob-ea5d7addd8f84dad958b7ad8198ceafc67dbb762%2Finstallation-theme-nicht-kompatibel.webp?alt=media" alt="Theme eines anderen Anbieters mit rotem Status-Punkt"><figcaption><p>Das Muster Theme eines anderen Anbieters ist nicht kompatibel – der Punkt ist rot.</p></figcaption></figure>

<table><thead><tr><th width="287">Funktion</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Status-Punkt (1)</td><td><strong>Grün:</strong> Alle zugewiesenen Themes sind kompatibel.<br><strong>Gelb:</strong> Nur ein Teil der zugewiesenen Themes ist kompatibel.<br><strong>Rot:</strong> Kein zugewiesenes Theme ist kompatibel, keinem Verkaufskanal ist ein Theme zugewiesen oder die Shopware-Erweiterung „Shopware Store“ ist nicht installiert.<br>Beim Überfahren mit der Maus erklärt ein Hinweis den Stand.</td></tr><tr><td>Kompatibel / Nicht kompatibel (2)</td><td>Zeigt für jeden Verkaufskanal, ob sein Theme vom Theme - Manager unterstützt wird. Duplikate erhalten zusätzlich die Kennzeichnung <strong>Duplikat</strong> und werden nach ihrem Ursprungs-Theme beurteilt.</td></tr></tbody></table>

Wie du einem Verkaufskanal ein anderes Theme zuweist, erklärt die Seite **Themes & Verkaufskanäle**.

{% content-ref url="/pages/a5BwHX8BwUslP5vYsXhU" %}
[Themes & Verkaufskanäle](/theme-manager/erste-schritte/themes-und-verkaufskanaele.md)
{% endcontent-ref %}

## Theme - Manager und Themes von RH-Webdesign

Die Themes von RH-Webdesign bauen auf dem Theme - Manager auf, sind aber eigenständige Erweiterungen. Die Reihenfolge ist deshalb egal: Du kannst ein Theme auch vor dem Theme - Manager installieren und aktivieren und ihn später ergänzen.

Solange der Theme - Manager fehlt oder deaktiviert ist, zeigt ein Theme von RH-Webdesign unter **Inhalte › Themes** statt seiner Einstellungen den Hinweis **Theme - Manager Erweiterung benötigt**. Die Einstellungen darunter sind gesperrt.

<figure><img src="https://2298866969-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7jsLHIar9cIHQMU8bdJQ%2Fuploads%2Fgit-blob-9acd6c434ddee703b104aae93f39040e72ce7545%2Finstallation-theme-ohne-theme-manager.webp?alt=media" alt="Theme von RH-Webdesign unter Inhalte Themes mit dem Hinweis Theme - Manager Erweiterung benötigt"><figcaption><p>Ein Theme von RH-Webdesign ohne aktiven Theme - Manager – hier das Beispiel-Theme „Theme - Beispiel“: oben der Hinweis, darunter die gesperrten Einstellungen.</p></figcaption></figure>

<table><thead><tr><th width="287">Funktion</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Dokumentation (1)</td><td>Öffnet die Dokumentation des Theme - Managers in einem neuen Tab.</td></tr><tr><td>Theme - Manager aktivieren (2)</td><td>Aktiviert den installierten Theme - Manager. Ist er nur hochgeladen, heißt die Schaltfläche <strong>Theme - Manager installieren</strong> und installiert und aktiviert ihn in einem Schritt. Ist er noch gar nicht in deinem Shop, steht hier <strong>Im Shopware Store ansehen</strong>. Danach lädt die Administration neu.</td></tr></tbody></table>

Einem Verkaufskanal zuweisen kannst du ein Theme von RH-Webdesign erst, wenn der Theme - Manager aktiv ist. Wählst du es vorher aus, zum Beispiel unter **Verkaufskanäle** im Tab **Theme**, erscheint derselbe Hinweis als Fenster, und das Theme wird nicht zugewiesen.

<figure><img src="https://2298866969-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7jsLHIar9cIHQMU8bdJQ%2Fuploads%2Fgit-blob-26b69a15bcd360f36a353fc4462635c0932a293c%2Finstallation-theme-zuweisen-ohne-theme-manager.webp?alt=media" alt="Hinweisfenster beim Zuweisen eines Themes ohne Theme - Manager" width="500"><figcaption><p>Das Fenster beim Zuweisen: <strong>Dokumentation</strong> (1) und <strong>Theme - Manager aktivieren</strong> (2) wirken wie oben beschrieben.</p></figcaption></figure>

Sobald du den Theme - Manager aktivierst, kompiliert Shopware alle zugewiesenen Themes automatisch neu – mit ihrer vollen Gestaltung. Umgekehrt kannst du den Theme - Manager auch deaktivieren oder deinstallieren, während ein Theme von RH-Webdesign zugewiesen ist: Das Theme bleibt zugewiesen, und dein Shop bleibt erreichbar. Was sich dabei ändert, erklärt **Theme - Manager deaktivieren oder deinstallieren** auf der Seite **Themes & Verkaufskanäle**.

{% content-ref url="/pages/a5BwHX8BwUslP5vYsXhU" %}
[Themes & Verkaufskanäle](/theme-manager/erste-schritte/themes-und-verkaufskanaele.md)
{% endcontent-ref %}

## Deinstallieren

Über das Menü „…“ (3) und **Deinstallieren** entfernst du den Theme - Manager aus deinem Shop. Shopware fragt dabei mit dem Schalter **Alle App-Daten endgültig entfernen**, was mit deinen Daten geschehen soll:

* **Ausgeschaltet** (Standard): Alle Einstellungen und Inhalte des Theme - Managers bleiben gespeichert. Installierst du ihn später wieder, ist alles wie vorher.
* **Eingeschaltet:** Der Theme - Manager entfernt alles, was er angelegt hat – die Einstellungen aller Karten, seine Inhalte wie Produkt Bundles, Produktbadges, Produkt Anhänge, Aufschläge, Produktkonfiguratoren, Cross-Selling Popups, SCSS- und JavaScript-Container, Twig-Templates, Wunschlisten, Wieder-auf-Lager-Anmeldungen und die Checkout-Statistik, außerdem die E-Mail-Vorlagen für „Wieder auf Lager“, die automatisch angelegten Regeln und Preiszeilen der Versandkostenfrei-Anzeige, die Zusatzfelder der Registrierung und die heruntergeladenen Google Fonts.

{% hint style="warning" %}
Das Entfernen lässt sich nicht rückgängig machen. Bestellungen, Kunden, Produkte, Bilder und der Merkzettel von Shopware bleiben dabei unberührt.
{% endhint %}

## Wie geht es weiter?

Lerne als Nächstes das Dashboard kennen und erfahre, wie du Einstellungen speicherst, je Verkaufskanal anpasst und im Shop sichtbar machst.

{% content-ref url="/pages/KCExAvFX3Cyh1n64kiXr" %}
[Das Dashboard](/theme-manager/erste-schritte/dashboard.md)
{% endcontent-ref %}

{% content-ref url="/pages/NNjBHYgFh1Oylj6ZIF0j" %}
[Einstellungen bedienen](/theme-manager/erste-schritte/einstellungen-bedienen.md)
{% endcontent-ref %}