Carrinho lateral
Painel lateral responsivo com produtos, subtotal, 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. Esta página é a documentação do plugin; a página comercial continua em /cart.
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 e totais atualizam sem recarregar a página.
Painel próprio
Configurações de visual, texto, compatibilidade e comportamento 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 os hooks e scripts padrão do WordPress.
Recomendado: testar primeiro em loja de homologação ou em um WordPress separado antes de aplicar em uma loja com vendas ativas.
Instalação
O Portus Cart segue o fluxo padrão de instalação de plugins no WordPress.
Baixe o pacote Free
Use o botão de download oficial da Portus ou a versão disponível no WordPress.org quando ela estiver aprovada.
Envie o ZIP no WordPress
No painel, acesse Plugins > Adicionar novo > Enviar plugin e selecione o arquivo do Portus Cart.
Ative com o WooCommerce instalado
Depois de ativar, confira se o WooCommerce também está ativo. O carrinho depende das APIs do WooCommerce.
Abra o painel do plugin
Acesse Portus Cart no admin para ajustar textos, visual, botão flutuante e compatibilidade.
Configuração
As abas do painel organizam os ajustes por tipo de uso. A maioria das lojas pode começar apenas com Carrinho, Visual e Compatibilidade.
Carrinho
Nome do cabeçalho, botão flutuante e comportamento de abertura.
Visual
Cores, bordas, tipografia visual e aparência geral do painel lateral.
Conversão
Textos dos botões, cupom, carrinho vazio e chamadas principais.
Estoque
Mensagens de estoque baixo e limites de quantidade.
Compatibilidade
Z-index, overlay, largura do painel e ajustes para temas.
Saúde e suporte
Diagnóstico do ambiente, checklist e dados úteis para suporte.
Recursos da versão Free
A versão Free deve ser funcional por si só. Ela não depende de licença para executar os recursos incluídos no pacote público.
- Carrinho lateral responsivo para WooCommerce.
- Botão flutuante com contador de itens.
- Alteração de quantidade e remoção de produto via AJAX.
- Cupom de desconto dentro do carrinho.
- Favoritos locais, sem depender de tema específico.
- Preview do carrinho no painel do WordPress.
- Controles de compatibilidade com temas.
Checklist de testes
Depois de configurar, valide o fluxo real do cliente em desktop e mobile.
- Adicionar produto simples ao carrinho.
- 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.
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. Integrações específicas de Woodmart ficam na rota Pro.
Se o carrinho aparecer atrás de algum elemento do tema, aumente o z-index na aba Compatibilidade.
Free vs Pro
O Free cobre a experiência base do carrinho. A versão Pro será distribuída fora do WordPress.org, com recursos comerciais extras e suporte dedicado.
Recurso
Free
Pro
Carrinho lateral responsivo
Sim
Sim
Cupom no carrinho
Sim
Sim
Favoritos locais
Sim
Sim
Frete avançado, CEP e métodos
Não
Planejado
Cards de Pix, entrega e confiança
Não
Planejado
Produtos relacionados no carrinho
Não
Planejado
Licença, updates e suporte comercial
Não
Planejado
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 o z-index 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.
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.
- Passos para reproduzir o problema.