Guia de Instalação

01O que vem no pacote

A Aurora Themes é uma suíte de três peças que trabalham juntas, mais os modelos de e-mail.

O arquivo aurorathemes.zip tem esta estrutura:

aurorathemes-vX.Y.Z/
│   ├── templates/aurorathemes/            tema da área do cliente
│   ├── templates/orderforms/aurorathemes_cart/   carrinho
│   ├── modules/addons/aurorathemes_admin/ addon
│   └── includes/hooks/aurorathemes_client.php    hook do tema
└── docs/                                  manuais e modelos de e-mail (não enviar)

02Requisitos

Confira cada item antes de enviar os arquivos.

03Antes de começar

Três cuidados rápidos evitam dor de cabeça.

• Backup completo dos arquivos do WHMCS e do banco de dados. A instalação não altera arquivos do WHMCS, mas o backup permite voltar atrás em qualquer situação.
• Anote o tema e o carrinho atuais (em Configurações gerais › Geral › Template e Configurações gerais › Pedidos), para poder voltar se precisar.
• Tenha à mão o acesso FTP/SFTP ou o gerenciador de arquivos da hospedagem, um usuário administrador do WHMCS com acesso total e a chave de licença.

04Enviar os arquivos

Os arquivos vão para a raiz do WHMCS, sem substituir nada do próprio WHMCS.

1. Descompacte o pacote no seu computadorAbra aurorathemes.zip e localize as pastas templates, modules e includes.
2. Localize a raiz do WHMCS no servidorÉ a pasta onde ficam configuration.php, clientarea.php e cart.php. Pode ser a raiz do domínio (public_html/) ou uma subpasta (ex.: public_html/clientes/).
3. Envie as pastas templates, modules e includesEnvie as três pastas para a raiz do WHMCS. Elas já existem no servidor: o conteúdo é mesclado a elas.

   No gerenciador de arquivos do cPanel, a forma mais rápida é compactar as três pastas num zip, enviar esse zip para a raiz do WHMCS e usar Extrair.

4. Confira o resultadoDepois do envio, a raiz do WHMCS deve ter:

   templates/aurorathemes/theme.yaml
   templates/orderforms/aurorathemes_cart/theme.yaml
   modules/addons/aurorathemes_admin/aurorathemes_admin.php
   includes/hooks/aurorathemes_client.php

5. Ajuste as permissões, se necessárioArquivos com 644 e pastas com 755. A pasta modules/addons/aurorathemes_admin/ precisa permitir escrita pelo PHP: a subpasta uploads/, onde ficam os logos e imagens enviados pelo painel, é criada no primeiro envio.

05Ativar o addon

O addon cria as tabelas de configuração e libera o painel da Aurora no admin.

1. Abra a lista de addonsNo admin do WHMCS, vá em Configurações do sistema › Módulos Addon (Addon Modules).
2. Ative o Aurora ThemesLocalize Aurora Themes e clique em Ativar. As tabelas mod_aurorathemes_* são criadas nesse momento.
3. Clique em ConfigurarNa mesma linha, abra Configurar e preencha:

   Campo	O que informar
   Chave de licença	Cole a chave recebida da Modules Pay, sem espaços antes ou depois.
   Apagar dados ao desativar	Deixe desmarcado. Marque só quando quiser remover a Aurora de vez (veja Desinstalação).
   Access Control	Marque apenas os grupos de administradores que podem alterar o tema (normalmente, só Full Administrator).

4. SalveClique em Salvar alterações. O painel da Aurora passa a aparecer em Addons › Aurora Themes.

06Ativar a licença

Sem licença ativa o tema continua funcionando, mas as configurações ficam bloqueadas.

1. Abra o painelVá em Addons › Aurora Themes. No topo aparece o quadro Licença.
2. Clique em “Verificar agora”O WHMCS consulta o servidor de licenças da Modules Pay. Em poucos segundos a situação muda para Ativa e as abas de configuração são liberadas.

Situações possíveis

Como a verificação funciona

• A licença é conferida no cron diário e quando você abre o painel do addon, se a última verificação tiver mais de 24 horas.
• A área do cliente nunca consulta o servidor de licenças: o site dos seus clientes não fica mais lento nem depende da Modules Pay estar no ar.
• Se o servidor de licenças não responder, a última confirmação vale por até 7 dias.
• Sem licença ativa, o painel mostra só o quadro da licença, com a instrução do caso e o atalho Abrir configuração do módulo. A área do cliente e a skin do admin continuam funcionando com as configurações atuais, e um aviso discreto aparece no canto inferior do admin.

07Ativar o tema da área do cliente

A partir deste passo os clientes passam a ver a Aurora.

1. Abra as configurações geraisConfigurações do sistema › Configurações gerais › Geral.
2. Escolha o templateNo campo Template, selecione Aurora Themes.
3. SalveClique em Salvar alterações.

Se o seu WHMCS permite que o cliente escolha o template, a Aurora aparece na lista como qualquer outro tema. O tema padrão escolhido aqui é o que visitantes e novos clientes veem.

08Ativar o carrinho (order form)

O carrinho da Aurora segue o visual do tema escolhido.

1. Abra as opções de pedidoConfigurações do sistema › Configurações gerais › Pedidos (Ordering).
2. Escolha o order form padrãoEm Default Order Form Template, selecione Aurora Themes Cart.
3. SalveClique em Salvar alterações.
4. Confira os grupos de produtosEm Configurações do sistema › Produtos/Serviços, cada grupo pode ter um order form próprio, que vence o padrão. Edite os grupos que devem usar a Aurora e selecione Aurora Themes Cart (ou deixe o grupo usando o padrão).

09Cron, nginx e cache

Ajustes finais do servidor.

Cron diário

Em Configurações do sistema › Automação, confirme que o cron está rodando (a data da última execução aparece na página). Sem ele, a licença não é reconfirmada e acaba ficando “não verificada” depois de 7 dias.

Servidor nginx

Em Apache, o arquivo .htaccess criado junto com a pasta de envios já bloqueia a execução de scripts. Em nginx, que ignora o .htaccess, adicione esta regra ao bloco server do site (ajuste o caminho se o WHMCS estiver numa subpasta) e recarregue o nginx:

location ~* ^/modules/addons/aurorathemes_admin/uploads/.*\.(php|phtml|phar|pl|py|cgi|sh|svg|html?)$ {
    deny all;
}

Cache de templates

Em Utilitários › Sistema › Limpeza do sistema, clique em Empty Template Cache. Se usar CDN ou cache no servidor (Cloudflare, LiteSpeed, Varnish), limpe também.

10Conferência final

Abra o site numa janela anônima e percorra os pontos abaixo.

Área do cliente

• A página inicial abre com o visual da Aurora (cabeçalho, hero, planos, rodapé).
• Login e cadastro mostram o painel de marca ao lado do formulário.
• Depois do login: painel, serviços, domínios, faturas e tickets com o menu lateral.
• O botão de claro/escuro funciona (se estiver liberado no addon).
• A troca de idioma funciona (inglês, português e espanhol).
• No celular, o menu abre como painel lateral.

Carrinho

• A lista de planos mostra a troca de ciclo (mensal, anual…).
• Um pedido de teste passa por configuração, carrinho, checkout e página de conclusão.
• A busca e o registro de domínio funcionam.

Admin

• Addons › Aurora Themes abre com a licença Ativa.
• A skin do admin aparece (se ligada na aba Painel admin).
• Relatórios › Smarty Compatibility, com o tema ativo, não aponta problemas nos templates da Aurora.

11Modelos de e-mail (opcional)

A importação é manual, para não sobrescrever modelos que você já personalizou.

Os arquivos ficam em docs/email-templates/ do pacote: cabeçalho e rodapé globais, CSS global opcional e o corpo de 13 modelos (cadastro, senha, pedido, faturas, serviço, domínio e suporte) em inglês, português e espanhol. Os assuntos estão em SUBJECTS.md.

1. Cabeçalho e rodapé globais (uma vez só)Em Configurações gerais › Correio, cole global/header.html em Client Email Header Content e global/footer.html em Client Email Footer Content. Opcional: global/global.css em Global Email CSS Styling. Salve.
2. Cada modeloEm Configurações do sistema › Modelos de e-mail, abra o modelo, mude o editor para o modo código-fonte, apague o conteúdo e cole o arquivo do idioma desejado. Cole também o assunto.
3. TesteSalve e envie um e-mail de teste para conferir.

O passo a passo completo, com a lista dos modelos e dos merge fields, está em docs/pt-BR/email-templates.md.

12Atualização para uma nova versão

As configurações ficam no banco de dados e não se perdem na atualização.

1. Leia o CHANGELOGO arquivo CHANGELOG.md da nova versão lista o que mudou e se há algum cuidado especial.
2. Faça backupArquivos e banco de dados.
3. Envie as pastas templates, modules e includes por cimaSubstitua os arquivos existentes, mantendo:
   • templates/aurorathemes/css/custom.css, se você criou;
   • modules/addons/aurorathemes_admin/uploads/ (logos e imagens enviados).
4. Abra o painel do addon uma vezAcesse Addons › Aurora Themes. O WHMCS roda a atualização do banco do addon automaticamente.
5. Limpe o cacheUtilitários › Sistema › Limpeza do sistema › Empty Template Cache, mais o cache do navegador/CDN.

Quando o WHMCS for atualizado

A Aurora herda do Nexus e do Standard Cart, então as correções da WHMCS continuam chegando. Depois de atualizar o WHMCS, rode Relatórios › Smarty Compatibility e confira se há uma versão nova da Aurora para a sua versão do WHMCS.

13Solução de problemas na instalação

Os casos mais comuns e como resolver.

14Desinstalação

Remova na ordem abaixo para os clientes nunca verem uma página quebrada.

1. Volte o tema e o carrinhoEm Configurações gerais, selecione Nexus como template e Standard Cart como order form (e nos grupos de produtos que usavam a Aurora).
2. Decida sobre as configuraçõesPara apagar as configurações e preferências: em Módulos Addon › Aurora Themes › Configurar, marque Apagar dados ao desativar e salve. Sem essa opção, desativar mantém tudo, e reativar depois recupera as configurações.
3. Desative o addonClique em Desativar na linha do Aurora Themes.
4. Apague os arquivostemplates/aurorathemes/, templates/orderforms/aurorathemes_cart/, modules/addons/aurorathemes_admin/ e includes/hooks/aurorathemes_client.php.
5. Limpe o cache de templatesUtilitários › Sistema › Limpeza do sistema › Empty Template Cache.

Os modelos de e-mail importados não são removidos: restaure os padrões do WHMCS em Modelos de e-mail, se quiser.