# Imagens das combinações por cor: instalação e configuração

> Apresentação O módulo associa as fotos de um produto às suas combinações segundo a cor. Para cada foto indica se pertence a uma cor, a todas, a algumas ou a…

- Página: <https://www.datafirefly.com/pt/documentation/dfcombinationimages/>
- Idioma: pt
- Atualizado em: 2026-10-07
- Outros 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), [es](https://www.datafirefly.com/es/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)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## Apresentação

O módulo associa as fotos de um produto às suas combinações segundo a cor. Para cada foto indica se pertence a uma cor, a todas, a algumas ou a nenhuma. O módulo escreve depois a lista exata de imagens de cada combinação, para todos os tamanhos da cor.

No PrestaShop, uma combinação sem imagem mostra todas as fotos do produto. Por isso o módulo dá a cada combinação uma lista explícita de imagens. A interface do módulo está disponível em inglês, francês e italiano: os nomes dos botões deste guia são os da interface em inglês.

## Instalação

1. No back-office, abra **Módulos > Gestor de módulos** e clique em **Carregar um módulo**.
2. Envie o ficheiro `dfcombinationimages.zip`.
3. O módulo adiciona o menu **Catálogo > Imagens das combinações** e cria as suas tabelas.

Para atualizar, envie o novo ZIP por cima do anterior: as configurações e as cópias de segurança são mantidas.

## Definições

Separador **Settings**, a configurar uma única vez.

### Grupos de atributos de cor

Marque os grupos que indicam a cor de uma combinação. Os grupos do tipo cor são marcados na instalação. Os outros atributos (tamanho, copa, comprimento) são ignorados: todas as combinações da mesma cor recebem as mesmas fotos.

### Foto adicionada mais tarde

Escolha se uma foto nova, colocada depois da capa de um produto configurado, vai para todas as combinações ou para nenhuma até a configurar. Uma foto adicionada antes da capa nunca é associada automaticamente.

### Atualização automática

Quando se adiciona uma combinação ou uma foto a um produto configurado, o módulo volta a aplicar a configuração. O PrestaShop só executa estes hooks para os funcionários autorizados a ver o módulo (**Equipa > Permissões > Módulos**). Caso contrário, use **Apply again** no produto ou a associação em massa.

### Textos ALT e sinónimos

O módulo pode procurar o nome da cor no texto ALT das fotos. Se uma cor estiver escrita de outra forma nos seus ALT, adicione uma linha por cor: `Carne = nude, bege`. A leitura do ALT é ignorada quando todas as fotos de um produto têm o mesmo ALT.

### Produtos por lote

Número de produtos processados por pedido durante uma associação em massa. 25 serve na maioria dos casos; reduza o valor se o servidor exceder o tempo limite.

## Configurar um produto

Separador **Products**: a lista mostra os produtos com combinações, com o número de cores e de fotos antes da capa. Filtre por categoria, pesquise por nome ou referência e clique em **Configure**. O mesmo ecrã abre a partir da ficha do produto, separador Módulos.

### As quatro opções de cada foto

- **Photo of one color**: a foto só aparece nas combinações da cor escolhida.
- **All colors**: a foto aparece em todas as combinações, como uma foto com modelo ou a capa.
- **Only these colors**: marque as cores em causa.
- **No combination**: a foto fica na ficha do produto mas não aparece em nenhuma combinação.

### A proposta automática

Um produto ainda não configurado mostra uma proposta, gravada apenas quando clica em **Save and apply**.

- **A partir das associações atuais** (predefinido): uma foto já ligada às combinações de uma cor mantém essa cor, e uma foto sem combinação passa a ser uma foto comum. As fotos antes da capa sem cor recebem uma cor cada quando há exatamente uma por cor.
- **A partir da ordem das fotos e do ALT**: cada foto antes da capa recebe uma cor, primeiro pelo texto ALT, depois pela ordem das fotos e dos valores de cor.

### Texto ALT e zoom

O texto ALT completo aparece por baixo de cada foto. Se escolher uma cor diferente da indicada no ALT, o cartão fica laranja. Clique numa foto para a ampliar e distinguir cores próximas.

### Pré-visualização por cor e imagem principal

A pré-visualização atualiza-se enquanto edita. Para cada cor, a primeira foto da linha é a imagem principal das combinações: o PrestaShop 9 usa a primeira foto associada na ordem das posições. Se uma foto associada a várias cores passar à frente da foto própria de uma cor, a pré-visualização assinala-o a laranja.

### Colocar primeiro as fotos de cor

Quando a capa é a primeira foto e as fotos de cor vêm depois, a opção **Move the photos of one color before the other photos** coloca-as antes da capa. As fotos já colocadas antes da capa nunca são movidas e a capa do produto não muda. A ordem final aparece por baixo da opção antes de guardar.

## Associação em massa

1. Escolha uma ou várias categorias, ou deixe vazio para todo o catálogo.
2. Escolha os produtos: não configurados, não configurados ou configurados em massa (os configurados à mão são mantidos), todos, ou apenas voltar a aplicar as configurações gravadas.
3. Escolha a origem das fotos de uma só cor: as imagens atuais das combinações (recomendado após uma importação) ou as fotos antes da capa.
4. Escolha o que fazer quando uma cor não tem foto própria: ignorar o produto (recomendado) ou aplicar na mesma.
5. Escolha para onde vão as fotos comuns: todas as combinações ou apenas algumas cores.
6. Deixe **Simulation** marcada e clique em **Start**. Marque **Show only the products to check** para ver os produtos ignorados e abri-los.
7. Quando o resultado lhe convier, desmarque a simulação e volte a lançar. É criada uma cópia de segurança antes de qualquer alteração.

## Cópias de segurança e restauro

Cada gravação de produto e cada associação em massa cria uma cópia de segurança. O separador **Backups** lista-as; **Restore** repõe as imagens das combinações, a ordem das fotos e a configuração dos produtos em causa. O módulo guarda as 10 últimas cópias em massa e as 50 últimas cópias de produto.

## Resolução de problemas

### As opções não reagem antes de guardar

O navegador ainda usa o JavaScript de uma versão anterior. Limpe a cache do navegador ou recarregue a página com Ctrl+F5.

### Um tamanho novo não recebeu as suas fotos

O funcionário que o criou provavelmente não tem permissão para ver o módulo. Abra o produto no módulo e clique em **Apply again**, ou lance a associação em massa no modo de nova aplicação.
