Simple Tokens #

Simple Tokens ist womöglich eines der meistunterschätzten Features innerhalb von Contao und wird im Kern von Contao leider auch nur für das Newsletter-Modul verwendet.

Simple Tokens werden deshalb in der offiziellen Dokumentation auch nur kurz angerissen.

In Isotope eCommerce werden die Tokens oft verwendet, weil sie dir viel Flexibilität geben. Sie werden unter anderem hier verwendet:

  • Im gesamten Benachrichtigungszentrum
  • Für die Darstellung der Adressen der verschiedenen Länder (bspw. PLZ vor oder nach Ort etc.)
  • In den Dokumenten, um den Dokumententitel sowie den Dokumenten-Dateinamen zu individualisieren

Im Benachrichtigungszentrum kriegst du übrigens durch einfaches Tippen von `##` einen Autocompleter, der dich bei der Auswahl der Tokens assistiert.

Simple Tokens unterstützen im Gegensatz zu Inserttags auch einfache If-Else-Abfragen wodurch z.B. in Bestellbestätigungs-E-Mails auch sowas möglich wäre:

{if billing_address_gender=="male"}
Sehr geehrter Herr ##billing_address_lastname##,
{elseif billing_address_gender=="female"}
Sehr geehrte Frau ##billing_address_lastname##,
{else}
Sehr geehrte Damen und Herren,
{endif}

Dieser Benachrichtigungstyp kann bei der Änderung des Status einer Bestellung ausgelöst werden. Dies gilt auch für eine ganz neue Bestellung da die im Prinzip nichts anderes darstellt, als den Wechsel von "keinem Status" zu Status "neu".

Simple TokenBeschreibung
##uniqid##Eindeutige ID der Bestellung.
##order_status##Bezeichnung des derzeitigen Status der Bestellung.
##order_status_old##Bezeichnung des vorherigen Bestellstatus. Nützlich beispielsweise für "Bestellstatus änderte sich von x zu y".
##order_status_id##Die ID des derzeitigen Status der Bestellung.
##order_status_id_old##ID des vorherigen Status der Bestellung.
##recipient_email##Die E-Mail-Adresse des Empfängers.
##order_id##Die ID der Bestellung.
##order_items##Die Anzahl der Artikel (Anzahl aufsummiert) in der Bestellung.
##order_products##Die Anzahl von individuellen Produkten in der Bestellung.
##order_subtotal##Zwischensumme der Bestellung.
##order_total##Gesamtsumme der Bestellung.
##document_number##Die Dokumentennummer der Bestellung (Bestellnummer).
##cart_text##Bestellung/Warenkorb im Text-Format.
##cart_html##Bestellung/Warenkorb in HTML.
##document##Das Dokument, welches angehängt werden soll (z. B. eine Rechnung).
##form_*##Alle im Formulargenerator angelegten Felder.
##payment_id##ID der Zahlungsart.
##payment_label##Zahlungsart-Beschriftung.
##payment_note##Notiz zur Zahlungsart.
##shipping_id##ID der Versandart.
##shipping_label##Versandart-Name.
##shipping_note##Versandart-Hinweis.
Simple TokenBeschreibung
##billing_address_gender##Das Rechnungsadressfeld für "Geschlecht".
##billing_address_salutation##Das Rechnungsadressfeld für "Anrede".
##billing_address_firstname##Das Rechnungsadressfeld für "Vorname".
##billing_address_lastname##Das Rechnungsadressfeld für "Nachname".
##billing_address_dateOfBirth##Das Rechnungsadressfeld für "Geburtsdatum".
##billing_address_company##Das Rechnungsadressfeld für "Firma".
##billing_address_vat_no##Das Rechnungsadressfeld für "USt-IdNr.".
##billing_address_street_1##Das Rechnungsadressfeld für "Strasse".
##billing_address_street_2##Das Rechnungsadressfeld für "Strasse 2".
##billing_address_street_3##Das Rechnungsadressfeld für "Strasse 3".
##billing_address_postal##Das Rechnungsadressfeld für "Postleitzahl".
##billing_address_city##Das Rechnungsadressfeld für "Ort".
##billing_address_subdivision##Das Rechnungsadressfeld für "Staat".
##billing_address_country##Das Rechnungsadressfeld für "Land".
##billing_address_phone##Das Rechnungsadressfeld für "Telefonnummer".
##billing_address_email##Das Rechnungsadressfeld für "E-Mail-Adresse".
Simple TokenBeschreibung
##shipping_address_gender##Das Versandadressfeld für "Geschlecht".
##shipping_address_salutation##Das Versandadressfeld für "Anrede".
##shipping_address_firstname##Das Versandadressfeld für "Vorname".
##shipping_address_lastname##Das Versandadressfeld für "Nachname".
##shipping_address_dateOfBirth##Das Versandadressfeld für "Geburtsdatum".
##shipping_address_company##Das Versandadressfeld für "Firma".
##shipping_address_vat_no##Das Versandadressfeld für "USt-IdNr.".
##shipping_address_street_1##Das Versandadressfeld für "Strasse".
##shipping_address_street_2##Das Versandadressfeld für "Strasse 2".
##shipping_address_street_3##Das Versandadressfeld für "Strasse 3".
##shipping_address_postal##Das Versandadressfeld für "Postleitzahl".
##shipping_address_city##Das Versandadressfeld für "Ort".
##shipping_address_subdivision##Das Versandadressfeld für "Staat".
##shipping_address_country##Das Versandadressfeld für "Land".
##shipping_address_phone##Das Versandadressfeld für "Telefonnummer".
##shipping_address_email##Das Versandadressfeld für "E-Mail-Adresse".
Simple TokenBeschreibung
##config_firstname##Das Shop-Konfigurationfeld für "Vorname".
##config_lastname##Das Shop-Konfigurationfeld für "Nachname".
##config_company##Das Shop-Konfigurationfeld für "Firma".
##config_vat_no##Das Shop-Konfigurationfeld für "USt-IdNr.".
##config_street_1##Das Shop-Konfigurationfeld für "Strasse".
##config_street_2##Das Shop-Konfigurationfeld für "Strasse 2".
##config_street_3##Das Shop-Konfigurationfeld für "Strasse 3".
##config_postal##Das Shop-Konfigurationfeld für "Postleitzahl".
##config_city##Das Shop-Konfigurationfeld für "Ort".
##config_subdivision##Das Shop-Konfigurationfeld für "Staat".
##config_country##Das Shop-Konfigurationfeld für "Land".
##config_phone##Das Shop-Konfigurationfeld für "Telefonnummer".
##config_email##Das Shop-Konfigurationfeld für "E-Mail-Adresse".
Simple TokenBeschreibung
##member_firstname##Das Contao-Mitgliederfeld für "Vorname".
##member_lastname##Das Contao-Mitgliederfeld für "Nachname".
##member_dateOfBirth##Das Contao-Mitgliederfeld für "Geburtsdatum".
##member_gender##Das Contao-Mitgliederfeld für "Geschlecht".
##member_company##Das Contao-Mitgliederfeld für "Firma".
##member_street##Das Contao-Mitgliederfeld für "Strasse".
##member_postal##Das Contao-Mitgliederfeld für "Postleitzahl".
##member_city##Das Contao-Mitgliederfeld für "Ort".
##member_state##Das Contao-Mitgliederfeld für "Staat".
##member_country##Das Contao-Mitgliederfeld für "Land".
##member_phone##Das Contao-Mitgliederfeld für "Telefonnummer".
##member_mobile##Das Contao-Mitgliederfeld für "Handynummer".
##member_fax##Das Contao-Mitgliederfeld für "Faxnummer".
##member_email##Das Contao-Mitgliederfeld für "E-Mail-Adresse".
##member_website##Das Contao-Mitgliederfeld für "Webseite".
##member_language##Das Contao-Mitgliederfeld für "Sprache".
##member_username##Das Contao-Mitgliederfeld für "Benutzername".
##member_dateAdded##Das Contao-Mitgliederfeld für "Hinzugefügt am".
Simple TokenBeschreibung
##collection_locked##Das Datum der Bestellung.
Die Ausgabe ist ein Timestamp und muss mit Hilfe eines Inserttags formatiert werden.
##collection_document_number##Die Dokumentennummer der Bestellung.
##collection_uniqid##Eindeutige ID der Bestellung.
##collection_date_paid##Das Datum an dem die Bestellung bezahlt wurde.
Die Ausgabe ist ein Timestamp und muss mit Hilfe eines Inserttags formatiert werden.
##collection_date_shipped##Das Datum an dem die Bestellung versendet wurde.
Die Ausgabe ist ein Timestamp und muss mit Hilfe eines Inserttags formatiert werden.
##collection_subtotal##Die Zwischensumme der Bestellung.
##collection_tax_free_subtotal##Die Zwischensumme der Bestellung ohne Steuern.
##collection_total##Das Gesamtsumme der Bestellung
##collection_tax_free_total##Die Gesamtsumme der Bestellung ohne Steuern.
##collection_currency##Die Währung der Bestellung.

Dieser Benachrichtigungstyp kann dazu verwendet werden, Benachrichtigungen zu versenden, wenn ein Mitglied seine Adresse ändert.

Simple TokenBeschreibung
##admin_email##Die E-Mail-Adresse des Webseiten-Administrators.
##domain##Die Domain auf der die Änderung vorgenommen wurde.
##link##Die vollständige URL auf der die Änderung vorgenommen wurde.
Simple TokenBeschreibung
##address_gender##Das neue Adressfeld für "Geschlecht".
##address_old_gender##Das alte Adressfeld für "Geschlecht".
##address_salutation##Das neue Adressfeld für "Anrede".
##address_old_salutation##Das alte Adressfeld für "Anrede".
##address_firstname##Das neue Adressfeld für "Vorname".
##address_old_firstname##Das alte Adressfeld für "Vorname".
##address_lastname##Das neue Adressfeld für "Nachname".
##address_old_lastname##Das alte Adressfeld für "Nachname".
##address_dateOfBirth##Das neue Adressfeld für "Geburtsdatum".
##address_old_dateOfBirth##Das alte Adressfeld für "Geburtsdatum".
##address_company##Das neue Adressfeld für "Firma".
##address_old_company##Das alte Adressfeld für "Firma".
##address_vat_no##Das neue Adressfeld für "USt-IdNr.".
##address_old_vat_no##Das alte Adressfeld für "USt-IdNr.".
##address_street_1##Das neue Adressfeld für "Strasse".
##address_old_street_1##Das alte Adressfeld für "Strasse".
##address_street_2##Das neue Adressfeld für "Strasse 2".
##address_old_street_2##Das alte Adressfeld für "Strasse 2".
##address_street_3##Das neue Adressfeld für "Strasse 3".
##address_old_street_3##Das alte Adressfeld für "Strasse 3".
##address_postal##Das neue Adressfeld für "Postleitzahl".
##address_old_postal##Das alte Adressfeld für "Postleitzahl".
##address_city##Das neue Adressfeld für "Ort".
##address_old_city##Das alte Adressfeld für "Ort".
##address_subdivision##Das neue Adressfeld für "Staat".
##address_old_subdivision##Das alte Adressfeld für "Staat".
##address_country##Das neue Adressfeld für "Land".
##address_old_country##Das alte Adressfeld für "Land".
##address_phone##Das neue Adressfeld für "Telefonnummer".
##address_old_phone##Das alte Adressfeld für "Telefonnummer".
##address_email##Das neue Adressfeld für "E-Mail-Adresse".
##address_old_email##Das alte Adressfeld für "E-Mail-Adresse".
Feedback zu diesem Artikel geben
Bitte rechne 9 plus 7.