# 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 é…

- Página: <https://www.datafirefly.com/pt/documentation/dfwatermark/>
- Idioma: pt
- Atualizado em: 2026-09-03
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfwatermark/index.md), [en](https://www.datafirefly.com/en/documentation/dfwatermark/index.md), [es](https://www.datafirefly.com/es/documentation/dfwatermark/index.md), [de](https://www.datafirefly.com/de/documentation/dfwatermark/index.md), [it](https://www.datafirefly.com/it/documentation/dfwatermark/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfwatermark/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfwatermark/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## 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.

Depois de cada alteração, lembre-se de **guardar** e depois de regenerar as miniaturas para aplicar as novas definições às imagens já online. As novas imagens carregadas recebem automaticamente a marca de água com as definições em vigor.

## 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.

Em modo logótipo, a transparência do seu PNG é preservada graças a uma fusão alfa à medida que combina a opacidade global que define com a transparência nativa da imagem. Sem moldura nem fundo opaco acrescentado à volta do logótipo.

## 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

**A marca de água não se aplica.** Verifique que pelo menos um tipo de imagem e um formato estão marcados no painel _Aplicação_, que um logótipo está carregado em modo logótipo (ou um texto introduzido em modo texto), e que a largura mínima não exclui o tipo de imagem visado. Lance depois uma regeneração das miniaturas.

- **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.