Ce document vous aidera à créer des formules dans le module complémentaire WPForms Calculations. Pour plus d'informations et d'aide sur la création de formules, veuillez consulter la documentation du module complémentaire Calculations.
Règles
- Nombres : Le point (.) est le seul symbole autorisé comme séparateur décimal (par exemple, 5.20). N'utilisez pas de virgule (,) pour les milliers. (par exemple, 12999.45)
- Les chaînes de caractères doivent être entourées de guillemets simples (') ou doubles ("). Exemples : 'Bonjour, le monde !', "Je m'appelle 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 listés ci-dessous sont autorisés.
Arithmétique
| Opérateur | Description |
|---|---|
| + | Ajouter |
| – | Soustraire |
| * | Multiplier |
| / | Diviser |
| ( ) | Parenthèses ; encadrez 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 : Texte sur une seule ligne, Texte de paragraphe, Liste déroulante, Choix multiples, Cases à cocher, Nombre, Nom, E-mail, Curseur numérique, Téléphone, Adresse, Date / Heure, Site Web / URL, Évaluation, Masqué, Éléments de case à cocher, Éléments multiples, Éléments de liste déroulante, Élément unique, Total
| Modèle de 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 d'entrée. Les champs combinés, tels que Nom (mais pas un champ simple), Adresse, Cases à cocher, etc., auront la valeur combinée. Par exemple, le champ Nom, sa valeur combinée est [prénom nom] « Jean Dupont ». Veuillez noter : la valeur combinée stockée dans $FX a le même format que la valeur de saisie du champ principal visible sur la page de visualisation des entrées. | ||||||||||
| $FX_sous_champ | $F1_prénom | 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 cases à cocher avec l'ID #X. La valeur :
Ceci s'applique uniquement au champ Cases à cocher et au champ Articles de paiement par case à cocher. Si des choix dynamiques sont activés, les variables de choix ne seront pas disponibles. | ||||||||||
| $FX_montant | $F12_montant | La valeur du montant du champ de paiement avec l'ID #X. Toujours un nombre, comme 9,99. Ceci s'applique à tous les champs de paiement pouvant être utilisés dans les calculs : payment-checkbox, payment-multiple, payment-select, payment-single, payment-total |
Instructions conditionnelles
Utilisez des instructions conditionnelles pour spécifier différentes formules à utiliser lorsque certaines conditions sont remplies.
si/sinon
if ( $F1 > 10 ):
$F1 * 50
else:
0
endif;
si/sinon si/sinon
if ( $F1 < 5.2 ):
$F1 * 50
elseif ( $F1 >= 16 ):
F1 * 25
else:
0
endif;
Astuce
Vous pouvez utiliser autant d'instructions elseif que nécessaire.
Opérateurs logiques
| Opérateur | Description |
|---|---|
| && | ET logique |
| || | OU logique |
| ! | NON logique |
Opérateurs conditionnels
| Opérateur | Description |
|---|---|
| == | Égal à |
| != | Différent de |
| > | Supérieur à |
| < | Inférieur à |
| >= | Supérieur ou égal à |
| <= | Inférieur ou égal à |
Fonctions
Fonctions mathématiques
| Fonction/Utilisation | Description |
|---|---|
| abs( valeur ) | Retourne la valeur absolue d'un nombre |
| moyenne( valeur1, [valeur2, …] ) | Retourne la valeur moyenne des arguments |
| arrondi.sup( valeur ) | Arrondit un nombre à l'entier supérieur |
| exp( valeur ) | Retourne e^x, où e est le nombre d'Euler et x est l'argument fourni |
| arrondi.inf( valeur ) | Retourne le plus grand entier inférieur ou égal à un nombre |
| ln( valeur ) | Retourne le logarithme d'un nombre, base e |
| log( valeur ) | Retourne le logarithme d'un nombre, base 10 |
| max( valeur1, [valeur2, …] ) | Retourne la plus grande valeur dans la liste des arguments |
| min( valeur1, [valeur2, …] ) | Retourne la plus petite valeur dans la liste des arguments |
| pi() | Retourne pi (π) à 20 décimales |
| pow( base, exposant ) | Retourne la base élevée à la puissance de l'exposant |
| rand( min, max ) | Génère un entier aléatoire |
| round( valeur, précision ) | Arrondit un nombre à l'entier le plus proche |
| sqrt( valeur ) | Retourne la racine carrée d'un nombre |
Fonctions de chaîne
| Fonction/Utilisation | Description |
|---|---|
| num( chaîne, précision = 14 ) | Convertit une chaîne en nombre.
Si la précision est fournie, la valeur résultante sera arrondie au nombre donné de chiffres après la virgule. |
| trim( chaîne ) | Supprime les espaces blancs (ou autres caractères) du début et de la fin de la chaîne |
| truncate( chaîne, longueur ) | Retourne les longueur premiers caractères de la chaîne |
| concat( str1, [str2, …] ) | Concatène tous les arguments str1, str2 … strN en une seule chaîne |
| join( séparateur, str1, [str2, …] ) | Joint les arguments str1, str2 … strN en une seule chaîne en utilisant le séparateur |
| format_amount( montant ) | Formate le montant avec un symbole de devise |
Fonctions date/heure
| Fonction/Utilisation | Description |
|---|---|
| now( format = ‘ ‘ ) | Retourne la date et l'heure actuelles. Le format est le format de chaîne de date et d'heure WPForms. Une chaîne vide (valeur par défaut) signifie le format par défaut : d-m-y H:i. |
| date_diff( start, end, units = ‘jours’, format = ‘ ‘ ) | Calcule la durée d’une période en unités. Unités : années, mois, semaines, jours, heures, minutes, secondes. Le format est le format de chaîne de date/heure WPForms. Une chaîne vide signifie que nous essaierons de déterminer le bon format automatiquement. |
| années( start, end, format = ‘ ‘ ) | Calcule la durée d’une période en années. Le format est le format de chaîne de date/heure WPForms. Une chaîne vide signifie que nous essaierons de déterminer le bon format automatiquement. |
| fonctions mois(), semaines(), jours(), heures(), minutes(), secondes() | Calcule la durée d’une période. Similaire à années() ci-dessus. |
Autres fonctions
| Fonction/Utilisation | Description |
|---|---|
| debug( valeur1, [valeur2, … ] ) | Affiche les 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. |