# 2. Installationsanleitung

## Installation

### Über den Shopware Store

1. Melden Sie sich im **Shopware Administration** an
2. Navigieren Sie zu **Erweiterungen → Store**
3. Suchen Sie nach „Verkaufszähler" und klicken Sie auf **Installieren**
4. Das Plugin wird automatisch heruntergeladen und aktiviert

### Manuelle Installation per ZIP

1. Laden Sie die Plugin-ZIP-Datei herunter
2. Navigieren Sie in der Administration zu **Erweiterungen → Meine Erweiterungen**
3. Klicken Sie auf **Erweiterung hochladen** und wählen Sie die ZIP-Datei aus
4. Nach dem Upload erscheint das Plugin in der Liste — klicken Sie auf **Installieren**
5. Aktivieren Sie das Plugin anschließend über den Schalter

## Erste Schritte nach der Installation

Nach der Aktivierung läuft das Plugin sofort. Die Verkaufszahlen werden jedoch erst beim nächsten geplanten Aggregationslauf angezeigt (standardmäßig täglich).

**Für sofortige Ergebnisse** können Sie die Aggregation manuell auslösen:

```bash
bin/console momo:sold-count:aggregate
```

Sobald die Aggregation abgeschlossen ist, erscheinen die Badges auf Produktdetailseiten und in Listings.

## CLI-Befehl

Das Plugin stellt einen Konsolenbefehl für die manuelle Aggregation bereit:

```bash
# Aggregation ausführen
bin/console momo:sold-count:aggregate

# Vorschau ohne Datenbankänderungen (Dry Run)
bin/console momo:sold-count:aggregate --dry-run
```

Der `--dry-run`-Parameter zeigt an, welche Daten aggregiert werden würden, ohne die Datenbank zu verändern.

## Hinweise

* Die Aggregation berücksichtigt nur Bestellungen mit Status **Abgeschlossen** oder **Bezahlt (teilweise)**
* Bei Produkten mit Varianten werden alle Variantenverkäufe zum Elternprodukt summiert
* Änderungen am Zeitraumfilter in der Konfiguration werden erst beim nächsten Aggregationslauf wirksam
* Der tägliche Aggregationslauf wird über Shopwares Scheduled-Task-System ausgeführt