Carrinho lateral
Painel responsivo com produtos, subtotal, frete, total e chamadas de ação.
Documentação
Portus Cart for WooCommerce
Manual prático para instalar, configurar, testar e manter o Portus Cart em lojas WooCommerce. Conteúdo atualizado para o Free 3.5.1 e o Pro 3.6.0.
Visão geral
O Portus Cart adiciona um carrinho lateral ao WooCommerce para o cliente revisar produtos, alterar quantidades, remover itens, aplicar cupom e avançar para o checkout sem perder o contexto da loja.
Atualização AJAX
Quantidade, remoção, cupom e totais atualizam sem recarregar a página.
Painel próprio
Configurações de visual, texto, compatibilidade, diagnóstico e suporte no admin.
Requisitos
Antes de instalar, confirme se a loja possui a base mínima para o plugin carregar com segurança.
- WordPress 6.0 ou superior.
- PHP 7.4 ou superior.
- WooCommerce ativo e configurado.
- Tema compatível com hooks e scripts padrão do WordPress.
- Cache/minificação revisados depois da configuração inicial.
Recomendado: testar primeiro em uma loja de homologação ou em um WordPress separado antes de aplicar em uma loja com vendas ativas.
Instalação da versão Free
A versão Free 3.5.1 é distribuída pelo WordPress.org e deve ser instalada como qualquer plugin gratuito do diretório oficial.
Instale pelo painel
No WordPress, acesse Plugins > Adicionar novo e pesquise por Portus Cart for WooCommerce.
Ative o plugin
Depois de instalar, ative o plugin com o WooCommerce também ativo na loja.
Abra o painel Portus Cart
Acesse WooCommerce > Portus Cart para configurar carrinho, visual, conversão, compatibilidade e suporte.
Teste o fluxo base
Adicione produto, altere quantidade, aplique cupom, remova item e avance para o checkout.
Instalação do Portus Cart Pro
A versão Pro 3.6.0 é distribuída fora do WordPress.org, com ZIP privado, licença por domínio e atualizações próprias. Ela não deve ser mantida ativa junto com a versão Free no mesmo WordPress.
Conclua a compra
Após a confirmação do pagamento, acesse Minha conta > Downloads.
Baixe o ZIP Pro
Use o arquivo do Portus Cart Pro entregue pela Portus. Não use ZIP antigo ou pacote Free para ativar recursos Pro.
Instale no WordPress
Acesse Plugins > Adicionar novo > Enviar plugin, selecione o ZIP Pro e ative.
Ative a licença
No painel do plugin, abra a aba Licença, informe a chave e vincule ao domínio da loja.
Importante: mantenha apenas uma edição do Portus Cart ativa. Se você instalou o Pro, desative e remova a edição Free ou antiga depois de confirmar que o Pro está funcionando.
Licença e atualizações Pro
A licença Pro valida o domínio autorizado e permite receber atualizações privadas pelo painel do WordPress quando o servidor Portus estiver configurado.
Chave
A chave é entregue após a compra e deve ser informada na aba Licença do Portus Cart Pro.
Domínio
A licença é vinculada ao domínio da loja onde o plugin será usado.
Servidor
Use a URL privada https://useportus.com/wp-json/portus-license/v1/check.
Status esperado
Quando tudo estiver correto, a mensagem será: Licença ativa para este domínio.
Para atualizar, abra Portus Cart > Licença, clique em “Verificar atualização” e depois use a atualização normal da página Plugins. O envio manual do ZIP deve ser apenas uma alternativa de recuperação.
Se aparecer licença inválida, confira se a chave pertence ao domínio certo, se a URL do servidor está correta e se o domínio foi cadastrado no Portus License Manager.
Configuração
As abas do painel organizam os ajustes por tipo de uso. O Free reúne a configuração essencial; o Pro acrescenta Metas, Frete grátis, Mensagens, Recomendações e Licença.
Carrinho
Nome do cabeçalho, botão flutuante, comportamento de abertura e URL do carrinho vazio.
Visual
Presets, cores, ícones, botão flutuante, botão do cabeçalho e visual responsivo.
Conversão
Textos dos botões, carrinho vazio e chamadas principais para o checkout.
Metas
No Pro, configure frete grátis, desconto percentual e brinde por valor do carrinho.
Frete grátis
No Pro, personalize o incentivo tradicional de frete ou use a recompensa das Metas Inteligentes.
Estoque
Mensagens de estoque baixo, avisos e limites relacionados à quantidade disponível.
Mensagens
No Pro, configure os cards de Pix, entrega, rastreio e confiança.
Recomendações
No Pro, escolha produtos relacionados que podem ser adicionados diretamente pelo carrinho.
Compatibilidade
Camada, largura, overlay, posição e ajustes para temas e elementos fixos.
Licença
No Pro, ative o domínio, confira o status e solicite uma nova verificação de atualização.
Ferramentas e saúde
Diagnóstico do ambiente, requisitos, arquivos principais e dados úteis para suporte.
Metas Inteligentes — Pro 3.6.0
As Metas Inteligentes criam uma sequência cumulativa de recompensas para incentivar o aumento do pedido. O cálculo considera o subtotal dos produtos antes de frete e descontos.
Frete grátis
Quando o subtotal atinge a meta, o plugin libera e seleciona uma opção de entrega com custo zero.
Desconto automático
Aplica internamente o percentual configurado. Não exige código e pode coexistir com cupons comuns da loja.
Brinde automático
Adiciona uma unidade gratuita ao atingir a meta e remove o brinde se o subtotal voltar a ficar abaixo do valor definido.
Cupom e Meta de desconto são recursos diferentes: o campo de cupom via AJAX existe no Free e no Pro; o desconto automático por meta é exclusivo do Pro.
Para o brinde, escolha um produto simples, publicado, comprável e em estoque. Teste também a redução do carrinho para confirmar a remoção automática.
Frete e CEP — Pro
O cálculo de entrega foi desenhado para acontecer dentro do carrinho lateral sem deslocar o cliente para outra parte da página.
Informe o CEP
O botão permanece inativo enquanto o CEP estiver incompleto. Ao completar os oito dígitos, a consulta é iniciada automaticamente.
Confira as opções
Os métodos de entrega permanecem ocultos antes do CEP e aparecem somente depois de uma consulta válida.
Escolha o método
O cliente pode selecionar a opção desejada sem recarregar a página e sem perder sua posição no carrinho.
Use o botão se necessário
O botão Calcular frete continua disponível para repetir manualmente a consulta quando necessário.
Recursos por edição
A versão Free é funcional por si só. A versão Pro contém todos os recursos do Free e adiciona ferramentas comerciais, licença e atualizações privadas sem misturar código premium no pacote do WordPress.org.
Free
- Carrinho lateral responsivo.
- Botão flutuante e botão de menu/cabeçalho.
- Quatro ícones locais, presets e personalização visual.
- Quantidade, remoção e totais via AJAX.
- Aplicação e remoção de cupom via AJAX.
- Favoritos locais.
- Preview, compatibilidade e saúde do plugin.
Pro
- Todos os recursos disponíveis no Free.
- Metas de frete grátis, desconto e brinde.
- Frete, CEP e métodos no carrinho.
- Cards de Pix, entrega e confiança.
- Produtos relacionados no carrinho.
- Licença por domínio.
- Atualizações privadas e suporte comercial.
Checklist de testes
Depois de configurar, valide o fluxo real do cliente em desktop e mobile.
- Adicionar produto simples ao carrinho.
- Adicionar produto variável e verificar opções.
- Alterar quantidade pelo carrinho lateral.
- Remover item e conferir se totais atualizam.
- Aplicar cupom válido e testar cupom inválido.
- Abrir e fechar o painel pelo botão flutuante.
- Testar em produto, loja, carrinho e checkout.
- Conferir visual em celular, tablet e desktop.
- No Pro, digitar um CEP incompleto e confirmar que as opções de frete permanecem ocultas.
- No Pro, completar o CEP e confirmar cálculo automático sem rolagem da página.
- No Pro, testar as metas abaixo, exatamente no valor e acima de cada limite.
- No Pro, confirmar o desconto automático junto com um cupom comum.
- No Pro, liberar o brinde e depois reduzir o subtotal para confirmar sua remoção.
- No Pro, validar licença, Pix, relacionados e atualização privada.
Compatibilidade com temas
O Portus Cart usa APIs padrão do WordPress e WooCommerce, mas temas e plugins de otimização podem alterar camadas, scripts e comportamento de botões.
Astra
Compatível em testes com WooCommerce e Elementor, usando ajustes de camada quando necessário.
Storefront
Boa base para teste limpo, por usar padrões próximos do WooCommerce.
Woodmart
Compatível com o carrinho base. Recursos específicos dependem da edição e configuração usada.
Se o carrinho aparecer atrás de algum elemento do tema, aumente a camada na aba Compatibilidade. Se scripts não atualizarem, limpe cache e teste sem minificação temporariamente.
Free 3.5.1 vs Pro 3.6.0
O Free entrega o fluxo essencial completo, inclusive cupom via AJAX. O Pro mantém essa base e acrescenta recursos para aumentar o pedido e apoiar a decisão antes do checkout.
Recurso
Free 3.5.1
Pro 3.6.0
Carrinho lateral responsivo
Sim
Sim
Cupom via AJAX
Sim
Sim
Botão flutuante, cabeçalho e presets
Sim
Sim
Metas de frete grátis, desconto e brinde
Não
Sim
Frete, CEP e métodos
Não
Sim
Cards de Pix, entrega e confiança
Não
Sim
Produtos relacionados no carrinho
Não
Sim
Licença, atualizações e suporte comercial
Não
Sim
Problemas comuns
Use esta área para resolver situações frequentes antes de abrir suporte.
O botão flutuante não aparece
Confira se o botão está ativo na aba Carrinho. Ele pode ser ocultado automaticamente no carrinho, checkout, pedido recebido ou página de produto para evitar distrações.
O carrinho fica atrás de menu, popup ou cabeçalho
Acesse Compatibilidade e aumente a camada do carrinho. Também confira se algum plugin de popup está usando camada muito alta.
O carrinho não atualiza depois de adicionar produto
Confirme se o WooCommerce está ativo e se o produto pode ser comprado. Desative temporariamente plugins de cache/minificação para verificar conflito de JavaScript.
A licença Pro não ativa
Confira a chave, o domínio cadastrado, a URL privada do servidor e se a licença está ativa no Portus License Manager.
As opções de frete não aparecem
Confirme se o CEP possui oito dígitos e se a loja tem métodos de entrega configurados para a região informada. As opções ficam ocultas até uma consulta válida.
Uma Meta Inteligente não foi liberada
Confira se o recurso e a recompensa estão ativos, se o subtotal atingiu o valor definido e, no caso do brinde, se o produto está publicado, comprável e em estoque.
A atualização Pro continua aparecendo depois de atualizar
Confira a versão exibida na página Plugins e solicite uma nova verificação na aba Licença. Se a versão instalada não mudar, envie ao suporte a versão atual, o domínio e uma captura do resultado da atualização.
O visual não mudou depois de salvar
Limpe cache do navegador, cache do plugin de otimização e cache da hospedagem. Depois recarregue a página da loja em aba anônima.
Suporte
Quando precisar de ajuda, envie as informações básicas para facilitar o diagnóstico.
- Versão do WordPress, WooCommerce e Portus Cart.
- Nome do tema ativo.
- Link da página onde o problema acontece.
- Print ou vídeo curto mostrando o comportamento.
- Print da aba Saúde do plugin.
- No Pro, print da aba Licença e domínio usado.