Novo Módulo – Ferramentas de Imagem do Produto
Patch Notes - Ferramentas de Imagem do Produto
Descrição da atualização
Disponibilizamos o módulo Ferramentas de Imagem do Produto, desenvolvido para facilitar o gerenciamento de imagens de produtos diretamente na galeria do painel administrativo.
O módulo resolve duas situações comuns em operações com grande volume de produtos: a necessidade de atribuir manualmente os papéis de imagem um a um, e a ausência de imagem padrão em produtos recém-cadastrados. Com ele, essas tarefas passam a ser executadas de forma automática e controlada, reduzindo retrabalho e inconsistências na exibição dos produtos na loja.
A solução foi projetada para ser segura e não interferir no comportamento padrão do Magento, garantindo que nenhum recurso do módulo seja carregado ou executado enquanto estiver desabilitado.
O que o módulo faz
-
Exibe um botão "Definir como Padrão" em cada linha da galeria de imagens do produto, permitindo ao usuário atribuir todos os papéis de imagem daquela linha com um único clique;
-
atribui automaticamente a primeira imagem da galeria a quaisquer papéis ainda não definidos ao salvar o produto;
-
e permite controlar se o papel "Guia de Medidas" deve ou não ser incluído tanto na ação automática quanto no botão manual.
Funcionamento do botão Definir como Padrão
Ao clicar no botão em uma linha da galeria, o módulo identifica todos os inputs de papel de imagem daquela linha e executa o clique em cada um, acionando a lógica nativa do Magento. O processo respeita a configuração de inclusão do "Guia de Medidas", ignorando ou incluindo esse papel conforme definido nas configurações. O botão é adicionado dinamicamente, inclusive em linhas inseridas via upload AJAX, sem necessidade de recarregar a página.
Funcionamento da primeira imagem automática
Ao salvar um produto, o módulo verifica se existem papéis de imagem sem nenhuma imagem atribuída. Caso existam, a primeira imagem da galeria é automaticamente definida para esses papéis. O processo ocorre apenas quando não há imagem já configurada, nunca sobrescrevendo atribuições existentes.
A inclusão ou não do papel "Guia de Medidas" nessa atribuição automática segue a mesma configuração do botão manual.
Onde fica
Sistema → Configuração → Catálogo → Ferramentas de Imagem do Produto
Configurações disponíveis (resumo)
-
Habilitar Ferramentas de Imagem — ativa ou desativa o módulo por completo. Quando desabilitado, nenhum recurso do módulo é carregado na página.
-
Definir Primeira Imagem Automaticamente como Padrão — ao salvar um produto, atribui automaticamente a primeira imagem da galeria a quaisquer papéis de imagem ainda não definidos.
-
Incluir "Guia de Medidas" na Atribuição Automática e Botão "Selecione como Padrão" — quando ativado, o papel "Guia de Medidas" é incluído tanto na ação automática ao salvar quanto na ação do botão manual. Quando desativado, esse papel é ignorado por ambos.
Principais vantagens
Agilidade na atribuição de papéis de imagem com um único clique; eliminação de produtos sem imagem padrão definida; controle granular sobre o papel "Guia de Medidas"; compatível com uploads AJAX sem necessidade de recarregar a página; não interfere no comportamento nativo do Magento; e nenhum recurso é carregado quando o módulo está desabilitado.
Observações importantes
O módulo é instalado desabilitado por padrão, exigindo ativação manual pelo usuário. A atribuição automática da primeira imagem ocorre somente ao salvar o produto, nunca sobrescrevendo papéis já atribuídos. O botão "Definir como Padrão" aciona a lógica nativa do Magento, garantindo compatibilidade com o comportamento esperado da galeria. A configuração do "Guia de Medidas" controla simultaneamente o comportamento do botão manual e da atribuição automática.