AgoraLogin: documentação

Guia do AgoraLogin e do AgoraLogin Pro: instalação, primeiros passos, métodos de login, checkout brasileiro e licença.

Instalação

1. Envie a pasta agoralogin para /wp-content/plugins/ (ou envie o .zip em Plugins › Adicionar novo › Enviar plugin) e ative.
2. Pronto: o plugin cria a página “Entrar” e adota a cor do seu tema. Ajuste em Configurações › AgoraLogin.

Requisitos: WordPress 6.3+ e PHP 7.4+. Para o checkout brasileiro, WooCommerce.

Primeiros passos

Ao ativar, o AgoraLogin cria (ou reaproveita) a página “Entrar”. Com o WooCommerce ativo, ele também assume a página Minha conta. Escolha o modelo (clássico, vidro, minimalista, dividido ou neon), o tema claro ou escuro e se o login abre em janela ou painel lateral. Você pode adicionar links de login automáticos aos menus.

Métodos de login

• E-mail, usuário, telefone ou CPF/CNPJ no mesmo campo.
• Link mágico e código de uso único por e-mail.
• Login social: Google, Microsoft e Facebook, e gov.br (experimental). Você informa as suas credenciais; sem elas, nada é enviado a terceiros.
• Recuperação de senha dentro do mesmo formulário.

Verificação em duas etapas e passkeys

2FA: aplicativo autenticador (TOTP), código por e-mail, SMS ou WhatsApp e códigos de recuperação. O QR code do autenticador é gerado no navegador.

Passkeys: o usuário cadastra uma passkey no perfil. Ela fica guardada no aparelho ou navegador onde foi criada, então é preciso cadastrar uma em cada aparelho; no computador dá para usar o celular pelo QR code. A configuração “Verificação do usuário” vem como Obrigatória, para o navegador sempre pedir PIN ou biometria.

Cadastro

Formulário em etapas que cabe em qualquer tela, com telefone internacional (cerca de 50 países) e CPF opcional para clientes brasileiros. Campos de documento brasileiro somem para clientes de fora do Brasil.

Checkout brasileiro (WooCommerce)

Na aba “Checkout brasileiro” você ativa tipo de pessoa, CPF, CNPJ (com validação e máscara), número e bairro, no checkout em blocos e no clássico. Os dados vão para as chaves clássicas do pedido (_billing_cpf, _billing_cnpj, _billing_persontype, _billing_number, _billing_neighborhood), compatíveis com plugins de nota fiscal e frete.

Convivência: se Brazilian Market, CheckoutBR, Checkout Brasil ou outro plugin de campos estiver ativo, o módulo fica desligado e pergunta o que fazer. O AgoraLogin nunca desativa outro plugin sozinho, e as duas escolhas podem ser desfeitas.

AgoraLogin Pro

• Portão de checkout: o visitante entra ou se cadastra antes de finalizar. Aba Checkout.
• Nota fiscal: CPF/CNPJ obrigatório, validação de dígitos, duplicidade, IE opcional. Aba Fiscal.
• CEP e CNPJ automáticos: ViaCEP e BrasilAPI. A opção “CEP no checkout da loja” tem os modos Automático (recua se outro plugin já preenche), Sempre ligado e Desligado.
• Campos personalizados: repetidor no painel, com atalho de “endereço completo”. Aba Campos.
• B2B: contas PJ ficam pendentes até a aprovação. Aba Empresas.
• Relatório: 7, 30 ou 90 dias e exportação CSV. Aba Relatório.

As abas do Pro ficam em Configurações › AgoraLogin, no grupo “AgoraLogin Pro”. Veja os planos.

Ativar a licença do Pro

1. Assine em AgoraLogin Pro.
2. Instale o AgoraLogin Pro (exige AgoraLogin 3.8.0+).
3. Abra Configurações › AgoraLogin › AgoraLogin Pro › Licença, cole a chave e ative.

Cada licença vale para 1 site. Para mudar de site, desative a licença no antigo e ative no novo. A validade acompanha o vencimento do serviço, com 7 dias de carência; sem licença ativa o checkout volta ao padrão.

Atualização

Pelo painel do WordPress. O pacote do Pro é baixado do servidor de licenças da Agorasite, só com licença ativa e site ativado, com a chave fora da URL e conferência SHA-256.

Multisite

Na ativação em rede, cada subsite recebe as configurações e a página “Entrar” no primeiro acesso. A desinstalação passa por todos os sites e só apaga o que cada um pediu para apagar.

Suporte

Dúvidas? Veja as perguntas frequentes, o changelog ou fale com a Agorasite. Clientes do Pro também usam a Área do Cliente.