Este documento irá ajudá-lo a criar fórmulas no addon WPForms Calculations. Para mais informações e ajuda na criação de fórmulas, consulte a nossa documentação do addon Calculations.

Regras

  • Números: O ponto (.) é o único símbolo permitido como ponto decimal (por exemplo, 5,20). Não utilize uma vírgula (,) para milhares. (por exemplo, 12999.45)
  • As cadeias de caracteres devem ser envolvidas por aspas (') ou aspas duplas ("). Exemplos: 'Olá, mundo!', "O meu nome é Sullie".
  • A adição de um ponto e vírgula no final da linha da fórmula é opcional.
  • Apenas são permitidos os operadores, variáveis, declarações condicionais e funções listados abaixo.

Aritmética

OperadorDescrição
+Adicionar
-Subtrair
*Multiplicar
/Dividir
( )Parêntesis; inclui partes da fórmula que devem ser calculadas primeiro
%Módulo; devolve o resto de uma divisão

Variáveis de campo

Utilize valores de outros campos nos seus cálculos.

Tipos de campos suportados: 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 o 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 verificação, etc., terão o valor combinado. Por exemplo, o campo Nome, o seu valor combinado é [primeiro último] "John Smith".
Tenha em atenção: o valor combinado armazenado em $FX tem a mesma formatação que o valor de entrada do campo principal visível na página Vista de entrada.
$FX_subcampo$F1_primeiroO valor do subcampo do campo com ID #X.
Isto aplica-se aos campos combinados:
Tipo de campo Subcampos
nome primeiro, meio, último
correio eletrónico primário, secundário
endereço endereço1, endereço2, cidade, estado, código postal, país
data-hora data, hora
$FX_n$F1_nO valor do escolha n do campo da caixa de verificação com o ID #X.
O valor:
  • false - Opção não selecionada.
  • a etiqueta da escolha (valor) - Escolha selecionada.

Isto aplica-se apenas ao campo Caixas de verificação e ao campo Itens de caixa de verificação de pagamento.

Se a opção Escolhas dinâmicas estiver activada, as variáveis de escolha não estarão disponíveis.

$FX_amount$F12_amountO valor do montante do campo de pagamento com o número de identificaçãoX.
Sempre um número, como 9.99.
Isto aplica-se a todos os Campos de pagamento que podem ser utilizados em cálculos: payment-checkbox, payment-multiple, payment-select, payment-single, payment-total

Declarações condicionais

Utilize instruções condicionais para especificar diferentes fórmulas a serem utilizadas quando determinadas condições são satisfeitas.

se/então

se ( $F1 > 10 ):
     $F1 * 50
senão:
     0
endif;

if/elseif/else

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

Dica

Pode utilizar tantos elseif declarações conforme necessário.

Operadores lógicos

OperadorDescrição
&&Lógica E
||OR lógico
!Lógico NÃO

Operadores condicionais

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

Funções

Funções matemáticas

Função/UtilizaçãoDescrição
abs( valor )Devolve o valor absoluto de um número
média( valor1, [valor2, ...] )Devolve o valor médio em args
ceil( valor )Arredonda o número até ao maior número inteiro seguinte
exp ( valor )Devolve 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 )Devolve o logaritmo de um número, base e
log( valor )Devolve o logaritmo de um número, base 10
max( valor1, [valor2, ...] )Devolve o maior valor da lista de argumentos
min( valor1, [valor2, ...] )Devolve o valor mais pequeno da lista de argumentos
pi()Devolve pi (π) com 20 casas decimais
pow( base, expoente )Devolve 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 )Devolve a raiz quadrada de um número

Funções de cadeia de caracteres

Função/UtilizaçãoDescrição
num( string, precisão = 14 )Converte a cadeia de caracteres num número.

Se for fornecida precisão, o valor do resultado será arredondado para o número de dígitos indicado 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
truncar( string, comprimento )Devolve o primeiro length caracteres da cadeia
concat( str1, [str2, ...] )Concatena todos os argumentos str1, str2 ... strN numa única cadeia
join( separador, str1, [str2, ...] )Junta os argumentos str1, str2 ... strN a uma cadeia de caracteres utilizando o separador
format_amount( montante )Formatar o montante com um símbolo de moeda

Funções de data/hora

Função/UtilizaçãoDescrição
now( formato = ' ' )Devolve a data e a hora actuais. O format é o formato de string de data e hora do WPForms. Uma cadeia vazia (valor por defeito) significa o formato por defeito: 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 da cadeia de caracteres de data e hora do WPForms. Uma cadeia vazia significa que tentaremos determinar automaticamente o formato correto.
anos( início, fim, formato = ' ' )Calcular a duração do intervalo de tempo em anos. O format é o formato da cadeia de caracteres de data e hora do WPForms. Uma cadeia vazia significa que tentaremos determinar automaticamente o formato correto.
funções meses(), semanas(), dias(), horas(), minutos(), segundos()Calcular o comprimento do intervalo de tempo. Semelhante a years() acima.

Outras funções

Função/UtilizaçãoDescrição
debug( valor1, [valor2, ... ] )Emite dados de depuração para o registo de depuração no servidor e para a consola do navegador quando executado do lado do cliente.