Dieses Dokument hilft Ihnen beim Erstellen von Formeln im WPForms Calculations Addon. Weitere Informationen und Hilfe zur Erstellung von Formeln finden Sie in unserer Dokumentation für das Calculations Addon.
Regeln
- Zahlen: Der Punkt (.) ist das einzige erlaubte Dezimaltrennzeichen (z. B. 5.20). Verwenden Sie kein Komma (,) für Tausender. (z. B. 12999.45)
- Zeichenfolgen sollten in einfache (‘) oder doppelte (“) Anführungszeichen gesetzt werden. Beispiele: ‘Hallo, Welt!’, “Mein Name ist Sullie”.
- Das Hinzufügen eines Semikolons am Ende der Formelzeile ist optional.
- Nur die unten aufgeführten Operatoren, Variablen, bedingten Anweisungen und Funktionen sind erlaubt.
Arithmetik
| Operator | Beschreibung |
|---|---|
| + | Addieren |
| – | Subtrahieren |
| * | Multiplizieren |
| / | Dividieren |
| ( ) | Klammern; umschließen Teile der Formel, die zuerst berechnet werden sollen |
| % | Modulo; gibt den Rest einer Division zurück |
Feldvariablen
Verwenden Sie Werte aus anderen Feldern in Ihren Berechnungen.
Unterstützte Feldtypen: Single Line Text, Paragraph Text, Dropdown, Multiple Choice, Checkboxes, Number, Name, Email, Number Slider, Phone, Address, Date / Time, Website / URL , Rating, Hidden, Checkbox Items, Multiple Items, Dropdown Items, Single Item, Total
| Variablenmuster | Variablenbeispiel | Erklärung | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| $FX | $F1 | Wert des Feldes mit der ID #X (#1). Alle zulässigen Felder liefern den Hauptwert des Feldes. Ein einfaches Feld liefert den Wert des Eingabeelements. Die kombinierten Felder, wie Name (aber nicht ein einfaches), Adresse, Kontrollkästchen usw., haben den kombinierten Wert. Zum Beispiel das Feld Name, sein kombinierter Wert ist [Vorname Nachname] „Max Mustermann“. Bitte beachten Sie: Der kombinierte Wert, der in $FX gespeichert ist, hat die gleiche Formatierung wie der Hauptfeld-Eintragswert, der auf der Seite „Eintrag anzeigen“ sichtbar ist. | ||||||||||
| $FX_subfield | $F1_first | Der Wert des Unterfeldes des Feldes mit der ID #X. Dies gilt für die kombinierten Felder:
| ||||||||||
| $FX_n | $F1_n | Der Wert der Auswahl n des Kontrollkästchenfeldes mit der ID #X. Der Wert:
Dies gilt nur für das Feld Kontrollkästchen und das Feld Zahlung Kontrollkästchen Elemente. Wenn dynamische Auswahlmöglichkeiten aktiviert sind, sind die Auswahlvariablen nicht verfügbar. | ||||||||||
| $FX_amount | $F12_amount | Der Betragswert des Zahlungsfeldes mit der ID #X. Immer eine Zahl, wie 9,99. Dies gilt für alle Zahlungsfelder, die in Berechnungen verwendet werden können: payment-checkbox, payment-multiple, payment-select, payment-single, payment-total |
Bedingte Anweisungen
Verwenden Sie bedingte Anweisungen, um verschiedene Formeln anzugeben, die verwendet werden sollen, wenn bestimmte Bedingungen erfüllt sind.
wenn/sonst
if ( $F1 > 10 ):
$F1 * 50
else:
0
endif;
wenn/andernfalls/sonst
if ( $F1 < 5.2 ):
$F1 * 50
elseif ( $F1 >= 16 ):
F1 * 25
else:
0
endif;
Tipp
Sie können beliebig viele elseif-Anweisungen verwenden.
Logische Operatoren
| Operator | Beschreibung |
|---|---|
| && | Logisches UND |
| || | Logisches ODER |
| ! | Logisches NICHT |
Bedingte Operatoren
| Operator | Beschreibung |
|---|---|
| == | Gleich |
| != | Ungleich |
| > | Größer als |
| < | Kleiner als |
| >= | Größer als oder gleich |
| <= | Kleiner als oder gleich |
Funktionen
Mathematische Funktionen
| Funktion/Verwendung | Beschreibung |
|---|---|
| abs( Wert ) | Gibt den Absolutwert einer Zahl zurück |
| average( Wert1, [Wert2, …] ) | Gibt den Durchschnittswert der Argumente zurück |
| ceil( Wert ) | Rundet eine Zahl auf die nächste ganze Zahl auf |
| exp( Wert ) | Gibt e^x zurück, wobei e die Eulersche Zahl und x das angegebene Argument ist |
| floor( Wert ) | Gibt die größte ganze Zahl zurück, die kleiner oder gleich einer Zahl ist |
| ln( Wert ) | Gibt den Logarithmus einer Zahl zur Basis e zurück |
| log( Wert ) | Gibt den Logarithmus einer Zahl zur Basis 10 zurück |
| max( Wert1, [Wert2, …] ) | Gibt den größten Wert in der Liste der Argumente zurück |
| min( Wert1, [Wert2, …] ) | Gibt den kleinsten Wert aus der Liste der Argumente zurück |
| pi() | Gibt Pi (π) mit 20 Dezimalstellen zurück |
| pow( Basis, Exponent ) | Gibt Basis hoch Exponent zurück |
| rand( min, max ) | Generiert eine zufällige Ganzzahl |
| round( Wert, Genauigkeit ) | Rundet eine Zahl auf die nächste Ganzzahl |
| sqrt( Wert ) | Gibt die Quadratwurzel einer Zahl zurück |
Zeichenfolgenfunktionen
| Funktion/Verwendung | Beschreibung |
|---|---|
| num( Zeichenkette, Genauigkeit = 14 ) | Konvertiert Zeichenkette in eine Zahl.
Wenn Genauigkeit angegeben ist, wird der Ergebniswert auf die angegebene Anzahl von Nachkommastellen gerundet. |
| trim( Zeichenkette ) | Entfernt Leerzeichen (oder andere Zeichen) vom Anfang und Ende der Zeichenkette |
| truncate( Zeichenkette, Länge ) | Gibt die ersten Länge Zeichen der Zeichenkette zurück |
| concat( str1, [str2, …] ) | Verkettet alle Argumente str1, str2 … strN zu einer Zeichenkette |
| join( Trennzeichen, str1, [str2, …] ) | Verbindet die Argumente str1, str2 … strN zu einer Zeichenkette unter Verwendung des Trennzeichens |
| format_amount( Betrag ) | Formatiert den Betrag mit einem Währungssymbol |
Datums-/Zeitfunktionen
| Funktion/Verwendung | Beschreibung |
|---|---|
| now( format = ‘ ‘ ) | Gibt das aktuelle Datum und die aktuelle Uhrzeit zurück. Das Format ist das WPForms Datums-/Zeitformat. Eine leere Zeichenkette (Standardwert) bedeutet Standardformat: d-m-y H:i. |
| date_diff( start, end, units = ‘days’, format = ‘ ‘ ) | Berechnet die Länge des Zeitraums in Einheiten. Einheiten: years, months, weeks, days, hours, minutes, seconds. Das Format ist das WPForms Datums-/Zeitformat. Eine leere Zeichenkette bedeutet, dass wir versuchen, das richtige Format automatisch zu ermitteln. |
| years( start, end, format = ‘ ‘ ) | Berechnet die Dauer eines Zeitraums in Jahren. Das format ist das WPForms Datetime-String-Format. Ein leerer String bedeutet, dass wir versuchen, das richtige Format automatisch zu ermitteln. |
| months(), weeks(), days(), hours(), minutes(), seconds() Funktionen | Berechnet die Dauer eines Zeitraums. Ähnlich wie years() oben. |
Andere Funktionen
| Funktion/Verwendung | Beschreibung |
|---|---|
| debug( wert1, [wert2, … ] ) | Gibt Debug-Daten auf dem Server in das Debug-Protokoll und auf der Client-Seite in die Browserkonsole aus. |