Documentation

ShopBite Plugin Installation

Dieses Kapitel führt Sie durch die Installation des ShopBite Plugins in Ihrem Shopware 6-System.

Voraussetzungen

  • Shopware 6.7.0 oder höher (installiert und funktionierend)
  • PHP 8.4 oder höher
  • Composer 2.0 oder höher
  • Datenbankzugriff mit ausreichenden Berechtigungen

Installationsmethoden

1. Installation über Composer (empfohlen)

# Plugin über Composer installieren
composer require shopbite-de/shopware-plugin

# Plugin aktivieren
bin/console plugin:install --activate ShopBite

# Cache leeren
bin/console cache:clear

2. Installation über Shopware Plugin Store

  1. Shopware Administration öffnen
  2. Erweiterungen > Store navigieren
  3. Nach "ShopBite" suchen
  4. Installieren klicken
  5. Aktivieren klicken

3. Manuelle Installation

# Plugin herunterladen
wget https://github.com/shopbite-de/shopware-plugin/releases/latest/download/shopbite-plugin.zip
unzip shopbite-plugin.zip -d custom/plugins/ShopBite

# Plugin installieren und aktivieren
bin/console plugin:refresh
bin/console plugin:install --activate ShopBite

# Datenbank-Migrationen ausführen
bin/console database:migrate --all ShopBite

# Cache leeren
bin/console cache:clear

Installationsprozess im Detail

Schritt 1: Plugin herunterladen

# Composer-Methode (empfohlen)
composer require shopbite-de/shopware-plugin

# Manuelle Methode
wget https://github.com/shopbite-de/shopware-plugin/releases/latest/download/shopbite-plugin.zip
unzip shopbite-plugin.zip -d custom/plugins/ShopBite

Schritt 2: Plugin registrieren

# Plugin-List aktualisieren
bin/console plugin:refresh

# Plugin installieren
bin/console plugin:install ShopBite

Schritt 3: Plugin aktivieren

# Plugin aktivieren
bin/console plugin:activate ShopBite

# Status prüfen
bin/console plugin:list | grep ShopBite

Schritt 4: Datenbank-Migrationen ausführen

# Migrationen ausführen
bin/console database:migrate --all ShopBite

# Migrationen prüfen
bin/console database:migrate:status

Schritt 5: Cache und Assets

# Cache leeren
bin/console cache:clear

# Theme-Cache aktualisieren
bin/console theme:compile

# Administration-Cache aktualisieren
bin/console administration:build

Schritt 6: Berechtigungen prüfen

# Verzeichnisberechtigungen setzen
sudo chown -R www-data:www-data custom/plugins/ShopBite
sudo chmod -R 755 custom/plugins/ShopBite

# Cache-Berechtigungen
sudo chmod -R 777 var/cache

Post-Installation

Administrationsoberfläche

  1. Shopware Administration öffnen
  2. Erweiterungen > Meine Erweiterungen navigieren
  3. ShopBite Plugin finden und auf Konfigurieren klicken
  4. Grundkonfiguration durchführen

API-Zugang einrichten

# API-Integration erstellen
bin/console integration:create:admin --name="ShopBite Storefront" --description="API-Zugang für ShopBite Storefront"

# Berechtigungen setzen
bin/console acl:role:create --name="ShopBite API Role" --description="API-Rolle für ShopBite"
bin/console acl:role:assign --name="ShopBite API Role" --resource="order:read,order:write,product:read"

Sales Channel konfigurieren

  1. Einstellungen > Vertriebskanäle navigieren
  2. Neuen Sales Channel erstellen
  3. ShopBite-spezifische Einstellungen konfigurieren
  4. API-Zugang zuweisen

Installationsprüfung

Plugin-Status prüfen

# Plugin-Status anzeigen
bin/console plugin:list | grep ShopBite

# Plugin-Details anzeigen
bin/console plugin:info ShopBite

Datenbank prüfen

# Tabellen prüfen
mysql -u shopware -p shopware -e "SHOW TABLES LIKE 'shopbite_%';"

# Daten prüfen
mysql -u shopware -p shopware -e "SELECT * FROM shopbite_business_hour LIMIT 5;"

API-Endpunkte testen

# API-Test (ersetzen Sie die URL und den Token)
curl -X GET "https://Ihre-Shopware-Domain.de/store-api/shopbite/business-hour" \
  -H "Authorization: Bearer IhrAPIToken" \
  -H "sw-access-key: IhrAccessKey"

Häufige Installationsprobleme

Problem: Plugin wird nicht in der Administration angezeigt

Symptome:

  • Plugin ist installiert, aber nicht sichtbar
  • Fehler: "Plugin not found"

Lösungen:

# Cache leeren
bin/console cache:clear

# Plugin-List aktualisieren
bin/console plugin:refresh

# Berechtigungen prüfen
sudo chown -R www-data:www-data custom/plugins/ShopBite

Problem: Datenbank-Migrationen fehlgeschlagen

Symptome:

  • Fehler: "Migration failed"
  • Tabellen werden nicht erstellt

Lösungen:

# Migrationen manuell ausführen
bin/console database:migrate --all ShopBite --force

# Datenbank-Berechtigungen prüfen
mysql -u root -p
GRANT ALL PRIVILEGES ON shopware.* TO 'shopware'@'localhost';
FLUSH PRIVILEGES;

Problem: API-Endpunkte nicht erreichbar

Symptome:

  • 404 Fehler bei API-Aufrufen
  • Endpunkte nicht verfügbar

Lösungen:

# Routen-Cache leeren
bin/console router:cache:warmup

# Plugin neu aktivieren
bin/console plugin:deactivate ShopBite
bin/console plugin:activate ShopBite

# API-Berechtigungen prüfen
bin/console acl:role:list

Problem: Composer-Installation fehlgeschlagen

Symptome:

  • Fehler: "Could not find package shopbite-de/shopware-plugin"
  • Composer-Installation bricht ab

Lösungen:

# Composer-Cache leeren
composer clear-cache

# Packagist aktualisieren
composer update

# Manuelle Installation
wget https://github.com/shopbite-de/shopware-plugin/releases/latest/download/shopbite-plugin.zip

Deinstallation

Plugin deaktivieren

# Plugin deaktivieren
bin/console plugin:deactivate ShopBite

Plugin deinstallieren

# Plugin deinstallieren
bin/console plugin:uninstall ShopBite

# Daten bereinigen (optional)
bin/console plugin:uninstall ShopBite --keep-user-data=false

Manuelle Bereinigung

# Plugin-Verzeichnis entfernen
rm -rf custom/plugins/ShopBite

# Cache leeren
bin/console cache:clear

# Datenbank bereinigen (optional)
mysql -u shopware -p shopware -e "DROP TABLE IF EXISTS shopbite_business_hour, shopbite_holiday;"

Nächste Schritte