Performance Revolution: configuración y ayuda

Sube el ZIP en Módulos > "Module Manager", instálalo y pulsa "Configure". El menú del back office es Rendimiento, con Panel de control, Caché, Recursos, Consultas, Copia de seguridad, Configuración y Verificación del sistema.

Antes de activar más capas, registra cómo funcionan inicio, categoría, producto, carrito, cuenta y pago. Prueba en un navegador de cliente y en uno de empleado. Selecciona la tienda prevista y respalda la configuración antes de cambiar la caché del núcleo o las reglas CDN.

Empieza en Configuración > Backend de caché. El proceso PHP necesita escritura en los directorios de caché de PrestaShop y recursos generados. La instalación de la caché de objetos Redis de PrestaShop también necesita acceso a la clase de caché del núcleo y los archivos de configuración afectados. Las acciones Cloudflare requieren un token autorizado para la zona elegida y las operaciones solicitadas.

Guarda y comprueba el adaptador elegido en Panel de control. Si Redis no conecta, verifica host, puerto, autenticación, base de datos y compatibilidad Redis de PHP. No supongas que elegir el backend del módulo activa también la caché de objetos del núcleo.

Abre Caché > Resumen para los interruptores de ámbito Caché global, Interfaz de usuario (Front Office), Interfaz de administración (Back Office) y "Webservice". Están activados por defecto en el módulo. El interruptor global controla el uso de su caché y los de ámbito restringen los contextos de solicitud correspondientes.

Usa Caché > Capas para controlar capas, Navegador para inspeccionar entradas, Páginas para los datos de caché de páginas y Preajustes para revisar preajustes disponibles. Lee un preajuste antes de aplicarlo porque cambia varios ajustes a la vez.

Abre Configuración > Almacenamiento en caché de fragmentos.

Un desarrollador puede almacenar un fragmento de categoría incluyendo su identidad:

{mpr_cache id="category_products" ttl=3600 tags=["product","category"] vary=["category" => $category.id]}
  {foreach from=$products item=product}
    {include file='catalog/_partials/miniatures/product.tpl' product=$product}
  {/foreach}
{/mpr_cache}

La clave de caché incluye idioma, tienda, moneda y grupo de clientes predeterminado salvo que se desactive la inclusión del contexto. Añade a vary cualquier otro valor que afecte al fragmento. No incluyas marcado específico de clientes en un fragmento compartido sin variación adecuada o sustitución dinámica.

Usa marcadores dinámicos para los valores compatibles de la solicitud actual:

<span class="cart-count">{mpr_dynamic name="cart_count"}</span>
<span class="cart-total">{mpr_dynamic name="cart_total"}</span>
<span class="customer-name">{mpr_dynamic name="customer_name" default=""}</span>
<span class="csrf-token">{mpr_dynamic name="csrf_token"}</span>

Los nombres compatibles también abarcan valores de cliente, idioma, moneda y tienda. Un proveedor personalizado puede usar actionMPRDynamicContent:

public function hookActionMPRDynamicContent($params)
{
    if (($params['name'] ?? '') === 'loyalty_points') {
        return (string) $this->getCurrentCustomerPoints();
    }
    return $params['default'] ?? '';
}

Abre Configuración > Caché de consultas.

Usa Consultas para inspeccionar las consultas recopiladas. Activa el perfilado al diagnosticar un problema y revisa su sobrecarga antes de mantenerlo activo.

Abre Configuración > Optimización de recursos. Activa y prueba un cambio cada vez en tu tema.

Activar el CSS generado no inicia un navegador durante una solicitud de la tienda. Créalo con los procesos separados. Estado del CSS inicial generado informa de su disponibilidad. El proceso "Critical CSS" necesita Node 22.12 o posterior y su entorno de navegador configurado. Sigue sus instrucciones incluidas para generar y desplegar.

Estos comandos CLI inspeccionan o inicializan el trabajo; no completan por sí mismos la generación mediante navegador:

php modules/mprperformancerevolution/cli/critical-css.php --targets
php modules/mprperformancerevolution/cli/critical-css.php --seed
php modules/mprperformancerevolution/cli/critical-css.php --status
php modules/mprperformancerevolution/cli/page-type-css.php --status

Reconstruye los datos CSS offline después de cambios relevantes en hojas de estilo, plantillas, scripts o contenido. Si los datos generados faltan o no son válidos, el módulo vuelve a las hojas completas.

Abre Configuración > Navegación instantánea.

La política integrada excluye carrito, pago, cuenta, acceso, enlaces con parámetros de consulta, archivos, enlaces nofollow y herramientas del módulo. El servidor también valida las solicitudes especulativas.

Abre Configuración > Imágenes.

La codificación AVIF durante la ejecución puede usar GD imageavif o Imagick con soporte AVIF. GD AVIF suele requerir PHP 8.1 o posterior. La generación por lotes también puede usar el backend Python incluido si están disponibles Python, Pillow, pillow_avif y la ejecución de procesos. WebP usa funciones GD compatibles.

Se aplican valores predeterminados internos adicionales a las imágenes de los listados: el filtro de tipos está desactivado por defecto y la lista es default_sm,default_md,default_lg,home_default,product_main,product_main_2x. No son campos visibles separados del formulario estándar Imágenes. Asimismo, la tasa interna de muestreo RUM es 0.1.

Para un lote controlado, ejecuta desde la tienda instalada:

php modules/mprperformancerevolution/scripts/generate-images-cli.php --quality=50 --webp-quality=80 --webp --limit=100

Usa --path=PATH, repetible, para restringir el trabajo dentro de la raíz de la tienda. --force regenera variantes existentes. Revisa los recuentos de conversiones, omisiones y errores antes de un lote mayor.

Abre Configuración > Caché de páginas de origen.

Es una auténtica caché de página completa en origen que usa el gestor del módulo. Es independiente de la caché HTML CDN y los fragmentos Smarty. Carrito, cuenta, pago, administración, AJAX, cookies de sesión no seguras y consultas desconocidas la omiten según la política de ejecución.

Actívala solo tras comprobar una página anónima limpia y los casos de omisión requeridos. Solicita dos veces la misma URL anónima e inspecciona X-MPR-PageCache. Después prueba acceso, creación del carrito, cambios de moneda/idioma y páginas privadas en sesiones de navegador separadas.

Abre Configuración > Caché de páginas CDN. Empieza con la política de cookies predeterminada "Strict".

Después de guardar, usa las Acciones CDN para aplicar y verificar las reglas e inspeccionar el resultado. Un cambio en la política de cookies reaplica las reglas y purga la zona. No consideres una transición fallida o pendiente como configuración terminada.

Prueba por separado la caché anónima y la omisión privada. Accesos, carritos, pago, cuentas, AJAX, rutas protegidas de módulos, personalización y estados de solicitud no seguros no deben compartir HTML anónimo. Mantén el periodo de conservación de recursos generados mientras HTML duradero siga refiriéndose a recursos antiguos.

El módulo envía cabeceras de caché y realiza las operaciones Cloudflare compatibles. Cómo cachea realmente el edge sigue dependiendo de tus reglas de zona, de los permisos del token API y de si una respuesta se puede cachear. Algunos métodos de purga de Cloudflare no están disponibles en todos los planes.

Abre Configuración > Precalentamiento de caché.

Copia el token realmente generado al programador del servidor. Un comando habitual del ejecutor es:

* * * * * php /var/www/html/modules/mprperformancerevolution/cron.php --token=YOUR_TOKEN --max-tasks=20 --max-seconds=55 --context=cron

Ajusta las rutas PHP y de la tienda. El ejecutor también procesa limpiezas declaradas, invalidaciones/purgas pendientes, trabajos de imágenes y mantenimiento CSS según el estado de las tareas. Activar una función y programar su tarea son comprobaciones separadas.

Una pasada manual tras desplegar puede usar:

php modules/mprperformancerevolution/cli/warm-cache.php --full --both --url-set=all --concurrency=1 --resolve-ip=127.0.0.1 --max-seconds=120

Usa --edge solo para edge, --cron para modo cron y --help para los argumentos compatibles. Lee el resumen de estados desactivados, fallidos o de escritura externa bloqueada. Una pasada pausada o limitada por presupuesto puede ser normal con valores predeterminados conservadores.

Abre Configuración > Monitoreo. Activar la recogida de métricas está activado por defecto, Conservación de métricas vale 30 días y Métricas de usuarios reales está activado. La tasa interna de muestreo RUM es del 10 por ciento. Las métricas del panel incluyen estado del adaptador, aciertos, fallos, tasa de aciertos, memoria, consultas lentas y medidas disponibles TTFB, FCP, LCP, CLS e INP.

Abre Configuración > Modo dev para suspender temporalmente los ajustes de caché. Modo dev empieza inactivo, guarda la configuración anterior y la restaura al desactivarse o caducar. Modo depuración de empleado empieza desactivado y habilita la salida de desarrollo de PrestaShop solo para empleados reconocidos con la cookie de depuración validada del módulo.

En Configuración > Depuración, Superposición de depuración, Activar el panel de depuración y Panel del perfilador están desactivados por defecto. Direcciones IP permitidas y ID de empleados permitidos empiezan vacíos. Perfilador: solo empleados está activado por defecto. Restringe los diagnósticos durante las pruebas y desactívalos al terminar.

Hay archivos opcionales del perfilador en optional-overrides/classes/Hook.php y optional-overrides/classes/db/Db.php. Usa el procedimiento protegido de instalación de overrides del perfilador para comprobar los existentes. Limpia el estado de clases/caché de PrestaShop según ese procedimiento. No sobrescribas overrides ajenos con una copia incondicional. Retira los overrides opcionales mediante el mismo procedimiento cuando dejen de ser necesarios.

Después de cada cambio de configuración, comprueba inicio, listado, producto, carrito y pago, y confirma cabeceras de caché y razones de omisión en sesiones de cliente separadas. Los hooks de catálogo, stock, precios y contenido invalidan etiquetas compatibles, pero los cambios en tema, integraciones y reglas CDN pueden requerir vaciado explícito.

Si el adaptador difiere de tu selección, inspecciona la disponibilidad del backend y la resolución del punto de conexión Redis. Si una página omite la caché, lee su razón diagnóstica antes de aumentar límites o cambiar la política de cookies. Para HTML obsoleto, comprueba origen y edge por separado y confirma que terminó la invalidación.

Si la agrupación, el aplazamiento o cambios CSS rompen un componente, desactiva el ajuste afectado, vacía sus archivos generados o su caché y vuelve a probar. Para CSS generado, revisa el estado y el registro del proceso. Para errores de imágenes, comprueba codificadores y permisos de escritura. Para calentamiento pendiente, revisa ejecutor, interruptor de función, carga del host y presupuestos.

Antes de desinstalar, retira los overrides opcionales del perfilador que instalaste y revisa las reglas CDN activas. Desactiva o elimina las reglas edge del módulo mediante el procedimiento CDN para que la zona no siga almacenando rutas privadas sin la protección de origen prevista. Respalda la configuración y los datos generados que necesites.

La desinstalación elimina tareas programadas, arranque de depuración de empleados, clase de caché Redis instalada, menús y tablas del módulo. Revisa después la configuración de caché del núcleo de PrestaShop y cualquier configuración CDN externa; no supongas que Module Manager deshace toda la configuración remota.

Requiere PrestaShop 1.6.1 o posterior y PHP 7.1 o posterior.