Skip to content

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 ​

SettingTypeDefaultDescription
showInOffcanvas — Im Off-Canvas-Warenkorb anzeigenbooltrueDer Warenkorb, der nach dem Hinzufügen einfährt. Aus blendet nur den Balken aus; Belohnungen gelten weiter.
showOnCartPage — Auf der Warenkorbseite anzeigenbooltrueAus blendet nur den Balken aus; Belohnungen gelten weiter.
showOnConfirmPage — Auf der Bestellbestätigungsseite anzeigenbooltrueDer letzte Schritt vor der Bestellung. Aus blendet nur den Balken aus; Belohnungen gelten weiter.
showAllUnlockedMessage — Meldung „Alles freigeschaltet“ anzeigenbooltrueBestätigt in Worten, was freigeschaltet ist, wenn kein Ziel mehr offen ist. Aus zeigt nur den Balken.
thresholdRounding — Umgerechnete Warenwerte aufrunden aufsingle-select1Fü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 ​

SettingTypeDefaultDescription
preset — Vorlagesingle-selectnativeMinimal, 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üllfarbecolorpicker—Leer = Primärfarbe des Themes.
trackColor — Hintergrundfarbe des Balkenscolorpicker—Leer = Rahmenfarbe des Themes.

Aussehen: Feineinstellungen (Pro) ​

SettingTypeDefaultDescription
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 — Markierungsstilsingle-selectautoWas 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 — Textfarbecolorpicker—Leer = Textfarbe des Themes.
unlockedColor — Farbe „Freigeschaltet“colorpicker—Leer = Erfolgsfarbe des Themes.
celebration — Freischalt-Animationsingle-selectoffSpielt 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.

FeldGilt fürHinweise
AktivalleInaktive Meilensteine bleiben gespeichert, erscheinen aber nicht und gewähren nichts.
BelohnungalleKostenloser Versand oder Geschenk.
Ab WarenwertalleGrößer als 0. Globale Meilensteine: Standardwährung. Eigene Meilensteine eines Verkaufskanals: dessen Währung.
TitelalleÜ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.
BeschreibungalleÜbersetzbar. Erscheint im Popover des Geschenks.
GeschenkoptionenGeschenkProdukte oder Varianten, keine Hauptprodukte. Die erste ist der Standard. Mehr als eine erfordert Pro.
Nur anzeigen für (Rule Builder)allePro. Leer bedeutet: alle. Ein Meilenstein für kostenlosen Versand pro Regel.
IconalleErsetzt das Bild der Markierung (Lieferwagen-Icon oder Geschenkfoto). Uploads landen im Ordner „Unlock Bar Media“.

Pläne ​

FunktionFreePro
Meilensteine für kostenlosen Versandeiner pro Regel unter „Nur anzeigen für“einer pro Regel unter „Nur anzeigen für“
Geschenk-Meilensteine1 (der niedrigste zutreffende Betrag)unbegrenzt
Geschenkoptionen pro Meilensteindie Standardoptionunbegrenzt
Nur anzeigen für (Rule Builder)bereits gesetzte Regeln bleiben✓
Vorlagen, Feineinstellungen, Freischalt-Animationgespeichert, nicht angewendet✓

Details: Unlock Bar Pro erwerben.

Rechte ​

Unter Einstellungen → Benutzer & Rechte ergänzt Unlock Bar die Rolle Unlock Bar im Bereich Marketing:

RolleErlaubt
Betrachterdie Unlock-Bar-Seite öffnen und die Meilensteine lesen, inklusive der Produkte, Regeln, Aktionen und Versandarten, die sie zeigt
BearbeiterMeilensteine 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 ​

SchnittstelleName
Store-API-Warenkorb-ErweiterungunlockBarProgress
Store-API-RoutenPOST /store-api/ssd-unlock-bar/gift/{milestoneId}/choose, POST /store-api/ssd-unlock-bar/gift/{milestoneId}/add-back
JavaScript-EventUnlockBar/milestoneUnlocked auf document.$emitter
Rule-Builder-BedingungssdCpbMilestoneUnlocked
Entitätenssd_cpb_milestone, ssd_cpb_gift_option

Details: Den Balken im Theme oder in einer Headless-Storefront anpassen.

Your Vision. Signed, Sealed, Delivered.