Gestor de Tags Hreflang: configuración y ayuda

En tu Back Office, abre Módulos > "Module Manager", elige "Upload a module" y sube el ZIP del módulo. Instálalo y haz clic en "Configure". En versiones anteriores de PrestaShop, usa la página de módulos correspondiente.

"Configure" abre "Improve" > Hreflang > "Grupos". Abre Configuración para los ajustes de la tienda. En multitienda, selecciona una tienda antes de ver o guardar sus ajustes. El módulo inicializa cada tienda por separado.

El módulo genera enlaces a idiomas alternativos en el head de la página mediante displayHeader. No crea traducciones ni añade un bloque visible en la tienda. Prepara primero páginas traducidas y activas y códigos de idioma correctos.

Abre Configuración > General.

Haz clic en "Guardar ajustes de la tienda". Las alternativas nativas conectan las traducciones disponibles dentro de la tienda actual. El módulo usa la generación de enlaces de PrestaShop para las páginas de entidades admitidas. Los códigos de idioma provienen de language_code, con respaldo en iso_code, y se normalizan a minúsculas.

Los resultados de búsqueda, los listados filtrados, la paginación posterior a la página 1 y las páginas de módulos quedan fuera de las alternativas generadas. El módulo no genera enlaces de respaldo para otros tipos de páginas. En las páginas de catálogo aptas que gestiona, suprime los enlaces a idiomas alternativos del tema para evitar conjuntos duplicados.

Si SEO Revolution controla la generación de hreflang en esta tienda, la configuración muestra una advertencia y estos ajustes no cambian la salida en la tienda. Elige un solo responsable. Desactiva la generación de hreflang de SEO Revolution si quieres que la controle este módulo.

Abre Configuración > Exclusiones de páginas y usa "Excluir páginas e idiomas". La selección predeterminada está vacía y no excluye nada. Selecciona entidades o reglas del selector y haz clic en "Guardar ajustes de la tienda".

Seleccionar una categoría excluye la página de la categoría. Usa "Productos por categoría" si te refieres a los productos de esa categoría. Excluir el idioma actual suprime todo el conjunto de etiquetas de la página. Ejecuta la comprobación de exclusiones en Integridad si la pantalla indica que no se han podido actualizar las exclusiones.

Usa "Grupos" cuando las traducciones nativas no sean suficientes. Un grupo selecciona páginas de origen y asigna destinos por idioma. Puedes usar entidades de destino o URL personalizadas.

Por ejemplo, selecciona "Productos por categoría" para una categoría de ropa y restringe con un atributo Rojo. Esto se aplica a los productos coincidentes, en lugar de a todos los productos o a la propia página de categoría.

Usa "Elegir destino" o "Cambiar" en la tabla de idiomas. Las filas locales sin sustituciones usan "Misma página (automático)". "Borrar sustitución" restaura ese comportamiento. Usa Guardar grupo y revisa su estado y vista previa. Un grupo compartido necesita destinos aptos y acceso a todas las tiendas participantes. Las páginas coincidentes deben tener contenido equivalente; las URL recíprocas por sí solas no establecen esa equivalencia.

Abre Configuración > Conexiones automáticas. Esta configuración se aplica al conjunto de tiendas seleccionadas y tiene su propio botón de guardado.

Haz clic en "Guardar conexión automática". Las páginas con el mismo tipo de entidad e ID forman conjuntos recíprocos cuando están disponibles en las tiendas seleccionadas. Confirma que esos ID representen contenido equivalente. El módulo no inventa códigos regionales. Las páginas no preferidas con un código duplicado no generan salida. Los grupos manuales tienen prioridad. Un x-default compartido no disponible o asignado manualmente se omite del conjunto automático.

1. Abre un producto o una categoría traducidos en cada idioma y consulta su código fuente HTML.
2. Busca rel="alternate" y verifica los códigos de idioma, las URL de destino y la autorreferencia. Abre cada destino.
3. Comprueba x-default solo cuando su idioma/destino sea apto. La salida nativa necesita al menos dos destinos de idioma distintos. Las conexiones entre tiendas o los grupos pueden proporcionar alternativas para una tienda que, de otro modo, tendría un solo idioma.
4. Comprueba un listado filtrado y la página 2. El módulo no debería generar su conjunto de alternativas para esas variantes.
5. Si no aparecen etiquetas, comprueba el contexto de tienda, la licencia, "Generar etiquetas hreflang", Tipos de página, las exclusiones, el estado del grupo y el control por parte de SEO Revolution. Se omiten las páginas de destino desactivadas o no disponibles.
6. Si se rechaza el guardado, verifica los permisos de visualización/edición del empleado y el acceso a todas las tiendas participantes. Recarga un formulario caducado o no válido en vez de eludir sus comprobaciones de token.

El módulo genera las etiquetas en el head. No exporta hreflang en sitemaps. No añade JavaScript en la tienda para generar etiquetas.

La plantilla de origen es modules/mprhreflang/views/templates/hook/hreflang.tpl. Para personalizarla, coloca una copia en themes/your-theme/modules/mprhreflang/views/templates/hook/hreflang.tpl usando el mecanismo de sobrescritura de plantillas de módulos de tu tema.

La plantilla actual recibe el conjunto final, incluida cualquier fila x-default, en mprhreflang_links. Mantén el escape de la salida:

{if isset($mprhreflang_links)}
{foreach from=$mprhreflang_links item=link}
<link rel="alternate" hreflang="{$link.lang|escape:'html':'UTF-8'}" href="{$link.url|escape:'html':'UTF-8'}" />
{/foreach}
{/if}

No restaures el antiguo bucle separado mprhreflang_xdefault. Un conjunto resuelto podría contener en-us, fr-fr, de-de y x-default con sus URL completas correspondientes.

Desactiva "Generar etiquetas hreflang" por tienda para suspender la generación. Revisa las conexiones compartidas al retirar una tienda. Desinstala mediante "Module Manager" para eliminar el menú del módulo, las preferencias, la configuración y el esquema propio del módulo. Guarda las definiciones de grupo que necesites antes de desinstalar. Licencia, Soporte, Actualizar e Integridad están disponibles en el menú Hreflang.

Requiere PrestaShop 1.6.1 o posterior y PHP 7.1 o posterior.