Questo documento ti aiuterà a creare formule nell'addon WPForms Calculations. Per ulteriori informazioni e aiuto nella creazione di formule, consulta la nostra documentazione dell'addon Calculations.

Regole

  • Numeri: Il punto (.) è l'unico simbolo consentito come separatore decimale (es. 5.20). Non usare la virgola (,) per le migliaia. (es. 12999.45)
  • Le stringhe devono essere racchiuse tra virgolette singole (') o doppie ("). Esempi: 'Ciao, mondo!', "Mi chiamo Sullie".
  • Aggiungere un punto e virgola alla fine della riga della formula è facoltativo.
  • Sono consentiti solo gli operatori, le variabili, le istruzioni condizionali e le funzioni elencate di seguito.

Aritmetica

OperatoreDescrizione
+Aggiungi
–Sottrai
*Moltiplica
/Dividi
( )Parentesi; racchiudono parti della formula da calcolare per prime
%Modulo; restituisce il resto di una divisione

Variabili di campo

Utilizza i valori di altri campi nei tuoi calcoli.

Tipi di campo supportati: Testo a riga singola, Testo paragrafo, Menu a discesa, Scelta multipla, Caselle di controllo, Numero, Nome, Email, Slider numerico, Telefono, Indirizzo, Data / Ora, Sito web / URL, Valutazione, Nascosto, Elementi casella di controllo, Elementi multipli, Elementi menu a discesa, Elemento singolo, Totale

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 uno semplice), Indirizzo, Caselle di controllo, ecc., avranno il valore combinato. Ad esempio, il campo Nome, il suo valore combinato è [nome cognome] “Mario Rossi”.
Nota: il valore combinato memorizzato in $FX ha la stessa formattazione del valore della voce principale del campo visibile nella pagina Visualizzazione voci.
$FX_subfield$F1_firstIl valore del sottocampo del campo con ID #X.
Questo si applica ai campi combinati:
Tipo di campo Sottocampi
nome nome, secondo nome, cognome
email primaria, secondaria
indirizzo indirizzo1, indirizzo2, città, stato, CAP, nazione
data-ora data, ora
$FX_n$F1_nIl valore della scelta n del campo casella di controllo con ID #X.
Il valore:
  • false – Scelta non selezionata.
  • l'etichetta (valore) della scelta – Scelta selezionata.

Questo si applica solo al campo Caselle di controllo e al campo Elementi casella di controllo di pagamento.

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

$FX_amount$F12_amountIl valore dell'importo del campo di pagamento con ID #X.
Sempre un numero, come 9,99.
Questo si applica a tutti i campi di pagamento che possono essere utilizzati nei calcoli: payment-checkbox, payment-multiple, payment-select, payment-single, payment-total

Istruzioni condizionali

Utilizza istruzioni condizionali per specificare formule diverse da utilizzare quando vengono soddisfatte determinate condizioni.

if/else

if ( $F1 > 10 ):
     $F1 * 50
else:
     0
endif;

if/elseif/else

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

Suggerimento

Puoi usare tutte le istruzioni elseif necessarie.

Operatori logici

OperatoreDescrizione
&&AND logico
||O logico
!NON logico

Operatori condizionali

OperatoreDescrizione
==Uguale a
!=Diverso da
>Maggiore di
<Minore di
>=Maggiore o uguale a
<=Minore o uguale a

Funzioni

Funzioni Matematiche

Funzione/UtilizzoDescrizione
abs( valore )Restituisce il valore assoluto di un numero
average( valore1, [valore2, …] )Restituisce il valore medio degli argomenti
ceil( valore )Arrotonda un numero all'intero superiore più vicino
exp( valore )Restituisce e^x, dove e è il numero di Eulero e x è l'argomento fornito
floor( valore )Restituisce il più grande intero minore o uguale a un numero
ln( valore )Restituisce il logaritmo di un numero, base e
log( valore )Restituisce il logaritmo di un numero, base 10
max( valore1, [valore2, …] )Restituisce il valore più grande nell'elenco degli argomenti
min( valore1, [valore2, …] )Restituisce il valore più piccolo nell'elenco degli argomenti
pi()Restituisce pi (π) a 20 cifre decimali
pow( base, esponente )Restituisce la base elevata alla potenza dell'esponente
rand( min, max )Genera un numero intero casuale
round( valore, precisione )Arrotonda un numero all'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 specificato di cifre dopo il punto decimale.

trim( stringa )Rimuove spazi bianchi (o altri caratteri) dall'inizio e dalla fine della stringa
truncate( stringa, lunghezza )Restituisce i primi lunghezza caratteri della stringa
concat( str1, [str2, …] )Concatena tutti gli argomenti str1, str2 … strN in un'unica stringa
join( separatore, str1, [str2, …] )Unisci gli argomenti str1, str2 … strN in un'unica stringa usando il separatore
format_amount( importo )Formatta l'importo con un simbolo di valuta

Funzioni Data/Ora

Funzione/UtilizzoDescrizione
now( formato = ‘ ‘ )Restituisce la data e l'ora correnti. Il formato è il formato stringa data/ora di WPForms. Una stringa vuota (valore predefinito) significa formato predefinito: d-m-y H:i.
date_diff( inizio, fine, unità = ‘giorni’, formato = ‘ ‘ )Calcola la lunghezza dell'intervallo di tempo in unità. Unità: anni, mesi, settimane, giorni, ore, minuti, secondi. Il formato è il formato stringa data/ora di WPForms. Una stringa vuota significa che proveremo a determinare automaticamente il formato corretto.
anni( inizio, fine, formato = ‘ ‘ )Calcola la durata dell’intervallo di tempo in anni. Il formato è la stringa del formato data/ora di WPForms. Una stringa vuota significa che proveremo a determinare automaticamente il formato corretto.
funzioni mesi(), settimane(), giorni(), ore(), minuti(), secondi()Calcola la durata dell’intervallo di tempo. Simile a anni() sopra.

Altre funzioni

Funzione/UtilizzoDescrizione
debug( valore1, [valore2, … ] )Emette dati di debug nel registro di debug sul server e nella console del browser quando eseguito lato client.