Ce document vous aidera à construire des formules dans l'addon Calculs de WPForms. Pour plus d'informations et de l'aide pour créer des formules, veuillez consulter la documentation de notre addon Calculations.
Règles
- Les nombres : Le point (.) est le seul symbole autorisé comme point décimal (par exemple, 5,20). Ne pas utiliser de virgule (,) pour les milliers. (par exemple, 12999.45)
- Les chaînes de caractères doivent être entourées de guillemets (') ou de guillemets doubles ("). Exemples : 'Hello, world!', 'My name is Sullie'.
- L'ajout d'un point-virgule à la fin de la ligne de formule est facultatif.
- Seuls les opérateurs, variables, instructions conditionnelles et fonctions énumérés ci-dessous sont autorisés.
Arithmétique
| Opérateur | Description |
|---|---|
| + | Ajouter |
| - | Soustraire |
| * | Multiplier |
| / | Diviser |
| ( ) | Parenthèses ; entourent les parties de la formule à calculer en premier. |
| % | Modulo ; renvoie le reste d'une division |
Variables de champ
Utilisez les valeurs d'autres champs dans vos calculs.
Types de champs pris en charge : 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
| Modèle variable | Exemple de variable | Explication | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| $FX | $F1 | Valeur du champ avec l'ID #X (#1). Tous les champs autorisés fournissent la valeur principale du champ. Un champ simple fournit la valeur de l'élément de saisie. Les champs combinés, tels que le champ Nom (mais pas un champ simple), le champ Adresse, les cases à cocher, etc. Par exemple, la valeur combinée du champ Nom est [first last] "John Smith". Veuillez noter que la valeur combinée stockée dans $FX a le même formatage que la valeur d'entrée du champ principal visible sur la page de visualisation des entrées. | ||||||||||
| $FX_subfield | $F1_first | La valeur du sous-champ du champ avec l'ID #X. Ceci s'applique aux champs combinés :
| ||||||||||
| $FX_n | $F1_n | La valeur du choix n du champ de la case à cocher avec l'ID #X. La valeur :
Ceci ne s'applique qu'aux champs Cases à cocher et Éléments de la case à cocher de paiement. Si les choix dynamiques sont activés, les variables de choix ne seront pas disponibles. | ||||||||||
| $FX_amount | $F12_amount | La valeur du montant du champ de paiement avec l'ID #.X. Toujours un nombre, comme 9.99. Cela s'applique à toutes les Champs de paiement qui peuvent être utilisés dans les calculs : payment-checkbox, payment-multiple, payment-select, payment-single, payment-total |
Déclarations conditionnelles
Utilisez des instructions conditionnelles pour spécifier différentes formules à utiliser lorsque certaines conditions sont remplies.
if/else
si ( $F1 > 10 ) :
$F1 * 50
else :
0
endif ;
if/elseif/else
if ( $F1 < 5.2 ):
$F1 * 50
elseif ( $F1 >= 16 ):
F1 * 25
else:
0
endif;
Conseil
Vous pouvez utiliser autant de elseif le cas échéant.
Opérateurs logiques
| Opérateur | Description |
|---|---|
| && | ET logique |
| || | OU logique |
| ! | Logique NON |
Opérateurs conditionnels
| Opérateur | Description |
|---|---|
| == | Egale à |
| != | Pas égal à |
| > | Supérieure à |
| < | Moins de |
| >= | Supérieur ou égal à |
| <= | Inférieur ou égal à |
Fonctions
Fonctions mathématiques
| Fonction/utilisation | Description |
|---|---|
| abs( valeur ) | Renvoie la valeur absolue d'un nombre |
| average( value1, [value2, ...] ) | Renvoie la valeur moyenne dans les args |
| ceil( valeur ) | Arrondit le nombre à l'entier supérieur le plus proche |
| exp ( valeur ) | Renvoie e^x, où e est le nombre d'Euler et x est l'argument fourni |
| floor( valeur ) | Renvoie le plus grand entier inférieur ou égal à un nombre |
| ln( valeur ) | Renvoie le logarithme d'un nombre, base e |
| log( valeur ) | Renvoie le logarithme d'un nombre, en base 10 |
| max( valeur1, [valeur2, ...] ) | Renvoie la plus grande valeur de la liste d'arguments |
| min( valeur1, [valeur2, ...] ) | Renvoie la plus petite valeur de la liste d'arguments |
| pi() | Renvoie pi (π) avec 20 décimales |
| pow( base, exposant ) | Renvoie la base élevée à la puissance de l'exposant |
| rand( min, max ) | Génère un nombre entier aléatoire |
| round( value, precision ) | Arrondit un nombre à l'entier le plus proche |
| sqrt( valeur ) | Renvoie la racine carrée d'un nombre |
Fonctions des chaînes de caractères
| Fonction/utilisation | Description |
|---|---|
| num( string, precision = 14 ) | Convertit une chaîne de caractères en un nombre.
Si la précision est fournie, la valeur du résultat sera arrondie au nombre de chiffres indiqué après la virgule. |
| trim( string ) | Supprime les espaces blancs (ou autres caractères) au début et à la fin de la chaîne. |
| truncate( string, length ) | Renvoie le premier length caractères de la chaîne de caractères |
| concat( str1, [str2, ...] ) | Concatène tous les arguments str1, str2 ... strN en une seule chaîne. |
| join( separator, str1, [str2, ...] ) | Joindre les arguments str1, str2 ... strN en une seule chaîne de caractères en utilisant le séparateur |
| format_amount( amount ) | Formater le montant avec un symbole monétaire |
Fonctions date/heure
| Fonction/utilisation | Description |
|---|---|
| now( format = ' ' ) | Renvoie la date et l'heure actuelles. La date format est le format de la chaîne de date de WPForms. Une chaîne vide (valeur par défaut) correspond au format par défaut : d-m-y H:i. |
| date_diff( start, end, units = 'days', format = ' ' ) | Calculer la longueur de l'intervalle de temps en unités. Unités : years, months, weeks, days, hours, minutes, seconds. Les format est le format de la chaîne de date de WPForms. Une chaîne vide signifie que nous essaierons de déterminer le bon format automatiquement. |
| years( start, end, format = ' ' ) | Calculer la durée de l'intervalle de temps en années. Les format est le format de la chaîne de date de WPForms. Une chaîne vide signifie que nous essaierons de déterminer le bon format automatiquement. |
| les fonctions months(), weeks(), days(), hours(), minutes(), seconds() | Calculer la longueur de l'intervalle de temps. Similaire à years() ci-dessus. |
Autres fonctions
| Fonction/utilisation | Description |
|---|---|
| debug( value1, [value2, ... ] ) | Produit des données de débogage dans le journal de débogage sur le serveur et dans la console du navigateur lorsqu'il est exécuté côté client. |