Marca de Água Automática nas Imagens de Produto: guia completo

Apresentação

O módulo Marca de Água Automática aplica o seu logótipo ou o seu nome nas miniaturas das suas imagens de produto, sem intervenção manual. A marca de água é aplicada assim que uma imagem é adicionada a um produto e a cada regeneração das miniaturas. Ponto essencial: os seus ficheiros originais nunca são modificados. Só as declinações por tipo de imagem (large, home, categoria, etc.) são marcadas, o que garante que uma nova regeneração parte sempre de uma fonte limpa.

O módulo propõe dois modos, um logótipo PNG transparente ou um texto, com uma afinação da opacidade, do tamanho, da posição e dos formatos processados. É compatível com PrestaShop 1.7, 8 e 9, e só requer a extensão PHP GD, presente na quase totalidade dos alojamentos.

Instalação

1. A partir do back-office, abra Módulos > Gestor de módulos.
2. Clique em Instalar um módulo e carregue o arquivo ZIP do módulo.
3. Terminada a instalação, clique em Configurar.

Na instalação, o módulo regista o hook actionWatermark e aplica definições por defeito prontas a usar (opacidade 60 %, posição em baixo à direita, tamanho do logótipo a 25 % da largura, todos os tipos de imagem selecionados). A extensão GD é verificada: se estiver ausente, a instalação é interrompida com uma mensagem explícita.

Configuração

A página de configuração está organizada em três painéis: Tipo de marca de água, Aparência e posição e Aplicação. Uma pré-visualização do logótipo atualmente carregado aparece no topo da página, bem como um botão direto para a regeneração das miniaturas.

Tipo de marca de água

• Modo: escolha entre Logótipo (imagem PNG) e Texto.
• Logótipo da marca de água: carregue a sua imagem (PNG transparente recomendado, 4 MB no máximo). O ficheiro é convertido em PNG para preservar a transparência. Deixe este campo vazio para conservar o logótipo atual.
• Eliminar o logótipo: marque esta caixa para retirar o logótipo guardado.
• Texto da marca de água: o texto a incrustar em modo Texto (nome da loja, copyright, URL…).
• Cor do texto: a cor do texto, em modo Texto.

Aparência e posição

• Opacidade (%): de 1 (muito transparente) a 100 (opaco).
• Tamanho do logótipo (% da largura da imagem): a largura do logótipo expressa em percentagem da largura da imagem. O valor 0 conserva o tamanho nativo do logótipo. Exprimir o tamanho em percentagem permite à marca de água manter proporções coerentes em todos os formatos de imagem, da grande ficha de produto à miniatura de categoria.
• Tamanho do texto (% da largura da imagem): mesmo princípio, para o modo Texto.
• Ângulo do texto (°): inclinação do texto, em modo Texto.
• Posição: nove âncoras (cima/centro/baixo × esquerda/centro/direita) ou o modo Mosaico, que repete a marca de água em toda a imagem.
• Margens horizontal e vertical (px): a distância em píxeis em relação ao bordo, para as posições de âncora.
• Espaçamento do mosaico (%): a distância entre as repetições, usada apenas com a posição Mosaico.

Aplicação

• Largura mínima (px): as imagens mais estreitas do que este valor não recebem marca de água. Isto evita marcar as microminiaturas (carrinho, pesquisa), onde uma marca de água seria ilegível.
• Tipos de imagem a marcar: selecione os tipos de imagem em causa (large_default, home_default, etc.). Cada tipo mostra as suas dimensões para o ajudar a escolher.
• Formatos a processar: JPG, PNG, WebP e AVIF. Selecione os formatos gerados pela sua loja. O PrestaShop 8 e 9 produzem muitas vezes WebP e AVIF para além do formato principal.

Como funciona a marca de água

O módulo liga-se ao hook nativo actionWatermark do PrestaShop, desencadeado a cada (re)geração das miniaturas de uma imagem de produto. Para cada tipo de imagem selecionado e cada formato ativo, o módulo carrega a miniatura gerada, aplica a marca de água e volta a guardar o ficheiro retomando os níveis de qualidade definidos nos parâmetros de imagens da sua loja.

Só as declinações por tipo de imagem são processadas: o ficheiro original fica intacto. Pode portanto mudar de marca de água e regenerar tantas vezes quantas forem necessárias sem nunca degradar a fonte.

Aplicar a marca de água aos produtos existentes

O hook só processa uma imagem no momento em que é gerada. Para marcar todo um catálogo já online, lance uma regeneração das miniaturas:

1. Abra Design > Parâmetros de imagens (há um botão direto na página do módulo).
2. Lance a regeneração das miniaturas para as imagens de produto.

A regeneração recria as miniaturas a partir dos originais, e o módulo aplica-lhes depois a marca de água. Nos catálogos muito grandes, prefira a regeneração nativa do PrestaShop, concebida para processar grandes volumes. A regeneração está também disponível em linha de comandos:

bin/console prestashop:thumbnails:regenerate products

Modo logótipo ou modo texto

O modo logótipo convém se tiver uma identidade visual forte: um PNG transparente colocado em baixo à direita, a 60 % de opacidade, basta para assinar os seus visuais sem prejudicar a leitura do produto.

O modo texto é ideal para uma menção rápida sem preparar ficheiro. O tipo de letra DejaVuSans está incorporado no módulo, o que garante uma renderização idêntica em todos os alojamentos, sem depender dos tipos de letra instalados no servidor.

Compatibilidade

• PrestaShop: 1.7, 8.x e 9.x. A compatibilidade 9.x cobre a nova regeneração baseada em Symfony: o módulo resolve os seus caminhos de ficheiros de forma defensiva para funcionar mesmo quando as constantes históricas não estão carregadas.
• PHP: 7.2 e superior, com a extensão GD.
• Formatos: JPG, PNG, WebP e AVIF, bem como as variantes de alta densidade @2x. O processamento de WebP e AVIF depende do suporte destes formatos pela biblioteca GD do servidor.

Desinstalação

A desinstalação elimina a configuração do módulo e o seu hook. As marcas de água já aplicadas permanecem nas miniaturas até à próxima regeneração. Para recuperar imagens sem marca de água, desinstale o módulo e regenere depois as miniaturas: partem dos ficheiros originais, que ficaram intactos.

Resolução de problemas

• O logótipo aparece demasiado pequeno ou demasiado grande: ajuste o Tamanho do logótipo (em % da largura), ou coloque-o em 0 para conservar o tamanho nativo.
• WebP ou AVIF sem marca de água: o servidor deve dispor de uma biblioteca GD compilada com o suporte destes formatos. Se não for o caso, os ficheiros em causa são simplesmente ignorados, sem erro.
• Marca de água nas miniaturas minúsculas: aumente a Largura mínima para excluir os formatos pequenos.

FAQ

As minhas imagens originais são modificadas?

Não. Só as miniaturas geradas por tipo de imagem recebem a marca de água. O ficheiro original fica intacto.

Como aplicar a marca de água aos produtos já online?

Configure o módulo e lance depois uma regeneração das miniaturas a partir de Design > Parâmetros de imagens. As novas imagens carregadas recebem automaticamente a marca de água.

O módulo funciona com WebP e AVIF?

Sim, e também com as variantes @2x, desde que a extensão GD do servidor suporte estes formatos.

É preciso preparar um ficheiro para o modo texto?

Não. Basta introduzir o texto; o tipo de letra está incorporado no módulo.

A transparência do meu logótipo PNG é conservada?

Sim, graças a uma fusão alfa à medida que preserva a transparência aplicando ao mesmo tempo a opacidade escolhida.

O módulo é compatível com o PrestaShop 9?

Sim, o módulo é compatível com PrestaShop 1.7, 8 e 9, incluindo a nova regeneração através do motor Symfony.