Ihr erstes Shopware 6 Plugin erstellen

1. Der einfache Weg: CLI-Generator verwenden

Shopware bietet einen Konsolenbefehl, um Plugins sofort zu erstellen. Dies verhindert menschliche Fehler in Verzeichnisstrukturen und stellt sicher, dass alle erforderlichen Dateien korrekt erstellt werden.

Schritt 1: Terminal öffnen

Navigieren Sie zu Ihrem Shopware-Stammverzeichnis, wo sich bin/console befindet.

Schritt 2: Erstellungsbefehl ausführen

php bin/console plugin:create MyFirstPlugin

Was wird erstellt

Dies erstellt folgende Struktur in custom/plugins/MyFirstPlugin:

custom/plugins/MyFirstPlugin/
├── src/
│   └── MyFirstPlugin.php    # Die Haupt-Einstiegsklasse
└── composer.json            # Metadaten und Autoloading

2. Die manuelle Einrichtung (Funktionsweise verstehen)

Das Verständnis der manuellen Einrichtung hilft Ihnen beim Debuggen von Problemen und beim Anpassen von Plugins über das Standard-Gerüst hinaus. Die kritische Datei ist composer.json - sie teilt Shopware mit "Ich existiere."

Die composer.json-Datei

Erstellen Sie custom/plugins/MyFirstPlugin/composer.json:

{
  "name": "my-vendor/my-first-plugin",
  "description": "Mein erstes Shopware 6 Plugin",
  "type": "shopware-platform-plugin",
  "version": "1.0.0",
  "license": "MIT",
  "autoload": {
    "psr-4": {
      "MyVendor\\MyFirstPlugin\\": "src/"
    }
  },
  "extra": {
    "shopware-plugin-class": "MyVendor\\MyFirstPlugin\\MyFirstPlugin",
    "label": {
      "de-DE": "Mein erstes Plugin",
      "en-GB": "My First Plugin"
    }
  }
}

Die Konfiguration verstehen

• type: Muss shopware-platform-plugin sein, damit Shopware es erkennt
• autoload.psr-4: Ordnet Ihren Namespace dem src/-Verzeichnis zu
• extra.label: Plugin-Name im Admin-Panel (unterstützt mehrere Sprachen)

3. Die Bootstrap-Klasse

Die Bootstrap-Klasse ist der Einstiegspunkt für Ihr Plugin. Sie erweitert die Kern-Plugin-Klasse und ermöglicht es Ihnen, Code während der Installation, Updates oder Deinstallation auszuführen (z.B. Datenbanktabellen erstellen).

Die Haupt-Plugin-Datei erstellen

Erstellen Sie custom/plugins/MyFirstPlugin/src/MyFirstPlugin.php:

<?php declare(strict_types=1);

namespace MyVendor\MyFirstPlugin;

use Shopware\Core\Framework\Plugin;
use Shopware\Core\Framework\Plugin\Context\InstallContext;

class MyFirstPlugin extends Plugin
{
    public function install(InstallContext $installContext): void
    {
        // Logik zur Ausführung während der Installation (z.B. Tabelle erstellen)
        parent::install($installContext);
    }
}

Verfügbare Lifecycle-Methoden

Die Plugin-Klasse bietet mehrere Lifecycle-Methoden, die Sie überschreiben können:

• install(): Wird aufgerufen, wenn das Plugin zum ersten Mal installiert wird
• update(): Wird beim Update auf eine neue Version aufgerufen
• uninstall(): Wird beim Entfernen des Plugins aufgerufen
• activate() / deactivate(): Wird beim Umschalten des Plugin-Status aufgerufen

4. Ihr Plugin installieren und aktivieren

Sobald Ihre Dateien vorhanden sind, müssen Sie das Plugin mit Konsolenbefehlen bei Shopware registrieren.

Schritt 1: Plugin-Liste aktualisieren

Weisen Sie Shopware an, nach neuen Plugins zu suchen:

php bin/console plugin:refresh

Schritt 2: Installieren und aktivieren

Installieren und aktivieren Sie in einem Befehl:

php bin/console plugin:install --activate MyFirstPlugin

Schritt 3: Cache leeren

Leeren Sie immer den Cache nach Strukturänderungen:

php bin/console cache:clear

5. Entwicklungs-Workflow: Hot Reloading

Wenn Sie Storefronts (CSS/JS) oder Administration-Module entwickeln, möchten Sie nicht jedes Mal manuell Assets kompilieren. Verwenden Sie die "Hot Module Replacement"-Watcher:

Für Storefront (Frontend)

./bin/watch-storefront.sh

Für Administration (Backend)

./bin/watch-administration.sh

Diese Watcher kompilieren Assets automatisch neu, wenn Sie Dateien ändern, und geben Ihnen nahezu sofortiges Feedback während der Entwicklung.

6. Produktions-Performance-Checkliste

Shopware 6 ist funktionsreich, kann aber ohne Optimierung schwer sein. Überprüfen Sie vor dem Go-Live diese kritischen Punkte:

APP_ENV=prod

php bin/console cache:http:warm-up