Construir F rmulas com o Add-on de C a culos

Gostaria de aprender a criar fórmulas para realizar operações básicas e avançadas nos seus formulários WordPress? Com o suplemento Cálculos, poderá converter os seus formulários em calculadoras para resolver problemas específicos dos utilizadores.

Este tutorial explicará como criar fórmulas, abordando todas as regras, operações e funções no guia de consulta rápida do suplemento Cálculos.

---

Antes de começar, terá primeiro de garantir que o WPForms está instalado e ativado no seu site WordPress e que verificou a sua licença.

Aceder à Documentação de Consulta Rápida

Após instalar o suplemento Cálculos, crie um novo formulário ou edite um existente para aceder ao construtor de formulários.

No construtor de formulários, terá de adicionar um dos campos suportados para poder ativar o modo de cálculo no campo do formulário.

Assim que adicionar um campo suportado, clique nele para abrir o painel Opções de Campo. Em seguida, navegue até ao separador Avançadas. Lá, verá o interruptor Ativar Cálculo.

Ativar esta opção abrirá o construtor de fórmulas. Aqui, pode criar fórmulas e realizar cálculos utilizando outros valores de campo como variáveis.

Pode aceder à documentação de consulta rápida do suplemento Cálculos clicando na ligação Consulta Rápida acima do construtor de fórmulas.

Alternativamente, pode aceder a esta página utilizando esta ligação. O guia de consulta rápida contém as várias regras, operadores e funções atualmente suportados com o suplemento Cálculos.

Compreender as Regras e Operadores do Suplemento Cálculos

Semelhante à forma como as linguagens de programação têm regras e sintaxe, o construtor de fórmulas também tem o seu próprio conjunto de regras. Aderir a estas regras garante que as suas fórmulas funcionam como pretendido. Abaixo, explicámos as mais importantes a seguir.

• Ao adicionar números, só pode usar um ponto (.) para valores decimais (por exemplo, 59.99). O uso de vírgulas para separar números grandes não é permitido e resultará num erro quando validar a sua fórmula.

• Inclua texto de string em aspas simples (') ou aspas duplas (").
• Só pode usar os seus campos de formulário como variáveis no construtor de fórmulas. O suplemento Cálculos não permite a declaração de variáveis que não sejam variáveis de campo.
• Adicionar um ponto e vírgula após cada linha no construtor de fórmulas é opcional. No entanto, se estiver a escrever declarações condicionais, a linha endif deve ter um ponto e vírgula.

Nas secções seguintes, explicaremos como funcionam as variáveis e mostraremos exemplos de operações suportadas no construtor de fórmulas.

Utilizar Variáveis de Campo

Uma vez ativado o modo de cálculo num campo suportado, pode usar outros campos no formulário como variáveis para criar a sua fórmula. Abaixo estão as regras a seguir ao usar variáveis de campo.

• Cada variável de campo começa com o símbolo $F, seguido pelo ID do campo. Assim, o nome completo da variável será $FX (onde X é o ID do campo).
• As variáveis de campo para subcampos são adicionadas usando a sintaxe $FX_subfield. Onde X é o ID do campo e subfield é o identificador do subcampo. Por exemplo, F1_first representa o subcampo do primeiro nome do campo Nome.
• Para aceder ao valor que os utilizadores selecionam num campo de pagamento, utilize o formato $FX_amount. Assim, se um campo de Item Único tiver um ID de 2, por exemplo, a variável do campo será $F2. Enquanto o valor do montante selecionado será $F2_amount.
• Os valores num campo de Caixas de Seleção ou Itens de Caixa de Seleção podem ser acedidos usando a sintaxe $FX_n. Onde X é o ID do campo e n é a opção da Caixa de Seleção. Isto significa essencialmente que a primeira opção num campo de Caixas de Seleção será $FX_1, a opção 2 será $FX_2, e assim por diante.

• Multiple Choice and Dropdown fields do not currently support targeting options using unique IDs. If you’d like to target the choice the user selected in an if statement, you’ll need to use an exact match to check the value in your condition. Here is an example:

  if ($FX == 'first choice'):
     // formula to execute
  endif;

Dicas a Considerar Antes de Criar Fórmulas

Antes de construir as suas fórmulas, há algumas dicas a ter em mente para o ajudar a acelerar o processo e a evitar erros. Abaixo explicamos as nossas principais recomendações:

• Certifique-se de que sabe a fórmula que pretende utilizar para o cálculo. Conhecer a fórmula antecipadamente permitir-lhe-á saber os campos a adicionar ao seu formulário.
• Utilize o campo Oculto se pretender armazenar o resultado de um cálculo numa variável de campo diferente. O suplemento Cálculos não suporta a utilização de variáveis personalizadas. Assim, se necessitar desta funcionalidade para a sua fórmula, considere utilizar o campo Oculto para armazenar os resultados dos seus cálculos.
• Ao concatenar uma string e um número no seu campo, sugerimos a utilização do campo de Texto de Linha Única ou Texto de Parágrafo.
• Se estiver a combinar uma string e um número, envolva a sua fórmula numa instrução if e defina a condição para mostrar apenas se o utilizador preencheu as variáveis de campo necessárias. Isto garante que o campo não tem um valor indefinido no frontend.

Criar Fórmulas Com Operadores Aritméticos

O suplemento Cálculos permite-lhe construir fórmulas básicas para realizar ações como adição, subtração, multiplicação e divisão.

Para este exemplo, vamos criar uma calculadora que realiza operações aritméticas quando recebe 2 números.

Comece por abrir o construtor de formulários e adicionar 2 campos de Números. Clique em cada campo e altere o Rótulo do campo para qualquer nome que desejar. Para este exemplo, utilizaremos Número 1 e Número 2 como Rótulo para ambos os campos.

Em seguida, vamos adicionar um Divisor de Secção e alterar o Rótulo para Operações Aritméticas. Abaixo disso, adicionaremos um campo de Layout e 4 campos de Número com os Rótulos Adição, Subtração, Multiplicação e Divisão.

Agora, selecione o campo Adição para abrir as Opções do Campo. Depois disso, navegue até o separador Avançadas.

Uma vez lá, ative a opção Ativar Cálculo para a posição ligada.

No construtor de fórmulas, escreveremos uma equação para somar o valor de ambos os campos de Número ($F1 + $F2).

Após adicionar a primeira fórmula, certifique-se de ativar os cálculos nos campos restantes e atualizar as fórmulas. A fórmula para cada campo deve ler:

• Adição: $F1 + $F2
• Subtração: $F1 - $F2
• Multiplicação: $F1 * $F2
• Divisão: $F1 / $F2

Assim que adicionar a fórmula para cada campo, guarde e pré-visualize o seu formulário para garantir que as equações funcionam como espera.

Criar Fórmulas Com Declarações Condicionais

As instruções if/else permitem-lhe construir fórmulas avançadas que só funcionarão se as condições especificadas forem cumpridas. Por defeito, a instrução if tem a seguinte sintaxe:

if(condition):
   // formula to calculate on true
else:
   // formula to calculate on false
endif;

Dentro dos parênteses após a instrução if, terá de especificar a(s) condição(ões) que pretende verificar. Depois, dentro do bloco if, escreva a equação que pretende executar se a condição for verdadeira.

O bloco else contém a equação que deve ser executada se a condição for falsa. Eis um exemplo de como provavelmente utilizaria esta instrução condicional.

if($FX_amount > 50):
   ($FX_amount * 5/100)
else:
   7
endif;

No exemplo acima, estamos a ativar o modo de cálculo num campo de Item Único e a verificar se o montante selecionado pelo utilizador é superior a 50. Se for verdadeiro, a taxa adicional é de 5% do montante do pagamento. Caso contrário, no bloco else, definimos a taxa para 7 para qualquer montante inferior a 50.

Se pretender adicionar múltiplas condições à sua equação, utilize a instrução elseif(). Eis uma versão atualizada da equação acima.

if ($FX_amount > 50 && $FX_amount <= 200): 
   $FX_amount * (5 / 100) 
elseif($FX_amount > 200):
   $FX_amount * (2.5 / 100)   
else:
   10
endif;

O suplemento Cálculos permite-lhe usar um número ilimitado de instruções elseif no construtor de fórmulas. No construtor de fórmulas, também pode aninhar instruções if dentro de uma instrução if. Eis um exemplo.

if ($FX_amount > 50 && $FX_amount <= 200): 
   if($FX == 'shipping'):
      $FX_amount * (5 / 100) 
   endif;
elseif($FX_amount > 200):
   $FX_amount * (2.5 / 100)   
else:
   10
endif;

Criar Fórmulas Com Operadores de Comparação

Os operadores de comparação permitem-lhe comparar uma variável de campo com um número, uma string ou o valor de outra variável de campo. É frequentemente usado para escrever as condições para instruções if. Eis um exemplo.

if ($FX < 25): 
    $FX * (10 / 100)
elseif($FX >= 25 && $FX < 150): 
    $FX * (5 / 100)
elseif($FX >= 150): 
    $FX * (3 / 100)
else: 
    10 
endif;

Na fórmula acima, estamos a usar operadores de comparação para escrever as condições para cada bloco de instrução if. A primeira condição que retornar verdadeira será executada.

Repare que utilizámos o operador E lógico (&&) numa das condições elseif. Os operadores lógicos permitem-lhe encadear 2 ou mais condições. Na secção seguinte, explicaremos como funcionam em detalhe.

Criar Fórmulas Com Operadores Lógicos

O suplemento Cálculos suporta a utilização de operadores lógicos como os operadores E e OU. Na folha de consulta, encontrará os operadores lógicos disponíveis e como são representados no construtor de fórmulas. Abaixo, destacámos os operadores lógicos que o suplemento Cálculos suporta.

• E (&&): A instrução retornará verdadeiro quando todas as condições forem verdadeiras.
• OU (||): A instrução retornará verdadeiro se alguma das condições individuais for verdadeira.
• NÃO (!): Também conhecido como negação. Converte um valor verdadeiro em falso e vice-versa.

Estes operadores podem ser utilizados em combinação com instruções condicionais. Permitem-lhe restringir a sua instrução condicional juntando 2 ou mais condições. Eis um caso de uso básico para estes operadores.

Calculadora de Notas Utilizando o Operador E

Para este exemplo, construiremos uma calculadora que retorna a nota do utilizador com base na sua pontuação. Para começar, adicione um campo de Números e um campo de Texto de Linha Única e altere os Rótulos dos campos para Pontuação e Nota, respetivamente.

Depois disso, ative o modo de cálculo no campo Nota e adicione a fórmula abaixo.

if ( $F3 >= 95 ):
    'A+'
elseif ( $F3 >= 90 && $F3 < 95 ):
    'A'
elseif ( $F3 >= 85 && $F3 < 90 ):
    'B+'
elseif ( $F3 >= 80 && $F3 < 85 ):
    'B'
elseif ( $F3 >= 75 &&  $F3 < 80 ):
    'C+'
elseif ( $F3 >= 70 &&  $F3 < 75 ):
    'C'
elseif ( $F3 >= 65 &&  $F3 < 70 ):
    'D+'
elseif ( $F3 >= 60 &&  $F3 < 65 ):
    'D'
elseif (  $F3 >=0 &&  $F3 < 60 ): 
    'F'
endif;

Se utilizar o operador &&, a condição será verdadeira se ambas as comparações retornarem como verdadeiras.

Calculadora de Custo por Clique

Para este exemplo, estamos a calcular o custo por clique para uma determinada campanha. Isto requer 2 variáveis de campo: Montante total cobrado e Número de cliques obtidos. Assim, precisará de adicionar 2 campos de Números e atualizar o Rótulo de cada campo para Montante total cobrado e Número de cliques, respetivamente.

Também precisaremos de adicionar um campo de Item Único para realizar o cálculo.

Depois de adicionar estes 3 campos, selecione o campo Item Único e altere o Rótulo para Custo por Clique (CPC). Em seguida, navegue para o separador Avançadas e ative o modo de cálculo. Depois disso, adicione a equação abaixo ao construtor de fórmulas.

if ( $F1 || $F2 ): 
     $F1 / $F2
else:
     0
endif;

Na condição, estamos a verificar se o utilizador introduziu um valor em algum dos campos. Assim que uma das condições for verdadeira, a equação na instrução if será executada.

Utilizar Funções Suportadas em Fórmulas de Cálculo

O suplemento Cálculos suporta inúmeras funções para realizar facilmente tarefas específicas. Existem funções matemáticas, funções de string, funções de data/hora e uma função de depuração. Na documentação da folha de consulta, verá uma lista de funções suportadas e como funcionam.

Funções Matemáticas

Existem funções para realizar operações matemáticas básicas e complexas. Estas funções ajudam a reduzir o número de equações que precisará na sua fórmula.

Por exemplo, em vez de escrever manualmente uma equação para encontrar a média entre 2 ou mais números, pode usar a função average() para calcular o valor médio de um determinado conjunto de números. Eis um exemplo de implementação.

average($F1, $F2, $F3)

No exemplo acima, estamos a calcular a média de 3 campos de Números. No entanto, pode adicionar um número ilimitado de campos à função average().

Assim que o utilizador introduzir um valor para cada campo de Números, o campo com cálculos ativados retornará a média destes números.

Outra função que provavelmente utilizará é a função round(). Esta função aceita 2 argumentos:

• Valor (variável de campo): O número que pretende arredondar. Este pode ser o resultado de um cálculo no seu formulário.
• Precisão: O nível de precisão indica o número de casas decimais que pretende utilizar. Introduzir 2 arredondaria o número para as 2 casas decimais mais próximas.

Pode usar outra função como parâmetro para a sua função. Por exemplo, podemos envolver a fórmula de média que usámos no exemplo acima com a função round e definir o nível de precisão para 2.

round(average($F1, $F2, $F3), 2)

Esta equação executará primeiro a média dos números. Depois disso, a função round() arredondará o resultado para as 2 casas decimais mais próximas.

Existem outras funções que pode usar ao construir as suas fórmulas. Algumas delas incluem potência de expoente (pow(base, exponent)), raiz quadrada (sqrt(value)), logaritmo (log(value)), gerador de números aleatórios (rand(min, max)), entre outras.

Sugerimos que reveja o guia de consulta rápida para ver se existe uma função para a fórmula que pretende construir.

Funções de String

Existem muitas funções que pode usar para realizar operações em strings no construtor de fórmulas. Uma das funções mais populares é a função concat(). Esta função permite combinar 2 ou mais strings ou números.

Dentro dos parênteses, adicionará as strings e os números que pretende combinar e separará cada um com uma vírgula. Eis um exemplo.

concat('Random generated number ', rand($F1, $F2))

No frontend, o campo gerará um número aleatório e concatenará a string e o resultado como o valor do campo.

Outra função útil é a função truncate(). Esta função aceita 2 parâmetros: O texto da string e o comprimento a truncar.

Se usar esta função, removerá o texto da string e retornará caracteres até ao número especificado como comprimento. Isto pode ser útil se quiser gerar automaticamente nomes de utilizador para os seus utilizadores com base no seu endereço de e-mail. Eis um exemplo.

Gerador de Nomes de Utilizador

No construtor de formulários, adicione um campo de E-mail e um campo de Texto de Linha Única. Depois disso, selecione o campo de Texto de Linha Única, altere o Rótulo para Nome de utilizador, e ative o cálculo para o campo.

Dentro do construtor de fórmulas, adicione a equação abaixo.

truncate($F1, 6)

$F1 na fórmula acima é o campo Email que será usado como o texto da string. 6 é o comprimento da string a ser retornada. Isto significa que a fórmula retornará os primeiros 6 caracteres do campo email.

Funções de Data/Hora

O complemento Cálculos fornece funções de data e hora para usar ao construir suas fórmulas. Estas funções têm vários casos de uso, como a criação de um relógio básico no seu site ou a criação de um calculador de idade.

Por exemplo, a função now() retorna a data e hora atuais cada vez que o utilizador abre o formulário no frontend do seu website.

A imagem acima mostra o formato padrão da função now(). No entanto, pode personalizar como a data é apresentada especificando um formato na função.

O formato de data no complemento Cálculos funciona da mesma forma que o do núcleo do WordPress. Abaixo listamos alguns formatos suportados.

Formato	Exemplo
d-m-y	19-10-23
j F, Y	19 de Outubro de 2023
d/m/Y	19/10/2023

Outra função útil é a função date_diff(). Esta função aceita 2 campos de data e retorna a diferença entre eles. Um terceiro argumento é necessário para especificar a unidade que gostaria de retornar. Abaixo estão as unidades disponíveis atualmente suportadas:

• Anos
• Meses
• Semanas
• Dias
• Horas
• Minutos
• Segundos

Vamos construir um calculador de idade usando a função date_diff().

Calculador de Idade Usando a Função de Data

Comece por adicionar um campo Data/Hora. Depois disso, altere o Formato para Data e atualize o Rótulo do campo para Data de Nascimento.

Em seguida, adicione 2 campos de Texto de Linha Única. Para o primeiro campo, altere o Rótulo para Data Atual e, em seguida, ative os cálculos para o campo.

No construtor de fórmulas, simplesmente adicione a função now(). Isto retornaria a data e hora atuais.

Para o segundo campo de Texto de Linha Única, atualize o Rótulo para Sua Idade e, em seguida, ative o modo de cálculo. No construtor de fórmulas, adicione a equação abaixo.

date_diff($F1, $F2, 'years')

Estamos a usar a função date_diff() para retornar a diferença entre o campo Data Atual e o campo Data de Nascimento.

No nosso exemplo, $F1 é o campo Data de Nascimento, enquanto $F2 é o campo Data Atual. O argumento 'anos' que adicionámos retornará a diferença de data em anos. Se usarmos 'meses' em vez disso, retornará a diferença de data em meses.

Quando guardar e pré-visualizar o seu formulário, poderá estimar a sua idade atual após introduzir a sua data de nascimento.

Se pretender calcular o intervalo de tempo entre 2 campos de Data/Hora, pode usar a função anos(). Aceita 2 argumentos (data de início e fim) e um parâmetro de formato opcional. Esta função retorna a diferença entre 2 datas em formato de anos, semelhante à função date_diff().

Também pode usar a função meses(), semanas(), ou dias() se pretender retornar a diferença de datas em meses, semanas ou dias, respetivamente. Certifique-se de rever o guia de consulta rápida para ver outras funções de data e hora.

Aceder a Valores de Data e Hora no Construtor de Fórmulas

Se estiver a construir uma fórmula que exija a segmentação dos valores individuais para os subcampos de data e hora num campo de Data/Hora, pode usar a sintaxe de subcampo.

Para aceder ao subcampo de data no construtor de fórmulas, use a sintaxe $FX_data. Certifique-se de substituir X pelo ID do campo. No nosso exemplo, este valor é 1.

Da mesma forma, use a sintaxe $FX_hora para aceder ao valor do subcampo de hora.

Perguntas Frequentes

Estas são as respostas a algumas das principais perguntas sobre a criação de fórmulas com o suplemento Cálculos.

Posso ativar o modo de depuração para cálculos a partir do menu Ferramentas do WPForms?

A função debug() gera dados de depuração no ficheiro debug.log no seu servidor. Isto pode ser útil ao resolver erros nas suas fórmulas. Atualmente, só pode usar esta função dentro do construtor de fórmulas. Quando adicionada ao construtor de fórmulas, registará quaisquer dados de depuração para o formulário específico no qual ativou o modo de cálculo.

É tudo! Agora sabe como criar fórmulas para os seus formulários de cálculos.

Em seguida, gostaria de criar um formulário de lead magnet para capturar leads no seu website? Veja o nosso guia para saber como instalar e usar o suplemento Formulários de Lead.