ecomyseo/velocidad-prestashop

Meça e melhore a velocidade de uma loja PrestaShop (1.7, 8 e 9) e de seu servidor sem quebrar nada. Cópia de segurança e reversão antes de cada alteração, medição antes e depois com navegador real (móvel em 4G), imagens WebP (núcleo, modelo, banners e CMS), recursos que bloqueiam a pintura (fontes, ícones, jQuery, reCAPTCHA), cache do navegador, ajustes do servidor (OPcache, MariaDB, PHP-FPM, sessões, DNS) e módulos de terceiros.

O que é velocidad-prestashop?

Este skill é um guia prático e sistemático para otimizar o desempenho de lojas PrestaShop, abrangendo das versões 1.7 até a 9, sem causar danos. Ele foi construído a partir de experiências reais em lojas reais, anonimizadas, e foca no que realmente funciona, na ordem correta de implementação e nas armadilhas comuns. O processo é rigoroso: cada alteração exige backup prévio e um script de reversão (`volver.sh`); as medições de desempenho são feitas antes e depois com um navegador real (simulando um dispositivo móvel em conexão 4G lenta) usando a ferramenta `scripts/medir.py`; e cada mudança é testada individualmente (A/B) para validar seu impacto. As áreas de otimização incluem: conversão de imagens para WebP (especialmente banners grandes), eliminação de recursos que bloqueiam a pintura (fontes, ícones, jQuery, reCAPTCHA), configuração de cache do navegador para arquivos estáticos, e ajustes no servidor (OPcache, MariaDB, PHP-FPM, sessões, DNS). O skill é compatível com as principais plataformas de agentes de IA (Claude Code, Cursor, Codex) e fornece scripts em Python, templates de configuração para nginx, Apache e Smarty, e referências detalhadas para cada etapa. Ao final, o usuário deve gerar um relatório claro das alterações, resultados de medição, localização dos backups e instruções de reversão.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ecomyseo/velocidad-prestashop/tree/HEAD/skill/velocidad-prestashop

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Velocidade em PrestaShop sem quebrar nada

Este skill reúne o que foi medido e aplicado em lojas PrestaShop reais: o que realmente melhora, em que ordem convém fazer e onde se tropeça. Tudo está anonimizado.

As regras que não se quebram

  1. Cópia de segurança antes de cada alteração. De cada arquivo que se toca, das linhas de configuração que se alteram e da configuração do servidor. E um volver.sh que desfaça essa alteração específica. Detalhe em referencias/01-metodo-seguro.md.
  2. Medir antes e depois, com o mesmo método. Sem uma medida inicial não se pode dizer que algo melhorou. O método está em referencias/02-medir.md e a ferramenta em scripts/medir.py.
  3. Uma alteração de cada vez, e testá-la ativando e desativando. Para saber se uma opção ajuda, mede-se com ela e sem ela, alternando (A, B, A, B) e com várias cargas. Se não melhorar, desfaz-se.
  4. Nada em produção sem a permissão do dono da loja, dizendo antes o que vai ser tocado. Se houver uma cópia da loja, testa-se primeiro ali.
  5. Verificar o final, não apenas o início. Mesmos códigos HTTP que antes nas páginas-chave, zero erros de JavaScript novos (os que já existiam não contam, mas são anotados), imagens que carregam, e carrinho e checkout que funcionam.
  6. Avisar de cada alteração: o que foi tocado, onde está a cópia, como se desfaz e o que foi medido.

Ordem de trabalho, do mais rentável ao menos

PassoO quêReferência
1Medir a situação inicial (móvel 4G, primeira e segunda visita)referencias/02-medir.md
2Imagens: WebP em fotos de produto, no modelo e em banners/CMSreferencias/03-imagenes-webp.md
3Recursos que bloqueiam a pintura: fontes, ícones, jQuery, reCAPTCHA, CCCreferencias/04-bloqueos.md
4Cache do navegador para os estáticosreferencias/05-cache-navegador.md
5Servidor: OPcache, MariaDB, PHP-FPM, sessões, DNS, CPUreferencias/06-servidor.md
6Módulos de terceiros que chamam externamente ou bloqueiamreferencias/07-modulos-terceiros.md
—Armadilhas já pisadas (ler antes de começar)referencias/08-trampas.md

O que mais pesa quase sempre são as imagens: banners em PNG de 2 a 5 MB são comuns. Numa loja a página inicial passou de 26,5 MB para 4,8 MB apenas com WebP nos banners, sem tocar em nenhuma imagem original.

Ferramentas

ScriptPara quê
scripts/medir.pyNavegador real (Playwright) em móvel com 4G lenta e CPU ×4: FCP, LCP, carga, KB, requisições, recursos que bloqueiam, o mais pesado e erros de JavaScript, na primeira e segunda visita.
scripts/revisar_cache.pyQuanto tempo o navegador guarda os CSS, JS, imagens e fontes de um site, e que as páginas e o JSON não são guardados. Apenas leitura.
scripts/webp_al_lado.pyCria imagem.png.webp junto a cada imagem de uma pasta (sem tocar a original), apenas se pesar pelo menos 10% a menos. Deixa um registro para desfazer.

Modelos de configuração prontos para adaptar em plantillas/: negociação de WebP no nginx e no Apache, bloco de cache do navegador seguro para .htaccess, o parcial Smarty que pede o WebP apenas se existir e um modelo de aviso ao desenvolvedor de um módulo.

Como informar ao terminar

  • O que foi alterado, loja por loja, com o número de antes e o de depois.
  • Onde está a cópia e a ordem exata para desfazer.
  • O que fica pendente e que decisão cabe ao dono da loja.
  • O que foi visto de passagem e não foi tocado (erros que já existiam, módulos suspeitos).

Habilidades Relacionadas