# Installation

## Voraussetzungen

- Shopware **6.6** oder **6.7**
- Installationsrecht für Plugins in der Administration (oder durch Ihre Agentur)

## Plugin installieren

### Über den Shopware Store (empfohlen)

So erhalten und installieren Sie die Extension am einfachsten:

1. Öffnen Sie die Produktseite bei NETZKOLLEKTIV: [Manuelle Produktsortierung für Shopware 6](https://netzkollektiv.com/extension-store/manuelle-produktsortierung-shopware-extension)
2. Dort finden Sie alle Infos zur Lizenz sowie den Link **Im Shopware Store erwerben** — damit gelangen Sie in den offiziellen [Shopware Store](https://store.shopware.com/).
3. Erwerben Sie die Extension (inkl. kostenloser Testphase, sofern angeboten) und laden Sie sie in Ihren Shop.
4. In der Administration: **Einstellungen → System → Plugins → Meine Erweiterungen** — Extension **installieren** und **aktivieren**.
5. Cache leeren, falls der Shop es nicht automatisch anbietet.

Die Extension ist auch ohne direkten Shopware-Store-Zugang nutzbar; Details dazu stehen auf der [Produktseite](https://netzkollektiv.com/extension-store/manuelle-produktsortierung-shopware-extension).

### ZIP-Upload in der Administration

Wenn Sie die Extension als ZIP-Datei erhalten haben (z. B. von Ihrer Agentur):

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 NetzkollektivManualProductSort
bin/console cache:clear
```

## Nach der Installation

1. Öffnen Sie eine **Kategorie** und wechseln Sie zum Tab **Produktsortierung**.
2. Richten Sie im Shop die Sortierung ein — siehe {doc}`usage` → *Sortierung im Storefront*.

Bei der ersten Installation wird die Sortieroption **Empfehlung** (EN: *Recommendation*) angelegt. Sie können diese in den Shop-Einstellungen den Verkaufskanälen zuweisen.

## Deinstallation

Beim Deinstallieren gelten die üblichen Shopware-Regeln für Plugins. Bereits gespeicherte Sortierpositionen bleiben in der Datenbank erhalten, solange keine separate Bereinigung durch Ihre Agentur vorgenommen wird.