Documentação do MevvForms

Formulários acessíveis, entradas locais e uma migração reversível.

O MevvForms é dono do esquema do formulário, da validação no servidor, da renderização acessível, das entradas locais e de uma fila de notificações durável. Este guia documenta a versão principal em funcionamento e o caminho medido para substituir um formulário existente do WPForms sem apagar os dados de origem dele.

Visão geral e requisitos

O MevvForms Free é o runtime local. Um formulário publicado é lido de um registro de formulário do WordPress versionado, renderizado com rótulos reais e relações de erro, validado outra vez no servidor, armazenado localmente e entregue a uma fila de notificações durável.

WordPress
6.6 ou superior; testado até o WordPress 7.1.
PHP
8.1 ou superior; a matriz de releases cobre PHP 8.1–8.5.
Fronteira dos dados
As definições de formulário, as entradas e os trabalhos na fila permanecem no site WordPress por padrão.
Arquivos de tradução
Estão incluídos catálogos PO editáveis, MO compilados e POT para turco e inglês.

O Free não faz nenhuma requisição de licença, telemetria, IA ou atualização a um serviço externo enquanto um visitante renderiza ou envia um formulário.

Instalação

  1. Faça um backup restaurável do banco de dados e de wp-content.
  2. Envie e ative o ZIP do MevvForms Free.
  3. Confirme que as tabelas de banco de dados do MevvForms foram criadas e que um administrador consegue abrir o painel.
  4. Mantenha o plugin de formulários de origem ativo até que a prévia da migração, a importação e as verificações de integridade estejam concluídas.
  5. Instale o complemento Pro correspondente apenas quando o formulário salvo usar um módulo Pro já lançado.

Não remova o pacote Free enquanto o Pro estiver instalado. O runtime do formulário salvo pertence ao Free; o Pro o estende.

Renderizar e enviar um formulário

Insira um formulário publicado com [mevvforms id="123"]. O renderizador imprime identificadores de campo estáveis, rótulos reais, descrições, um alvo de resumo de erros e uma sessão assinada vinculada à revisão atual do formulário.

  • O estado de obrigatoriedade e as regras de validação vêm do esquema que pertence ao servidor.
  • Valores ocultos ou desconhecidos do cliente não podem afrouxar as regras do servidor.
  • Um envio válido cria a entrada antes de qualquer efeito colateral de notificação ser executado.
  • A resposta contém a mensagem configurada ou o redirecionamento seguro, nunca os valores de campo armazenados.

Se um formulário mudou depois de a página ter sido aberta, atualize a página antes de enviar para que a sessão assinada corresponda à revisão atual.

Migração reversível do WPForms

A migração começa somente em leitura. A prévia lista os campos mapeados, as notificações, as confirmações, as inserções e as configurações não suportadas. Aplicar cria ou atualiza um formulário preparado do MevvForms e registra o hash de origem. Ela não apaga dados, revisões, tabelas nem conteúdo de páginas do WPForms.

  1. Exija uma prévia exata antes de aplicar.
  2. Importe o formulário como preparado e compare de novo os hashes de origem.
  3. Execute a barreira de integridade da transição: publicar, renderizar, envio de teste assinado, entrada local e notificação na fila.
  4. Somente depois que essas verificações passarem o plugin de origem pode ser desligado.
  5. Se alguma verificação falhar, a reversão restaura a lista anterior de plugins ativos e devolve o formulário importado a rascunho.

O inventário medido do mevvshop.com é um formulário de origem com 4 campos, 1 notificação, 1 confirmação e uma inserção ao vivo. Esses números são uma barreira de release para aquele site, não uma promessa sobre todo formulário do WPForms.

Entradas e fronteira de privacidade

As entradas e as projeções tipadas dos campos são armazenadas em tabelas locais dedicadas. Senhas, dados de cartão, CVV, nonces do WordPress, tokens de sessão e campos marcados com store=false nunca são gravados nos valores da entrada.

  • Os endereços IP são representados apenas por um HMAC específico do site onde a limitação de frequência precisa disso.
  • As projeções de texto, numéricas e de data permitem buscas posteriores sem mudar a identidade original do campo.
  • Uma gravação malsucedida da entrada ou da caixa de saída reverte por completo a transação do envio.
  • A evidência de produção registra apenas os identificadores de formulário, entrada e trabalho; ela nunca registra os valores enviados.

Notificações e confirmações

As notificações são trabalhos duráveis. Uma queda do e-mail não pode apagar uma entrada aceita: falhas transitórias são repetidas com esperas limitadas, enquanto erros permanentes de configuração param à espera da ação de um administrador.

Cabeçalhos
Os destinatários e as tags de mesclagem dos cabeçalhos são validados; a injeção de CR/LF é removida.
Corpo
O HTML é escapado ou filtrado conforme o seu contexto de saída.
Confirmação
As decisões de mensagem, página do mesmo site e redirecionamento permitido são escolhidas no esquema salvo.
Idempotência
A mesma chave de trabalho de notificação não pode criar o mesmo efeito colateral duas vezes.

A fronteira entre Free e Pro

O Free é dono do runtime confiável: esquema, campos básicos, renderização acessível, validação no servidor, entradas locais, notificações pela caixa de saída, confirmações, administração bilíngue e migração reversível do WPForms.

O Pro é o complemento para os módulos avançados já lançados. Fluxos condicionais, ferramentas de conversão em várias etapas, documentos, comércio, integrações, análises e superfícies para desenvolvedores só são habilitados à medida que suas barreiras de release se fecham. A configuração Pro salva deve continuar renderizando e enviando enquanto o código Pro instalado continuar disponível, mesmo que a licença dele expire depois.

Um item do roteiro não é anunciado como um recurso já funcional. Confira a versão instalada e as notas de versão antes de desenhar um formulário em torno de um módulo Pro.

Solução de problemas e reversão

O shortcode antigo aparece em branco
Confirme que o ID de origem tem um mapeamento de migração ativo e que nenhum outro plugin é dono do shortcode wpforms.
O envio informa uma sessão expirada
Recarregue a página e envie contra a última revisão publicada.
Uma notificação está aguardando
Abra o status da fila, corrija o erro permanente de configuração ou permita a nova tentativa agendada para um erro de transporte transitório.
A transição não desativou o WPForms
Leia o resultado de integridade. A barreira de segurança manteve ou restaurou o WPForms porque a verificação de renderização, envio, entrada ou trabalho falhou.

Para o suporte, informe as versões do plugin, do WordPress e do PHP, além do código de erro seguro. Remova os valores dos campos, os dados de clientes, os tokens de sessão, os nonces e as chaves de licença antes de enviar os logs.