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 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 Token | Beschreibung |
|---|---|
##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 Token | Beschreibung |
|---|---|
##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 Token | Beschreibung |
|---|---|
##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 Token | Beschreibung |
|---|---|
##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". |
Dieses Feature ist neu in Isotope eCommerce 2.6.
| Simple Token | Beschreibung |
|---|---|
##config_bankName## | Das Shop-Konfigurationfeld für "Bankname". |
##config_bankAccount## | Das Shop-Konfigurationfeld für "Bankkontonummer (z. B. IBAN)". |
##config_bankCode## | Das Shop-Konfigurationfeld für "Bankleitzahl (BIC / SWIFT)". |
##config_taxNumber## | Das Shop-Konfigurationfeld für "Steuernummer". |
| Simple Token | Beschreibung |
|---|---|
##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 Token | Beschreibung |
|---|---|
##collection_locked## | Das Datum der Bestellung. Die Ausgabe ist ein Timestamp und muss mit Hilfe eines |
##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 |
##collection_date_shipped## | Das Datum an dem die Bestellung versendet wurde. Die Ausgabe ist ein Timestamp und muss mit Hilfe eines |
##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 Token | Beschreibung |
|---|---|
##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 Token | Beschreibung |
|---|---|
##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". |