Platzhalter-Arten
Es gibt 2 Arten von Platzhaltern mit Daten aus 4 verschiedenen Bereichen.
Hinweis: Einige dieser Features sind Teil der Visforms Subscription und in der freien Visforms Version nicht enthalten.
- Feld-Platzhalter
- Feldwerte und Feldlabel.
- Overhead-Platzhalter.
- Formular-Eigenschaften.
- Verwaltungs-Informationen der übermittelten Daten.
- Spezielle Platzhalter
- Aktuelles Datum.
- Double-Opt-In Link in der Double-Opt-In E-Mail.
Feld-Platzhalter
Die Feld-Platzhalter können für die übermittelten Formular-Daten verwendet werden.
Das einfachste Format ohne zusätzliche Option für Feld-Platzhalter lautet: ${fieldname}
Hinweis: Felder vom Typ Submit-Button, Image Submit-Button, Reset-Button und Feldtrenner kennen keine Platzhalter.
Alle Feld-Platzhalter haben mehrere Ausführungen.
Die unterschiedlichen Ausführungen können durch Angabe einer zusätzlichen Platzhalter-Option festgelegt werden.
Einige Feld-Platzhalter haben darüber hinaus weitere Feldtyp-spezifische Optionen.
Zusätzliche Optionen für Feld-Platzhalter
Alle Feld-Platzhalter haben mindestens 3 Ausführungen:
- ${feldname}: Mit Feldwert ersetzen.
- ${feldname|DISPLAYLABEL}: Mit Feldlabel ersetzen.
- ${feldname|DISPLAYLABELPLUSSPACE}: Mit Feldlabel plus Leer-Zeichen ersetzen.
Man kann damit im Text durch Kombination des Feldlabel plus Leerzeichen mit Feldwert erreichen, dass die Darstellung Label Wert nur dann angezeigt wird, wenn tatsächlich ein Wert existiert.
Hinweis: Achtung: Eine dadurch eventuell entstehende Leerzeile bleibt dabei bestehen.
Feldtyp-spezifische Optionen für Platzhalter
Abhängig vom Feldtyp haben einige Feld-Platzhalter zusätzliche Platzhalter-Optionen um zu steuern, wie der Wert konkret angezeigt werden soll:
- ${feldname|FELD-TYP-SPEZIFISCHER-PARAMETER}
Es gibt Feldtyp-spezifische Platzhalter-Optionen für die Darstellung des Wertes für folgende Feld-Typen:
- Feld-Typ Datei Upload:
- ORGNAME: Originalname der Datei.
- PATH: Lokaler Pfad und Name der Datei.
- FULLPATH: Kompletter Pfad und Name der Datei.
- LINK: URL-Link zur Datei.
- ASIMAGE: Als Bild darstellen (Visforms Subscription).
- Feld-Typ Standort (Visforms Subscription):
- LAT: Nur die Latitude (Breitengrad).
- LNG: Nur die Longitude (Längengrad).
- Feld-Typen Radiobutton, Radio SQL (SQL nur Visforms Subscription)
- DISPLAYOPTIONLABEL: Label der Option
- DISPLAYOPTIONVALUE: Wert der Option.
- Feld-Typen Listbox, Checkbox Gruppe, Listbox SQL, Checkbox Gruppe SQL (SQL nur Visforms Subscription):
- DISPLAYOPTIONLABEL: Label der Option.
- DISPLAYOPTIONLABELASLIST: Label der Optionen als Liste bei Mehrfach-Selektion.
- DISPLAYOPTIONVALUE: Wert der Option.
- DISPLAYOPTIONVALUEASLIST: Wert der Optionen als Liste bei Mehrfach-Selektion.
Beispiel für Feld-Typ Datei Upload:
Beispiel für Feld-Typ Listbox:
Overhead-Platzhalter
Overhead-Platzhalter stehen für zusätzliche Verwaltungs-Informationen, die nicht zur Übertragung der eigentlichen Formular-Daten gehören.
Das sind einerseits Informationen zum Formular selbst sowie Verwaltungs-Informationen zum Datensatz der Formular-Daten.
Formular-Eigenschaften
Es gibt folgende Platzhalter für Formular-Eigenschaften:
- ${formid}: Die Formular-ID.
- ${formtitle}: Der Formular-Titel.
Verwaltungs-Informationen der übermittelten Daten
Verwaltungs-Informationen der übermittelten Daten sind nur vorhanden, wenn die Formular-Daten gespeichert werden.
- ${id}: Datensatz-ID.
- ${created}: Datum und Uhrzeit.
- ${created|DATE}: Datum ohne Uhrzeit.
- ${created_by}: Benutzer-ID des Benutzers, der den Datensatz angelegt hat.
- ${created_by|NAME}: Name des Benutzers, der den Datensatz angelegt hat.
- ${modified}: Datum und Uhrzeit der letzten Änderung.
- ${modified|DATE}: Datum ohne Uhrzeit der letzten Änderung.
- ${modified_by}: Benutzer-ID des Benutzers, der den Datensatz zuletzt geändert hat.
- ${modified_by|NAME}: Name des Benutzers, der den Datensatz zuletzt geändert hat.
- ${ismfd}: Modifiziert, also der Hinweis, dass der Datensatz nachträglich geändert wurde.
- ${ipaddress}: IP-Adresse für das Absenden des Formulars.
Bemerkungen zu ${created_by|NAME} und ${modified_by|NAME}:
- Ist die Benutzer-ID gleich 0, wird der Platzhalter einfach nur entfernt.
- Ist die Benutzer-ID ungleich 0 und ein Benutzer mit der ID existiert, wird der Name des Benutzers eingefügt.
- Ist die Benutzer-ID ungleich 0 und ein Benutzer mit der ID existiert nicht, wird der Platzhalter einfach nur entfernt. Das kann etwa der Fall sein, wenn der Benutzer zwischenzeitlich gelöscht wurde.
- Joomla hat eine verwirrende Bezeichnung mit User Name und Username.
Hier geht es um den User Name.
Spezielle Platzhalter
Es gibt einen Platzhalter mit einer Option für das aktuelle Datum:
- ${currentdate}: Das aktuelle Datum
- ${currentdate|DATETIME}: Das aktuelle Datum mit Uhrzeit
Es gibt einen speziellen Platzhalter ohne weitere Optionen, der komplett separat behandelt wird:
- ${doiclink}: Der Double-Opt-In Link in der Double-Opt-In E-Mail.