Marca de Agua Automática en Imágenes de Producto — Guía completa

Presentación

El módulo Marca de Agua Automática aplica tu logotipo o tu nombre en las miniaturas de tus imágenes de producto, sin intervención manual. La marca de agua se aplica en cuanto se añade una imagen a un producto y en cada regeneración de las miniaturas. Lo esencial: tus archivos originales nunca se modifican. Solo se marcan las variantes por tipo de imagen (large, home, categoría, etc.), lo que garantiza que una nueva regeneración siempre parta de una fuente limpia.

El módulo ofrece dos modos — un logotipo PNG transparente o un texto — con un ajuste preciso de la opacidad, el tamaño, la posición y los formatos procesados. Es compatible con PrestaShop 1.7, 8 y 9, y solo requiere la extensión PHP GD, presente en casi todos los alojamientos.

Instalación

1. En el back-office, abre Módulos > Gestor de módulos.
2. Haz clic en Subir un módulo y suelta el archivo ZIP del módulo.
3. Una vez completada la instalación, haz clic en Configurar.

Durante la instalación, el módulo registra el hook actionWatermark y aplica ajustes por defecto listos para usar (opacidad 60 %, posición abajo a la derecha, tamaño del logotipo al 25 % del ancho, todos los tipos de imagen seleccionados). Se comprueba la extensión GD: si falta, la instalación se interrumpe con un mensaje explícito.

Configuración

La página de configuración se organiza en tres paneles: Tipo de marca de agua, Apariencia y posición y Aplicación. En la parte superior se muestra una vista previa del logotipo subido actualmente, junto con un botón directo a la regeneración de miniaturas.

Tipo de marca de agua

• Modo — elige entre Logotipo (imagen PNG) y Texto.
• Logotipo de la marca de agua — sube tu imagen (PNG transparente recomendado, 4 MB máximo). El archivo se convierte a PNG para preservar la transparencia. Deja este campo vacío para conservar el logotipo actual.
• Eliminar el logotipo — marca esta casilla para quitar el logotipo guardado.
• Texto de la marca de agua — el texto a incrustar en modo Texto (nombre de la tienda, copyright, URL…).
• Color del texto — el color del texto, en modo Texto.

Apariencia y posición

• Opacidad (%) — de 1 (muy transparente) a 100 (opaco).
• Tamaño del logotipo (% del ancho de la imagen) — el ancho del logotipo expresado como porcentaje del ancho de la imagen. El valor 0 conserva el tamaño nativo del logotipo. Expresar el tamaño en porcentaje permite que la marca de agua mantenga proporciones coherentes en todos los formatos de imagen, desde la ficha de producto grande hasta la miniatura de categoría.
• Tamaño del texto (% del ancho de la imagen) — mismo principio, para el modo Texto.
• Ángulo del texto (°) — inclinación del texto, en modo Texto.
• Posición — nueve anclajes (arriba/centro/abajo × izquierda/centro/derecha) o el modo Mosaico, que repite la marca de agua por toda la imagen.
• Márgenes horizontal y vertical (px) — la distancia en píxeles respecto al borde, para las posiciones de anclaje.
• Espaciado del mosaico (%) — la distancia entre las repeticiones, usada solo con la posición Mosaico.

Aplicación

• Ancho mínimo (px) — las imágenes más estrechas que este valor no reciben marca de agua. Esto evita marcar las microminiaturas (carrito, búsqueda), donde una marca de agua sería ilegible.
• Tipos de imagen a marcar — selecciona los tipos de imagen pertinentes (large_default, home_default, etc.). Cada tipo muestra sus dimensiones para ayudarte a elegir.
• Formatos a procesar — JPG, PNG, WebP y AVIF. Selecciona los formatos generados por tu tienda. PrestaShop 8 y 9 suelen producir WebP y AVIF además del formato principal.

Cómo funciona la marca de agua

El módulo se engancha al hook nativo actionWatermark de PrestaShop, que se dispara en cada (re)generación de las miniaturas de una imagen de producto. Para cada tipo de imagen seleccionado y cada formato activo, el módulo carga la miniatura generada, aplica la marca de agua y vuelve a guardar el archivo reutilizando los niveles de calidad definidos en los ajustes de imágenes de tu tienda.

Solo se procesan las variantes por tipo de imagen: el archivo original permanece intacto. Por tanto, puedes cambiar la marca de agua y regenerar tantas veces como quieras sin degradar nunca la fuente.

Aplicar la marca de agua a los productos existentes

El hook solo procesa una imagen en el momento en que se genera. Para marcar un catálogo ya publicado, ejecuta una regeneración de miniaturas:

1. Abre Diseño > Ajustes de imágenes (hay un botón directo en la página del módulo).
2. Ejecuta la regeneración de miniaturas para las imágenes de producto.

La regeneración recrea las miniaturas a partir de los originales, y luego el módulo les aplica la marca de agua. En catálogos muy grandes, usa la regeneración nativa de PrestaShop, diseñada para grandes volúmenes. La regeneración también está disponible por línea de comandos:

bin/console prestashop:thumbnails:regenerate products

Modo logotipo o modo texto

El modo logotipo te conviene si tienes una identidad visual fuerte: un PNG transparente colocado abajo a la derecha al 60 % de opacidad basta para firmar tus visuales sin estorbar el producto.

El modo texto es ideal para un aviso rápido sin preparar ningún archivo. La fuente DejaVuSans viene incluida en el módulo, lo que garantiza una representación idéntica en cualquier alojamiento, sin depender de las fuentes instaladas en el servidor.

Compatibilidad

• PrestaShop — 1.7, 8.x y 9.x. La compatibilidad 9.x cubre la nueva regeneración basada en Symfony: el módulo resuelve sus rutas de archivo de forma defensiva para funcionar incluso cuando las constantes heredadas no se cargan.
• PHP — 7.2 y superior, con la extensión GD.
• Formatos — JPG, PNG, WebP y AVIF, así como las variantes de alta densidad @2x. El procesamiento de WebP y AVIF depende del soporte de estos formatos por la biblioteca GD del servidor.

Desinstalación

La desinstalación elimina la configuración del módulo y su hook. Las marcas de agua ya aplicadas permanecen en las miniaturas hasta la siguiente regeneración. Para recuperar imágenes sin marca de agua, desinstala el módulo y luego regenera las miniaturas: vuelven a partir de los archivos originales, que permanecieron intactos.

Resolución de problemas

• El logotipo aparece demasiado pequeño o demasiado grande — ajusta el Tamaño del logotipo (en % del ancho), o ponlo a 0 para conservar el tamaño nativo.
• WebP o AVIF sin marca de agua — el servidor debe disponer de una biblioteca GD compilada con soporte de estos formatos. Si no es el caso, los archivos correspondientes simplemente se omiten, sin error.
• Marca de agua en las miniaturas diminutas — aumenta el Ancho mínimo para excluir los formatos pequeños.

FAQ

¿Se modifican mis imágenes originales?

No. Solo se marcan las miniaturas generadas por tipo de imagen. El archivo original permanece intacto.

¿Cómo aplico la marca de agua a productos ya publicados?

Configura el módulo y luego ejecuta una regeneración de miniaturas desde Diseño > Ajustes de imágenes. Las nuevas imágenes subidas reciben la marca de agua automáticamente.

¿Funciona el módulo con WebP y AVIF?

Sí, así como con las variantes @2x, siempre que la extensión GD del servidor soporte esos formatos.

¿Hay que preparar un archivo para el modo texto?

No. Basta con escribir el texto; la fuente viene incluida en el módulo.

¿Se conserva la transparencia de mi logotipo PNG?

Sí, gracias a una fusión alfa a medida que preserva la transparencia aplicando a la vez la opacidad elegida.

¿Es el módulo compatible con PrestaShop 9?

Sí, el módulo es compatible con PrestaShop 1.7, 8 y 9, incluida la nueva regeneración mediante el motor Symfony.