Plugin JetMask Brasil WordPress

Descrição

# JetMask Brasil – Plugin WordPress

## Descrição
JetMask Brasil é um plugin WordPress desenvolvido especialmente para formulários JetFormBuilder, adicionando máscaras e validações para campos comuns no Brasil, como CPF, CNPJ, CEP e telefone. O plugin também oferece funcionalidade de autopreenchimento para endereços via CEP e dados empresariais via CNPJ.

## Características Principais

### 1. Máscaras de Input
– CPF: `000.000.000-00`
– CNPJ: `00.000.000/0000-00`
– CEP: `00000-000`
– Telefone: `(00) 0000-0000` ou `(00) 00000-0000`
– Data: `00/00/0000`

### 2. Validações
– **CPF**: Validação completa do algoritmo
– **CNPJ**: Validação completa do algoritmo
– **Email**: Validação de formato
– **Telefone**: Validação de formato (fixo ou celular)
– Verificação de números repetidos

### 3. Consultas Automáticas
– **CEP**: Consulta automática via ViaCEP
– Preenchimento automático de endereço
– Cache local para consultas repetidas
– Timeout de 5 segundos
– Tratamento de erros

– **CNPJ**: Consulta automática via ReceitaWS
– Preenchimento automático dos dados da empresa
– Cache local para consultas repetidas
– Timeout de 5 segundos
– Tratamento de erros

### 4. Feedback Visual
– Campos válidos: borda verde com ícone de check
– Campos inválidos: borda vermelha com ícone X
– Indicador de carregamento durante consultas
– Mensagens de erro claras e amigáveis

## Requisitos
– WordPress 5.0 ou superior
– JetFormBuilder instalado e ativo
– jQuery (incluído no WordPress)

## Instalação
1. Faça o upload da pasta `mask-form-elemjet` para o diretório `/wp-content/plugins/`
2. Ative o plugin através do menu ‘Plugins’ no WordPress
3. Configure os campos no JetFormBuilder normalmente

## Uso

### Configuração de Campos no JetFormBuilder

#### Campo CEP
1. Adicione um campo de texto
2. Defina a classe CSS: `cep-field`
3. Defina o ID do campo para consulta

#### Campos de Endereço (para autopreenchimento via CEP)
1. Adicione campos de texto para:
– Logradouro (rua)
– Bairro
– Cidade
– Estado
2. Configure os IDs correspondentes

#### Campo CNPJ
1. Adicione um campo de texto
2. Defina a classe CSS: `cnpj-field`
3. Defina o ID do campo para consulta

#### Campos Empresa (para autopreenchimento via CNPJ)
1. Adicione campos de texto para:
– Razão Social
– Nome Fantasia
– Atividade Principal
– Situação
– Data de Abertura
– Endereço
– Telefone
– Email
2. Configure os IDs correspondentes

### Classes CSS Disponíveis
– `cpf-field`: Máscara e validação de CPF
– `cnpj-field`: Máscara e validação de CNPJ
– `cep-field`: Máscara e consulta de CEP
– `phone-field`: Máscara de telefone
– `date-field`: Máscara de data

### Estados Visuais
– `.jetmask-valid`: Campo com valor válido
– `.jetmask-invalid`: Campo com valor inválido
– `.jetmask-loading`: Campo em processo de consulta

## Funcionalidades Técnicas

### Cache Local
– Armazena resultados de consultas CNPJ e CEP
– Evita requisições repetidas
– Melhora a performance do formulário
– Cache é limpo ao recarregar a página

### Tratamento de Erros
– Timeout após 5 segundos
– Mensagens de erro específicas
– Limpeza automática de campos em caso de erro
– Log de erros no console para debug

### Validações em Tempo Real
– Feedback imediato ao usuário
– Previne envio de dados inválidos
– Validação completa de algoritmos (CPF/CNPJ)
– Verificação de formatos (email/telefone)

## Suporte e Compatibilidade
– Compatível com temas WordPress modernos
– Funciona com JetFormBuilder
– Suporte a navegadores modernos
– Responsivo e adaptável

## Limitações Conhecidas
– Consulta de CNPJ limitada pela API ReceitaWS
– Necessário conexão com internet para consultas
– Cache local é limpo ao recarregar a página

## Segurança
– Sanitização de inputs
– Validação de dados no lado do cliente
– Uso de JSONP para consultas seguras
– Sem armazenamento de dados sensíveis

## Suporte
Para suporte ou relatar problemas, entre em contato através do GitHub ou WordPress.org.

## Licença
Este plugin é licenciado sob a GPL v2 ou posterior.

—

**Nota**: Este plugin utiliza serviços de terceiros (ViaCEP e ReceitaWS) para consultas. A disponibilidade e precisão dos dados dependem destes serviços.