> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/apps/fortschrittsbalken-fur-kostenlosen-versand-and-rabatt-im-warenkorb/warenkorb-meilensteine-konfigurieren.md).

# Warenkorb-Meilensteine konfigurieren

Meilensteine für Gratisversand, Rabatte, Gutscheine und Gratisprodukte im Warenkorb einrichten

Mit Warenkorb-Meilensteinen steuerst du Vorteile im Fortschrittsbalken. Dazu zählen Gratisversand, Rabatte, Gutscheine und Gratisprodukte. Du findest sie unter **Erweiterungen → Warenkorb-Meilensteine**.

### Meilenstein im Warenkorb anlegen

Klick auf "Meilenstein hinzufügen" und füll die Felder aus. Pflicht sind nur Titel und Betrag, der Rest ist optional.

| Feld                    | Beschreibung                                                                              |
| ----------------------- | ----------------------------------------------------------------------------------------- |
| Aktiv                   | Nur aktive Meilensteine erscheinen im Shop                                                |
| Titel / Name            | Wird dem Kunden angezeigt, zum Beispiel "Gratisversand"                                   |
| Interne Bezeichnung     | Nur für dich in der Administration sichtbar                                               |
| Betrag / Grenzwert      | Ab diesem Warenkorbwert gilt der Meilenstein als erreicht                                 |
| Wert                    | Gegenwert des Vorteils, zum Beispiel 9.90. Taucht im Text auf als "im Wert von 9,90 Euro" |
| Position                | Reihenfolge, falls zwei Meilensteine denselben Betrag haben                               |
| Verkaufskanäle          | Leer bedeutet: gilt in allen Kanälen                                                      |
| Custom Icon             | Eigenes Icon. Am besten mit transparentem Hintergrund                                     |
| Zugewiesenes Produkt    | Bei Gratisprodukten. Das Produktbild wird dann automatisch als Icon genutzt               |
| Verknüpfte Aktion       | Optionale Verknüpfung mit einer Shopware-Aktion                                           |
| Startdatum und Enddatum | Für zeitlich begrenzte Meilensteine, etwa Aktionswochen                                   |

### Meilenstein mit Aktion verknüpfen

Verknüpfst du eine Shopware-Aktion, gilt der Meilenstein als erreicht, sobald die Aktion im Warenkorb greift. Unabhängig vom Betrag. Praktisch bei Gutscheincodes, die den Vorteil unabhängig vom Warenkorbwert freischalten.

Dazu gehört die Option "Verknüpften Rabatt vom aktuellen Wert herausrechnen". Ist sie aktiv, wird der gewährte Rabattbetrag bei der Berechnung der folgenden Meilensteine wieder dazugerechnet. Der Kunde fällt durch seinen eigenen Rabatt also nicht zurück, was sonst ziemlich frustrierend aussieht.

### Produkte vom Warenkorbwert ausschließen

Manche Artikel sollen nicht auf den Vorteil einzahlen, etwa Gutscheine oder Sperrgut. Das stellst du in der Plugin-Konfiguration unter Produktausschluss ein.

Leg dazu in Shopware eine dynamische Produktgruppe mit diesen Artikeln an und wähl sie im Feld für ausgeschlossene Produkte aus. Zwei Optionen ergänzen das:

"Hinweis zu ausgeschlossenen Produkten anzeigen" erklärt dem Kunden, warum der anrechenbare Betrag von seinem Warenkorbwert abweicht. Ohne diesen Hinweis wirkt der Balken schnell kaputt.

"Fortschrittsbalken ohne anrechenbare Produkte ausblenden" versteckt den Balken komplett, solange nur ausgeschlossene Artikel im Warenkorb liegen.

### Meilensteine automatisch übernehmen

Wenn du weitere Cogi-Erweiterungen nutzt, musst du nichts doppelt pflegen.

"Von Gratisprodukten synchronisieren" legt aus deinen konfigurierten Gratisprodukten automatisch Meilensteine an und hält sie aktuell.

"Meilenstein Nächste Treuestufe hinzufügen" zeigt jedem eingeloggten Kunden individuell, wie viel ihm bis zur nächsten Treuestufe fehlt.

Importierte Meilensteine sind in der Übersicht entsprechend markiert. Änderungen daran können beim nächsten Abgleich überschrieben werden.

### Sichtbare Meilensteine im Warenkorb begrenzen

Viele Meilensteine machen den Balken unübersichtlich, gerade im Off-Canvas. Unter Erweitert, Layout und Größen legst du mit "Maximale Anzahl von Meilensteinen" fest, wie viele gleichzeitig zu sehen sind. Angezeigt werden dann die, die für den Kunden gerade relevant sind. Eine 0 bedeutet: keine Begrenzung.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/apps/fortschrittsbalken-fur-kostenlosen-versand-and-rabatt-im-warenkorb/warenkorb-meilensteine-konfigurieren.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
