PS PrestaShop Principiante

Hreflang Manager: etiquetas hreflang multilingües y multitienda

Instalar, configurar, previsualizar y auditar las etiquetas hreflang de PrestaShop, sin override.

Actualizado Versión del módulo 2.0.0

Presentación

Hreflang Manager escribe las etiquetas <link rel="alternate" hreflang> de sus páginas para indicar a Google las versiones lingüísticas y regionales de una misma página. Escribe un único conjunto por página, solo en las páginas canónicas e indexables, y solo hacia las versiones que existen realmente.

Compatible con PrestaShop 1.7.8 a 9.x, tienda única y multitienda (uno o varios dominios). La versión 2.0.0 no contiene ningún override y no modifica ningún archivo del tema.

Resumen de Hreflang Manager: puntuación, versiones activas y detección de conflictos (tema, SEO, sitemaps, override)
Resumen de Hreflang Manager

Novedades de la versión 2.0

  • Sin override: el módulo funciona con hooks. El override de FrontController de la 1.0.0 se retira al actualizar.
  • Un único conjunto de etiquetas: escrito en la variable del tema o mediante el hook displayHeader, con una protección que retira los duplicados.
  • Versiones comprobadas: nada hacia un producto inactivo, sin traducir o ausente de una tienda; nada en las 404, páginas noindex, listados filtrados ni combinaciones.
  • Back office rediseñado: asistente de configuración, mapa idioma × país → tienda, vista previa de las etiquetas, auditoría con puntuación, detección de conflictos, modo de prueba.
  • Sitemap XML hreflang opcional, caché por página, compatibilidad con PrestaShop 1.7.8 e interfaz en 8 idiomas.

Instalación y actualización

  1. En Módulos > Gestor de módulos, haga clic en Subir un módulo y envíe el archivo ZIP.
  2. El módulo se abre en Parámetros de la tienda > Tráfico & SEO > Hreflang Manager.
  3. Mientras no haya ninguna versión configurada, no cambia nada en sus páginas. Inicie el Asistente de configuración.

La actualización desde la 1.0.0 conserva sus versiones y sus grupos. Los valores mal escritos se corrigen cuando la corrección es segura (en_UK pasa a en-GB, fr_BE pasa a fr-BE), se mantiene un solo x-default por grupo, el antiguo override se retira mediante el procedimiento de PrestaShop y el menú pasa a Tráfico & SEO. Se muestra un informe en la vista general.

En multitienda, instale el módulo en el contexto «Todas las tiendas» y compruebe que está activado en cada tienda de un grupo: de lo contrario, sus páginas no remiten a las demás versiones y Google ignora los pares. El detector de conflictos lo señala.

Asistente de configuración

El asistente lee sus tiendas, sus dominios (HTTP o HTTPS), su país y sus idiomas activos, y propone un valor hreflang para cada par tienda e idioma:

  • un idioma vendido en una sola tienda recibe solo el idioma (fr): se dirige a todos los francófonos;
  • un idioma vendido en varias tiendas recibe el país de cada tienda (fr-FR, fr-BE) para que Google muestre la tienda adecuada;
  • el x-default propuesto es el idioma principal de la tienda predeterminada.

Los valores se comprueban durante la introducción. Nada cambia en sus páginas antes de guardar.

Asistente de configuración: tiendas, dominios e idiomas detectados, valores hreflang y x-default propuestos
Asistente de configuración

Versiones, grupos y mapa

Cada fila es una versión: una tienda, un idioma, un valor hreflang, un origen público opcional (si la tienda se sirve bajo otro dominio), un interruptor de activación y la elección del x-default. Una sola versión x-default por grupo.

El mapa idioma × país → tienda muestra qué tienda atiende a qué mercado. Las versiones en gris no se imprimen (inactivas o con el idioma desactivado en la tienda).

Los grupos vinculan tiendas que apuntan unas a otras. El contenido se empareja por id (catálogo compartido) o únicamente mediante mapeo manual (catálogos separados). El mapeo vincula dos ids de un producto, una categoría, una página CMS, una marca o un proveedor; funciona en ambos sentidos y se mantiene coherente en todo el grupo.

Versiones y mapa idioma × país → tienda, con validación de los códigos hreflang al escribir
Versiones y mapa idioma × país → tienda, con validación de los códigos hreflang al escribir

Reglas aplicadas

El módulo sigue las directrices de Google Search Central sobre las versiones localizadas:

  • URL absolutas con el protocolo y el dominio de cada tienda; espacios y caracteres no permitidos codificados.
  • Autorreferencia y enlaces de retorno: cada versión enumera todas las demás y a sí misma, con el mismo conjunto en todas las versiones.
  • Códigos válidos: idioma ISO 639-1, país ISO 3166-1 alfa-2 opcional, escritura ISO 15924 opcional. en-UK, los guiones bajos, un país solo o es-419 se rechazan con una sugerencia.
  • Solo versiones existentes: producto activo y visible, categoría activa y accesible para los visitantes, página CMS activa e indexable, marca o proveedor activo, traducidos al idioma de destino.
  • Solo páginas canónicas e indexables: ninguna etiqueta en las 404, páginas noindex, listados filtrados u ordenados, URL de combinación, carrito, cuenta y búsqueda, ni cuando la etiqueta canonical designa otra dirección.
  • Paginación: la página 2 de una categoría apunta a la página 2 de las demás versiones (configurable).

Vista previa de las etiquetas

Introduzca una URL de su tienda o elija un ejemplo (inicio, producto, categoría, página 2, página CMS). El módulo lee la página desde el servidor y muestra el diagnóstico (página canónica, noindex, versión ausente…), cada etiqueta con su control y, en paralelo, el head esperado y el head realmente impreso. Solo se pueden leer los dominios de su instalación.

Vista previa de las etiquetas de una página de producto: etiquetas esperadas y mostradas, cada alternativa comprobada
Vista previa de las etiquetas de una página de producto
Extracto del código fuente de la sección head: etiquetas hreflang esperadas y las que muestra la página
Extracto del código fuente de la sección head

Auditoría

La auditoría lee una muestra de páginas de sus propios dominios (inicio, productos, categorías con página 2, páginas CMS, marcas, proveedores, otras páginas), cada una en todas sus versiones, y comprueba: respuesta 200, indexable, etiqueta canonical, valores, URL absolutas, autorreferencia, enlaces de retorno, duplicados, x-default y un único conjunto por página. Muestra una puntuación, los errores y advertencias agrupados por regla con la corrección necesaria, el historial de auditorías y una exportación CSV.

Ejecutada con el módulo en «Desactivado», la auditoría evalúa las etiquetas nativas de PrestaShop: la captura siguiente muestra este resultado en una tienda de demostración (enlaces de retorno ausentes en las páginas 2, x-default ausente).

Auditoría hreflang de las etiquetas nativas de PrestaShop: puntuación, errores, avisos y correcciones propuestas
Auditoría hreflang de las etiquetas nativas de PrestaShop

La auditoría no llama a ningún servicio externo y solo lee las direcciones declaradas en sus tiendas. Si el servidor no puede acceder a su propio dominio (Docker, NAT, DNS local), la petición pasa por la interfaz local del servidor con el mismo nombre de host.

Conflictos y otras fuentes

La vista general enumera lo que puede generar etiquetas hreflang además del módulo, sin modificar nunca sus ajustes:

  • el tema (Classic, Hummingbird y la mayoría de los temas imprimen $urls.alternative_langs);
  • DataFirefly All in One SEO si su opción «Gestionar hreflang» está activa: la protección mantiene un único conjunto y un botón ejecuta Hreflang Manager en último lugar;
  • los sitemaps de DataFirefly Sitemap o de la suite SEO que contienen alternativas;
  • los demás módulos que contienen código hreflang, el antiguo override de la 1.0.0, un módulo desactivado en una tienda del grupo, las tiendas servidas en HTTP.

El botón Comprobar las páginas de inicio ahora lee la página de inicio de cada tienda como un visitante y cuenta las etiquetas y los duplicados.

Ajustes

  • Estado: en línea, modo de prueba (visitantes y motores conservan las etiquetas originales; solo la vista previa y la auditoría ven las nuevas) o desactivado.
  • Dónde imprimir las etiquetas: automático (variable del tema si el tema la imprime; si no, hook displayHeader), variable del tema o hook.
  • Protección contra duplicados y retirada de las etiquetas de PrestaShop allí donde el módulo no las imprime (404, noindex, listados filtrados…).
  • Paginación, respeto de la etiqueta canonical, otras páginas con versiones (más vendidos, novedades, promociones, contacto, tiendas físicas, listados de marcas y de proveedores) y páginas de módulos autorizadas (module/controller).
  • Sitemap XML hreflang: opcional, uno por tienda, en la dirección /module/datafireflyhreflang/sitemap. Cada dirección enumera todas sus versiones con xhtml:link, incluida ella misma. Declárelo usted mismo en Google Search Console o en robots.txt.
  • Caché: las alternativas de una página se calculan una vez y después se leen en una sola consulta; se recalculan cuando se guarda un producto, una categoría, una página CMS, una marca o un proveedor, y por completo cuando cambia una versión, un grupo, un idioma o una tienda.
Ajustes: salida única, protección contra duplicados, paginación, sitemap XML hreflang y caché
Ajustes

Si DataFirefly Sitemap o la suite SEO también incluyen hreflang en su sitemap, declare a Google solo uno de esos sitemaps, o compruebe que indican lo mismo.

Seguridad y permisos

  • Cada modificación requiere el permiso «Modificar» en la pestaña Hreflang Manager y el token de seguridad del back office; un perfil de solo lectura puede consultar, previsualizar y exportar.
  • La vista previa y la auditoría rechazan cualquier dirección fuera de los dominios de la tienda (sin acceso a URL arbitrarias).
  • Las URL impresas en el head se escapan; la exportación CSV neutraliza las celdas que empiezan por =, +, - o @.

Desinstalación

La desinstalación elimina las 6 tablas del módulo (versiones, grupos, tiendas de los grupos, mapeo, caché, auditorías), sus ajustes y su pestaña. No hay que limpiar ningún archivo del tema ni ningún override.

Solución de problemas

Ninguna etiqueta en una página

Abra la vista previa en esa URL: el diagnóstico indica el motivo (página noindex, filtrada, de combinación, canonical hacia otra dirección, versión única, idioma sin versión, modo de prueba…).

Etiquetas duplicadas

Active la protección contra duplicados y consulte «Conflictos y otras fuentes»: un módulo o el tema imprime sus propias etiquetas.

Enlaces de retorno ausentes en la auditoría

Una versión está inactiva en un solo lado, el módulo está desactivado en una tienda del grupo o una caché de página completa sirve una página antigua. Vacíe la caché del módulo (Ajustes) y la de la tienda.

¿Te ha resultado útil esta página?

¿Sigues atascado? Contacta con soporte