Auto Login compatível com WHMCS 7 e com múltiplas URLs de destino

Com a atualização para o WHMCS 7, quem usa técnicas de auto login no WHMCS pode ter o envio de e-mails interrompidos, devido a mudanças que impedem que os e-mails sejam gerados se o template de email contiver merge tags não registradas pelo WHMCS ou por algum hook. A partir dessa descoberta, decidimos criar o Gofas WHMCS Autologin, que resolve essa e outras dificuldades.

O auto login é um recurso simples (e até mesmo "manjado"), essa funcionalidade é ideal para redirecionar o cliente diretamente para o Boleto, gerado pelo módulo Gofas Gerencianet Boleto para WHMCS.
O que torna o nosso método de auto login especial é:

• Capacidade de escolha do destino após o login, configurado diretamente na merge tag do template de e-mail;
• Não é necessário inserir o hash diretamente no template do e-mail, apenas a tag {hash};
• Configuração mais simples, merge tags e urls dinâmicos menores;

Instalação

1) Baixe aqui o módulo., descompacte o arquivo gofaswhmcsautologin.zip, mova o arquivo auth.php para a pasta raiz e o arquivo gofas_hash_email.php para a pasta /includes/hooks/ do WHMCS;

2) Ative a opção AutoAuth do WHMCS adicionando a variável $autoauthkey com uma chave única ao arquivo configuration.php, localizado na raíz da instalação do WHMCS. Como no exemplo da linha 15 do nosso configuration.php, adicione uma senha única que será usada nos próximos passos, se a sua chave autoauthkey for por exemplo 123456abcdef, a linha da variável $autoauthkey vai ficar assim:

$autoauthkey = "123456abcdef";

3) Adicione a mesma chave $autoauthkey do arquivo configuration.php na linha 11 do arquivo auth.php. Exemplo: Se a sua chave for 123456abcdef, a linha 11 do arquivo auth.php vai ficar desta forma:

$autoauthkey = "123456abcdef"; // chave igual à inserida no /configuration.php

4) Crie uma nova chave (diferente da atribuída à $autoauthkey) e atribua à variável $secret_key na linha 12 do arquivo auth.php. Exemplo: Se a sua secret_key for abcdef123456, a linha 12 do auth.phpvai ficar assim:

$secret_key = "abcdef123456"; // chave igual à inserida no /includes/hooks/gofas_hash_email.php

5) Adicione a mesma chave atribuída à $secret_key no arquivo auth.php (descrito no passo anterior) na linha 21 do arquivo /includes/hooks/gofas_hash_email.php. Exemplo: Se a sua secret_key é abcdef123456, a linha 21 do arquivo gofas_hash_email.php vai ficar assim:

$secret_key = 'abcdef123456'; // chave igual à inserida no /auth.php

6) Após concluir esses passos, ao adicionar a tag dinâmica {hash} a um template de email, ela será substituída por uma senha que será utilizada para identificar o usuário e conceder acesso à área do cliente do WHMCS após o login. Para gerar os URLs com o hash, adicione as tags abaixo nos modelos de email seguindo a lógica dos exemplos a seguir:

URL dinâmico para colar no template de email "Invoice Created" que leva o usuário para a visualização da fatura após o login:

{$whmcs_url}auth.php?email={$client_email}&uid={$client_id}&uname={$client_first_name}{$client_last_name}&hash={$hash}&whmcsurl={$whmcs_url}&goto=viewinvoice.php?id={$invoice_id}

URL dinâmico que leva o usuário para a edição do perfil após o login:

{$whmcs_url}auth.php?email={$client_email}&uid={$client_id}&uname={$client_first_name}{$client_last_name}&hash={$hash}&whmcsurl={$whmcs_url}&goto=clientarea.php?action=details

Exemplo de URL para que leva o usuário para a visualização de um ticket respondido após o login:

{$whmcs_url}auth.php?email={$client_email}&uid={$client_id}&uname={$client_first_name}{$client_last_name}&hash={$hash}&whmcsurl={$whmcs_url}&goto={$ticket_link}

Agora você possui um sistema de Auto Login simples e funcional, se ele é útil para você, compartilhe sua gratidão com um comentário!