Tags Alt SEO automáticos para imágenes: configuración y ayuda

Sube el ZIP en Módulos > "Module Manager" > "Upload a module". Instálalo y haz clic en Configurar para abrir el panel. Abre "Improve" > Etiquetas alt SEO de imágenes > Configuración para editar los ajustes.

El texto alt usa los datos de imágenes de producto o categoría proporcionados por PrestaShop y mostrados por tu tema. La plantilla de categoría se aplica desde PrestaShop 9.1.

Haz clic en Guardar. Los resultados largos se acortan al límite de caracteres. El generador usa un límite de palabra cercano cuando hay un espacio en el último 30 por ciento de ese límite.

Usa estas variables de producto cuando los campos correspondientes existan en el producto presentado:

{product_name}, {manufacturer}, {category}, {reference}, {ean13}, {isbn}, {upc}, {mpn}

Usa {image_position} para numerar imágenes de galería en la ficha de producto. Las posiciones empiezan en 1 según el orden de iteración de la galería. La portada, la imagen predeterminada y el texto de listados no reciben esta variable.

Las plantillas de categoría aceptan {category_name} y {category_description}. La variable de descripción elimina las etiquetas HTML.

Por ejemplo:

Product Page Template: {product_name} - {manufacturer} - Image {image_position}
Product Listing Template: {product_name} in {category}
Category Image Template: {category_name}

Como el primer ejemplo también se aplica a la portada, la palabra literal Image puede quedar sin número allí. Usa {product_name} - {manufacturer} si quieres la misma frase completa en todos los contextos de imágenes de producto.

También puedes usar identificadores del catálogo:

{product_name} - {reference}
{product_name} - {manufacturer} - {ean13}
{product_name} - {mpn}

Las variables ausentes se convierten en cadenas vacías. El generador elimina HTML de los valores, decodifica entidades, compacta espacios y limpia los separadores - y | repetidos o en los extremos. Para un producto llamado Classic Linen Shirt, {product_name} - {manufacturer} produce Classic Linen Shirt - Northwear si el fabricante es Northwear. Produce Classic Linen Shirt si falta el fabricante.

Elige un producto con una leyenda de imagen guardada vacía. Deja Sobrescribir etiquetas alt existentes en No y guarda una plantilla con un campo de producto reconocible. Vacía la caché de páginas y abre el producto y un listado que lo contenga.

Inspecciona el atributo alt de la imagen renderizada. En las fichas de producto, el módulo actualiza cover, default_image y las entradas de images. En los listados actualiza esas mismas estructuras cuando existen. El tema debe usar sus valores legend en el marcado de las imágenes.

Para comprobar la conservación, abre una imagen con una leyenda manual existente. Debe mantenerla si la sustitución está desactivada. Para probar la sustitución, activa temporalmente Sobrescribir etiquetas alt existentes, vuelve a inspeccionar la salida y restaura el modo deseado.

Los textos alt de categorías se aplican mediante el hook actionPresentCategory, que PrestaShop llama a partir de la versión 9.1. En versiones anteriores, la plantilla de categoría se guarda, pero las imágenes de categoría conservan su texto alt actual.

Las leyendas generadas se asignan durante el renderizado. No se escriben en los registros de leyendas de imágenes del catálogo. El módulo construye texto a partir de los datos del catálogo y no analiza el contenido de las imágenes.

Si el tema construye sus propias etiquetas de imagen, usa la leyenda presentada para alt. Por ejemplo, dentro del marcado de la portada correspondiente:

alt="{$product.cover.legend|escape:'html':'UTF-8'}"

Usa la leyenda de cada imagen correspondiente al renderizar un bucle de galería. No uses la leyenda de portada para todas las entradas si necesitas valores de {image_position}.

Confirma que Activar módulo está en Sí. Comprueba si la imagen ya tiene leyenda y si la sustitución está desactivada. Confirma que la página usa actionPresentProduct o actionPresentProductListing y que el tema lee la leyenda modificada.

Si una variable está vacía, inspecciona el campo presentado. Las variables de fabricante y categoría leen manufacturer_name y category_name; un presentador personalizado puede omitirlos. Las variables no admitidas se eliminan. Si el resultado generado está vacío, el hook deja los datos de imagen intactos.

Si la salida parece antigua, vacía la caché de páginas o plantillas de la tienda. Usa la página "Integrity" del módulo para comprobar la infraestructura de configuración y los valores de las plantillas. Puede reparar valores obligatorios ausentes. Las plantillas de reparación difieren de las de instalación: "Product Page" pasa a {product_name} - {manufacturer} - {category}, "Product Listing" a {product_name} in {category} y "Category Image" a {category_name} category image. Revísalas después de reparar.

Establece Activar módulo en No para detener la generación y conservar tus plantillas. También puedes desactivar el módulo en "Module Manager".

Desinstálalo mediante "Module Manager" cuando ya no lo necesites. La desinstalación elimina el menú, la configuración y las preferencias de administración del módulo. Las leyendas originales del catálogo se conservan porque la generación no las sobrescribió en el almacenamiento.