O WooCommerce é o plugin que mais deixa as agências nervosas na hora de atualizar, e com razão. Um post de blog quebrado é constrangedor; um checkout quebrado custa dinheiro ao seu cliente a cada minuto até alguém perceber. A boa notícia é que a maioria dos problemas do WooCommerce depois de uma atualização vem de uma lista curta de causas, e uma rotina de quinze minutos pega quase todos. Este guia é essa rotina.
Por que as atualizações do WooCommerce quebram lojas
O WooCommerce em si é bem testado. Os problemas costumam vir da combinação do WooCommerce com tudo ao redor dele:
- Substituições de templates no tema. Muitos temas de loja copiam templates do WooCommerce para a própria pasta. Quando o WooCommerce muda um template, o tema continua servindo a cópia antiga. O WooCommerce lista esses arquivos em WooCommerce → Status como “cópias desatualizadas”.
- Extensões que ficam para trás. Gateways de pagamento, plugins de frete e complementos de checkout que se conectam a fundo no checkout podem parar de funcionar quando o WooCommerce muda a forma como o checkout é montado.
- A atualização do banco de dados. Versões maiores pedem que você rode uma atualização do banco de dados depois. Em lojas grandes isso pode demorar, e até terminar algumas telas se comportam de forma estranha.
- Cache. Um cache de páginas ou uma CDN que continua servindo scripts antigos ao carrinho e ao checkout depois da atualização.
Antes de atualizar: cinco verificações
- Leia as notas de versão da versão do WooCommerce e do gateway de pagamento que você usa. Procure por “breaking”, “deprecated” e pelas versões mínimas de PHP e WordPress.
- Verifique WooCommerce → Status em busca de cópias de templates desatualizadas. Se o tema substitui os templates do carrinho ou do checkout, teste essas páginas com cuidado redobrado, ou peça primeiro uma atualização ao autor do tema.
- Faça um backup recente dos arquivos e do banco de dados, e saiba como você o restauraria. Um backup que você nunca restaurou é uma esperança, não um plano.
- Escolha um momento tranquilo. Veja quando a loja recebe menos pedidos. Para a maioria das lojas, é no começo da manhã.
- Atualize uma coisa de cada vez. Primeiro o WooCommerce, depois as extensões, com uma verificação entre cada uma. Se algo quebrar, você sabe qual atualização causou.
Teste em uma cópia, não na loja no ar
O lugar mais seguro para descobrir um checkout quebrado é uma cópia da loja que nenhum cliente consegue acessar. A maioria das hospedagens oferece uma cópia de staging com um clique. Atualize primeiro a cópia e percorra os passos de um cliente:
- Abra a página inicial, uma página de categoria e uma página de produto no desktop e em um celular.
- Coloque um produto no carrinho e mude a quantidade.
- Vá ao checkout e verifique se os campos, as formas de envio e as opções de pagamento aparecem.
- Se o gateway tiver um modo de teste ou sandbox, faça um pedido de teste apenas na cópia. Nunca faça pedidos de teste na loja no ar com dados de pagamento reais.
- Entre como cliente e abra “Minha conta”.
Garanta que a cópia não consiga enviar e-mails para clientes reais nem falar com o provedor de pagamento real, e que os mecanismos de busca não possam indexá-la. Uma cópia de staging que manda e-mails de pedido para clientes reais causa mais problemas do que a atualização que você estava testando.
Depois da atualização: o que verificar na loja no ar
Quando a cópia passar, atualize a loja no ar e repita o roteiro curto: página inicial, página de produto, carrinho, checkout e conta, no desktop e no celular. Se o WooCommerce pedir uma atualização do banco de dados, rode na hora e espere até ela informar que terminou. Depois limpe o cache de páginas e a CDN, e verifique o checkout mais uma vez em uma janela anônima.
Se o checkout quebrar mesmo assim
- Reverta só a atualização que causou o problema, não o site inteiro. Restaurar um backup completo de hoje cedo também apaga os pedidos feitos desde então.
- Se precisar restaurar o banco de dados, exporte antes os pedidos feitos depois do backup, para poder colocá-los de volta.
- Coloque um aviso curto no site se o checkout ficar fora do ar por mais de alguns minutos, para que os clientes saibam que podem voltar.
- Anote o que quebrou e em qual versão. Na próxima vez você sabe qual combinação testar primeiro.
Como o Verploy cuida das atualizações do WooCommerce
O Verploy trata atualizações de loja como arriscadas. Ele as roda primeiro em uma cópia temporária da loja no seu próprio servidor, coloca um produto no carrinho e verifica se a página de checkout abre, antes e depois da atualização, só nessa cópia. Ele nunca paga nem faz um pedido, e a cópia não envia e-mails e bloqueia requisições de saída. A loja no ar só é atualizada quando as verificações passam. Nos sites com a proteção de dados, os pedidos e envios de formulários feitos depois do backup ficam no site se for preciso reverter. Mais na página de atualizações do WooCommerce .
Quer que as atualizações da loja sejam testadas antes de chegarem aos clientes dos seus clientes?
Cada atualização é verificada, e as arriscadas, como o WooCommerce e suas extensões, são testadas primeiro em uma cópia. Se algo quebrar depois de ir ao ar, o Verploy reverte. Comece grátis, sem cartão de crédito.