Console Commands

Inhalt dieser Seite:

• Verfügbare Commands
  • guppy:theme:create
  • guppy:install:plugins
• Best Practices
  • Theme-Entwicklung
  • Plugin-Installation
• Troubleshooting
  • Häufige Probleme
  • Debugging

Das Guppy Theme bietet spezialisierte Console Commands, die den Entwicklungsprozess vereinfachen und die Einrichtung von Projekten automatisieren.

Verfügbare Commands

guppy:theme:create

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

Verwendung

bin/console guppy:theme:create

Interaktive Konfiguration

Der Command führt Sie durch einen interaktiven Prozess:

Grundeinstellungen

• Namespace: Standard-Namespace für das Theme (z.B. "Dmf")
• Theme-Name: Name des Child-Themes (z.B. "CustomerShop")
• Theme-Titel: Anzeigename im Admin-Panel

Farbkonfiguration

• Primärfarbe: Hauptfarbe des Themes (Standard: #215AFF)
• Sekundärfarbe: Unterstützende Farbe (Standard: #0B1845)
• Rahmenfarbe: Farbe für Rahmen (Standard: #CFD1D7)
• Hintergrundfarbe: Basis-Hintergrundfarbe (Standard: #FFFFFF)

Asset-Konfiguration

• Plugin-Bild: Name für das Plugin-Icon (plugin.png)
• Vorschau-Bild: Name für das Theme-Preview (preview.jpg)
• Logo: Name für das Hauptlogo (logo.svg)
• Share-Icon: Name für Social Media Icon (share-icon.svg)
• Favicon: Name für das Favicon (favicon.ico)

Automatische Erstellung

Das Command erstellt automatisch:

Verzeichnisstruktur

custom/static-plugins/DmfCustomerShopTheme/
├── src/
│   ├── DmfCustomerShopTheme.php
│   └── Resources/
│       ├── app/storefront/
│       │   ├── src/scss/
│       │   │   ├── base.scss
│       │   │   └── overrides.scss
│       │   └── dist/
│       │       ├── assets/
│       │       └── storefront/js/
│       ├── config/
│       │   └── plugin.png
│       └── views/storefront/
└── composer.json

Automatische Konfiguration

• composer.json: Vollständige Composer-Konfiguration
• theme.json: Komplett konfigurierte Theme-Datei mit Vererbung
• PHP-Klasse: Theme-Klasse mit korrektem Namespace

Config-Inheritance

{
  "configInheritance": [
    "@Storefront",
    "@DmfGuppyTheme"
  ]
}

Zusätzliche Features

Composer-Integration

• Automatische Installation: Optional via Composer
• Dependency-Management: Automatische Guppy-Theme-Abhängigkeit
• Semantic Versioning: Versionierung ab 0.1.0

Asset-Management

• Automatisches Kopieren: Standard-Assets werden kopiert
• Pfad-Generierung: Automatische Asset-Pfade
• Datei-Validierung: Prüfung auf vorhandene Assets

Beispiel-Ausgabe

$ bin/console guppy:theme:create

 Theme Create Command
 ====================

 Bitte gebe den Namespace des Themes ein. [Dmf]:
 > Dmf

 Bitte gebe den Namen des Themes ein (z. B. Child).
 > MyShop

 Bitte gebe den Titel des Themes an, wie er im Admin dargestellt werden soll.
 > My Custom Shop Theme

 Möchtest du das Theme konfigurieren? (yes/no) [yes]:
 > yes

 [OK] Das Theme wurde erfolgreich erstellt unter: /path/to/custom/static-plugins/DmfMyShopTheme

---

guppy:install:plugins

Installiert automatisch die empfohlenen Plugins für das Guppy Theme.

Verwendung

bin/console guppy:install:plugins

Verfügbare Plugins

1. DmfCustomFonts

• Beschreibung: Ermöglicht benutzerdefinierte Schriftarten
• Composer-Package: dmf/sw6-plugin-custom-fonts
• Verwendung: Integration eigener Webfonts

2. DmfCustomGrid

• Beschreibung: Erweiterte Grid-Layouts für CMS
• Composer-Package: dmf/sw6-plugin-cms-custom-grids
• Verwendung: 11 zusätzliche Grid-Varianten

3. GuppyEmotionworldElements

• Beschreibung: Spezialisierte CMS-Elemente
• Composer-Package: dmf/sw6-plugin-guppy-emotionworld-elements
• Verwendung: Erweiterte CMS-Funktionen

Interaktive Installation

Der Command fragt für jedes Plugin einzeln nach:

$ bin/console guppy:install:plugins

 Plugins Installieren
 ====================

 Möchten Sie das Plugin Dmf Custom Fonts installieren? (yes/no) [no]:
 > yes

 [OK] Das Plugin Dmf Custom Fonts wurde erfolgreich installiert.

 Möchten Sie das Plugin Dmf Custom Grid installieren? (yes/no) [no]:
 > yes

 [OK] Das Plugin Dmf Custom Grid wurde erfolgreich installiert.

Fehlerbehandlung

• Automatische Fehlerprüfung: Überprüfung des Composer-Return-Codes
• Detaillierte Fehlermeldungen: Spezifische Fehlermeldungen pro Plugin
• Fortsetzung bei Fehlern: Ein fehlgeschlagenes Plugin bricht den Prozess nicht ab

---

Best Practices

Theme-Entwicklung

1. Verwenden Sie aussagekräftige Namespaces

   # Gut
   Namespace: MyCompany
   Theme-Name: CustomerPortal
   
   # Schlecht
   Namespace: Test
   Theme-Name: Theme1

2. Bereiten Sie Assets vor

   • Legen Sie alle erforderlichen Assets bereit
   • Verwenden Sie konsistente Namenskonventionen
   • Optimieren Sie Bilder für Web-Verwendung

3. Nutzen Sie Config-Inheritance

   {
     "configInheritance": [
       "@Storefront",
       "@DmfGuppyTheme"
     ]
   }

Plugin-Installation

1. Installieren Sie alle empfohlenen Plugins

   • Nutzen Sie die volle Funktionalität
   • Testen Sie Kompatibilität vor Produktivumgebung

2. Befolgen Sie die Installationsreihenfolge

   # 1. Plugins installieren
   bin/console guppy:install:plugins
   
   # 2. Plugin-Cache leeren
   bin/console plugin:refresh
   
   # 3. Theme aktivieren
   bin/console theme:change

Troubleshooting

Häufige Probleme

Theme-Erstellung schlägt fehl

• Problem: Verzeichnis existiert bereits
• Lösung: Löschen Sie das bestehende Verzeichnis oder wählen Sie einen anderen Namen

Plugin-Installation schlägt fehl

• Problem: Composer-Fehler
• Lösung: Prüfen Sie Composer-Konfiguration und Netzwerkverbindung

Assets werden nicht gefunden

• Problem: Standard-Assets fehlen
• Lösung: Prüfen Sie /src/Resources/default-assets/ Verzeichnis

Debugging

Verbose-Modus aktivieren

bin/console guppy:theme:create -v
bin/console guppy:install:plugins -v

Log-Dateien prüfen

# Shopware-Logs
tail -f var/log/prod.log

# Composer-Logs
composer install --verbose