Este documento o ajudará a criar fórmulas no complemento Calculations do WPForms. Para obter informações adicionais e ajuda na criação de fórmulas, consulte nossa documentação do complemento Calculations.

Regras

  • Números: O ponto (.) é o único símbolo permitido como ponto decimal (por exemplo, 5,20). Não use vírgula (,) para milhares. (por exemplo, 12999.45)
  • As cadeias de caracteres devem ser envolvidas por aspas (') ou aspas duplas ("). Exemplos: "Hello, world!", "My name is Sullie".
  • A adição de um ponto e vírgula no final da linha da fórmula é opcional.
  • Somente os operadores, as variáveis, as instruções condicionais e as funções listadas abaixo são permitidos.

Aritmética

OperadorDescrição
+Adicionar
-Subtrair
*Multiplicar
/Dividir
( )Parênteses; coloque as partes da fórmula a serem calculadas primeiro
%Modulo; retorna o restante de uma divisão

Variáveis de campo

Use valores de outros campos em seus cálculos.

Tipos de campo compatíveis: 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

Padrão variávelExemplo de variávelExplicação
$FX$F1Valor do campo com ID #X (#1).
Todos os campos permitidos fornecem o valor principal do campo. Um campo simples fornece o valor do elemento de entrada. Os campos combinados, como Nome (mas não um simples), Endereço, Caixas de seleção etc., terão o valor combinado. Por exemplo, no campo Nome, seu valor combinado é [first last] "John Smith".
Observe: o valor combinado armazenado em $FX tem a mesma formatação do valor de entrada do campo principal visível na página Entry View.
$FX_subcampo$F1_primeiroO valor do subcampo do campo com a ID #X.
Isso se aplica aos campos combinados:
Tipo de campo Subcampos
nome primeiro, meio, último
e-mail primário, secundário
endereço address1, address2, city, state, postal, country
data-hora data, hora
$FX_n$F1_nO valor do escolha n do campo de caixa de seleção com a ID #X.
O valor:
  • false - Opção não verificada.
  • o rótulo de escolha (valor) - Escolha marcada.

Isso se aplica somente ao campo Caixas de seleção e ao campo Itens de caixa de seleção de pagamento.

Se a opção Dynamic Choices estiver ativada, as variáveis de escolha não estarão disponíveis.

$FX_amount$F12_amountO valor do montante do campo de pagamento com ID #X.
Sempre um número, como 9.99.
Isso se aplica a todos os Campos de pagamento que podem ser usados em cálculos: payment-checkbox, payment-multiple, payment-select, payment-single, payment-total

Declarações condicionais

Use instruções condicionais para especificar diferentes fórmulas a serem usadas quando determinadas condições forem atendidas.

if/else

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

if/elseif/else

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

Dica

Você pode usar quantos elseif declarações conforme necessário.

Operadores lógicos

OperadorDescrição
&&E lógico
||OU lógico
!NÃO lógico

Operadores condicionais

OperadorDescrição
==Igual a
!=Não igual a
>Maior que
<Menos de
>=Maior ou igual a
<=Menor ou igual a

Funções

Funções matemáticas

Função/UsoDescrição
abs( valor )Retorna o valor absoluto de um número
média( valor1, [valor2, ...] )Retorna o valor médio em args
ceil( valor )Arredonda o número até o próximo maior número inteiro
exp ( valor )Retorna e^x, em que e é o número de Euler e x é o argumento fornecido
piso( valor )Retorna o maior número inteiro menor ou igual a um número
ln( valor )Retorna o logaritmo de um número, base e
log( valor )Retorna o logaritmo de um número, base 10
max( valor1, [valor2, ...] )Retorna o maior valor da lista de argumentos
min( valor1, [valor2, ...] )Retorna o menor valor na lista de argumentos
pi()Retorna pi (π) com 20 casas decimais
pow( base, expoente )Retorna a base elevada à potência do expoente
rand( min, max )Gera um número inteiro aleatório
round( value, precision )Arredonda um número para o inteiro mais próximo
sqrt( valor )Retorna a raiz quadrada de um número

Funções de cadeia de caracteres

Função/UsoDescrição
num( string, precision = 14 )Converte a cadeia de caracteres em um número.

Se a precisão for fornecida, o valor do resultado será arredondado para o número de dígitos fornecido após o ponto decimal.

trim( string )Retira os espaços em branco (ou outros caracteres) do início e do fim da cadeia de caracteres
truncate( string, length )Retorna o primeiro length caracteres da string
concat( str1, [str2, ...] )Concatena todos os argumentos str1, str2 ... strN em uma única string
join( separator, str1, [str2, ...] )Unir os argumentos str1, str2 ... strN em uma única cadeia de caracteres usando o seperador
format_amount( amount )Formatar o valor com um símbolo de moeda

Funções de data/hora

Função/UsoDescrição
now( formato = ' ' )Retorna a data e a hora atuais. A data format é o formato de string de data e hora do WPForms. Uma cadeia vazia (valor padrão) significa o formato padrão: d-m-y H:i.
date_diff( start, end, units = 'days', format = ' ' )Calcular o comprimento do intervalo de tempo em unidades. Unidades: years, months, weeks, days, hours, minutes, seconds. O format é o formato de string de data e hora do WPForms. Uma cadeia vazia significa que tentaremos determinar o formato correto automaticamente.
years( start, end, format = ' ' )Calcule a duração do intervalo de tempo em anos. O format é o formato de string de data e hora do WPForms. Uma cadeia vazia significa que tentaremos determinar o formato correto automaticamente.
Funções months(), weeks(), days(), hours(), minutes(), seconds()Calcular o comprimento do intervalo de tempo. Semelhante a years() acima.

Outras funções

Função/UsoDescrição
debug( value1, [value2, ... ] )Emite dados de depuração para o registro de depuração no servidor e para o console do navegador quando executado no lado do cliente.