Documentação oficial
Como instalar e configurar o Portus Header Pro
Guia prático para instalar o ZIP Pro, ativar a licença, configurar menu, busca WooCommerce, conta, sacola, modo automático, shortcode e substituir o cabeçalho antigo com segurança.
Passo 1
Instalação do plugin
Depois da compra, o Portus License Manager exibe a chave de licença e um botão de download seguro do ZIP Pro na área do pedido ou na conta do cliente.
- Acesse sua conta na Portus e abra o pedido do Portus Header Pro.
- Clique em Baixar ZIP Pro. O link é temporário por segurança.
- No WordPress, vá em Plugins > Adicionar plugin > Enviar plugin.
- Envie o arquivo ZIP baixado e clique em Instalar agora.
- Clique em Ativar plugin.
- Acesse Aparência > Portus Header.
Passo 2
Ativar licença no domínio
A licença conecta o site ao servidor Portus, autoriza o domínio e libera atualizações privadas pelo painel do WordPress.
- Copie a chave exibida no pedido ou na área da conta.
- No WordPress, vá em Aparência > Portus Header > Licença.
- Cole a chave no campo Chave de licença.
- Confira a URL do servidor: https://useportus.com/wp-json/portus-license/v1/check.
- Salve as configurações.
- Clique em Ativar neste domínio.
A chave foi validada e o domínio atual está autorizado.
A chave foi apagada, expirou, pertence a outro produto ou o domínio não está autorizado.
A licença ainda não foi ativada neste domínio ou as configurações não foram salvas.
Mostra o domínio autorizado pelo servidor Portus para aquela chave.
Passo 3
Escolher modo de exibição
O Portus Header Pro pode aparecer automaticamente pelo wp_body_open ou manualmente por shortcode.
Modo Shortcode
Use primeiro este modo para testar sem duplicar o cabeçalho do tema. Depois adicione o shortcode onde deseja exibir o header:
Modo Automático
Quando estiver tudo validado, você pode usar o modo automático. Ele insere o header via wp_body_open, desde que o tema ofereça esse ponto de integração.
Identidade visual
Logos, cores, CTA e mobile
Em Aparência > Portus Header, configure logo desktop, logo mobile, botão CTA, cores, ícones, tamanhos, espaçamentos e comportamento responsivo.
Azul #00053A, branco #FFFFFF e dourado #C0A821.
Use um texto direto, como “Versão Pro”, “Comprar agora” ou “Fale conosco”.
Configure fundo do menu, cor dos links, cor dos ícones e comportamento dos submenus.
Use o preset Portus padrão como base e ajuste os campos conforme sua marca.
Loja
Busca, conta e sacola WooCommerce
Os recursos de busca, conta e sacola dependem do WooCommerce. Se o WooCommerce estiver desativado, esses recursos podem não aparecer.
Busca instantânea de produtos
- Mostra resultados enquanto o cliente digita.
- Exibe imagem, nome, preço, categoria e estoque.
- Suporta produtos recentes antes da busca.
- Permite histórico opcional de pesquisas.
Conta e sacola
- Visitantes podem ver chamada para login/cadastro.
- Clientes logados veem atalhos de conta, pedidos, downloads, endereços e sair.
- A sacola pode exibir contador de itens quando o WooCommerce estiver ativo.
Substituição segura
Como remover ou ocultar o header antigo
Não remova o header antigo antes de testar o Portus Header Pro em desktop, tablet e celular. O caminho mais seguro é começar no modo shortcode, validar o visual e só depois ocultar o cabeçalho original.
- Configure o Portus Header Pro em uma página de teste.
- Confira menu, busca, CTA, conta, sacola e mobile.
- Ative o modo automático apenas quando estiver pronto.
- Use a opção explícita de ocultar header original, se disponível.
- Informe um seletor CSS seguro do header antigo.
- Limpe cache e teste em aba anônima.
Manutenção
Atualizações privadas
Com a licença ativa, o WordPress pode consultar o servidor Portus para verificar novas versões privadas do Portus Header Pro.
- Mantenha a chave salva em Portus Header > Licença.
- Não apague a licença do servidor se o site ainda precisa receber updates.
- Ao trocar de domínio, desative a licença no domínio antigo e ative no novo.
- Depois de atualizar, limpe cache do site, navegador e servidor.
Solução de problemas
Problemas comuns e como resolver
O header aparece duplicado
Verifique se o modo automático está ativo e se o shortcode também foi inserido. Confira também se o header antigo do tema ainda está visível.
O menu não aparece
Confirme se existe um menu criado em Aparência > Menus e se ele foi atribuído à localização do Portus Header.
A busca não encontra produtos
Verifique se o WooCommerce está ativo, se existem produtos publicados, se os produtos têm título/preço e se o cache foi limpo.
A licença aparece inválida
A chave pode ter sido excluída no License Manager, expirada, estar vinculada a outro produto ou não autorizada para o domínio atual.
O visual parece antigo após atualizar
Limpe cache do navegador, cache do plugin de performance, cache do servidor/CDN e teste em aba anônima.
FAQ
Perguntas frequentes
Preciso de Elementor Pro?
Não. O Portus Header Pro funciona como plugin próprio, usando menu nativo do WordPress, CSS e JavaScript puros.
Posso usar sem WooCommerce?
Sim, mas busca de produtos, conta e sacola dependem do WooCommerce. Sem WooCommerce, esses recursos não aparecem ou devem ser desativados.
É melhor começar pelo shortcode ou automático?
Comece pelo shortcode para testar sem duplicação. Depois de validar, use o modo automático se o tema tiver suporte a wp_body_open.
Posso trocar de domínio?
Depende da política da licença. Em geral, desative o domínio antigo e ative a chave no novo domínio, respeitando o limite de domínios permitidos.
O ZIP Pro fica público?
Não. O download deve ser protegido pelo Portus License Manager e vinculado à licença do cliente.
Ainda precisa de ajuda?
Antes de abrir suporte, envie a versão do WordPress, PHP, WooCommerce, tema ativo, plugins de cache, URL da página com problema e um print ou vídeo curto do erro.