Tokens

Tokens sind Platzhalter, die in der Page Editor HTML + CSS Komponente und im Alert Editor für Text und HTML genutzt werden können.

Syntax

Tokens werden mit doppelten geschweiften Klammern geschrieben:

{{creator.name}}

Beispiele:

{{creator.name}}
{{donation.amount}}
{{goal.main.title}}
{{goal.by_name.new-microphone.progress_percent}}
{{checkout.url}}
{{checkout.button:Jetzt unterstützen}}

Creator

Token	Beschreibung
`{{creator.name}}`	Creator-Name.
`{{creator.display_name}}`	Anzeigename des Creators.
`{{creator.avatar}}`	Avatar des Creators.
`{{creator.link_json}}`	Alle aktiven Links als JSON-Array.
`{{creator.link.website}}`	Website-Link.
`{{creator.link.youtube}}`	YouTube-Link.
`{{creator.link.<platformKey-oder-label-slug>}}`	Link über Plattform-Key oder Label-Slug.
`{{creator.links.full}}`	Alle aktiven Links als renderbare Liste.
`{{creator.link.youtube.name}}`	Name des YouTube-Links.
`{{creator.link.youtube.icon}}`	Icon des YouTube-Links.
`{{creator.link.youtube.url}}`	URL des YouTube-Links.
`{{creator.link.youtube.full}}`	Vollständig gerenderter YouTube-Link.

Creator Link Tokens

Creator-Link-Tokens greifen auf aktive Creator Links aus den Creator Links zu. Der Teil nach creator.link. ist kein fester einzelner Token, sondern ein Schlüssel.

Format:

{{creator.link.<linkname>}}

<linkname> kann der platformKey oder der Label-Slug des Links sein. KALYIX normalisiert den Wert als Slug, also klein geschrieben und mit - statt Leerzeichen.

Beispiele:

Creator Link	Möglicher Token	Ergebnis
Platform Key `website`	`{{creator.link.website}}`	URL des Website-Links.
Platform Key `youtube`	`{{creator.link.youtube}}`	URL des YouTube-Links.
Label `YouTube Shorts`	`{{creator.link.youtube-shorts}}`	URL des Links mit diesem Label.
Label `Amazon Wishlist`	`{{creator.link.amazon-wishlist}}`	URL des Links mit diesem Label.
Custom Link Key `my-shop`	`{{creator.link.my-shop}}`	URL des Custom Links.

Wenn mehrere aktive Links denselben Key oder Label-Slug erzeugen, wird der erste passende aktive Link genutzt.

Für Details hängst du ein Feld an den Link-Key an:

{{creator.link.<linkname>.<field>}}

Verfügbare Felder:

Feld	Beispiel	Ergebnis
`name`	`{{creator.link.youtube.name}}`	Anzeigename des Links.
`icon`	`{{creator.link.youtube.icon}}`	Icon-Key des Links. In HTML wird daraus ein Icon-Platzhalter.
`url`	`{{creator.link.youtube.url}}`	URL des Links.
`full`	`{{creator.link.youtube.full}}`	Icon plus Name. In HTML wird das Icon renderbar vorbereitet.

{{creator.link_json}} enthält alle aktiven Links als JSON-Array:

[{ "name", "icon", "iconSource", "url" }]

{{creator.links.full}} gibt alle aktiven Links als Liste aus. In HTML wird daraus eine renderbare Link-Liste, in Text ein kompakter Text-Fallback.

Donation

Token	Beschreibung
`{{donation.username}}`	Name des Unterstützers.
`{{donation.amount}}`	Betrag der Unterstützung.
`{{donation.message}}`	Nachricht des Unterstützers.
`{{donation.interval}}`	Intervall der Unterstützung.

Goals

Main Goal

Token	Beschreibung
`{{goal.main.title}}`	Titel des Hauptziels.
`{{goal.main.name}}`	Name des Hauptziels.
`{{goal.main.current_amount}}`	Aktueller Betrag des Hauptziels.
`{{goal.main.target_amount}}`	Zielbetrag des Hauptziels.
`{{goal.main.progress_percent}}`	Fortschritt des Hauptziels in Prozent.

Goal by Name

Format:

{{goal.by_name.<slug>.<field>}}

Beispiel:

Goal Titel: New Microphone
Slug: new-microphone
Token: {{goal.by_name.new-microphone.progress_percent}}

Felder wie bei goal.main.*:

title
name
current_amount
target_amount
progress_percent

Checkout

Token	Beschreibung
`{{checkout.url}}`	Checkout-URL.
`{{checkout.button}}`	Checkout Button.
`{{checkout.button:Custom Label}}`	Checkout Button mit eigenem Label.
`{{checkout.form}}`	Checkout Formular.
`{{checkout.value:3}}`	Setzt den Checkout-Betrag auf `3`.
`{{checkout.value.custom}}`	Erlaubt einen eigenen Checkout-Betrag.
`{{checkout.username}}`	Feld für Unterstützername.
`{{checkout.message}}`	Feld für Nachricht.

Checkout Form Logic

Für formularartige Checkout-Flows gilt:

{{checkout.value:3}}, {{checkout.value:5}}, …
{{checkout.value.custom}}
{{checkout.username}}
{{checkout.message}}

Diese Tokens setzen nur den Checkout-Entwurf, öffnen aber nicht selbst den Checkout.

Der eigentliche Trigger ist:

{{checkout.button}}

Das heißt:

Value/User/Message-Tokens setzen Werte.
checkout.button startet die Aktion.

Damit braucht es keinen separaten Submit-Token.

Hinweise:

In HTML wird checkout.button als sicheres <a> gerendert.
In Text wird ein Text-Fallback ausgegeben.

Sicherheit

HTML wird sanitized.
CSS wird gefiltert.
Unbekannte Tokens bleiben unverändert stehen.