# 2. Installationsanleitung

## Installation

### Über den Shopware Store (empfohlen)

1. Öffnen Sie **Erweiterungen → Store** im Shopware-Administrationsbereich.
2. Suchen Sie nach „Margen & Einkaufspreise in der Produktübersicht".
3. Klicken Sie auf **Kaufen** bzw. **Installieren**.
4. Das Plugin wird automatisch heruntergeladen und installiert.

### Manuelle Installation per ZIP

1. Laden Sie die Plugin-ZIP-Datei aus Ihrem Shopware-Account herunter.
2. Öffnen Sie **Erweiterungen → Meine Erweiterungen** im Adminbereich.
3. Klicken Sie auf **Plugin hochladen** und wählen Sie die ZIP-Datei aus.
4. Das Plugin erscheint anschließend in der Plugin-Liste.

## Aktivierung

1. Öffnen Sie **Erweiterungen → Meine Erweiterungen**.
2. Suchen Sie **Margen & Einkaufspreise in der Produktübersicht** in der Liste.
3. Klicken Sie auf den Schalter, um das Plugin zu **aktivieren**.
4. Bestätigen Sie ggf. die Cache-Leerung.

## Erste Schritte nach der Installation

Nach der Aktivierung sind die neuen Spalten sofort in der Produktliste sichtbar:

1. Öffnen Sie **Kataloge → Produkte**.
2. Scrollen Sie in der Tabelle nach rechts — Sie sehen die vier neuen Spalten: **Einkaufspreis**, **Nettopreis**, **Marge** und **Marge %**.
3. Wenn Produkte noch keinen Einkaufspreis haben, erscheint in den Marge-Spalten ein Strich (–). Hinterlegen Sie Einkaufspreise direkt im jeweiligen Produkt unter **Listenpreis → Einkaufspreis**.

## Einkaufspreis-Filter nutzen

Um schnell alle Produkte ohne Einkaufspreis zu finden:

1. Öffnen Sie **Kataloge → Produkte**.
2. Klicken Sie auf das **Filter**-Symbol (Trichter) in der oberen rechten Ecke.
3. Scrollen Sie im Filter-Panel nach unten zum Abschnitt **Einkaufspreis**.
4. Wählen Sie **Ohne Einkaufspreis**.
5. Die Produktliste zeigt nur Produkte ohne hinterlegten Einkaufspreis.

![Filter-Panel mit aktivem Einkaufspreis-Filter](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-6f89f1dbcd82404fc2a9fddbb6b899ff618f3f9d%2F3.png?alt=media)

## Hinweise

* Die Spalten **Marge** und **Marge %** berechnen sich auf Basis des Nettopreises der Standard-Währung und des hinterlegten Einkaufspreises.
* Varianten-Produkte (Produkte mit Varianten) werden in der Produktliste mit dem Preis der jeweiligen Variante angezeigt; der Einkaufspreis muss für jede Variante separat gepflegt werden.
* Die Sortierung nach Marge und Marge % ist serverseitig und nutzt eine vorberechnete Datenbanktabelle. Die Tabelle wird bei jeder Preisänderung automatisch aktualisiert.