Criação de fórmulas com o complemento Calculations

Gostaria de aprender a criar fórmulas para realizar operações básicas e avançadas em seus formulários do WordPress? Com o complemento Calculations, você poderá converter seus formulários em calculadoras para resolver problemas específicos do usuário.

Este tutorial explicará como criar fórmulas, abordando todas as regras, operações e funções no guia da planilha de cálculos do complemento Calculations.

---

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

Acesso à documentação da folha de dicas

Depois de instalar o complemento Calculations, crie um novo formulário ou edite um já existente para acessar o construtor de formulários.

No construtor de formulários, você precisará adicionar um dos campos compatíveis para poder ativar o modo de cálculo no campo do formulário.

Depois de adicionar um campo compatível, clique nele para abrir o painel Field Options (Opções de campo). Em seguida, navegue até a guia Advanced (Avançado ). Lá, você verá o botão Ativar cálculo.

A ativação dessa opção abrirá o construtor de fórmulas. Aqui, você pode criar fórmulas e realizar cálculos usando outros valores de campo como variáveis.

Você pode acessar a documentação da planilha de cálculos do complemento clicando no link Planilha de cálculos acima do construtor de fórmulas.

Como alternativa, você pode acessar essa página usando este link. O guia de folha de dicas contém as várias regras, operadores e funções atualmente compatíveis com o complemento Calculations.

Entendendo as regras e os operadores do addon Calculations

Da mesma forma que as linguagens de programação têm regras e sintaxe, o criador de fórmulas também tem seu próprio conjunto de regras. A adesão a essas regras garante que suas fórmulas funcionem como pretendido. A seguir, explicamos as mais importantes a serem seguidas.

• Ao adicionar números, você 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 retornará um erro quando você validar a fórmula.

• Coloque o texto da cadeia de caracteres entre aspas simples (') ou aspas duplas (").
• Você só pode usar seus campos de formulário como variáveis no criador de fórmulas. O complemento Calculations não permite a declaração de variáveis que não sejam variáveis de campo.
• A adição de um ponto e vírgula após cada linha no construtor de fórmulas é opcional. No entanto, se estiver escrevendo instruções condicionais, o endif deve ter um ponto e vírgula.

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

Uso de variáveis de campo

Quando o modo de cálculo estiver ativado em um campo compatível, você poderá usar outros campos do formulário como variáveis para criar sua fórmula. Abaixo estão as regras a serem seguidas ao usar variáveis de campo.

• Cada variável de campo começa com $F seguido do ID do campo. Portanto, o nome completo da variável será $FX (onde X é a ID do campo).
• As variáveis de campo para subcampos são adicionadas usando a sintaxe $FX_subfield. Onde X é a ID do campo e subfield é o identificador do subcampo. Por exemplo, F1_first representa o subcampo do primeiro nome do campo Name.
• Para acessar o valor que os usuários selecionam em um campo de pagamento, use a opção $FX_amount formato. Portanto, se um campo Single Item tiver um ID de 2, por exemplo, a variável de campo será $F2. Enquanto o valor selecionado será $F2_amount.
• Os valores em um campo Checkboxes ou Checkbox Items podem ser acessados usando o $FX_n sintaxe. Onde X é o ID do campo e n é a opção Checkbox. Isso significa essencialmente que a primeira opção em um campo Checkboxes será $FX_1, a opção 2 será $FX_2e assim por diante.

• Múltipla escolha e Menu suspenso Atualmente, os campos if não suportam opções de direcionamento usando IDs exclusivos. Se quiser direcionar a opção que o usuário selecionou em uma instrução if, será necessário usar uma correspondência exata para verificar o valor na condição. Aqui está um exemplo:

  if ($FX == 'first choice'):
     // fórmula a ser executada
  endif;

Dicas a serem consideradas antes de criar fórmulas

Antes de criar suas fórmulas, há algumas dicas que você deve ter em mente para ajudá-lo a acelerar o processo e evitar erros. A seguir, explicamos nossas principais recomendações:

• Certifique-se de que você conhece a fórmula que deseja usar para o cálculo. O conhecimento prévio da fórmula permitirá que você saiba os campos a serem adicionados ao formulário.
• Use o campo Hidden se quiser armazenar o resultado de um cálculo em outra variável de campo. O complemento Calculations não oferece suporte ao uso de variáveis personalizadas. Portanto, se você precisar dessa funcionalidade para sua fórmula, considere usar o campo Hidden para armazenar os resultados do cálculo.
• Ao concatenar uma cadeia de caracteres e um número em seu campo, sugerimos usar o campo Texto de linha única ou Texto de parágrafo.
• Se estiver combinando uma cadeia de caracteres e um número, coloque a fórmula em uma instrução if e defina a condição para ser exibida somente se o usuário tiver preenchido as variáveis do campo obrigatório. Isso garante que o campo não tenha um valor indefinido no frontend.

Criação de fórmulas com operadores aritméticos

O complemento Calculations permite que você crie fórmulas básicas para executar ações como adição, subtração, multiplicação e divisão.

Para este exemplo, criaremos uma calculadora que realiza operações aritméticas quando são fornecidos 2 números.

Comece abrindo o construtor de formulários e adicionando 2 campos Números. Clique em cada campo e altere o Rótulo do campo para o nome que desejar. Para este exemplo, usaremos Número 1 e Número 2 como rótulo para os dois campos.

Em seguida, vamos adicionar um Divisor de seção e alterar o Rótulo para Operações aritméticas. Abaixo disso, adicionaremos um campo Layout e 4 campos Numbers com os rótulos Addition (Adição), Subtraction (Subtração), Multiplication (Multiplicação) e Division (Divisão).

Agora, selecione o campo Addition (Adição ) para abrir suas Field Options (Opções de campo). Depois disso, navegue até a guia Advanced (Avançado ).

Uma vez lá, alterne a opção Enable Calculation (Ativar cálculo ) para a posição ativada.

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

Depois de 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 ser a seguinte:

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

Depois de adicionar a fórmula para cada campo, salve e visualize o formulário para garantir que as equações funcionem conforme o esperado.

Fórmulas de construção com instruções condicionais

As instruções if/else permitem que você crie fórmulas avançadas que só funcionarão se as condições especificadas forem atendidas. Por padrão, a instrução if tem a seguinte sintaxe:

if(condição):
   // fórmula para calcular se for verdadeira
else:
   // fórmula para calcular em falso
endif;

Dentro do parêntese após a instrução if, você precisará especificar a(s) condição(ões) que deseja verificar. Em seguida, no bloco if, escreva a equação que você deseja 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. Aqui está um exemplo de como você provavelmente usaria essa instrução condicional.

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

No exemplo acima, estamos ativando o modo de cálculo em um campo Single Item e verificando se o valor selecionado pelo usuário é maior que 50. Se for verdadeiro, a cobrança adicional será de 5% do valor do pagamento. Caso contrário, no bloco else, definimos a cobrança como 7 para qualquer valor inferior a 50.

Se você quiser adicionar várias condições à sua equação, use a opção elseif() declaração. Aqui está 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 complemento Calculations permite que você use um número ilimitado de elseif no criador de fórmulas. No criador de fórmulas, você também pode aninhar instruções if dentro de uma instrução if. Aqui está 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;

Criação de fórmulas com operadores de comparação

Os operadores de comparação permitem que você compare uma variável de campo com um número, uma cadeia de caracteres ou o valor de outra variável de campo. Geralmente são usados para escrever as condições das instruções if. Aqui está 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 usando operadores de comparação para escrever as condições de cada bloco de instrução if. A primeira condição que retornar verdadeiro será executada.

Observe que usamos o operador lógico AND (&&) em um dos operadores elseif condicional. Os operadores lógicos permitem que você encadeie duas ou mais condições. Na próxima seção, explicaremos em detalhes como eles funcionam.

Fórmulas de construção com operadores lógicos

O complemento Calculations suporta o uso de operadores lógicos, como os operadores AND e OR. Na folha de dicas, você encontrará os operadores lógicos disponíveis e como eles são representados no construtor de fórmulas. Abaixo, destacamos os operadores lógicos que o complemento Cálculos suporta.

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

Esses operadores podem ser usados em combinação com declarações condicionais. Eles permitem que você restrinja sua declaração condicional unindo duas ou mais condições. Este é um caso de uso básico para esses operadores.

Calculadora de notas usando o operador AND

Para este exemplo, criaremos uma calculadora que retorna a nota do usuário com base em sua pontuação. Para começar, adicione um campo Numbers (Números) e um campo Single Line Text (Texto de linha única) e altere os rótulos dos campos para Score (Pontuação ) e Grade Point (Nota), respectivamente.

Depois disso, ative o modo de cálculo no campo Grade Point 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 você usar o && a condição será verdadeira se ambas as comparações retornarem como verdadeiras.

Calculadora de custo por clique

Para este exemplo, estamos calculando o custo por clique de uma determinada campanha. Isso requer duas variáveis de campo: Valor total cobrado e Número de cliques obtidos. Portanto, você precisará adicionar dois campos Numbers (Números) e atualizar o Label (Rótulo) de cada campo para Total amount charged (Valor total cobrado ) e Number of clicks (Número de cliques ), respectivamente.

Também precisaremos adicionar um campo Single Item para realizar o cálculo.

Depois de adicionar esses três campos, selecione o campo Item único e altere o rótulo para Custo por clique (CPC). Em seguida, navegue até a guia Advanced (Avançado ) e ative o modo de cálculo. Depois disso, adicione a equação abaixo ao criador de fórmulas.

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

Na condição, estamos verificando se o usuário inseriu um valor em qualquer um dos campos. Quando uma das condições for verdadeira, a equação na instrução if será executada.

Uso de funções suportadas em fórmulas de cálculo

O add-on Calculations oferece suporte a várias funções para executar facilmente tarefas específicas. Há funções matemáticas, funções de cadeia de caracteres, funções de data/hora e uma função de depuração. Na documentação da folha de dicas, você verá uma lista das funções compatíveis e como elas funcionam.

Funções matemáticas

Há funções para realizar operações matemáticas básicas e complexas. Essas funções ajudam a reduzir o número de equações necessárias em sua fórmula.

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

média($F1, $F2, $F3)

No exemplo acima, estamos calculando a média de 3 campos Numbers. No entanto, você pode adicionar um número ilimitado de campos ao campo average() função.

Quando o usuário inserir um valor para cada campo Numbers (Números), o campo com os cálculos ativados retornará a média desses números.

Outra função que você provavelmente usará é a função round() função. Essa função recebe 2 argumentos:

• Valor (variável de campo): O número que você deseja arredondar. Esse pode ser o resultado de um cálculo em seu formulário.
• Precisão: O nível de precisão indica o número de casas decimais que você deseja usar. Se você digitar 2, o número será arredondado para as duas casas decimais mais próximas.

Você pode usar outra função como parâmetro da sua função. Por exemplo, podemos envolver a fórmula da média que usamos no exemplo acima com a função round e definir o nível de precisão como 2.

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

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

Há outras funções que você pode usar ao criar 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 outros.

Sugerimos que você analise o guia da planilha para ver se há uma função para a fórmula que você pretende criar.

Funções de cadeia de caracteres

Há muitas funções que você pode usar para realizar operações em cadeias de caracteres no construtor de fórmulas. Uma das funções mais populares é a função concat() função. Essa função permite combinar duas ou mais cadeias de caracteres ou números.

Entre parênteses, você adicionará as cadeias de caracteres e os números que deseja combinar e separará cada um deles com uma vírgula. Aqui está um exemplo.

concat('Número gerado aleatoriamente ', rand($F1, $F2))

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

Outra função útil é a truncate() função. Essa função aceita 2 parâmetros: O texto da cadeia de caracteres e o comprimento a ser truncado.

Se você usar essa função, ela removerá o texto da cadeia de caracteres e retornará caracteres até o número que você especificou como comprimento. Isso pode ser útil se você quiser gerar automaticamente nomes de usuário para seus usuários com base no endereço de e-mail deles. Aqui está um exemplo.

Gerador de nome de usuário

No construtor de formulários, adicione um campo Email e um campo Single Line Text. Depois disso, selecione o campo Texto de linha única, altere o Rótulo para Nome de usuário e ative o cálculo para o campo.

No criador de fórmulas, adicione a equação abaixo.

truncar($F1, 6)

$F1 na fórmula acima é o campo Email que será usado como texto da cadeia de caracteres. 6 é o comprimento da cadeia a ser retornada. Isso significa que a fórmula retornará os primeiros 6 caracteres do campo de e-mail.

Funções de data/hora

O complemento Calculations fornece funções de data e hora para serem usadas ao criar suas fórmulas. Essas funções têm vários casos de uso, como a criação de um relógio básico em seu site ou a criação de uma calculadora de idade.

Por exemplo, o now() retorna a data e a hora atuais sempre que o usuário abre o formulário no frontend do seu site.

A imagem acima mostra o formato padrão do now() função. No entanto, você pode personalizar a forma como a data é mostrada especificando um formato na função.

O formato de data no complemento Calculations funciona da mesma forma que no núcleo do WordPress. Abaixo, listamos alguns formatos compatíveis.

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

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

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

Vamos criar uma calculadora de idade usando o date_diff() função.

Calculadora de idade usando a função de data

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

Em seguida, adicione dois campos de texto de linha única. Para o primeiro campo, altere o rótulo para Current Date e, em seguida, ative os cálculos para o campo.

No criador de fórmulas, basta adicionar o now() função. Isso retornaria a data e a hora atuais.

Para o segundo campo de texto de linha única, atualize o rótulo para Your Age (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 usando o date_diff() para retornar a diferença entre os valores de Data atual e o campo Data de nascimento campo.

Em nosso exemplo, $F1 é o campo Date of Birth, enquanto $F2 é o campo Data atual. O campo 'years' que adicionamos retornará a diferença de data em anos. Se usarmos 'months' em vez disso, ele retornará a diferença de data em meses.

Ao salvar e visualizar o formulário, você poderá estimar sua idade atual depois de inserir sua data de nascimento.

Se quiser calcular o intervalo de tempo entre dois campos de data/hora, você pode usar a função years() função. Ela aceita 2 argumentos (data inicial e final) e um parâmetro de formato opcional. Essa função retorna a diferença entre duas datas em anos, em um formato semelhante ao da função date_diff() função.

Você também pode usar o months(), weeks()ou days() se você quiser retornar a diferença de data em meses, semanas ou dias, respectivamente. Não deixe de revisar a seção guia de folha de dicas para ver outras funções de data e hora.

Acesso a valores de data e hora no Formula Builder

Se estiver criando uma fórmula que exija o direcionamento dos valores individuais dos subcampos de data e hora em um campo Data/Hora, você poderá usar a sintaxe de subcampo.

Para acessar o subcampo de data no construtor de fórmulas, use a sintaxe $FX_date. Certifique-se de substituir X com o ID do campo. Em nosso exemplo, esse valor é 1.

Da mesma forma, use o $FX_time para acessar o valor do subcampo de tempo.

Perguntas frequentes

Estas são as respostas para algumas das principais perguntas sobre a criação de fórmulas com o complemento Calculations.

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

O debug() gera dados de depuração para o arquivo debug.log em seu servidor. Isso pode ser útil ao solucionar erros em suas fórmulas. Atualmente, você só pode usar essa função no construtor de fórmulas. Quando adicionada ao criador de fórmulas, ela registrará todos os dados de depuração do formulário específico no qual o modo de cálculo foi ativado.

É isso aí! Agora você sabe como criar fórmulas para seus formulários de cálculo.

Em seguida, você gostaria de criar um formulário de ímã de leads para capturar leads em seu site? Consulte nosso guia para saber como instalar e usar o complemento Lead Forms.