WHMCS

Tutorial de instalação e configuração do módulo Validação Cadastral no WHMCS.

Requisitos Mínimos

  • Versão do WHMCS: >= 7.x

  • Versão do PHP: >= 5.6

  • IonCube Loader: >= 10.x

Instalação

Extraindo seu módulo

Extraia a pasta "modules" que está dentro do arquivo "validacaocadastral.zip" para pasta raiz do seu WHMCS. Após extrair o seu módulo deverá ficar em /raizwhmcs/modules/addons/valida_cpfcnpj

Ativando seu módulo

Vá até WHMCS > Opções > Módulos Addon

Localize o módulo "Validação Cadastral" e em seguida clique em "Ativar"

Criando campos personalizados

Para este módulo você precisará criar 2 (dois) campos personalizados em seu WHMCS, para isso, siga as seguintes etapas:

Em seu WHMCS, navegue até Opções > Campos Personalizados

Em seguida crie os seguintes campos e clique em "Salvar Alterações"

Informação: Você poderá criar os nomes dos campos conforme seu gosto pessoal, não sendo obrigatório manter os mesmos nomes mencionados acima.

Configuração

Clique em "Configurações" e em seguida preencha os seguintes campos:

Preenchimento dos campos

Licença

Licença de validação do módulo (fornecido via e-mail após a compra).

Token API

Chave da API para consultas e validações de CPF e CNPJ (fornecido via e-mail após a compra).

Idade Mínima

Informe a idade mínima que deseja permitir cadastros em seu WHMCS.

Ao digitar a idade mínima, será aceito pelo sistema idades iguais ou maiores a informadas no campo. Ex: Ao preencher "18", o sistema entenderá cadastros de pessoas com 18 anos ou mais como válidos.

Campo Documento

Informe neste campo o ID do campo personalizado criado para "CPF/CNPJ". Para pegar o ID acesse sua página de cadastro (register.php), clique com o botão direito sob o campo "CPF/CNPJ" e em seguida clique em "Inspecionar" (Chrome) conforme imagem abaixo:

Verifique que ao clicar em "Inspecionar" abrirá a janela com o código HTML com as seguintes informações:

<input type="text" name="customfield[1]" id="customfield1" value="" size="30" class="form-control">

Neste código, procure pelo número que está entre colchetes após o nome "customfield". Em nosso exemplo acima, o campo personalizado tem o ID 1, preencha essa informação no campo de seu módulo.

Campo Data Nascimento

Informe neste campo o ID do campo personalizado para "Data de Nascimento". Para pegar o ID do campo, repita o mesmo processo informado do campo anterior.

Whatsapp para Alerta

Informe neste campo seu número de Whatsapp caso deseje receber notificações quando seu saldo estiver abaixo do número determinado no próximo campo.

O telefone deverá ser preenchido no seguinte formato: +Código do País DDD Telefone, exemplo: +55 11 94841-3923 Lista de códigos de países: https://bit.ly/3eLIw5S

Crédito Mínimo para Alerta

Informe neste campo com qual quantidade mínima de créditos você deseja receber um alerta via Whatsapp.

Controle de Acesso

Assinale as permissões desejadas do seu WHMCS para acessar a página de informações financeiras e de consulta do módulo (dashboard).

Acessando a Dashboard

Após ativar e configurar seu módulo, você poderá acompanhar todas as consultas realizadas através do seu "Token API" em tempo real, para isso navegue até Addons > Validação Cadastral

Após acessar a página, você terá todas informações necessárias como por exemplo: Saldo disponível, saldo gasto, total de erros, uso total (gastos + erros)

Solução de Problemas

Caso o módulo não funcione, navegue até WHMCS > Opções > Configurações Gerais > Outros. Localize a opção "Encoded File Loading" e marque a opçao "Attempt to load all files". Salve as alterações e teste novamente seu módulo.