FAQ
Allgemein
Was ist Guppy genau?
Ein Theme-Framework für Shopware 6.7 von digital.manufaktur. Besteht aus Core-Theme DmfGuppyTheme, 12 ergänzenden Plugins und einem browserbasierten Theme-Builder. Mehr unter Einführung.
Welche Shopware-Version brauche ich?
Shopware 6.7. Detaillierte Versionsmatrix: Voraussetzungen.
Ist Guppy kostenlos / Open Source?
Proprietär, entwickelt und gepflegt von digital.manufaktur. Kein öffentlicher Marketplace-Eintrag, Distribution erfolgt über digital.manufaktur.
Wo finde ich Live-Demos?
Guppy Playground. Express-Demo: express-demo.digital-manufaktur.com.
Theme-Setup
Soll ich Theme Builder oder manuelles Child-Theme nutzen?
| Bedarf | Empfehlung |
|---|---|
| reine Brand-Anpassung (Farben, Fonts, Logos) | Theme Builder |
| eigene Twig-Overrides oder JS | manuelles Child-Theme |
Wie ändere ich meine Brand-Farben?
Im Admin: Inhalte → Themes → Guppy Theme → Konfigurieren, dann Primär- und Sekundärfarbe setzen. Detail: Farben.
Theme:compile schlägt fehl, was tun?
bin/console plugin:list | grep -i guppy # alle aktiv?
bin/console plugin:refresh
bin/console theme:compile -v # Verbose-Output prüfen
bin/console cache:clearWenn ein Plugin fehlt: composer install. Wenn Storefront-Build kaputt: bin/build-storefront.sh.
Plugins
Welche Plugins sind Pflicht?
Nur DmfGuppyTheme und DmfSplideSlider (Pflicht-Dependency). Alles andere ist optional. Empfehlungen: Empfohlene Plugins.
Wie installiere ich alle empfohlenen Plugins auf einmal?
bin/console guppy:install:pluginsInteraktiver Befehl, fragt pro Plugin.
Sind die Plugins untereinander abhängig?
DmfGuppyEmotionworldElements setzt DmfGuppyTheme: ^2.0 voraus. Slider-basierte Custom-Elements von DmfCmsCustomElements brauchen DmfSplideSlider. Sonst alle unabhängig.
Welches Plugin macht was?
Plugin-Übersicht plus Empfohlene Plugins (mit Entscheidungsmatrix).
Theme Builder
Was passiert, wenn ich den Builder-Tab schließe?
Daten bleiben im localStorage. Beim erneuten Öffnen wird der Stand wiederhergestellt, solange du denselben Browser benutzt.
Wie versioniere ich meine Builder-Konfiguration?
Über Save Snapshot: Du erhältst eine .guppy-builder.json. Im Repo committen.
Kann ich Builder + Repo kombinieren?
Ja. ZIP entpacken, in custom/plugins/<Name>/ legen, mit Git versionieren. .guppy-builder.json ebenfalls committen, damit später noch Änderungen über den Builder möglich sind. Detail: Workflow.
Entwicklung
Wo gehören eigene Anpassungen hin?
Niemals in DmfGuppyTheme direkt. Stattdessen:
- Brand-/Token-Anpassungen → Child-Theme.
- Eigene Templates → eigenes Plugin oder Child-Theme.
- Eigene CMS-Elemente → DmfCmsCustomElements oder eigenes Plugin.
- Detail: Plugin-Integration.
Welche Mixins/Functions stehen mir zur Verfügung?
Vollständige Liste in Theme-Variablen.
Wie überschreibe ich ein Twig-Template?
Pfad spiegeln und {% sw_extends '@Storefront/...' %} nutzen. Detail: Twig-Overrides.
Wie schreibe ich ein eigenes Storefront-JS-Plugin?
PluginBase extenden, im PluginManager registrieren. Beispiel: Storefront-JS.
Was ist die richtige Vererbungs-Reihenfolge?
overrides.scss (Child) → @DmfGuppyTheme → base.scss (Child)
configInheritance: ["@Storefront", "@DmfGuppyTheme"]Diese Reihenfolge ist fest verdrahtet.
Updates
Wie führe ich ein Theme-Update durch?
composer update dmf/sw6-guppy-theme
bin/console plugin:refresh
bin/console plugin:update DmfGuppyTheme
bin/console theme:compile
bin/console cache:clearGibt es einen Upgrade-Scanner?
Ja, bin/console guppy:upgrade:scan. Detail: Changelog.
Was bedeuten die Branches main und stage?
main ist Produktions-LTS, stage ist QA-Branch (Playground). Es gibt keinen separaten next-Branch. Major Releases für kommende Shopware-Versionen erscheinen als RC-Tags auf main, z. B. 2.8.0-rc1. Detail: Mitwirken.
Hilfe
Wo finde ich Source-Code?
GitLab: theme-guppy.
Wo melde ich Bugs?
GitLab-Repository des betroffenen Plugins, Issue-Tracker. Bei Kund:innen-Projekten primär über das Support-Ticket-System der digital.manufaktur.