Novo Módulo – Regras Automáticas de Imagens
Patch Notes – Regras Automáticas de Imagens
Descrição da atualização
Disponibilizamos o módulo Regras Automáticas de Imagens, desenvolvido para automatizar a atribuição dos papéis de imagem dos produtos com base na ordem definida na galeria de mídia. Com ele, o lojista não precisa configurar manualmente qual imagem é a principal, qual é o hover ou qual é o guia de medidas, o módulo faz isso automaticamente sempre que um produto é salvo.
O módulo opera de forma silenciosa e transparente, sem exigir nenhuma ação adicional após a configuração inicial. Basta organizar as imagens do produto na ordem correta dentro da galeria que os papéis serão aplicados automaticamente.
A solução foi desenvolvida para lojas com grande volume de produtos ou processos de importação frequentes, onde a atribuição manual de papéis de imagem é inviável ou propensa a erros, garantindo:
- Consistência visual em toda a vitrine da loja;
- Padronização do papel de imagem principal, hover e guia de medidas;
- Compatibilidade com cadastros feitos via painel, API, integração e importação.
O que o módulo faz
- Atribui automaticamente a imagem de Ordem 1 da galeria como imagem principal do produto nos papéis: Imagem Principal XML, Imagem Base, Imagem Reduzida, Miniatura, os campos Hover Imagem e Guia de Medidas, conforme configuração;
- Atribui a imagem de Ordem 2 como imagem de hover (efeito ao passar o mouse), com valor padrão para a Ordem 1 caso não exista;
- Atribui a imagem de Ordem 3 como guia de medidas do produto, ou limpa o campo caso a imagem não exista;
- Aplica as regras automaticamente no salvamento individual de qualquer produto, independentemente da origem (painel administrativo, API, integração ou importação);
- Aplica as regras também em atualizações em massa realizadas pela grade de produtos;
- Limpa automaticamente o campo de guia de medidas quando a funcionalidade está desativada ou quando não há imagem na terceira posição.
Funcionamento da atribuição
O módulo opera por meio de observadores de eventos do Magento, seguindo o fluxo abaixo:
1. Um produto é salvo por qualquer meio (painel, API, importação, integração);
2. O módulo intercepta o evento após a confirmação do salvamento no banco;
3. Recarrega o produto completo para garantir acesso à galeria de mídia atualizada;
4. Lê as imagens da galeria e as organiza por posição (Ordem);
5. Verifica as configurações ativas (hover e guia de medidas habilitados ou não);
6. Aplica os papéis corretos a cada atributo de imagem do produto;
7. Salva os papéis de forma leve, sem disparar um novo ciclo de salvamento do produto.
Uma proteção anti-loop garante que a atribuição dos papéis não acione novamente o próprio observador, evitando ciclos infinitos.
Onde fica
Sistema → Configuração → Catálogo → Regras Automáticas de Imagens
Configurações disponíveis
Habilitar:
Ativa ou desativa todo o funcionamento do módulo. Quando desativado, nenhum papel de imagem é alterado automaticamente.
Utilizar Hover Imagem (ordem 2):
Define se a imagem de Ordem 2 da galeria será atribuída ao papel de hover.
- Sim – A imagem na segunda posição da galeria é usada como hover. Se não houver imagem na Ordem 2, a Ordem 1 é usada como valor padrão;
- Não – O papel de hover sempre recebe a mesma imagem da Ordem 1.
Utilizar Guia de Medidas (ordem 3):
Define se a imagem de Ordem 3 da galeria será atribuída ao papel de guia de medidas.
- Sim – A imagem na terceira posição da galeria é atribuída ao guia. Se não houver imagem na Ordem 3, o campo é limpo;
- Não – O campo de guia de medidas é sempre limpo, independentemente da galeria.
Todas as configurações são aplicáveis nos níveis global, website e loja.
Principais vantagens
- Eliminação do trabalho manual de atribuição de papéis de imagem por produto;
- Compatibilidade total com importações em massa e integrações via API;
- Aplicação automática tanto no salvamento individual quanto em atualizações em massa pela grade;
- Proteção contra loops e falhas silenciosas, erros são registrados no log sem interromper o salvamento do produto;
- Nenhum impacto de performance, a atribuição dos papéis usa atualização leve de atributos, sem reprocessar o produto completo.