DfRedirects — Redirecciones 301 y captura de 404 para Shopware 6

Presentación

DfRedirects añade a Shopware 6 un verdadero gestor de redirecciones: reglas 301, 302, 307, 308 y 410 con coincidencia exacta, comodín o expresión regular, captura automática de los errores 404 que encuentran tus visitantes, sugerencias de destino por similitud de URL e importación CSV masiva. El plugin funciona en Shopware 6.5, 6.6 y 6.7 con un único ZIP.

Instalación

Desde la administración

1. Ve a Extensiones > Mis extensiones.
2. Haz clic en Subir extensión y selecciona el archivo DfRedirects-1.0.0.zip.
3. Haz clic en Instalar y activa la extensión.

Desde la línea de comandos

bin/console plugin:refresh
bin/console plugin:install --activate DfRedirects
bin/build-administration.sh
bin/console cache:clear

La instalación crea dos tablas dedicadas: df_redirect (tus reglas de redirección) y df_redirect_404 (el registro de las URL no encontradas).

Configuración general

Abre Extensiones > Mis extensiones > DfRedirects > Configurar. Hay tres ajustes disponibles:

• Activar el registro de 404: guarda las URL no encontradas que visitan tus usuarios. Activado por defecto.
• Patrones ignorados: una entrada por línea. Las URL coincidentes no se redirigen ni se registran. Se aceptan comodines (por ejemplo /api-legacy/*); una simple cadena también sirve, se busca dentro de la URL.
• Conservar la query string: traslada los parámetros de la URL (por ejemplo ?utm_source=newsletter) a la URL de destino. Activado por defecto, sin efecto en las respuestas 410.

Crear una redirección

El módulo se encuentra en el menú Contenidos > Redirecciones de la administración. Haz clic en Añadir redirección y rellena:

• URL de origen: la ruta a interceptar, relativa a la raíz del canal de venta (por ejemplo /productos-antiguos/zapatillas-piel).
• URL de destino: la ruta o URL absoluta de destino. Este campo se oculta con el código 410.
• Código HTTP: 301 (permanente), 302 (temporal), 307, 308 o 410 (página eliminada definitivamente).
• Tipo de coincidencia: exacto, comodín o regex (ver la sección siguiente).
• Prioridad: orden de evaluación de los patrones, de mayor a menor. Sin efecto en las coincidencias exactas.
• Canal de venta: déjalo vacío para aplicar la regla a toda la tienda, o elige un canal concreto.
• Activo: permite desactivar una regla sin eliminarla.

Los tres modos de coincidencia

Exacto

La URL de origen debe coincidir con la ruta solicitada. La barra final se tolera en ambos sentidos: /mi-pagina y /mi-pagina/ activan la misma regla. Es el modo recomendado: cubre la gran mayoría de los casos y es el más rápido.

Comodín

El asterisco * captura cualquier porción de la URL. En la URL de destino, un asterisco en la misma posición reutiliza el valor capturado.

Origen  : /coleccion/verano-*
Destino : /novedades/*

/coleccion/verano-vestidos →  /novedades/vestidos
/coleccion/verano-shorts   →  /novedades/shorts

Regex

Para los casos más finos, introduce una expresión regular (sin delimitadores) y referencia los grupos capturados en el destino con $1, $2, etc.

Origen  : ^/producto/([0-9]+)-(.+)$
Destino : /p/$2

Orden de evaluación

1. Coincidencias exactas asociadas al canal de venta actual.
2. Coincidencias exactas globales.
3. Patrones comodín y regex activos, ordenados por prioridad descendente.

Registro de 404

La pestaña Registro de 404 lista todas las URL no encontradas con las que se topan tus visitantes. Cada entrada está deduplicada: una misma URL aparece una sola vez, con su número de impactos, el referer de la última visita y la fecha del último paso. Ordena por número de impactos para atender primero las URL rotas que más tráfico te cuestan.

Hay dos acciones disponibles en cada fila:

• Crear una redirección: abre el formulario con la URL de origen rellenada y las sugerencias de destino ya cargadas. Tras guardar, el 404 se marca automáticamente como resuelto.
• Marcar como resuelto: archiva la entrada sin crear una regla, por ejemplo para una URL que nunca existió.

Un interruptor Mostrar resueltos permite volver a ver las entradas tratadas.

Sugerencias de destino

En cuanto introduces una URL de origen, el plugin propone hasta cinco destinos ordenados por puntuación de similitud. El cálculo compara el último segmento de la URL rota con tus URL SEO canónicas: un prefiltro en base de datos reduce el conjunto de candidatos y después una puntuación de proximidad textual los ordena. Un clic en una sugerencia rellena el campo de destino.

Importación CSV

El botón Importar abre una ventana que acepta un archivo o un pegado directo. El formato esperado tiene cinco columnas:

origen;destino;codigo;tipo;activo
/pagina-antigua;/pagina-nueva;301;exact;1
/coleccion/verano-*;/novedades/*;301;wildcard;1
/producto-eliminado;;410;exact;1

• Delimitador: punto y coma o coma, detectado automáticamente.
• Línea de cabecera: opcional, se omite si se detecta.
• Columnas 3 a 5: opcionales. Por defecto: código 301, tipo exacto, regla activa.
• Tipo: se deduce automáticamente si el origen contiene un asterisco.
• Códigos aceptados: 301, 302, 307, 308 y 410. El destino puede quedar vacío para un 410.

La importación funciona como actualización: una regla existente con la misma URL de origen se actualiza en lugar de duplicarse. Las reglas importadas se crean con alcance global (todos los canales). Al finalizar, el plugin muestra cuántas líneas se crearon, actualizaron y omitieron, junto con el detalle de los errores encontrados.

Seguimiento del rendimiento

Cada regla cuenta sus activaciones y memoriza la fecha del último disparo. Una regla que lleva meses a cero suele poder archivarse; por el contrario, una regla muy solicitada señala una URL antigua todavía muy difundida, que puede merecer una corrección en origen (backlink, campaña, catálogo impreso).

Resolución de problemas

El módulo no aparece en el menú Contenidos

No se ejecutó la compilación de la administración tras la instalación. Lanza bin/build-administration.sh y vacía la caché de tu navegador.

Una redirección no se activa

1. Comprueba que la regla está activa y que su canal de venta coincide (o que es global).
2. Comprueba que la URL de origen es relativa a la raíz del canal: en un canal servido desde una subcarpeta, no incluyas el prefijo del dominio.
3. Comprueba que ningún patrón ignorado cubre esa URL.
4. Vacía la caché: bin/console cache:clear.
5. Asegúrate de que tu servidor web o tu CDN no apliquen ya una redirección aguas arriba: en ese caso la petición nunca llega a Shopware.

El registro de 404 sigue vacío

Comprueba que la opción Activar el registro de 404 está marcada en la configuración del plugin y que tus patrones ignorados no son demasiado amplios. Recuerda que los recursos estáticos se excluyen por diseño.

Un bucle de redirección

Se produce cuando una regla apunta a una URL que a su vez es redirigida de vuelta, directamente o mediante un patrón comodín demasiado amplio. Busca la URL de destino en la lista de orígenes y ajusta el patrón culpable.

Desinstalación

Al desinstalar, Shopware ofrece conservar los datos. Si desmarcas esa opción, las tablas df_redirect y df_redirect_404 se eliminan definitivamente, junto con todas tus reglas y el historial de 404. Exporta tus reglas antes si prevés una reinstalación.