Installation

Diese Anleitung beschreibt die Installation des Core-Themes DmfGuppyTheme plus seiner Pflicht-Dependency DmfSplideSlider in einem bestehenden Shopware-6.7-Projekt. Wenn du noch keine Shopware-Installation hast, folge zunächst der offiziellen Shopware-Installationsanleitung.

Schon installiert?

Auf dem Guppy Playground kannst du Guppy live ansehen, ohne lokal etwas einzurichten.

1. Theme via Composer hinzufügen

Im Shopware-Projekt-Root:

composer require dmf/sw6-guppy-theme

Composer zieht die Pflicht-Dependency dmf/sw6-plugin-splide-slider automatisch mit.

2. Plugin-Liste neu laden

bin/console plugin:refresh

Shopware erkennt jetzt beide Plugins.

3. Plugins installieren und aktivieren

bin/console plugin:install --activate DmfSplideSlider
bin/console plugin:install --activate DmfGuppyTheme

Reihenfolge beachten

DmfSplideSlider zuerst aktivieren, DmfGuppyTheme setzt den Slider voraus.

4. Theme dem Sales-Channel zuordnen

bin/console theme:change

Der Befehl ist interaktiv: Sales-Channel auswählen, dann Guppy Theme wählen.

5. Theme kompilieren

bin/console theme:compile

Erst nach theme:compile werden alle SCSS-Variablen und Twig-Overrides aktiv.

6. Cache leeren

bin/console cache:clear

7. Smoke-Test

Storefront aufrufen und prüfen:

• Layout zeigt den Guppy-Style.
• Logo erscheint (zunächst Default; eigenes Logo unter Erste Schritte → Logo hochladen).
• Tab-Navigation funktioniert (Barrierefreiheit-Default).

Vollständiger Installations-Workflow auf einen Blick

composer require dmf/sw6-guppy-theme
bin/console plugin:refresh
bin/console plugin:install --activate DmfSplideSlider
bin/console plugin:install --activate DmfGuppyTheme
bin/console theme:change
bin/console theme:compile
bin/console cache:clear

Optionale Plugins automatisch installieren

DmfGuppyTheme bringt einen Konsolen-Befehl mit, der weitere empfohlene Guppy-Plugins via Composer holt:

bin/console guppy:install:plugins

Welche Plugins sinnvoll sind, beschreibt Empfohlene Plugins.

Häufige Probleme

Theme erscheint nicht im Storefront

# Plugin-Status prüfen
bin/console plugin:list | grep -i guppy

# Theme neu kompilieren und Cache leeren
bin/console theme:compile
bin/console cache:clear

Styling-Probleme nach Update

# Storefront neu bauen
bin/build-storefront.sh
bin/console theme:compile
bin/console cache:clear

„Plugin nicht gefunden“ beim plugin:install

# Cache der Plugin-Liste invalidieren
bin/console plugin:refresh

Nächste Schritte

• Erste Schritte nach der Installation: Sales-Channel-Zuordnung, Theme-Konfig, Logo, optionale Plugins.
• Plugins: Übersicht aller 13 Plugins im Ökosystem.
• Child Theme: eigenes Brand-Theme mit dem Theme Builder.