Ersetzungscodes und Bedingungen
Mit Ersetzungscodes schreiben Sie einen Text einmal und Octoserv setzt beim Anzeigen oder Versenden die Daten des Kontakts ein: den Namen, die Anrede, die Firma, ein Datum. Mit Bedingungen entscheiden Sie zusätzlich, welcher Satz überhaupt erscheint. So beginnt ein Angebot mit „Guten Tag Herr Wittmann,“, wenn Anrede und Nachname da sind, und sonst mit „Guten Tag,“.
Wo die Codes gelten
Es ist ein gemeinsames System. Ein Code bedeutet überall dasselbe und Sie lernen es nur einmal:
- E-Mails und Newsletter
- Flows: alle Textfelder der Schritte, zum Beispiel Titel und Beschreibung von Aufgaben und Rechnungen
- Angebote: Einleitung, Schlusstext und Textblöcke, auch in Angebotsvorlagen (in der Webansicht und im PDF)
- Vertragsdokumente
- Mails und Texte von OctoPages, WhatsApp-Nachrichten und Umfragen
Absender und Unterschrift
In Brief- und Dokumentvorlagen (nicht in E-Mails) gibt es die Codes {sender.signature} (die Unterschrift als Bild), {sender.name}, {sender.first_name}, {sender.last_name}, {sender.email} und {sender.phone}. Sie gelten für den Benutzer, der das Dokument erstellt oder versendet. {sender.email} ist die Absenderadresse, die beim Erstellen oder Versenden gewählt ist (zentrale Adresse des Unternehmens oder eigene Adresse; Voreinstellung in den Angebotseinstellungen und unter Einstellungen → SMTP), nie die Adresse, mit der sich der Benutzer anmeldet. Die zentrale Adresse gibt es auch als {business.email}. Ohne Benutzer, zum Beispiel in einem Flow, bleiben die Codes {sender.*} leer. Mehr unter „Ein Brief aus einer Vorlage“.
Einen Code einfügen
Neben jedem Textfeld, das Codes versteht, sitzt der Knopf { } Tag. Er öffnet die Liste aller Codes, nach Gruppen geordnet und durchsuchbar. Ein Klick setzt den Code an die Stelle des Cursors. Oder Sie schreiben ihn von Hand in geschweiften Klammern.
| Code | Ergebnis |
|---|---|
{contact.first_name} | Vorname des Kontakts |
{contact.last_name} | Nachname des Kontakts |
{contact.salutation} | Anrede, zum Beispiel Herr oder Frau |
{company.name} | Firma des Kontakts |
{owner.full_name} | Name der zuständigen Person |
{gruss} | Eine eigene Ersetzungsregel, hier Ihre Grußformel |
{offer.number}, {offer.title}, {offer.valid_until} | Nur in Angeboten: Nummer, Titel und Gültigkeit des Angebots |
Ein Ersatztext, wenn der Wert fehlt
Nach einem senkrechten Strich schreiben Sie, was erscheinen soll, wenn der Kontakt keinen Wert hat:
Guten Tag {contact.first_name|liebe Kundin, lieber Kunde},
Bedingungen
Mit {if …}, {else} und {/if} erscheint ein Teil des Textes nur, wenn eine Bedingung stimmt.
Das ist der Weg zu einer sauberen Anrede:
{if contact.salutation and contact.last_name}Guten Tag {contact.salutation} {contact.last_name},{else}Guten Tag,{/if}
Hat der Kontakt Anrede und Nachnamen, steht dort „Guten Tag Herr Wittmann,“. Fehlt eines von beiden, steht dort „Guten Tag,“. Die OctoPages-Angebote beginnen genau so.
Die Bedingung ist einer dieser Formen:
| Schreibweise | Bedeutung |
|---|---|
{if contact.last_name} | stimmt, wenn der Code einen Wert hat |
{if !contact.last_name} | stimmt, wenn der Code leer ist |
{if contact.salutation == "Frau"} | Vergleich: == (oder =), !=, ~ (enthält), !~ (enthält nicht), >, >=, <, <= |
{if a and b}, {if a or b} | Verknüpfung; „and“ bindet stärker als „or“ |
Mit {elseif …} prüfen Sie eine weitere Bedingung. Bedingungen dürfen ineinander stehen. Vergleichen Sie Zahlen, wird
zahlenmäßig verglichen, sonst als Text ohne Beachtung der Groß-/Kleinschreibung. Steht ein {if} ohne {/if},
bleibt der Block unverändert stehen.
Formatieren
Hinter dem senkrechten Strich können Sie einen Wert umformen, auch mehrere nacheinander:
{contact.last_name|upper}.
| Format | Wirkung |
|---|---|
upper, lower, title, ucfirst | Groß-/Kleinschreibung |
trim | Leerzeichen am Rand entfernen |
substr:0,3 | ein Teil des Textes (Start, Länge) |
truncate:40 | höchstens 40 Zeichen, bei Kürzung mit „...“ |
number:2 | Zahl mit Nachkommastellen, deutsch 1.234,50 |
date:d.m.Y | ein Datum in der angegebenen Schreibweise |
and_list, or_list, csv, ul, ol | Listen als „a, b und c“, „a, b oder c“, „a, b, c“ oder als Aufzählung |
Datum
{date} ist das heutige Datum in Ihrer Zeitzone, {date.d.m.Y} in der Schreibweise Ihrer Wahl.
Dahinter können Sie das Datum verschieben:
Dieses Angebot gilt bis {date.d.m.Y|+14 days}.
Erlaubt ist alles, was der Datumsleser versteht: +2 days, -1 week, next monday,
first day of next month. Mit {local_date} gilt die Zeitzone des Kontakts.
Beispiel im Angebot
Im Angebotseditor, Reiter Anschreiben, haben Einleitung und Schlusstext den Knopf { } Tag. Die Vorschau zeigt den Text sofort mit den Daten des Kontakts. Textblöcke in den Bereichen verstehen die Codes ebenfalls. In der Vorschau stehen sie so, wie Sie sie tippen, in der Webansicht und im PDF des Kunden sind sie ersetzt.
{if contact.salutation and contact.last_name}Guten Tag {contact.salutation} {contact.last_name},{else}Guten Tag,{/if}
vielen Dank für Ihre Anfrage zum Angebot {offer.number}.