Atenção!

Este artigo contém código PHP e destina-se a programadores. Oferecemos este código como cortesia, mas não prestamos suporte para personalizações de código ou desenvolvimento de terceiros.

Para orientação adicional, consulte o tutorial da WPBeginner sobre como adicionar código personalizado.

Ignorar

Como Incrementar uma Contagem em Cada Submissão de Formulário

Pretende incrementar uma contagem em cada submissão de formulário? Com um simples trecho de código, pode adicionar um contador de auto-incremento dentro de um campo Oculto que aumenta com cada nova entrada. Esta funcionalidade é particularmente útil para rastrear submissões sequencialmente ou criar números de referência únicos.

Este guia mostrar-lhe-á como configurar um contador incremental que aumenta com cada nova entrada.


Configuração do Formulário

Para começar, abra o construtor de formulários criando um novo formulário ou editando um existente.

Em seguida, para que o contador funcione, terá de adicionar um campo Oculto – pode encontrá-lo na secção Campos Elaborados. Os seus utilizadores não verão este campo no formulário, mas ele armazenará o valor do nosso contador nos bastidores.

Adicionar campo oculto

Tome nota do ID do campo Oculto, pois precisará dele ao adicionar o trecho de código. Se precisar de ajuda para encontrar este ou o ID do formulário, consulte o nosso guia sobre como encontrar IDs de formulários e campos.

ID do campo oculto

Adicionar o Excerto de Código

O seguinte trecho de código contará as suas entradas de formulário e atribuirá um número incremental a cada nova submissão.

O trecho funciona verificando primeiro se o formulário submetido corresponde ao ID do seu formulário especificado. Quando encontra uma correspondência, conta todas as entradas existentes para esse formulário e adiciona 1 para criar o número da nova entrada.

Este número é então preenchido com zeros à esquerda e armazenado no seu campo Oculto. O processo ocorre automaticamente cada vez que alguém submete o seu formulário.

Personalizar o Contador

Terá de personalizar três valores chave no trecho de código para o seu formulário específico:

  1. Na linha 9, terá de alterar 1000 para o ID do seu próprio formulário.
  2. Na linha 16, substitua 15 para corresponder ao ID do seu Campo Oculto.
  3. Na linha 19, verá 3 que define quantos dígitos aparecem nos seus números. O código adiciona zeros no início para tornar todos os números do mesmo comprimento. Por exemplo, com 3 dígitos, os seus números ficariam assim: 001, 002, 003, e assim por diante.

Testar o seu Contador

Depois de adicionar e personalizar o trecho de código, é hora de garantir que tudo funciona corretamente. Submeta uma entrada de teste através do seu formulário e verifique a entrada em WPForms » Entradas. Deverá ver o seu número incremental armazenado no campo Oculto. Submeta outra entrada de teste para confirmar que o número aumenta como esperado.

Nota: Se pretender exibir este número nas suas notificações por e-mail ou mensagens de confirmação, basta adicionar {field_id="15"} a qualquer mensagem nas definições de Notificações ou Confirmações do seu formulário (substitua 15 pelo ID real do seu campo Oculto).

Perguntas Frequentes

P: Posso atribuir um prefixo a este número?

R: Absolutamente! Aqui está um exemplo de como adicionar algumas letras antes da contagem. Vamos adicionar order- antes da nossa contagem. Pode fazer isto modificando a linha 23 no trecho de código.

$fields[$my_field_id]['value'] = 'ORDER-' . zeroise($new_total_entries, $min_digits);

Isto será exibido como ORDER-001, ORDER002, e assim por diante. Pode alterar 'ORDER' para qualquer prefixo que desejar, como 'REF', 'Ticket', ou o que melhor se adequar às suas necessidades.

É tudo! Agora tem um formulário que atribui automaticamente um número incremental a cada novo envio.

Gostaria de atribuir um número de ID exclusivo a cada envio de formulário? Consulte o nosso guia sobre criação de IDs exclusivos para entradas de formulário.

Filtro de Referência

wpforms_process_filter