Código de Identificação – PIN

Hoje em dia a utilização de um código de identificação (chamarei de PIN para simplificar) para fins de validação/ativação de recursos é bastante comum seja em webmail, internet banking e etc… Algumas empresas de hospedagem utilizam esse PIN seja no atendimento online (chat) ou telefone, pensando nisso resolvi implementar no WHMCS. A príncipio utilizei uma programação em PHP mas otimizei o código para utilização via Smarty o que a meu ver gerou um excelente resultado! Uma explicação rápida, o PIN será gerado apartir do ID do cliente por ser um código único para cada cliente, em seguida iremos gerar um MD5 e efetuar algumas personalizações para exibir o PIN ao cliente/admin.

É possível gerar o PIN com N resultados, mas vou estabelecer 2 padrões: por data (diário, mensal ou anual) ou PIN único ( será sempre o mesmo código e nunca será alterado ).

Iremos inserir o código em 2 lugares ( no admin e no painel cliente )… detalhe você precisa saber qual theme/tema esta utilizando. No exemplo abaixo  a cada mês (%m) será gerado um novo PIN com 6 dígitos dígitos!

– Admin WHMCS

Estou utilizando o Blend que fica localizado em /meuadmin/templates/blend/ editarei o arquivo clientssummary.tpl procure a linha 37  e insira:

[code lang=”html”]
<div class="clientssummarybox">
<div class="title">PIN</div>
{assign var=’pin’ value=$smarty.now|date_format:"%m"|cat:$clientsdetails.userid}
<center>
<h1><b>
{$pin|md5|regex_replace:"/[^0-9]/":""|truncate:6:""}
</b></h1>
</center></div>
[/code]

– Cliente WHMCS

Já para o cliente, utilizei o Default que está localizado em /meuwhmcs/templates/default/ editamos o clientareahome.tpl e apartir da linha 37  inserimos o código:

[code lang=”php”]
<div class="alert alert-info">
Código PIN:{assign var=’pin’ value=$smarty.now|date_format:"%m"|cat:$clientsdetails.userid}<b>
{$pin|md5|regex_replace:"/[^0-9]/":""|truncate:6:""}
</b></div>
[/code]

Confira o resultado final ( lado esquerdo admin / direito painel do cliente )

Algumas Personalizações:

Como altero a quantidade de dígitos: Altere o truncate de 6 para quantidade que desejar.

Alterar o período de geração do PIN: Diário vá em date_format e substitua o atributo %m para %d ou para anual altere para %Y

PIN Único: Remova o atributo $smarty.now|date_format:”%m”|cat:

Gostaria que o PIN fosse alfa-númerico: Remova o atributo regex_replace:”/[^0-9]/”:””|

Poderia enviar o PIN no e-mail de boas vindas ( Client Signup Email ): Sim, edite o template Client Singnup Email e insira:

[code lang=”php”]
<br>PIN:&nbsp;{assign var=’pin’ value=$smarty.now|date_format:"%m"|cat:$client_id}
{$pin|md5|regex_replace:"/[^0-9]/":""|truncate:6:""}
[/code]

Observação: Se você estiver utilizando o PIN por data, lembre-se que a cada mês o PIN é alterado automaticamente. Essa opção seria interessante para quem utiliza o PIN único ou coloque uma observação informando ao cliente que o PIN é válido mensalmente!

É possível visualizar o PIN no ticket via ADMIN? Sim, o código é diferente! Edite o arquivo viewticket.tpl  localizado em /meuadmin/templates/blend/ e altere a linha 188 para:

[code lang=”php”]
{assign var=’pin’ value=$smarty.now|date_format:"%m"|cat:$userid}
– PIN<b>
{$pin|md5|regex_replace:"/[^0-9]/":""|truncate:6:""}</b>
[/code]

Demonstração:

Para facilitar sua vida e não ter desculpas, estou disponibilizando os arquivos já modificados/testados na versão 5.1.3 para os templates admin WHMCS ( blend, original e v4 ) e para o painel do cliente WHMCS (classic, default e portal). Agora ficou fácil, faça o download do , descompacte e envie o arquivo de acordo com seu template ( admin/cliente ).

Se você utiliza uma versão do WHMCS inferior a 5.X.X não conseguirá utilizar o PIN por data, apenas por PIN único. Exemplo:

[code lang=”html”]
{assign var=’pin’ value=$clientsdetails.userid}
[/code]

Gostou? Comente!

Deseja fazer alguma doação? Clique aqui

Agradeço desde já as empresas que fizeram doação:

– Flávio –  https://www.lim-apo.com.br/