Automatisches Wasserzeichen für Produktbilder — Vollständige Anleitung

Überblick

Das Modul Automatisches Wasserzeichen versieht die Thumbnails Ihrer Produktbilder mit Ihrem Logo oder Ihrem Namen, ganz ohne manuelle Arbeit. Das Wasserzeichen wird angewendet, sobald ein Bild zu einem Produkt hinzugefügt wird, und bei jeder Neugenerierung der Thumbnails. Entscheidend: Ihre Originaldateien werden nie verändert. Nur die Varianten pro Bildtyp (large, home, Kategorie usw.) werden versehen, was garantiert, dass eine erneute Generierung stets von einer sauberen Quelle ausgeht.

Das Modul bietet zwei Modi — ein transparentes PNG-Logo oder Text — mit feiner Steuerung von Deckkraft, Größe, Position und verarbeiteten Formaten. Es ist kompatibel mit PrestaShop 1.7, 8 und 9 und benötigt lediglich die PHP-Erweiterung GD, die auf nahezu jedem Hosting vorhanden ist.

Installation

1. Öffnen Sie im Back-Office Module > Modul-Manager.
2. Klicken Sie auf Modul hochladen und legen Sie das ZIP-Archiv des Moduls ab.
3. Klicken Sie nach Abschluss der Installation auf Konfigurieren.

Bei der Installation registriert das Modul den Hook actionWatermark und wendet einsatzbereite Standardwerte an (60 % Deckkraft, Position unten rechts, Logo-Größe bei 25 % der Breite, alle Bildtypen ausgewählt). Die GD-Erweiterung wird geprüft: Fehlt sie, wird die Installation mit einer expliziten Meldung abgebrochen.

Konfiguration

Die Konfigurationsseite ist in drei Bereiche gegliedert: Wasserzeichen-Typ, Erscheinungsbild & Position und Anwendung. Oben auf der Seite werden eine Vorschau des aktuell hochgeladenen Logos sowie eine direkte Schaltfläche zur Thumbnail-Neugenerierung angezeigt.

Wasserzeichen-Typ

• Modus — wählen Sie zwischen Logo (PNG-Bild) und Text.
• Wasserzeichen-Logo — laden Sie Ihr Bild hoch (transparentes PNG empfohlen, maximal 4 MB). Die Datei wird in PNG umgewandelt, um die Transparenz zu erhalten. Lassen Sie dieses Feld leer, um das aktuelle Logo beizubehalten.
• Logo löschen — aktivieren Sie dieses Kästchen, um das gespeicherte Logo zu entfernen.
• Wasserzeichen-Text — der im Text-Modus einzublendende Text (Shop-Name, Copyright, URL…).
• Textfarbe — die Textfarbe im Text-Modus.

Erscheinungsbild & Position

• Deckkraft (%) — von 1 (sehr transparent) bis 100 (deckend).
• Logo-Größe (% der Bildbreite) — die Logo-Breite als Prozentsatz der Bildbreite. Der Wert 0 behält die native Logo-Größe bei. Die Größe in Prozent anzugeben, lässt das Wasserzeichen über alle Bildformate hinweg stimmige Proportionen behalten, von der großen Produktseite bis zum Kategorie-Thumbnail.
• Text-Größe (% der Bildbreite) — gleiches Prinzip, für den Text-Modus.
• Textwinkel (°) — Neigung des Textes, im Text-Modus.
• Position — neun Anker (oben/Mitte/unten × links/Mitte/rechts) oder der Kachel-Modus, der das Wasserzeichen über das gesamte Bild wiederholt.
• Horizontale und vertikale Abstände (px) — der Abstand in Pixeln vom Rand, für die Ankerpositionen.
• Kachelabstand (%) — der Abstand zwischen den Wiederholungen, nur bei der Kachel-Position verwendet.

Anwendung

• Mindestbreite (px) — Bilder, die schmaler sind als dieser Wert, erhalten kein Wasserzeichen. So werden Mini-Thumbnails (Warenkorb, Suche) verschont, bei denen ein Wasserzeichen unleserlich wäre.
• Zu versehende Bildtypen — wählen Sie die relevanten Bildtypen (large_default, home_default usw.). Jeder Typ zeigt seine Abmessungen zur Orientierung.
• Zu verarbeitende Formate — JPG, PNG, WebP und AVIF. Wählen Sie die von Ihrem Shop erzeugten Formate. PrestaShop 8 und 9 erzeugen häufig WebP und AVIF zusätzlich zum Hauptformat.

Wie das Wasserzeichen funktioniert

Das Modul klinkt sich in den nativen actionWatermark-Hook von PrestaShop ein, der bei jeder (Neu-)Generierung der Thumbnails eines Produktbilds ausgelöst wird. Für jeden ausgewählten Bildtyp und jedes aktive Format lädt das Modul das erzeugte Thumbnail, wendet das Wasserzeichen an und speichert die Datei erneut, wobei die in Ihren Bildeinstellungen definierten Qualitätsstufen übernommen werden.

Nur die Varianten pro Bildtyp werden verarbeitet: Die Originaldatei bleibt unangetastet. Sie können das Wasserzeichen also ändern und beliebig oft neu generieren, ohne die Quelle je zu verschlechtern.

Das Wasserzeichen auf bestehende Produkte anwenden

Der Hook verarbeitet ein Bild nur in dem Moment, in dem es generiert wird. Um einen bereits veröffentlichten Katalog mit Wasserzeichen zu versehen, führen Sie eine Thumbnail-Neugenerierung durch:

1. Öffnen Sie Design > Bildeinstellungen (eine direkte Schaltfläche befindet sich auf der Modulseite).
2. Starten Sie die Thumbnail-Neugenerierung für Produktbilder.

Die Neugenerierung erstellt die Thumbnails aus den Originalen neu, anschließend wendet das Modul das Wasserzeichen darauf an. Bei sehr großen Katalogen bevorzugen Sie die native Neugenerierung von PrestaShop, die für große Mengen ausgelegt ist. Die Neugenerierung ist auch über die Kommandozeile verfügbar:

bin/console prestashop:thumbnails:regenerate products

Logo-Modus oder Text-Modus

Der Logo-Modus passt zu Ihnen, wenn Sie eine starke visuelle Identität haben: Ein transparentes PNG unten rechts bei 60 % Deckkraft genügt, um Ihre Visuals zu signieren, ohne das Produkt zu stören.

Der Text-Modus ist ideal für einen schnellen Hinweis ohne Datei-Vorbereitung. Die DejaVuSans-Schrift ist im Modul eingebettet, was eine identische Darstellung auf jedem Hosting garantiert, unabhängig von den auf dem Server installierten Schriften.

Kompatibilität

• PrestaShop — 1.7, 8.x und 9.x. Die 9.x-Kompatibilität umfasst die neue Symfony-basierte Neugenerierung: Das Modul löst seine Dateipfade defensiv auf, um auch dann zu funktionieren, wenn Legacy-Konstanten nicht geladen sind.
• PHP — 7.2 und höher, mit der GD-Erweiterung.
• Formate — JPG, PNG, WebP und AVIF sowie die hochauflösenden @2x-Varianten. Die Verarbeitung von WebP und AVIF hängt davon ab, ob diese Formate von der GD-Bibliothek des Servers unterstützt werden.

Deinstallation

Die Deinstallation entfernt die Konfiguration des Moduls und seinen Hook. Bereits angewendete Wasserzeichen bleiben bis zur nächsten Neugenerierung auf den Thumbnails. Um wasserzeichenfreie Bilder zurückzuerhalten, deinstallieren Sie das Modul und generieren Sie die Thumbnails neu: Sie gehen wieder von den Originaldateien aus, die unangetastet geblieben sind.

Fehlerbehebung

• Das Logo erscheint zu klein oder zu groß — passen Sie die Logo-Größe an (in % der Breite) oder setzen Sie sie auf 0, um die native Größe beizubehalten.
• WebP oder AVIF ohne Wasserzeichen — der Server muss über eine GD-Bibliothek verfügen, die mit Unterstützung für diese Formate kompiliert ist. Andernfalls werden die betreffenden Dateien einfach übersprungen, ohne Fehler.
• Wasserzeichen auf winzigen Thumbnails — erhöhen Sie die Mindestbreite, um kleine Formate auszuschließen.

FAQ

Werden meine Originalbilder verändert?

Nein. Nur die pro Bildtyp erzeugten Thumbnails erhalten ein Wasserzeichen. Die Originaldatei bleibt unangetastet.

Wie wende ich das Wasserzeichen auf bereits veröffentlichte Produkte an?

Konfigurieren Sie das Modul und führen Sie dann unter Design > Bildeinstellungen eine Thumbnail-Neugenerierung durch. Neu hochgeladene Bilder erhalten das Wasserzeichen automatisch.

Funktioniert das Modul mit WebP und AVIF?

Ja, ebenso wie mit @2x-Varianten, sofern die GD-Erweiterung des Servers diese Formate unterstützt.

Muss ich für den Text-Modus eine Datei vorbereiten?

Nein. Sie geben einfach den Text ein; die Schrift ist im Modul eingebettet.

Bleibt die Transparenz meines PNG-Logos erhalten?

Ja, dank eines maßgeschneiderten Alpha-Merges, der die Transparenz erhält und gleichzeitig die gewählte Deckkraft anwendet.

Ist das Modul mit PrestaShop 9 kompatibel?

Ja, das Modul ist mit PrestaShop 1.7, 8 und 9 kompatibel, einschließlich der neuen Symfony-basierten Neugenerierung.