Configurando WooCommerce no KapsuleHost

Kapsule tem um tipo de site WooCommerce dedicado que instala WordPress, WooCommerce e um conjunto de gateways de pagamento da Nova Zelândia para você, e depois adiciona ferramentas específicas da loja ao menu do site. Este guia abrange a criação da loja, conexão de pagamentos, as configurações que importam para uma loja sob carga e como fazer alterações sem perder pedidos.

Criando um Site WooCommerce

1. Faça login em KPanel e clique em Websites na barra lateral esquerda.
2. Clique em Add Website, depois em New Website.
3. Escolha WooCommerce como o tipo de site.
4. Dê um nome à loja e conclua o assistente.

Kapsule provisiona WordPress, cria o banco de dados, instala e ativa WooCommerce, e pré-instala os plugins de gateway de pagamento listados abaixo. PHP 8.3 é definido como o runtime, com as extensões que uma loja necessita, incluindo manipulação de imagens.

Se você já tem um site WordPress e deseja adicionar uma loja a ele, instale WooCommerce da forma comum em Plugins, depois Add New no wp-admin. O site mantém seu tipo de site WordPress, o que significa que as abas específicas da loja descritas aqui não aparecerão.

Gateways de Pagamento

Abra a loja, depois a aba WordPress, depois Payments. Esta é uma aba exclusiva de WooCommerce e não aparece em sites WordPress comuns.

Cinco gateways são cobertos, com os relevantes da Nova Zelândia marcados:

Apple Pay e Google Pay vêm com Stripe: não há nada separado para instalar para nenhum deles.

Os gateways são intencionalmente instalados inativos. Um gateway habilitado sem credenciais quebra o checkout, portanto nada fica ativo até que você forneça seus próprios detalhes de conta de comerciante:

1. Clique em Enable no gateway que você usa.
2. Clique em Configure, que abre as configurações do gateway dentro do wp-admin.
3. Digite suas próprias chaves de API ou credenciais de comerciante e salve.
4. Faça um pedido de teste antes de anunciar a loja.

Windcave é distribuído pelo fornecedor em vez do diretório de plugins, portanto o painel oferece um link Get plugin. Baixe-o, envie-o em Plugins, depois Add New no wp-admin, e volte para configurá-lo aqui.

Desempenho da Loja

Uma loja realiza muito mais trabalho de banco de dados por visualização de página do que um site de brochura, portanto o cache é onde os maiores ganhos estão.

Cache de página inteira. Na aba WordPress do site, depois Caching, o cache de página inteira serve HTML finalizado para visitantes anônimos sem executar PHP ou tocar no banco de dados. As páginas de carrinho, checkout, minha conta e os endpoints AJAX do WooCommerce são contornados automaticamente, e qualquer visitante com um cookie de carrinho ativo sempre recebe uma página ativa. O cache acelera as páginas de produto e categoria sem nunca mostrar o carrinho de um cliente a outro cliente.

Cache de objeto. Na mesma tela, o cache de objeto mantém os resultados de consultas de banco de dados e transientes na memória. Este é o que torna o admin do WooCommerce usável em um grande catálogo.

CDN. Ative-o em Performance, depois Kapsule CDN para servir imagens de produtos e ativos estáticos da borda, com otimização de imagem e conversão WebP. Veja Enabling the CDN. Limpe-o após uma mudança em massa de imagens de produtos: Purging the CDN Cache.

Configurações PHP para uma Loja

Lojas são a razão mais comum para se afastar dos padrões. Na aba Advanced, depois PHP do site:

• Memory limit: aumente de 256M para 512M se o catálogo for grande ou você usar assinaturas.
• Max execution time: aumente de 30 para 120 ou 300 segundos se importações de produto ou geração de relatórios expirarem.
• Max input variables: aumente de 3000 se você tiver produtos com muitas variações, ou uma tela de configurações que silenciosamente remove campos quando você salva.

Detalhes completos estão em Increasing the WordPress Memory Limit.

Tarefas Agendadas

WooCommerce executa muito em segundo plano: transições de status de pedidos, renovações de assinatura, emails, sincronização de estoque. Usa o agendador integrado do WordPress, que por padrão só dispara quando alguém visita o site. Em uma loja tranquila, isso significa que as renovações e emails são executados atrasados ou não ocorrem.

Substitua-o por um agendamento real do lado do servidor. A aba WordPress, depois a seção WP-Cron tem uma ação Enable system cron que adiciona o agendamento e desabilita a versão acionada por visitante no mesmo passo. Explicação completa e a alternativa manual estão em Setting Up and Managing Cron Jobs.

Você pode monitorar a fila em WooCommerce, depois Status, depois Scheduled Actions no wp-admin.

Fazendo Alterações Sem Perder Pedidos

Cada loja é um banco de dados ativo no qual clientes estão escrevendo continuamente, o que muda como você deve lidar com atualizações.

Uma rotina de atualização segura para uma loja:

1. Faça um backup: Taking a Backup.
2. Redefina o staging a partir da produção para que corresponda à loja ativa.
3. Aplique as atualizações de plugin, tema ou WooCommerce no staging.
4. Faça um pedido de teste completo no staging, até a página de confirmação.
5. Envie apenas arquivos para a produção.
6. Faça um pequeno pedido real na produção e reembolse-o.

Em planos gerenciados, a ação Update Plugins em Quick Actions se torna Smart Update: faz backup, atualiza um plugin por vez, executa uma verificação de saúde do site após cada um e reverte automaticamente tudo que quebra o site. Em uma loja onde um checkout quebrado custa dinheiro, isso vale a pena ter.

Recuperação Point-in-Time

Backups diários restauram uma loja para o estado em que estava quando esse backup foi executado, o que em uma loja movimentada pode significar perder um dia de pedidos. Sites WooCommerce podem ativar recuperação point-in-time em Backups, depois Point-in-time recovery, e restaurar para um minuto escolhido, com até 30 dias de retenção. Em qualquer loja que aceita dinheiro real, ative-o. Veja Taking a Backup.

Solução de Problemas

Checkout falha sem erro. Quase sempre um gateway ativado com credenciais ausentes ou incorretas. Desative gateways um de cada vez na aba Payments até que o checkout funcione, depois reconfigure o que o quebrou.

Emails de pedidos não estão chegando. WordPress envia emails através do PHP por padrão e a maioria das redes rejeita isso. Verifique o aviso de entrega na aba WordPress, depois Site Health, e configure envio autenticado apropriado.

Páginas de admin são lentas ou expiram. Aumente memória e tempo de execução na aba PHP, depois ative o cache de objeto. Uma loja com dezenas de milhares de pedidos também se beneficia de limpar ações agendadas antigas.

Mudanças de produto não aparecem no front end. Libere o cache em WordPress, depois Quick Actions, depois Flush Cache, e limpe o CDN.