DF Smart 404 — Documentación

Presentación

DF Smart 404 convierte la página «página no encontrada» de su tienda en un cruce de conversión. Cuando un visitante aterriza en una URL rota, el módulo analiza esa URL, extrae sus palabras clave y muestra los productos del catálogo que mejor coinciden, junto a un formulario de búsqueda ya precargado.

En paralelo, cada 404 se registra en un registro del back-office. Verá exactamente qué URL se rompen, cuántos visitantes las alcanzan y de dónde vienen. Desde ese registro, una redirección 301 hacia el producto correcto se crea con un clic.

Qué hace el módulo

• Inyecta un bloque de sugerencias de productos en la página 404 de su tema, sin sobrecargar ninguna plantilla.
• Precarga el formulario de búsqueda con las palabras clave humanizadas extraídas de la URL rota.
• Registra cada 404 con deduplicación, contador de hits, referer y user agent.
• Crea redirecciones 301 o 302 en un clic, con protección antibucle.
• Aplica esas redirecciones antes del dispatch de la página.

Requisitos

• PrestaShop 8.0 a 9.x
• PHP 7.4 o superior
• Sin dependencias externas, sin Composer

Instalación

1. Vaya a Módulos > Gestor de módulos.
2. Haga clic en Subir un módulo y suelte el archivo df404smart-1.0.0.zip.
3. Haga clic en Instalar.

Al instalar, el módulo crea dos tablas SQL (registro de 404 y redirecciones), registra tres hooks y añade un menú DF Smart 404 en el back-office con dos subpestañas.

El bloque está activo de inmediato en la página 404, con ajustes por defecto operativos. Puede probarlo visitando una URL inexistente de su tienda.

Configuración

Abra la página Configurar del módulo. Muestra primero cuatro indicadores de seguimiento, luego el formulario de ajustes.

Panel de control

• URL rotas a corregir — número de entradas con estado «nueva» en el registro.
• Hits 404 sobre esas URL — suma de visitas a las URL aún no tratadas.
• Redirecciones activas — número de reglas de redirección en servicio.
• Visitas rescatadas por las redirecciones — suma de hits interceptados por sus redirecciones.

Ajustes disponibles

• Enriquecer la página 404 — activa o desactiva la inyección del bloque de sugerencias.
• Mostrar el formulario de búsqueda — muestra el campo de búsqueda precargado dentro del bloque.
• Activar el motor de redirección — aplica las redirecciones creadas desde el registro. Desmarque esta casilla si ya utiliza un módulo de redirecciones de terceros.
• Número de sugerencias — entre 0 y 12 productos mostrados. El valor 0 desactiva las sugerencias conservando el formulario de búsqueda.
• Tipo de redirección por defecto — 301 permanente (recomendada para el SEO) o 302 temporal.
• Registrar el tráfico de bots — si se desactiva, los hits de rastreadores conocidos no se escriben en el registro.
• Retención del registro (días) — las entradas más antiguas se purgan automáticamente. Las reglas de redirección nunca se purgan.
• Patrones de exclusión — una expresión regular insensible a mayúsculas por línea. Las URL coincidentes nunca se registran.

Patrones de exclusión por defecto

El módulo se entrega con una lista de patrones que descartan el ruido generado por los escáneres de vulnerabilidades y las peticiones automatizadas: intentos sobre wp-admin, wp-login, xmlrpc, phpmyadmin, las carpetas .git, así como los recursos estáticos (imágenes, hojas de estilo, scripts). Añada sus propios patrones, uno por línea. Un patrón inválido se señala al guardar, con el número de línea correspondiente.

El bloque de sugerencias en el front

Cómo se seleccionan los productos

Cuando se produce un 404, el módulo divide los dos últimos segmentos de la URL en palabras clave. Las palabras vacías se descartan en cinco idiomas (francés, inglés, español, alemán, italiano), solo se conservan los tokens de al menos tres caracteres, y se excluyen los identificadores puramente numéricos.

Cada token restante se coteja luego con el catálogo mediante puntuación ponderada:

• coincidencia en el link_rewrite del producto: 4 puntos
• coincidencia en el nombre del producto: 3 puntos
• coincidencia en la referencia: 2 puntos

Los productos se ordenan por puntuación descendente, y solo se conservan aquellos con puntuación superior a cero.

El repliegue

Si ningún producto emerge del análisis — caso frecuente en URL muy cortas u oscuras — el módulo recurre automáticamente a los más vendidos. Si estos tampoco están disponibles (catálogo nuevo, estadísticas no calculadas), muestra los productos más recientes. El visitante ve siempre productos, nunca un bloque vacío.

El formulario de búsqueda

El campo de búsqueda viene precargado con la versión humanizada de las palabras clave de la URL. Un visitante que llega a /zapatillas-cuero-premium-edicion ya ve «zapatillas cuero premium edicion» en el campo.

El formulario apunta a la página de búsqueda nativa de su tema, con los parámetros de la query string correctamente transmitidos como campos ocultos. Sin conflicto con un módulo de búsqueda instantánea de terceros: este módulo no sobrecarga nada, utiliza el punto de entrada estándar de PrestaShop.

Dónde aparece el bloque

El módulo detecta la sección de contenido de la página 404 de su tema e inserta allí el bloque, justo debajo del mensaje nativo. Si la estructura del tema es atípica, varios repliegues sucesivos garantizan que el bloque permanezca por encima del pie de página. Ningún archivo del tema se modifica.

El registro de 404

Menú DF Smart 404 > Registro de 404.

Columnas

• URL rota — la ruta solicitada, normalizada.
• Hits — número de visitas a esta URL. La lista se ordena por hits descendentes por defecto: las URL más costosas aparecen primero.
• Último referer — de dónde venía el último visitante (Google, un sitio externo, una página interna).
• Estado — Nueva, Redirigida o Ignorada.
• Último hit — fecha de la última visita.

Deduplicación

La deduplicación se basa en un hash de la URL, delimitado por tienda. Mil visitas a la misma URL rota producen una sola línea con mil hits, nunca mil líneas. La escritura se realiza en una única consulta upsert.

Acciones disponibles en cada línea

• Redirección automática (icono de rayo) — crea al instante una redirección al producto más pertinente, vía AJAX, sin salir de la página. Esta acción solo se ofrece si la puntuación de coincidencia supera el umbral de confianza; de lo contrario, un mensaje le invita a usar el formulario guiado.
• Crear una redirección — abre el formulario guiado (ver más abajo).
• Ignorar — cambia la entrada al estado «ignorada». Desaparece de los indicadores pero sigue siendo consultable.
• Eliminar — borra la entrada del registro.

También están disponibles una acción masiva de eliminación y una exportación CSV desde la barra de herramientas.

Crear una redirección

La redirección automática

El botón de rayo calcula el mejor producto correspondiente a la URL rota. Si la puntuación supera el umbral de confianza interno, la redirección se crea de inmediato con el tipo por defecto configurado, y la entrada del registro pasa al estado «redirigida». Un mensaje de confirmación indica el producto de destino.

El umbral de confianza evita redirecciones arriesgadas. Una URL como /promo-verano-2024 probablemente no tendrá una coincidencia fiable: el módulo rechazará la redirección automática y le enviará al formulario guiado.

El formulario guiado

Muestra la URL rota, su número de hits, y luego la lista de productos sugeridos clasificados por puntuación. Cada sugerencia es un botón de radio, el primero preseleccionado. Un campo URL personalizada permite introducir cualquier destino: una categoría, una página CMS, una URL externa.

A continuación elige el tipo de redirección (301 o 302) y valida. El módulo verifica que el destino no esté vacío, que no apunte a la propia URL de origen (protección antibucle), y que no exista ya una redirección para esa fuente.

Gestionar las redirecciones

Menú DF Smart 404 > Redirecciones 404.

Esta pantalla ofrece un CRUD completo sobre sus reglas de redirección:

• URL de origen — la ruta rota (p. ej. /antigua-categoria/antiguo-producto).
• URL de destino — ruta o URL completa hacia la que redirigir.
• Tipo — 301 (permanente) o 302 (temporal).
• Hits — número de visitas interceptadas por esta regla. Es su medida directa de las visitas rescatadas.
• Activo — interruptor para desactivar una regla sin eliminarla.

Se aplican las mismas validaciones que en el formulario guiado: origen no vacío, sin bucle, sin duplicado de origen (el identificador actual se excluye del control al editar).

Funcionamiento del motor

Las redirecciones se evalúan antes del dispatch de la página, aguas arriba del controlador front. La ruta solicitada se normaliza, luego una búsqueda indexada sobre su hash localiza una regla activa para la tienda actual. Si una regla coincide, el contador de hits se incrementa y la redirección se emite con el código HTTP configurado.

Rendimiento

• El registro solo escribe ante un 404 real, en una única consulta upsert.
• El motor de redirección realiza una búsqueda indexada sobre hash: coste insignificante, incluso con cientos de reglas.
• La purga de entradas antiguas se activa aleatoriamente en aproximadamente el 1 % de los hits, para no bloquear nunca una petición de visitante.
• Los hits procedentes de bots pueden excluirse de la escritura, lo que reduce aún más la carga en tiendas muy rastreadas.

Multitienda

Todos los datos del módulo están delimitados por identificador de tienda: el registro, las redirecciones y las sugerencias. Cada tienda dispone de su propio registro, sus propias reglas y su propia configuración. Una URL rota en la tienda A no aparece en el registro de la tienda B.

RGPD

El registro guarda la URL rota, el referer y el user agent. No se almacena ninguna dirección IP, no se recoge ningún dato personal. La retención es configurable y la purga automática. El módulo no envía ningún dato a servicios externos.

Desinstalación

La desinstalación elimina las dos tablas del módulo (registro de 404 y redirecciones), las pestañas del back-office y la configuración. Las redirecciones creadas se perderán. Se solicita una confirmación antes de la operación.

Si prevé reinstalar el módulo o migrar, exporte primero sus redirecciones a CSV desde la pantalla de gestión.

Solución de problemas

El bloque no aparece en la página 404

• Compruebe que el ajuste Enriquecer la página 404 está activado.
• Vacíe la caché de PrestaShop (Parámetros avanzados > Rendimiento > Vaciar la caché).
• Asegúrese de que el tema usa el controlador pagenotfound estándar.

El bloque aparece bajo el pie de página

Este caso está tratado desde la versión 1.0.0: el módulo apunta a la sección de contenido y no a la etiqueta de cierre del contenedor principal. Si sigue observando este comportamiento, vacíe la caché Smarty y comunique la estructura de su tema al soporte.

No se sugiere ningún producto

• Compruebe que el Número de sugerencias no está fijado en 0.
• En un catálogo nuevo sin historial de ventas, el repliegue a los más vendidos está vacío: el módulo pasa entonces a los productos recientes. Asegúrese de tener al menos un producto activo y visible.

La redirección automática se niega a crearse

Es el comportamiento esperado cuando la puntuación de coincidencia es demasiado baja. Utilice el formulario guiado, que muestra las sugerencias incluso por debajo del umbral y permite introducir un destino personalizado.

Una redirección no se aplica

• Compruebe que el ajuste Activar el motor de redirección está marcado.
• Compruebe que la regla está activa en la pantalla de gestión.
• Compruebe que la regla pertenece a la tienda correcta en contexto multitienda.
• Si hay otro módulo de redirecciones instalado, puede interceptar la petición antes.

Soporte

12 meses de actualizaciones y 12 meses de soporte por correo electrónico están incluidos con su licencia. El código fuente PHP completo se entrega sin ofuscar.