Visforms-Platzhalter und Platzhalter-Formatierungen
Verfügbar ab Visforms Version 6.1.0.
Zahlreiche Visforms-Platzhalter können zusätzliche Platzhalter-Formatierungen erhalten. Dadurch können nachträglich individuell formatierte Ausgaben der Platzhalter-Werte und Platzhalter-Label erreicht werden.
Hinweis: Einige dieser Features sind Teil der Visforms Subscription und in der freien Visforms Version nicht enthalten.
Hinweis: Beispiele für Platzhalter-Formatierungen mit konkreten Werten und deren Wirkung befinden sich auf der Seite Platzhalter-Beispiele.
Die Format-Option
Die Format-Option und deren weitreichenden Möglichkeiten der Formatierung der Ausgabe werden nachträglich, also erst zum Zeitpunkt der konkreten Ausgabe angewendet.
Sie ermöglichen eine Anpassung der Ausgabe der Werte an die jeweilige Situation.
Die Format-Option für Visforms-Platzhalter kann die beiden folgenden Formen annehmen:
- Verwendung der expliziten FORMAT-Option mit angehängter Formatierungsanweisung:
${Name|FORMAT|(Funktion)Formatierung}
Die explizite FORMAT-Option steht für die folgenden Platzhalter-Arten zur Verfügung:- Feld-Typ Text
- Feld-Typ Zahl
- Feld-Typ Datum
- Feld-Typ Berechnung
- Feld-Typ E-Mail
- Feld-Typ Telefon
- Alle Formular-Eigenschaften
- Alle Formular-Daten-Eigenschaften
- Alle Joomla User-Objekt Information
- Alle Joomla Input-Objekt Information
- Erweiterung der DISPLAYLABEL-Option mit angehängter Formatierungsanweisung:
${Name|DISPLAYLABEL|(Funktion)Formatierung}
Die Erweiterung der DISPLAYLABEL-Option steht für alle DISPLAYLABEL-Optionen zur Verfügung.
Die angehängte Formatierungsanweisung hat den folgenden Aufbau:
- (Funktion)Formatierung
Hinweis: Geschweifte Klammern {} und eckige Klammern [] sind in der angehängten Formatierungsanweisung nicht erlaubt und führen zu einem Fehler.
Für Funktion stehen die folgenden Format-Funktionen zur verfügung:
- number zur einfachen Formatierung von Zahlen (Nachkommastellen, Tausender-Trennzeichen, Dezimal-Trennzeichen)
- date zur Formatierung eines Datums
- print zur Formatierung von Text
- float zur mathematisch/wissenschaftlichen Formatierung von Zahlen
Die Format-Funktionen
Die Format-Funktion “number”
Die Format-Funktion number entspricht der PHP-Funktion
PHP: number_format - Manual.
Der Platzhalter-Wert muss eine Zahl sein und kann Nachkommastellen besitzen.
Der Platzhalter-Wert kann den Dezimal-Trenner Punkt oder Komma besitzen; beide Eingaben sind möglich und werden entsprechend berücksichtigt.
Aufbau der Formatierung (Die eckigen Klammern entfallen):
(number)[Anzahl Nachkommastellen][Dezimal-Trennzeichen][Tausender-Trennzeichen]
Achtung: Die eckigen Klammern [] entfallen und werden nicht geschrieben.
Beispiel:
- Platzhalter: ${number1|FORMAT|(number)2.,}
Ersetzung: 57,550.00
Weitere Beispiele dazu befinden sich hier: Visforms-Informationen mit FORMAT-Optionen: Formular-Felder
Die Format-Funktion “date”
Die Format-Funktion date entspricht der PHP-Funktion
PHP: date_format - Manual.
Der Platzhalter-Wert muss ein valides Datum in Text-Form sein.
Bei einem Platzhalter für eine Information mit dem Typ Datum sind für folgende Platzhalter-Arten alle Bedingungen automatisch erfüllt:
- Feld-Platzhalter
- Overhead-Platzhalter
- Joomla-Objekt-Platzhalter
- Spezielle Platzhalter
Aufbau der Formatierung:
(date)[Datumsformatierung]
Achtung: Die eckigen Klammern [] entfallen und werden nicht geschrieben.
Beispiele:
- Platzhalter: ${date|FORMAT|(date)Y/m/d}
Ersetzung: 2026/03/21 - Platzhalter: ${user:registerDate|FORMAT|(date)Y/m/d H:i:s}
Ersetzung: 2021/11/19 09:17:01
Weitere Beispiele dazu befinden sich hier:
Visforms-Informationen mit FORMAT-Optionen: Formular-Felder
Joomla-Informationen mit FORMAT-Optionen: User-Objekt
Die Format-Funktion “print”
Die Format-Funktion print entspricht der PHP-Funktion
PHP: sprintf - Manual.
Die Format-Funktion print steht für alle Platzhalter-Arten zur Verfügung und bietet sehr viele Möglichkeiten.
Aufbau der Formatierung:
(print)[Ausgabe-Formatierung]
Achtung: Die eckigen Klammern [] entfallen und werden nicht geschrieben.
Beispiele:
- Platzhalter: ${first|FORMAT|(print)This is my entry: ' %s ‘}
Ersetzung: This is my entry: ' Mein Vorname ' - Platzhalter: ${calculate1|FORMAT|(float)%012.2f million bicycles}
Ersetzung: 000017755.62 million bicycles - Platzhalter: ${first|DISPLAYLABEL|(print) Messung ( %s ) =}
Ersetzung: Messung ( first ) =
Weitere Beispiele dazu befinden sich hier:
Visforms-Informationen mit FORMAT-Optionen
Joomla-Informationen mit FORMAT-Optionen
Die Format-Funktion “float”
Die Format-Funktion float entspricht der PHP-Funktion
PHP: sprintf - Manual.
Die Format-Funktion float arbeitet wie die Format-Funktion print mit dem einzigen Unterschied,
dass der Platzhalter-Wert zuvor in eine Zahl mit Nachkommastellen vom Datentyp Float konvertiert wird.
Die Konvertierung findet unmittelbar vor der Anwendung der PHP-Funktion sprintf statt.
Das ist notwendig, da etwa viele mathematisch/wissenschaftlichen Formatierungen diesen Datentyp als Eingabe erwarten.
Aufbau der Formatierung:
(float)[Ausgabe-Formatierung]
Achtung: Die eckigen Klammern [] entfallen und werden nicht geschrieben.
Beispiel:
- Platzhalter: ${number1|FORMAT|(float)%X }} ((Hexadezimale Schreibweise in Großschreibung))
Ersetzung: E0CE - Platzhalter: ${number1|FORMAT|(float)%e }} (Wissenschaftliche Schreibweise in Kleinschreibung)
Ersetzung: 5.755000e+4
Weitere Beispiele dazu befinden sich hier:
Visforms-Informationen mit FORMAT-Optionen
Joomla-Informationen mit FORMAT-Optionen
Übersicht: Platzhalter mit FORMAT-Option
Für die folgenden Platzhalter-Bereiche steht die Format-Option FORMAT zur Verfügung.
Feld-Platzhalter
Für die folgenden Formular-Feld-Typen steht die Format-Option FORMAT zur Verfügung.
- Text
- Zahl
- Datum
- Berechnung
- Telefon
Overhead-Platzhalter
- Alle Formular-Eigenschaften
- Alle Formular-Daten-Eigenschaften
Joomla-Objekt-Platzhalter
- Alle Joomla User-Objekt Informationen
- Alle Joomla Input-Objekt Informationen
Spezielle Platzhalter
- ${currentdate}: Das aktuelle Datum