Questo documento vi aiuterà a creare formule nell'addon Calcoli di WPForms. Per ulteriori informazioni e per aiutarvi a creare le formule, consultate la documentazione dell'addon Calcoli.

Regole

  • Numeri: Il punto (.) è l'unico simbolo consentito come punto decimale (ad esempio, 5,20). Non utilizzare la virgola (,) per le migliaia. (es. 12999,45)
  • Le stringhe devono essere avvolte da apici (') o da doppi apici ("). Esempi: "Ciao, mondo!", "Il mio nome è Sullie".
  • L'aggiunta di un punto e virgola alla fine della riga della formula è facoltativa.
  • Sono ammessi solo gli operatori, le variabili, le dichiarazioni condizionali e le funzioni elencate di seguito.

Aritmetica

OperatoreDescrizione
+Aggiungi
-Sottrarre
*Moltiplicare
/Dividere
( )Parentesi; racchiudere le parti della formula da calcolare per prime
%Modulo; restituisce il resto di una divisione

Variabili di campo

Utilizzate i valori di altri campi nei vostri calcoli.

Tipi di campo supportati: 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

Modello variabileEsempio di variabileSpiegazione
$FX$F1Valore del campo con ID #X (#1).
Tutti i campi consentiti forniscono il valore principale del campo. Un campo semplice fornisce il valore dell'elemento di input. I campi combinati, come Nome (ma non semplice), Indirizzo, Caselle di controllo e così via, avranno il valore combinato. Ad esempio, il campo Nome, il suo valore combinato è [primo ultimo] "John Smith".
Nota bene: il valore combinato memorizzato in $FX ha la stessa formattazione del valore del campo principale visibile nella pagina di visualizzazione dell'immissione.
$FX_subfield$F1_primoIl valore del sottocampo del campo con ID #X.
Questo vale per i campi combinati:
Tipo di campo Sottocampi
nome nome, centro, cognome
e-mail primario, secondario
indirizzo indirizzo1, indirizzo2, città, stato, posta, paese
data-ora data, ora
$FX_n$F1_nIl valore del scelta n del campo checkbox con ID #X.
Il valore:
  • false - Scelta non verificata.
  • l'etichetta della scelta (valore) - Scelta selezionata.

Questo vale solo per il campo Caselle di controllo e per il campo Voci delle caselle di pagamento.

Se le scelte dinamiche sono abilitate, le variabili di scelta non saranno disponibili.

$Importo_FX$F12_importoIl valore dell'importo del campo di pagamento con ID #X.
Sempre un numero, come 9.99.
Questo vale per tutti i Campi di pagamento che possono essere utilizzati nei calcoli: payment-checkbox, payment-multiple, payment-select, payment-single, payment-total

Dichiarazioni condizionali

Utilizzate le istruzioni condizionali per specificare le diverse formule da utilizzare quando si verificano determinate condizioni.

se/altro

se ( $F1 > 10 ):
     $F1 * 50
altrimenti:
     0
endif;

if/elseif/else

if ( $F1 < 5.2 ):
     $F1 * 50
elseif ( $F1 >= 16 ):
     F1 * 25
else:
     0
endif;

Suggerimento

È possibile utilizzare un numero di elseif dichiarazioni, se necessario.

Operatori logici

OperatoreDescrizione
&&AND logico
||OR logico
!Logico NON

Operatori condizionali

OperatoreDescrizione
==Pari a
!=Non uguale a
>Maggiore di
<Meno di
>=Maggiore o uguale a
<=Inferiore o uguale a

Funzioni

Funzioni matematiche

Funzione/UtilizzoDescrizione
abs( valore )Restituisce il valore assoluto di un numero
media( valore1, [valore2, ...] )Restituisce il valore medio in args
ceil( valore )Arrotonda il numero fino al numero intero immediatamente superiore
exp ( valore )Restituisce e^x, dove e è il numero di Eulero e x è l'argomento fornito.
floor( valore )Restituisce il più grande numero intero minore o uguale a un numero
ln( valore )Restituisce il logaritmo di un numero, in base e
log( valore )Restituisce il logaritmo di un numero, in base 10
max( valore1, [valore2, ...] )Restituisce il valore più grande dell'elenco di argomenti
min( valore1, [valore2, ...] )Restituisce il valore più piccolo dell'elenco di argomenti
pi()Restituisce pi greco (π) con 20 cifre decimali
pow( base, esponente )Restituisce la base elevata a potenza dell'esponente
rand( min, max )Genera un numero intero casuale
round( valore, precisione )Arrotonda un numero al numero intero più vicino
sqrt( valore )Restituisce la radice quadrata di un numero

Funzioni di stringa

Funzione/UtilizzoDescrizione
num( stringa, precisione = 14 )Converte una stringa in un numero.

Se viene fornita la precisione, il valore del risultato verrà arrotondato al numero di cifre indicato dopo la virgola.

trim( stringa )Elimina gli spazi bianchi (o altri caratteri) dall'inizio e dalla fine della stringa.
truncate( stringa, lunghezza )Restituisce il primo length caratteri della stringa
concat( str1, [str2, ...] )Concatena tutti gli argomenti str1, str2 ... strN in un'unica stringa.
join( separatore, str1, [str2, ...] )Unisce gli argomenti str1, str2 ... strN a una stringa utilizzando il separatore
format_amount( importo )Formattare l'importo con un simbolo di valuta

Funzioni di data/ora

Funzione/UtilizzoDescrizione
ora( formato = ' ' )Restituisce la data e l'ora correnti. Il format è il formato della stringa datetime di WPForms. Una stringa vuota (valore predefinito) indica il formato predefinito: d-m-y H:i.
date_diff( inizio, fine, unità = 'giorni', formato = ' ' )Calcola la lunghezza dell'intervallo di tempo in unità. Unità: years, months, weeks, days, hours, minutes, seconds. Il format è il formato della stringa datetime di WPForms. Una stringa vuota significa che cercheremo di determinare automaticamente il formato giusto.
anni( inizio, fine, formato = ' ' )Calcolare la lunghezza dell'intervallo di tempo in anni. Il format è il formato della stringa datetime di WPForms. Una stringa vuota significa che cercheremo di determinare automaticamente il formato giusto.
funzioni mesi(), settimane(), giorni(), ore(), minuti(), secondi()Calcolo della lunghezza dell'intervallo di tempo. Simile a years() sopra.

Altre funzioni

Funzione/UtilizzoDescrizione
debug( valore1, [valore2, ... ] )Invia i dati di debug al log di debug sul server e alla console del browser quando viene eseguito sul lato client.