# Imágenes de combinaciones por color: instalación y configuración

> Presentación El módulo asigna las fotos de un producto a sus combinaciones según su color. Para cada foto indicas si pertenece a un color, a todos, a algunos o a…

- Página: <https://www.datafirefly.com/es/documentation/dfcombinationimages/>
- Idioma: es
- Actualizado el: 2026-10-07
- Otros idiomas: [fr](https://www.datafirefly.com/documentation/dfcombinationimages/index.md), [en](https://www.datafirefly.com/en/documentation/dfcombinationimages/index.md), [it](https://www.datafirefly.com/it/documentation/dfcombinationimages/index.md), [de](https://www.datafirefly.com/de/documentation/dfcombinationimages/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfcombinationimages/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfcombinationimages/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfcombinationimages/index.md)
- Índice: <https://www.datafirefly.com/es/documentation/llms.txt>

## Presentación

El módulo asigna las fotos de un producto a sus combinaciones según su color. Para cada foto indicas si pertenece a un color, a todos, a algunos o a ninguno. El módulo escribe después la lista exacta de imágenes de cada combinación, para todas las tallas del color.

En PrestaShop, una combinación sin imagen muestra todas las fotos del producto. Por eso el módulo da a cada combinación una lista explícita de imágenes. La interfaz del módulo está en inglés, francés e italiano: los nombres de botones de esta guía son los de la interfaz en inglés.

## Instalación

1. En el back-office, abre **Módulos > Gestor de módulos** y haz clic en **Subir un módulo**.
2. Sube el archivo `dfcombinationimages.zip`.
3. El módulo añade el menú **Catálogo > Imágenes de combinaciones** y crea sus tablas.

Para actualizar, sube el nuevo ZIP sobre el anterior: las configuraciones y las copias de seguridad se conservan.

## Ajustes

Pestaña **Settings**, se configura una sola vez.

### Grupos de atributos de color

Marca los grupos que indican el color de una combinación. Los grupos de tipo color se marcan en la instalación. Los demás atributos (talla, copa, largo) se ignoran: todas las combinaciones de un mismo color reciben las mismas fotos.

### Foto añadida más tarde

Elige si una foto nueva, situada después de la portada de un producto configurado, va a todas las combinaciones o a ninguna hasta que la configures. Una foto añadida antes de la portada nunca se asigna automáticamente.

### Actualización automática

Cuando se añade una combinación o una foto a un producto configurado, el módulo vuelve a aplicar su configuración. PrestaShop solo ejecuta estos hooks para los empleados autorizados a ver el módulo (**Equipo > Permisos > Módulos**). Si no, usa **Apply again** en el producto o la asignación masiva.

### Textos ALT y sinónimos

El módulo puede buscar el nombre del color en el texto ALT de las fotos. Si un color está escrito de otra forma en tus ALT, añade una línea por color: `Carne = nude, beige`. La lectura del ALT se omite cuando todas las fotos de un producto tienen el mismo ALT.

### Productos por lote

Número de productos procesados por petición durante una asignación masiva. 25 sirve en la mayoría de los casos; bájalo si el servidor agota el tiempo de ejecución.

## Configurar un producto

Pestaña **Products**: la lista muestra los productos con combinaciones, con su número de colores y de fotos antes de la portada. Filtra por categoría, busca por nombre o referencia y haz clic en **Configure**. La misma pantalla se abre desde la ficha del producto, pestaña Módulos.

### Las cuatro opciones de cada foto

- **Photo of one color**: la foto solo aparece en las combinaciones del color elegido.
- **All colors**: la foto aparece en todas las combinaciones, como una foto con modelo o la portada.
- **Only these colors**: marca los colores afectados.
- **No combination**: la foto se queda en la ficha del producto pero no se muestra en ninguna combinación.

### La propuesta automática

Un producto sin configurar muestra una propuesta, que solo se guarda al hacer clic en **Save and apply**.

- **A partir de las asociaciones actuales** (por defecto): una foto ya vinculada a las combinaciones de un color conserva ese color, y una foto sin combinación pasa a ser una foto común. Las fotos situadas antes de la portada sin color reciben un color cada una cuando hay exactamente una por color.
- **A partir del orden de las fotos y del ALT**: cada foto situada antes de la portada recibe un color, primero según su texto ALT y después según el orden de las fotos y de los valores de color.

### Texto ALT y zoom

El texto ALT completo aparece bajo cada foto. Si eliges un color distinto del indicado en el ALT, la tarjeta se vuelve naranja. Haz clic en una foto para ampliarla y distinguir colores parecidos.

### Vista previa por color e imagen principal

La vista previa se actualiza mientras editas. Para cada color, la primera foto de la fila es la imagen principal de las combinaciones: PrestaShop 9 usa la primera foto asignada en el orden de posiciones. Si una foto asignada a varios colores pasa delante de la foto propia de un color, la vista previa lo indica en naranja.

### Poner primero las fotos de color

Cuando la portada es la primera foto y las fotos de color van después, la casilla **Move the photos of one color before the other photos** las coloca antes de la portada. Las fotos ya situadas antes de la portada nunca se mueven y la portada del producto no cambia. El orden final se muestra bajo la casilla antes de guardar.

## Asignación masiva

1. Elige una o varias categorías, o deja vacío para todo el catálogo.
2. Elige los productos: no configurados, no configurados o configurados en masa (los configurados a mano se conservan), todos, o solo volver a aplicar las configuraciones guardadas.
3. Elige el origen de las fotos de un solo color: las imágenes actuales de las combinaciones (recomendado tras una importación) o las fotos situadas antes de la portada.
4. Elige qué hacer si un color no tiene foto propia: omitir el producto (recomendado) o aplicar igualmente.
5. Elige dónde van las fotos comunes: todas las combinaciones o solo algunos colores.
6. Deja marcada la **Simulation** y haz clic en **Start**. Marca **Show only the products to check** para ver los productos omitidos y abrirlos.
7. Cuando el resultado te convenza, desmarca la simulación y vuelve a lanzar. Se crea una copia de seguridad antes de cualquier cambio.

## Copias de seguridad y restauración

Cada guardado de producto y cada asignación masiva crea una copia de seguridad. La pestaña **Backups** las lista; **Restore** devuelve las imágenes de las combinaciones, el orden de las fotos y la configuración de los productos afectados. El módulo conserva las 10 últimas copias masivas y las 50 últimas copias de producto.

## Solución de problemas

### Las opciones no reaccionan antes de guardar

El navegador sigue usando el JavaScript de una versión anterior. Vacía la caché del navegador o recarga la página con Ctrl+F5.

### Una talla nueva no recibió sus fotos

Probablemente el empleado que la creó no tiene permiso para ver el módulo. Abre el producto en el módulo y haz clic en **Apply again**, o lanza la asignación masiva en modo de nueva aplicación.
