Enlazado Interno Automático para Shopware 6

Presentación

DfInternalLinking automatiza el enlazado interno de su tienda Shopware 6. Usted define reglas que asocian una palabra clave a una página de destino (producto, categoría o URL libre), y el plugin convierte las apariciones de esa palabra clave en enlaces contextuales dentro de sus descripciones de productos y bloques de contenido CMS.

Compatibilidad

• Shopware 6.5.x, 6.6.x y 6.7.x
• PHP 8.1 o superior, según los requisitos de su versión de Shopware
• Multicanal: configuración independiente por canal de venta
• Administración traducida al inglés, alemán, francés, español e italiano

Instalación

Desde la administración

1. Vaya a Extensiones > Mis extensiones.
2. Haga clic en Subir extensión y seleccione el archivo ZIP del plugin.
3. Haga clic en Instalar y active la extensión con el interruptor.

Desde la línea de comandos

Descomprima la carpeta del plugin en custom/plugins/ y ejecute:

bin/console plugin:refresh
bin/console plugin:install --activate DfInternalLinking
bin/console cache:clear

Si instala desde el código fuente en lugar de un ZIP precompilado, reconstruya la administración:

./bin/build-administration.sh

Configuración general

Abra Ajustes > Sistema > Extensiones y luego los ajustes de DfInternalLinking. Cada opción puede definirse de forma global o por canal de venta.

• Activar el enlazado — activa o desactiva la inyección de enlaces. Valor por defecto: activado.
• Número máximo de enlaces por página — presupuesto global de enlaces inyectados en una misma página, en todas las reglas. Valor por defecto: 5.
• Modo silo — solo aplica una regla si su destino comparte una rama de categoría con la página actual. Valor por defecto: desactivado.
• Añadir nofollow — añade el atributo rel nofollow a los enlaces generados. Valor por defecto: desactivado.
• Clase CSS de los enlaces — clase aplicada a cada enlace generado, para darle estilo en su tema. Valor por defecto: df-internal-link.

Crear una regla de palabra clave

El plugin añade una entrada Enlazado interno al menú Marketing de la administración. Haga clic en Añadir regla para abrir el formulario.

• Palabra clave — la expresión que se detectará en sus contenidos. La detección no distingue mayúsculas y respeta los límites de palabra.
• Tipo de destino — Producto, Categoría o URL personalizada.
• Producto / categoría de destino — el selector mostrado depende del tipo elegido. La URL SEO canónica la genera automáticamente Shopware para el canal actual.
• URL de destino — campo mostrado solo para el tipo URL personalizada. Acepta una URL absoluta o una ruta relativa.
• Número máximo de enlaces por página — tope propio de esta regla, aplicado además del presupuesto global.
• Prioridad — las reglas se procesan por prioridad ascendente. A igual prioridad, la palabra clave más larga se aplica primero.
• Idioma — restringe la regla a un solo idioma. Déjelo vacío para aplicarla a todos.
• Canal de venta — restringe la regla a un solo canal. Déjelo vacío para aplicarla a todos.
• Activo — desactive temporalmente una regla sin eliminarla.

Dónde se inyectan los enlaces

El plugin procesa los siguientes contenidos:

• La descripción del producto en las páginas de producto
• Los bloques de contenido de tipo texto y HTML de las páginas de producto, de navegación (categorías) y landing

El análisis se realiza sobre el árbol HTML y solo procesa los nodos de texto. Las siguientes zonas se ignoran siempre:

• El interior de los enlaces existentes
• Los títulos de nivel 1 a 6
• Las etiquetas de script y de estilo
• Los botones

Dos salvaguardas completan este comportamiento: los límites de palabra Unicode impiden cualquier reemplazo dentro de una palabra, y una página nunca se enlaza a sí misma.

El modo silo

El modo silo está pensado para catálogos estructurados en universos temáticos. Cuando está activado, una regla solo se aplica si su destino comparte al menos una rama de categoría con la página que se está renderizando.

En la práctica, en una ficha de producto ubicada en la rama Senderismo, solo se aplicarán las reglas que apunten a otros productos o categorías de esa rama. Las reglas que apunten a otra rama se ignoran. Esto concentra la autoridad de enlace dentro de cada silo y refuerza la coherencia temática percibida por los motores de búsqueda.

El informe de páginas huérfanas

Desde la lista de reglas, haga clic en Informe páginas huérfanas. El informe enumera:

• Los productos activos que ninguna regla activa apunta
• Las categorías activas de tipo página que ninguna regla activa apunta

Tres estadísticas acompañan cada tabla: el número total de elementos activos, el número de elementos enlazados y el número de huérfanos. Utilice este informe como hoja de ruta: cada página huérfana es una página que no recibe ningún enlace interno de su catálogo.

Caché y puesta en producción

Vacíe la caché tras una sesión de edición de reglas:

bin/console cache:clear

También puede usar el botón de vaciado de caché disponible en la administración de Shopware.

Resolución de problemas

No aparece ningún enlace en la tienda

• Compruebe que el enlazado está activado en la configuración para el canal de venta correspondiente.
• Compruebe que la regla está activa y que su idioma y canal coinciden con la página consultada.
• Vacíe la caché del storefront.
• Asegúrese de que la palabra clave está realmente presente en la descripción, fuera de un enlace o un título.

Menos enlaces de los previstos

Se ha alcanzado el presupuesto global por página. Aumente el valor en la configuración o reduzca el tope de las reglas menos prioritarias.

Una regla se ignora en algunas páginas

Probablemente el modo silo esté activo y el destino de la regla pertenezca a otra rama de categoría. Desactive el modo silo o vincule el destino a la rama correcta.

Una palabra clave enlaza al lugar equivocado

Dos reglas concurrentes apuntan al mismo texto. Ajuste la prioridad: el valor más bajo se procesa primero.

Desinstalación

Al desinstalar, si no marca la opción de conservación de datos, la tabla de reglas se elimina. Sus descripciones de productos y sus contenidos CMS permanecen intactos, ya que nunca fueron modificados.