Opciones de Imagen

Controla qué tamaño de imagen, cuántas imágenes y en qué orden aparecen tus productos en el feed del catálogo de Facebook e Instagram.

nota

Disponible desde v1.0.0

Descripción general

Cada entrada de producto en el feed requiere al menos una URL de imagen. Facebook también acepta hasta 10 URLs de imagen adicionales por producto a través del campo additional_image_link, que utiliza para mostrar más ángulos en los anuncios dinámicos y el catálogo de la tienda.

La pestaña Images Options en la configuración del módulo te permite decidir qué formato de imagen de PrestaShop servir, si verificar que los archivos de imagen existen en disco antes de incluirlos, cómo codificar las URLs y cuántas imágenes incluir por producto. Configurar correctamente estos ajustes afecta tanto a la calidad de tus anuncios como al tiempo que tarda en generarse el feed.

Configuración

Ve a Módulos > Gestor de módulos, busca Facebook & Instagram Product Catalogue Feed Pro y haz clic en Configurar. A continuación, haz clic en la pestaña Images Options.

Campo	Valores	Por defecto	Descripción
Select image size to show with products	Cualquier tipo de imagen de PS registrado para productos	fpf_image (si está disponible)	El formato de miniatura de PrestaShop utilizado para construir las URLs de imagen en el feed.
Disable check image exists	Activado / Desactivado	Desactivado	Cuando está desactivado, el módulo verifica que el archivo físico existe en disco antes de incluir la imagen. Actívalo para omitir la comprobación.
Disable image URL encoding	Activado / Desactivado	Desactivado	Cuando está desactivado, el módulo aplica transliteración iconv para eliminar caracteres no ASCII de las URLs de imagen. Actívalo para conservar los caracteres especiales tal como están.
Disable Additional Images	Activado / Desactivado	Desactivado	Cuando está desactivado, todas las imágenes adicionales del producto se incluyen como entradas additional_image_link. Actívalo para exportar solo la imagen de portada.
Ignore cover?	Activado / Desactivado	Desactivado	Cuando está activado, el módulo ignora la imagen de portada designada del producto y utiliza en su lugar la primera imagen según el orden de posición como imagen principal.
Images limit	Entero	0 (sin límite)	Número máximo de imágenes (portada + adicionales) a incluir por producto. Establece 0 para incluir todas las imágenes disponibles.
Image Position Start	Entero	0 (desactivado)	Índice de posición desde el que empezar al seleccionar imágenes. Establece 0 para empezar desde la portada. Cualquier valor mayor que 0 activa automáticamente Ignore cover.

Recomendación de tamaño de imagen: Facebook funciona mejor con imágenes cuadradas o casi cuadradas. Elige un tipo de imagen con una relación de aspecto cercana a 1:1. Si ninguno de los tipos existentes coincide, el módulo instala un tipo fpf_image dedicado — pero debes regenerar las miniaturas en PrestaShop (Diseño > Preferencias de imágenes) después de seleccionarlo.

Cómo funciona cada ajuste

Selector de tipo de imagen

PrestaShop almacena las imágenes de los productos en múltiples tamaños pregenerados (miniaturas). El selector lista todos los tipos de imagen registrados para el contexto "products". El módulo utiliza el nombre del tipo seleccionado al llamar a getImageLink() de PrestaShop para construir la URL de cada producto.

Si seleccionas fpf_image, debes regenerar las miniaturas en el Back Office al menos una vez — de lo contrario, esos archivos no existirán en disco y aparecerán errores de imagen en el feed.

WebP y AVIF: PrestaShop puede almacenar imágenes en WebP o AVIF según la configuración de calidad de imagen (Diseño > Preferencias de imágenes > Formato de imagen). El importador de catálogos de Facebook no acepta de forma fiable URLs en WebP o AVIF para todos los formatos de anuncio. Si usas un formato de imagen moderno en tu tienda, activa Disable check image exists para que el módulo no omita silenciosamente imágenes que no encuentra como .jpg, y verifica en Facebook Commerce Manager que las imágenes se obtienen correctamente.

Disable check image exists

Por defecto, antes de añadir una URL de imagen al feed, el módulo verifica si el archivo .jpg (o .png) correspondiente existe en el sistema de archivos del servidor. Esto evita que las URLs de imagen rotas lleguen a Facebook.

Activa este ajuste en dos situaciones:

• Tu tienda utiliza un formato de imagen no estándar (WebP, AVIF, JPEG 2000, derivados de HEIC) en el que la comprobación de existencia del módulo busca un .jpg que nunca está ahí.
• Tu catálogo es muy grande y la generación del feed es lenta — omitir la comprobación del sistema de archivos acelera notablemente la generación.

Disable image URL encoding

Por defecto, el módulo aplica transliteración UTF-8 con iconv a las URLs de imagen antes de escribirlas en el feed. Esto convierte los caracteres acentuados o especiales (frecuentes en slugs de productos en francés, español, alemán y otros idiomas) en sus equivalentes ASCII, produciendo URLs más limpias y seguras para todos los analizadores XML.

Activa Disable image URL encoding si tus URLs de imagen ya utilizan codificación porcentual correcta o si la transliteración está corrompiendo las URLs en tu configuración regional específica.

Disable Additional Images

Cuando está desactivado (por defecto), el módulo recopila todas las imágenes asociadas a un producto más allá de la portada y las escribe como campos additional_image_link en el feed. Facebook acepta hasta 10 valores additional_image_link por producto — el módulo aplica este límite automáticamente independientemente de cuántas imágenes tenga un producto.

Activa este ajuste para omitir las imágenes adicionales por completo e incluir solo la portada. Esto puede reducir significativamente el tiempo de generación del feed en catálogos grandes con muchas imágenes por producto.

Ignore cover

Cuando está desactivado (por defecto), el módulo utiliza la imagen marcada como portada del producto en PrestaShop como image_link principal en el feed.

Activa Ignore cover para usar en su lugar la primera imagen según el orden de posición, ignorando la indicación de portada. Es útil cuando tus imágenes de portada no son el material creativo de mejor rendimiento para los anuncios, pero tu ordenación posicional sí lo es.

Images limit

Establece un número para limitar cuántas imágenes por producto se escriben en el feed. La portada cuenta como primera imagen; las imágenes adicionales ocupan posiciones desde la 2 en adelante. El límite se aplica antes del límite de 10 imágenes de Facebook.

Deja el valor en 0 para exportar todas las imágenes disponibles (Facebook sigue limitando a 10 imágenes adicionales).

Image Position Start

Introduce un número de posición (base 1) para iniciar la selección de imágenes desde esa posición en la lista de imágenes del producto, en lugar de hacerlo desde la primera imagen. Por ejemplo, introducir 2 hace que el módulo utilice la segunda imagen (por posición) como image_link principal y omita la primera.

Cuando este ajuste es mayor que 0, Ignore cover se activa automáticamente — porque el módulo ya no usa la imagen de portada y la opción de portada quedaría redundante.

Revisa la pestaña Errors: Si estableces Image Position Start en un número superior al total de imágenes que tienen algunos productos, esos productos aparecerán en la pestaña Errors bajo "Products with less than N images". La etiqueta de la pestaña refleja dinámicamente el valor de inicio configurado.

Ejemplos de uso

Ejemplo: Catálogo grande con imágenes WebP Tu tienda está configurada para generar imágenes WebP. La comprobación del sistema de archivos del módulo busca archivos .jpg y marca cientos de productos como si tuvieran imágenes faltantes. Activa Disable check image exists para que las URLs se incluyan independientemente del formato, y verifica en Facebook Commerce Manager que las imágenes se cargan correctamente.

Ejemplo: Catálogo de moda — omitir portada de lifestyle, usar foto de producto limpia Tus productos tienen una foto de lifestyle como portada, pero la segunda imagen es una foto limpia del producto sobre fondo blanco. Establece Image Position Start en 2. El módulo utilizará la posición 2 como image_link en todos los productos y activará automáticamente Ignore cover.

Ejemplo: Acelerar la generación para 50.000 productos Tu feed tarda 40 minutos en generarse. Activa Disable Additional Images para omitir el bucle de recopilación de imágenes por producto, y activa Disable check image exists para omitir las consultas al sistema de archivos. Estos dos cambios suelen reducir el tiempo de generación entre un 20 y un 40 % en catálogos grandes.

Notas importantes

• El límite de additional_image_link de Facebook es de 10 imágenes. El módulo aplica este límite estricto en FeedImage::getAdditionalImages() independientemente de tu ajuste de Images limit.
• Si usas combinaciones (variantes de producto), las imágenes asignadas a una combinación específica se utilizan para las entradas de esa variante. Si no existen imágenes específicas para la combinación, se usan las imágenes compartidas del producto.
• Las URLs de imagen siempre utilizan el dominio SSL de tu tienda cuando SSL está activado (PS_SSL_ENABLED). Si tu dominio de imágenes difiere del dominio de la tienda (por ejemplo, una CDN), el módulo corrige la parte del host de la URL para que coincida con el dominio de la tienda actual.
• Estos ajustes son por tienda en configuraciones multishop. Ajústalos por separado para cada contexto de tienda.

Resolución de problemas

Problema	Solución
Muchos errores de imagen en la pestaña Errors aunque los productos tienen imágenes	Activa Disable check image exists — tus imágenes pueden estar almacenadas en formato WebP o AVIF, que la comprobación del sistema de archivos no encuentra.
Las URLs de imagen contienen caracteres corruptos o no cargan	Desactiva Disable image URL encoding (es decir, mantén la codificación activada) para que el módulo elimine los caracteres no ASCII de las URLs.
La generación del feed es muy lenta en catálogos grandes	Activa Disable Additional Images y/o Disable check image exists para omitir las operaciones por imagen más costosas en tiempo.
Facebook muestra la imagen incorrecta como portada del producto	Activa Ignore cover si la designación de portada en PrestaShop no coincide con la imagen que quieres que Facebook utilice, o usa Image Position Start para seleccionar una posición específica.
Los productos desaparecen del feed al establecer Image Position Start	Esos productos tienen menos imágenes de las que requiere la posición de inicio. Reduce el valor o añade más imágenes a los productos afectados.
Tipo fpf_image seleccionado pero las imágenes aparecen rotas en el feed	Debes regenerar las miniaturas en PrestaShop (Diseño > Preferencias de imágenes > Regenerar miniaturas) después de seleccionar fpf_image.

Preguntas frecuentes

¿Qué tamaño de imagen debo elegir para los anuncios de Facebook?

Facebook recomienda imágenes con una relación de aspecto de 1:1 (cuadrada). Revisa los tipos de imagen listados en el selector y elige uno cuyas dimensiones sean cercanas a cuadradas, normalmente 800×800 px o más. Evita formatos de banner muy anchos, ya que Facebook puede recortarlos o rechazarlos.

¿Acepta Facebook imágenes WebP en el feed del catálogo?

El importador de catálogos de Facebook puede obtener imágenes WebP desde una URL, pero la compatibilidad varía según el formato y la ubicación del anuncio. Si tienes dudas, mantén la configuración de calidad de imagen de PrestaShop en JPEG y utiliza un tipo de imagen .jpg para que el feed apunte siempre a archivos JPEG.

¿Por qué al activar Image Position Start se activa automáticamente Ignore cover?

Cuando indicas al módulo que empiece desde una posición de imagen específica, la designación de portada deja de ser relevante — el módulo selecciona por orden, no por la indicación de portada. El módulo activa Ignore cover automáticamente para evitar un conflicto entre ambos ajustes.

¿Puedo incluir más de 10 imágenes adicionales por producto?

No. La especificación del feed de Facebook permite un máximo de 10 valores additional_image_link por producto. El módulo aplica este límite y deja de añadir imágenes una vez recopiladas 10, independientemente de cuántas imágenes tenga el producto en PrestaShop.

¿Desactivar la comprobación de existencia de imágenes provocará URLs rotas en Facebook?

Solo si los archivos de imagen realmente no existen. La comprobación es un filtro de seguridad — desactivarla significa que el módulo confía en que todas las URLs de imagen que construye son válidas. Si tus imágenes existen pero en un formato no estándar (WebP, AVIF), desactivar la comprobación es la solución correcta. Si las imágenes realmente faltan, generarán errores en Facebook Commerce Manager.

¿Cómo interactúa Image Position Start con las imágenes de combinaciones?

Para las combinaciones, el módulo busca primero las imágenes asignadas a la combinación específica. Si las encuentra, FPF_IMG_START se aplica a la lista de imágenes de esa combinación mediante array_slice. Si no existen imágenes específicas para la combinación, se utiliza la lista de imágenes compartidas del producto con el mismo desplazamiento de inicio.

Funciones relacionadas

• Combinaciones
• Generación por ciclos