# Installation

## Voraussetzungen

- Shopware **6.6** oder **6.7**
- Installationsrecht für Plugins in der Administration (oder durch Ihre Agentur)
- Afterbuy **User Token** und **Partner Token** (Afterbuy-Konto → Zugangsdaten anzeigen)

## Plugin installieren

### ZIP-Upload in der Administration

1. **Einstellungen → System → Plugins → Meine Erweiterungen**
2. Plugin-ZIP **hochladen**
3. Plugin **installieren** und **aktivieren**
4. Cache leeren, falls der Shop es nicht automatisch anbietet

### Über die Kommandozeile (optional)

Wenn Ihre Agentur das Plugin bereits unter `custom/plugins/` abgelegt hat:

```bash
bin/console plugin:refresh
bin/console plugin:install --activate NetzkollektivAfterbuy
bin/console cache:clear
```

## Nach der Installation

1. Öffnen Sie die Plugin-Einstellungen (**Erweiterungen → Afterbuy** bzw. über die Plugin-Konfiguration).
2. Tragen Sie **User Token** und **Partner Token** ein und prüfen Sie die Verbindung mit dem Test-Button.
3. Aktivieren Sie die **Schnittstelle**.
4. Konfigurieren Sie Übertragung und Bestellstatus — siehe {doc}`usage`.
5. Stellen Sie sicher, dass die **Message Queue** bzw. Scheduled Tasks laufen.

**Hinweis:** Bei der Installation werden bestehende Bestellungen mit dem Tag `afterbuy-processed` markiert, damit nur neue Bestellungen exportiert werden.

Wenn Sie einen **dauerhaft laufenden** Message-Consumer nutzen (`messenger:consume`), starten Sie diesen nach Installation/Update neu, damit neue Handler und Tasks geladen werden.

## Deinstallation

Es gelten die üblichen Shopware-Regeln für Plugins. Tags und Kommentar-Einträge an Bestellungen bleiben erhalten, solange keine separate Bereinigung erfolgt.