Daten in E-Mails & Erfolgsmeldung

Benutzerdaten in Erfolgsmeldung und Mails verwenden

Sie k├Ânnen mit Visforms Platzhalter in die E-Mail Texte und der Erfolgsmeldung einf├╝gen. Diese werden mit den ├╝bermittelten Benutzereingaben ersetzt, bevor die Mail verschickt, bzw. der Text angezeigt wird.

Mit diesem Feature k├Ânnen Sie:

  • Texte sehr individuell entsprechend Ihren Anforderungen gestalten.
  • Das Layout der E-Mails gestalten, inklusive der Anzeige der ├╝bermittelten Daten.

Das Grunds├Ątzliche

Standardm├Ą├čig TinyMCE

Wir benutzen sogenannte Textareas um lange Texte, wie Mailtexte oder die Erfolgsmeldung, einzugeben. Um Ihnen ohne gro├če Kenntnisse in HTML die M├Âglichkeit zu geben, diese Texte zu formatieren, kommt Joomla mit sogenannten WYSIWYG (what you see is what you get) Editoren. Standardm├Ą├čig ist dies der WYSIWYG Editor TinyMCE.

Zwei weitere Standard Editoren

Editoren sind Joomla Plugins vom Plugin-Typ “Editor”, die im Plugin-Manager in der Administration Ihrer Webseite aktiviert und deaktiviert werden. Zus├Ątzlich zum TinyMCE Editor Plugin hat Joomla zwei weitere Standard Editor-Plugins, den “Code Mirror” und den Editor “Keine”. Weitere Editoren sind als Third-Party Erweiterungen verf├╝gbar.

Mindestens einen Editor aktivieren

Damit Ihre Joomla Installation korrekt funktioniert, m├╝ssen Sie mindestens ein Editor-Plugin aktiviert haben.

Welcher ist der Standard Editor?

Sie k├Ânnen so viele Editor-Plugins aktivieren wie Sie wollen. In der globalen Konfiguration legen Sie fest, welcher der aktivierten Editoren als Standard Editor verwendet werden soll. Entsprechend Ihren Einstellungen in der Benutzerverwaltung k├Ânnen registrierte Benutzer eventuell einen eigenen abweichenden Standardeditor f├╝r sich festlegen.

Hinweis: Wenn Sie keinen WYSIWYG Editor verwenden wollen, dann w├Ąhlen Sie den Editor "Keine" als Standard Editor aus.

Buttons zum Einf├╝gen

Weiterhin kommt Joomla mit den sogenannten Editor-Buttons. Diese werden in oder unterhalb der Benutzeroberfl├Ąche des Editors als Button oder Icon angezeigt. Beispiele hierzu sind etwa der “Beitr├Ąge”-Button und der “Bilder”-Button. Mit deren Hilfe k├Ânnen Sie sehr einfach Beitragslinks oder Bilder in einen Text einf├╝gen. Editor-Buttons sind ebenfalls Joomla Plugins. Sie sind vom Typ “Editor-xtd”.

Hinweis: Visforms verwendet sein Editor-xtd Plugin "Button - Visformfields", um Ihnen das Einf├╝gen oben genannter Platzhalter so komfortabel wie m├Âglich zu machen.

Manchmal geht nur TinyMCE

Normalerweise funktionieren diese Editor-Buttons in allen Editoren sehr gut. Wenn Sie aber auf einer Seite mehr als ein Editor-Eingabefeld haben, kann es zu echten Schwierigkeiten mit den Editor-Buttons kommen. Das ist etwa innerhalb der Formularkonfiguration der Fall. Dann funktionieren die Editor-Buttons nur noch mit dem TinyMCE Editor so, wie man es erwarten w├╝rde. Die Editor-Buttons funktionieren dann nicht l├Ąnger mit dem Code Mirror Editor, dem “Kein Editor” oder einem Third-Party-Editor wie dem JCE.

Hinweis: Sie m├╝ssen daher sicherstellen, dass das TinyMCE Editor Plugin aktiviert ist. Stellen Sie au├čerdem sicher, dass das Plugin "Button - Visformfields" vom Type "Editor-xtd" aktiviert ist.

Platzhalter einf├╝gen

Visforms eigener Editor-Button

Visforms hat einen eigenen Editor-Button Visforms Platzhalter, mit dem Formularfeld-Platzhalter in die Erfolgsmeldung und die E-Mail Texte eingef├╝gt werden k├Ânnen.

Visforms Platzhalter Button

Dieser Button arbeitet ├Ąhnlich wie der Beitr├Ąge-Button oder der Bilder-Button. Ein Mausklick auf den “Visformfields - Button” ├Âffnet ein Popup Fenster mit einer Liste aller Felder des Formulars, die als Platzhalter eingef├╝gt werden k├Ânnen.

Visforms Platzhalter Liste

Klicken Sie auf den Feldtitel und der Platzhalter f├╝r dieses Feld wird automatisch an der aktuellen Cursor-Position im Editor-Eingabefeld eingef├╝gt.

Da die Formularkonfiguration mehrere Editor-Eingabefelder enth├Ąlt, funktioniert der Visforms Platzhalter-Button nur mit dem TinyMCE Editor korrekt. Die Gr├╝nde hierzu wurden weiter oben bereits beschrieben. Deshalb versucht Visforms die Verwendung des TinyMCE Editor in der Formularkonfiguration zu erzwingen.

Hinweis: Wenn das TinyMCE Editor Plugin aus irgendeinem Grund deaktiviert wurde, ist das Einf├╝gen von Visforms Platzhaltern ├╝ber die Editor-Buttons nicht mehr m├Âglich.

Zus├Ątzliche Platzhalter Optionen

Visforms bietet f├╝r einige Feldtypen zus├Ątzliche Optionen bei der Ersetzung von Platzhaltern an. Beispielsweise k├Ânnen Sie f├╝r Felder vom Typ “File Upload” bestimmen, ob der Platzhalter ersetzt wird gegen

  • den Dateinamen,
  • den Originalnamen der Datei,
  • den lokalen oder
  • den kompletten Pfad zur Datei, oder
  • einen Link zur Datei.

Mit der Visforms Subscription k├Ânnen Sie zus├Ątzlich, wenn die hochgeladenen Datei ein Bild ist, den Platzhalter gegen das eigentliche Bild austauschen.

Visforms Platzhalter Optionen

Alle Platzhalter mit Optionen k├Ânnen ebenfalls ├╝ber den Editor Button Visforms - Platzhalter eingef├╝gt werden.

Platzhalter von Hand einf├╝gen

Angenommen Sie wollen Benutzereingaben in den Mails oder der Erfolgsmeldung verwenden und haben das TinyMCE Editor Plugin aus irgendwelchen Gr├╝nden deaktiviert. Dann k├Ânnen Sie die Platzhalter auch leicht von Hand einf├╝gen. Geben Sie die Zeichenkette ${feldname} ein. Ersetzen Sie in der Zeichenkette “feldname” mit dem Namen des Feldes, das Sie als Platzhalter verwenden wollen.

Haben Sie beispielsweise ein Feld angelegt, das in der Option “Name” den Wert “strasse” hat, dann lautet der entsprechende Platzhalter ${strasse}.

Platzhalter mit Optionen haben das Format ${feldname|OPTIONSNAME}. Die Option wird nach einem trennenden “|”-Zeichen (Pipe) in Gro├čbuchstaben angeh├Ąngt.

Es stehen folgende Optionen zur Verf├╝gung:

  • ORGNAME, PATH, FULLPATH, LINK f├╝r den Feldtype “File Upload”
  • DISPLAYOPTIONVALUE f├╝r die Feldtypen “Listbox”, “Radiobutton”, “Checkbox Gruppe”
  • LAT, LNG f├╝r den Feldtyp “Standort” (Nur Visforms Subscription)
  • ASIMAGE f├╝r den Feldtype “File Upload” (Nur Visforms Subscription)
  • DISPLAYOPTIONVALUE f├╝r die Feldtypen “Listbox Sql”, “Radiobutton Sql”, “Checkbox Gruppe Sql” (Nur Visforms Subscription).

Dar├╝ber hinaus k├Ânnen sie folgende “Allgemeinen Platzhalter” f├╝r Formular-, Datensatzinformationen verwenden. Die Namen sind weitgehend selbsterkl├Ąrenden:

  • ${formtitle},
  • ${id},
  • ${created},
  • ${created_by},
  • ${modified},
  • ${modified_by},
  • ${ismdf},
  • ${ipaddress},
  • ${currentdate}.

${ismdf} ist der Statuszeiger, ob der urspr├╝ngliche Datensatz zwischenzeitlich irgendwie ver├Ąndert/bearbeitet wurde.

Felder vom Typ Submit-Button, Image Submit-Button, Reset-Button und Feldtrenner kennen keine Platzhalter.

Hinweis: Falls Sie einen Feldnamen falsch schreiben oder ein Feld mit einem der vorgenannten Feldtypen verwenden, wird der Platzhalter einfach aus dem Text entfernt.

Bitte beachten Sie, dass ein Formularfeld, das keine Benutzereingabe enth├Ąlt (z.B. weil es kein Pflichtfeld ist) einfach aus dem Text entfernt wird. ├ťberlegen Sie also bitte sorgf├Ąltig, welche Felder zu Pflichtfeldern gemacht werden m├╝ssen.

H├╝bsche E-Mails erstellen

Sie k├Ânnen Platzhalter nutzen, um h├╝bsch formatierte Mails zu erstellen.

  • Deaktivieren Sie die Mail-Option “Daten schicken”.
  • Nutzen Sie Platzhalter, um irgendwo in der Mail eine individuelle Liste mit den Benutzereingaben anzulegen.
  • So k├Ânnen Sie die Reihenfolge der Informationen festlegen.
  • Sie k├Ânnen alle Felder, die Sie nicht in der Mail ├╝bermitteln wollen, einfach auslassen.
  • Sie k├Ânnen den Editor verwenden, um das Layout der Mail zu formatieren, z.B. mit Abs├Ątzen und Fettdruck.

Hinweis: Wenn Sie die Option Download Link zeigen f├╝r die Benutzermail aktiviert haben, wird der Platzhalter f├╝r Felder vom Typ File Upload mit dem Download Link ersetzt. Andernfalls wird der Platzhalter ersetzt mit dem Originalnamen der hochgeladenen Datei.

Platzhalter in der Erfolgsmeldung

Visforms bietet Ihnen in der Formularkonfiguration unter dem Reiter “Ergebnis” die M├Âglichkeit einen eigenen Text zu hinterlegen. Der Text wird dem Benutzer angezeigt, nachdem das Formular erfolgreich ├╝bertragen wurden. Mehr dazu in: Prozesse nach dem Submit. In dieser Erfolgsmeldung k├Ânnen Sie ebenfalls Platzhalter verwenden, die mit den Benutzereingaben aus dem Formular ersetzt werden.

Platzhalter in E-Mail Betreffs

Auch in den Optionen Betreff der Mails k├Ânnen Sie Platzhalter verwenden. Sie m├╝ssen diese allerdings manuell eingeben, wie oben beschrieben.