Der Subscription upgrade-Block ist ein Sub-Block, der innerhalb von Cart items verschachtelt wird. Er fordert Käufer auf, eine berechtigte Einmalkauf-Position direkt im Warenkorb auf ein Abonnement umzustellen — so wird ein Einmalkauf im Moment der Entscheidung zu wiederkehrendem Umsatz — und ermöglicht es bereits abonnierten Käufern, ihren Plan auf dieser Zeile zu ändern oder zu kündigen.
Verhalten
- Erscheint nur auf berechtigten Zeilen. Der Block liest die Selling Plans des Produkts und rendert nichts auf einer Zeile, deren Produkt keine Abonnement-Pläne hat.
- Wird nie auf Reward-Geschenken angeboten. Das Abonnieren eines automatisch gewährten Gratisgeschenks würde dessen Reward-Status entfernen, daher wird die Aufforderung auf diesen Zeilen unterdrückt.
- Auf einer Einmalkauf-Zeile zeigt er den Upgrade-Call-to-Action.
- Auf einer bereits abonnierten Zeile zeigt er eine Planauswahl plus die Option „Downgrade auf Einmalkauf“.
Einstellungen
Platzierung und Limits
- Übergeordneter Block: verschachtelt sich nur innerhalb von Cart items.
- Maximum: 1 pro Warenkorb.
- Nicht standardmäßig hinzugefügt. Nicht gesperrt, du kannst ihn also entfernen oder ausblenden.
Custom Template
view.state verrät dir welchen. view ist innerhalb eines Custom Templates nie null: Wenn eine Zeile keine Pläne hat, rendert der Block nichts und dein Template wird nicht aufgerufen.
Jeder Eintrag in
view.plans ist { id: number, name: string, discountPercent: number }.
Verwende
onChange für ein <select> und selectPlan für Buttons. onChange behandelt den oneTimeValue-Sentinel bereits; wenn du deinen eigenen Handler an ein <select> hängst, musst du selbst gegen oneTimeValue vergleichen und selectPlan(null) aufrufen.