Guppy Theme

Zum Plugin

Das DmfGuppyTheme ist das Basis-Theme für alle Guppy-Projekte. Es erweitert das Shopware 6 Storefront mit optimierten Templates, Custom Fields und hilfreichen Console Commands.

Inhalt dieser Seite:

• Voraussetzungen
• Installation
• Features
• Custom Fields
  • Download-Dateien für Produkte
  • Footer-Optionen für Zahlungs-/Versandmethoden
• Console Commands
  • guppy:theme:create
  • guppy:install:plugins
• Theme-Konfiguration
• Weiterführende Dokumentation

---

Voraussetzungen

• Shopware 6.7.0 oder höher
• PHP 8.2 oder höher

Installation

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

---

Features

• Optimiertes Storefront: Verbesserte Templates und Komponenten
• Custom Fields: Zusatzfelder für Produkte und Zahlungs-/Versandmethoden
• Console Commands: Tools für Theme-Entwicklung und Plugin-Installation
• SCSS-Architektur: Modulare und wartbare Stylesheets
• Barrierefreiheit: WCAG 2.1 konforme Komponenten

---

Custom Fields

Das Guppy Theme installiert automatisch Custom Field Sets für erweiterte Funktionalität.

Download-Dateien für Produkte

Custom Field Set: guppy_download_tab_set

Ermöglicht das Hinzufügen von bis zu 5 Download-Dateien pro Produkt (z.B. Datenblätter, Anleitungen).

Feld	Typ	Beschreibung
guppy_download_title_1 - guppy_download_title_5	Text	Titel des Downloads
guppy_download_file_1 - guppy_download_file_5	Media	Die Download-Datei

Verwendung im Admin:

1. Öffne ein Produkt im Admin
2. Wechsle zum Tab Spezifikationen
3. Scrolle zu Download Dateien (Guppy)
4. Trage Titel und Datei für jeden Download ein

Footer-Optionen für Zahlungs-/Versandmethoden

Custom Field Set: guppy_footer_options

Kontrolliert die Darstellung von Zahlungs- und Versandmethoden im Footer.

Feld	Typ	Beschreibung
guppy_hide_in_footer	Boolean	Methode im Footer ausblenden
guppy_alternative_label	Text	Alternatives Label für den Tooltip

Verwendung im Admin:

1. Öffne Einstellungen → Shop → Zahlungsarten oder Versandarten
2. Wähle eine Methode aus
3. Scrolle zu Footer Optionen
4. Konfiguriere die Sichtbarkeit und das Label

---

Console Commands

guppy:theme:create

Erstellt ein neues Child-Theme basierend auf dem Guppy Theme.

bin/console guppy:theme:create

Der Befehl führt interaktiv durch die Theme-Erstellung:

1. Theme-Name: Name des neuen Themes (z.B. MyShopTheme)
2. Namespace: PHP-Namespace (z.B. MyShop\Theme)
3. Verzeichnis: Zielverzeichnis für das Theme

Generierte Struktur:

custom/plugins/MyShopTheme/
├── src/
│   ├── MyShopTheme.php
│   └── Resources/
│       ├── app/
│       │   └── storefront/
│       │       └── src/
│       │           ├── main.js
│       │           └── scss/
│       │               └── base.scss
│       └── views/
│           └── storefront/
├── composer.json
└── theme.json

guppy:install:plugins

Installiert und aktiviert alle Guppy-Plugins in der korrekten Reihenfolge.

bin/console guppy:install:plugins

Installierte Plugins:

• DmfGuppyEmotionworldElements
• DmfCmsCustomGrids
• DmfDropdownNavigation
• DmfCustomFonts
• (weitere optionale Plugins)

---

Theme-Konfiguration

Das Guppy Theme bietet umfangreiche Konfigurationsoptionen im Admin unter:

Pfad: Verkaufskanäle → [Verkaufskanal] → Theme → Theme-Konfiguration

Siehe Konfigurationsoptionen für die vollständige Referenz.

---

Weiterführende Dokumentation

• SCSS Architektur
• Templating
• JavaScript Plugins
• Emotionworld Elements