Este documento ajudará você a criar fórmulas no WPForms Calculations addon. Para informações adicionais e ajuda na criação de fórmulas, consulte nossa documentação do Calculations addon.
Regras
- Números: O ponto (.) é o único símbolo permitido como separador decimal (ex: 5.20). Não use vírgula (,) para milhares. (ex: 12999.45)
- Strings devem ser envolvidas por aspas simples (‘) ou duplas (“). Exemplos: ‘Olá, mundo!’, “Meu nome é Sullie”.
- Adicionar um ponto e vírgula no final da linha da fórmula é opcional.
- Apenas os operadores, variáveis, declarações condicionais e funções listados abaixo são permitidos.
Aritmética
| Operador | Descrição |
|---|---|
| + | Adicionar |
| – | Subtrair |
| * | Multiplicar |
| / | Dividir |
| ( ) | Parênteses; englobe partes da fórmula a serem calculadas primeiro |
| % | Módulo; retorna o resto de uma divisão |
Variáveis de Campo
Use valores de outros campos em seus cálculos.
Tipos de campo suportados: Linha de Texto Único, Texto de Parágrafo, Dropdown, Múltipla Escolha, Checkboxes, Número, Nome, Email, Slider de Número, Telefone, Endereço, Data / Hora, Website / URL , Avaliação, Oculto, Itens de Checkbox, Itens Múltiplos, Itens de Dropdown, Item Único, Total
| Padrão da Variável | Exemplo de Variável | Explicação | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| $FX | $F1 | Valor 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, o campo Nome, seu valor combinado é [primeiro último] “João Silva”. Por favor, observe: o valor combinado armazenado em $FX tem a mesma formatação do valor da entrada do campo principal visível na página de Visualização de Entrada. | ||||||||||
| $FX_subfield | $F1_primeiro | O valor do subcampo do campo com ID #X. Isso se aplica aos campos combinados:
| ||||||||||
| $FX_n | $F1_n | O valor da opção n do campo de caixa de seleção com ID #X. O valor:
Isso se aplica apenas ao campo Caixas de Seleção e ao campo Itens de Caixa de Seleção de Pagamento. Se Opções Dinâmicas estiverem habilitadas, as variáveis de opção não estarão disponíveis. | ||||||||||
| $FX_valor | $F12_valor | O 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 fórmulas diferentes a serem usadas quando certas condições forem atendidas.
se/senão
if ( $F1 > 10 ):
$F1 * 50
else:
0
endif;
se/senão se/senão
if ( $F1 < 5.2 ):
$F1 * 50
elseif ( $F1 >= 16 ):
F1 * 25
else:
0
endif;
Dica
Você pode usar quantas instruções elseif forem necessárias.
Operadores Lógicos
| Operador | Descrição |
|---|---|
| && | E lógico |
| || | OU lógico |
| ! | NÃO lógico |
Operadores Condicionais
| Operador | Descrição |
|---|---|
| == | Igual a |
| != | Diferente de |
| > | Maior que |
| < | Menor que |
| >= | Maior ou igual a |
| <= | Menor ou igual a |
Funções
Funções Matemáticas
| Função/Uso | Descrição |
|---|---|
| abs( valor ) | Retorna o valor absoluto de um número |
| average( valor1, [valor2, …] ) | Retorna o valor médio dos argumentos |
| ceil( valor ) | Arredonda o número para cima para o próximo maior inteiro |
| exp ( valor ) | Retorna e^x, onde e é o número de Euler e x é o argumento fornecido |
| floor( valor ) | Retorna o maior 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 na 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( valor, precisão ) | Arredonda um número para o inteiro mais próximo |
| sqrt( valor ) | Retorna a raiz quadrada de um número |
Funções de String
| Função/Uso | Descrição |
|---|---|
| num( string, precisão = 14 ) | Converte string em número.
Se a precisão for fornecida, o valor resultante será arredondado para o número de dígitos especificado após o ponto decimal. |
| trim( string ) | Remove espaços em branco (ou outros caracteres) do início e do fim da string |
| truncate( string, comprimento ) | Retorna os primeiros comprimento caracteres da string |
| concat( str1, [str2, …] ) | Concatena todos os argumentos str1, str2 … strN em uma única string |
| join( separador, str1, [str2, …] ) | Une os argumentos str1, str2 … strN em uma única string usando o separador |
| format_amount( valor ) | Formata o valor com um símbolo de moeda |
Funções de Data/Hora
| Função/Uso | Descrição |
|---|---|
| now( format = ‘ ‘ ) | Retorna a data e hora atuais. O format é o formato de string de data e hora do WPForms. Uma string vazia (valor padrão) significa formato padrão: d-m-y H:i. |
| date_diff( start, end, units = ‘days’, format = ‘ ‘ ) | Calcula o comprimento do intervalo de tempo em unidades. Unidades: anos, meses, semanas, dias, horas, minutos, segundos. O formato é o formato de string de data/hora do WPForms. Uma string vazia significa que tentaremos determinar o formato correto automaticamente. |
| anos( inicio, fim, formato = ‘ ‘ ) | Calcula o comprimento do intervalo de tempo em anos. O formato é o formato de string de data/hora do WPForms. Uma string vazia significa que tentaremos determinar o formato correto automaticamente. |
| funções meses(), semanas(), dias(), horas(), minutos(), segundos() | Calcula o comprimento do intervalo de tempo. Semelhante a anos() acima. |
Outras Funções
| Função/Uso | Descrição |
|---|---|
| debug( valor1, [valor2, … ] ) | Exibe dados de depuração no log de depuração no servidor e no console do navegador quando executado no lado do cliente. |