Konfigurationsreferenz
Die Plugin-Konfiguration finden Sie unter Erweiterungen → Meine Erweiterungen → Unlock Bar → Konfigurieren. Jede Einstellung lässt sich für alle Verkaufskanäle oder für einen festlegen. Die Tabellen unten werden aus der config.xml des Plugins erzeugt; die Beschreibungen sind die Hilfetexte neben den Feldern. Zur Anwendung: Festlegen, wo der Balken erscheint und wie er aussieht.
Die Konfigurationsseite zeigt außerdem drei Teile, die keine Einstellungen sind: eine Karte mit dem aktiven Plan und einem Link zu den Meilensteinen, eine Live-Vorschau in der Karte Aussehen und, ohne Pro, eine Sperrzeile mit der Schaltfläche Pro holen.
Anzeige
| Setting | Type | Default | Description |
|---|---|---|---|
showInOffcanvas — Im Off-Canvas-Warenkorb anzeigen | bool | true | Der Warenkorb, der nach dem Hinzufügen einfährt. Aus blendet nur den Balken aus; Belohnungen gelten weiter. |
showOnCartPage — Auf der Warenkorbseite anzeigen | bool | true | Aus blendet nur den Balken aus; Belohnungen gelten weiter. |
showOnConfirmPage — Auf der Bestellbestätigungsseite anzeigen | bool | true | Der letzte Schritt vor der Bestellung. Aus blendet nur den Balken aus; Belohnungen gelten weiter. |
showAllUnlockedMessage — Meldung „Alles freigeschaltet“ anzeigen | bool | true | Bestätigt in Worten, was freigeschaltet ist, wenn kein Ziel mehr offen ist. Aus zeigt nur den Balken. |
thresholdRounding — Umgerechnete Warenwerte aufrunden auf | single-select | 1 | Für Verkaufskanäle in einer anderen Währung. Der gerundete Wert gilt. Options: 0 (Nicht runden), 1 (Ganze Währungseinheit (63,84 → 64)), 5 (5 Währungseinheiten (63,84 → 65)), 10 (10 Währungseinheiten (63,84 → 70)). |
Aussehen
| Setting | Type | Default | Description |
|---|---|---|---|
preset — Vorlage | single-select | native | Minimal, Bold und Steps erfordern Unlock Bar Pro; ohne Pro nutzt der Balken Native. Options: native (Native (folgt dem Theme)), minimal (Minimal: dünne Linie, Punkte (Pro)), bold (Bold: dicker Balken, große Fotos (Pro)), steps (Steps: nummerierte Schritte (Pro)). |
fillColor — Füllfarbe | colorpicker | — | Leer = Primärfarbe des Themes. |
trackColor — Hintergrundfarbe des Balkens | colorpicker | — | Leer = Rahmenfarbe des Themes. |
Aussehen: Feineinstellungen (Pro)
| Setting | Type | Default | Description |
|---|---|---|---|
cornerRadius — Eckenradius (px) | int | — | Balken, Füllung und Markierungen. 0 bis 999 px; 999 = ganz rund. Leer = wie die Vorlage. |
barHeight — Balkenhöhe (px) | int | — | 2 bis 24 px. Leer = wie die Vorlage. |
markerStyle — Markierungsstil | single-select | auto | Was jede Markierung im Balken zeigt. Wie die Vorlage: Native und Bold zeigen das Geschenkfoto, Minimal einen Punkt, Steps eine Nummer. Options: auto (Wie die Vorlage), photo (Geschenkfoto), icon (Icon), dot (Punkt), number (Nummer). |
textColor — Textfarbe | colorpicker | — | Leer = Textfarbe des Themes. |
unlockedColor — Farbe „Freigeschaltet“ | colorpicker | — | Leer = Erfolgsfarbe des Themes. |
celebration — Freischalt-Animation | single-select | off | Spielt einmal, wenn ein Meilenstein freigeschaltet wird. Entfällt bei reduzierter Bewegung. Options: off (Aus), pulse (Pulse), confetti (Konfetti). |
Felder eines Meilensteins
Meilensteine bearbeiten Sie unter Marketing → Unlock Bar, nicht in der Plugin-Konfiguration.
| Feld | Gilt für | Hinweise |
|---|---|---|
| Aktiv | alle | Inaktive Meilensteine bleiben gespeichert, erscheinen aber nicht und gewähren nichts. |
| Belohnung | alle | Kostenloser Versand oder Geschenk. |
| Ab Warenwert | alle | Größer als 0. Globale Meilensteine: Standardwährung. Eigene Meilensteine eines Verkaufskanals: dessen Währung. |
| Titel | alle | Übersetzbar. Leer zeigt „Kostenlose Lieferung“ oder den Produktnamen des Geschenks. Der Titel eines Meilensteins für kostenlosen Versand ist auch der Name der Aktion in Warenkorb und Bestellung. |
| Beschreibung | alle | Übersetzbar. Erscheint im Popover des Geschenks. |
| Geschenkoptionen | Geschenk | Produkte oder Varianten, keine Hauptprodukte. Die erste ist der Standard. Mehr als eine erfordert Pro. |
| Nur anzeigen für (Rule Builder) | alle | Pro. Leer bedeutet: alle. Ein Meilenstein für kostenlosen Versand pro Regel. |
| Icon | alle | Ersetzt das Bild der Markierung (Lieferwagen-Icon oder Geschenkfoto). Uploads landen im Ordner „Unlock Bar Media“. |
Pläne
| Funktion | Free | Pro |
|---|---|---|
| Meilensteine für kostenlosen Versand | einer pro Regel unter „Nur anzeigen für“ | einer pro Regel unter „Nur anzeigen für“ |
| Geschenk-Meilensteine | 1 (der niedrigste zutreffende Betrag) | unbegrenzt |
| Geschenkoptionen pro Meilenstein | die Standardoption | unbegrenzt |
| Nur anzeigen für (Rule Builder) | bereits gesetzte Regeln bleiben | ✓ |
| Vorlagen, Feineinstellungen, Freischalt-Animation | gespeichert, nicht angewendet | ✓ |
Details: Unlock Bar Pro erwerben.
Rechte
Unter Einstellungen → Benutzer & Rechte ergänzt Unlock Bar die Rolle Unlock Bar im Bereich Marketing:
| Rolle | Erlaubt |
|---|---|
| Betrachter | die Unlock-Bar-Seite öffnen und die Meilensteine lesen, inklusive der Produkte, Regeln, Aktionen und Versandarten, die sie zeigt |
| Bearbeiter | Meilensteine und Geschenkoptionen anlegen, ändern und löschen, Icons hochladen und Regeln direkt anlegen (inklusive Betrachter) |
Die Plugin-Konfiguration selbst unterliegt dem Shopware-eigenen Recht für Plugin-Einstellungen.
Storefront-Textbausteine
Die Texte des Balkens sind Storefront-Textbausteine unter dem Schlüssel ssdUnlockBar (Englisch und Deutsch enthalten). Bearbeiten Sie sie unter Einstellungen → Textbausteine.
Schnittstellen für Entwickler
| Schnittstelle | Name |
|---|---|
| Store-API-Warenkorb-Erweiterung | unlockBarProgress |
| Store-API-Routen | POST /store-api/ssd-unlock-bar/gift/{milestoneId}/choose, POST /store-api/ssd-unlock-bar/gift/{milestoneId}/add-back |
| JavaScript-Event | UnlockBar/milestoneUnlocked auf document.$emitter |
| Rule-Builder-Bedingung | ssdCpbMilestoneUnlocked |
| Entitäten | ssd_cpb_milestone, ssd_cpb_gift_option |
Details: Den Balken im Theme oder in einer Headless-Storefront anpassen.
