Automatisches Wasserzeichen für Produktbilder: vollständige Anleitung
Das automatische Wasserzeichen für Produktbilder in PrestaShop 1.7, 8 und 9 installieren, aktualisieren und konfigurieren: Logo oder Text mit Variablen, Live-Vorschau, Ausschlussregeln, Katalogverarbeitung und Fehlerbehebung.
Überblick
Das Modul DataFirefly Wasserzeichen setzt Ihr Logo oder einen Text auf die Miniaturen Ihrer Produktbilder. Das Wasserzeichen wird angewendet, wenn ein Bild zu einem Produkt hinzugefügt wird, beim CSV-Import, über den Webservice und bei jeder Neugenerierung der Miniaturen. Die Originaldateien werden nie verändert: Jede Miniatur wird aus einer frischen Kopie des Originals gestempelt, und jede Datei mit Wasserzeichen erhält einen Fingerabdruck, der ein zweites Wasserzeichen verhindert.
Diese Anleitung gilt für Version 1.1.1.
Voraussetzungen
- PrestaShop 1.7.0 bis 9.x.
- PHP 5.4 bis 8.4 mit der Erweiterung GD. Ohne GD wird die Installation abgelehnt.
- FreeType (in GD einkompiliert) für den Textmodus. Fehlt es, weist die Konfigurationsseite darauf hin und der Logomodus bleibt nutzbar.
- Die Verarbeitung von WebP– und AVIF-Dateien hängt davon ab, was die GD-Bibliothek des Servers schreiben kann. Nicht unterstützte Formate sind im Reiter Regeln ausgegraut.
Installation
- Öffnen Sie im Backoffice Module > Modul-Manager.
- Klicken Sie auf Modul hochladen und ziehen Sie das ZIP-Archiv hinein.
- Klicken Sie nach der Installation auf Konfigurieren.
Die Standardeinstellungen sind sofort einsatzbereit: Logo unten rechts, Deckkraft 60 %, Größe 25 % der Breite, Rand 3 %, Mindestbreite 250 px, alle Miniaturgrößen ab 250 px Breite und alle vom Server unterstützten Formate. Im Textmodus lautet der Standardtext © {shop_name}. Sie müssen nur noch Ihr Logo hochladen.
Update von Version 1.0.x
- Laden Sie das Archiv 1.1.1 im Modul-Manager über die alte Version hoch. PrestaShop führt das Update-Skript aus.
- Ihre Einstellungen bleiben erhalten: Logo, Deckkraft, Größe, Position, ausgewählte Größen, Formate. Die Pixelabstände von 1.0.x werden durch einen prozentualen Rand ersetzt. Im Textmodus bleibt die normale Schrift ohne Effekt erhalten, damit das Ergebnis gleich aussieht.
- Ein Hinweis Ein letzter Schritt nach dem Update erscheint. Klicken Sie auf Katalog öffnen und dann auf Alles neu generieren.
Diese Neugenerierung erstellt jede Miniatur aus ihrem Original neu, bevor sie das Wasserzeichen erhält. Sie entfernt die Wasserzeichen, die Version 1.0.1 bei wiederholten Neugenerierungen in PrestaShop 8 und 9 gestapelt hat. Der Hinweis verschwindet am Ende der Verarbeitung.
Solange „Alles neu generieren“ nicht gelaufen ist, stapelt das Modul kein neues Wasserzeichen: Jede in der Zwischenzeit verarbeitete Miniatur wird zuerst aus dem Original neu erstellt.
Die Konfigurationsseite
Oben auf der Seite zeigt ein Schalter Automatisches Wasserzeichen an oder aus. Ist er aus, rührt das Modul hinzugefügte oder neu generierte Bilder nicht an, und Miniaturen mit Wasserzeichen bleiben unverändert. Ein Link führt zu dieser Dokumentation.
Die Einstellungen sind auf drei Reiter verteilt: Design, Regeln und Katalog. Sobald sich eine Einstellung ändert, erscheint unten eine Leiste Nicht gespeicherte Änderungen mit zwei Schaltflächen: Verwerfen und Speichern. Vor dem Speichern wird nichts auf die Bilder angewendet.
Reiter Design
Wasserzeichentyp
Wählen Sie Logo oder Text.
Logo
- Ziehen Sie Ihre Datei auf Logo hier ablegen oder klicken Sie zum Auswählen. Akzeptierte Formate: PNG (transparent empfohlen), WebP, GIF oder JPG, maximal 5 MB und 40 Megapixel.
- Das Logo wird in PNG umgewandelt, auf 1600 px verkleinert, falls es größer ist, und seine transparenten Ränder werden abgeschnitten. Größe und Rand beziehen sich so auf die sichtbare Grafik und nicht auf einen leeren Bereich darum.
- Ersetzen lädt eine neue Datei hoch, Entfernen löscht das Logo.
Text
- Wasserzeichentext: maximal 120 Zeichen. Die Schaltfläche Variable einfügen fügt eine Variable an der Cursorposition ein.
- Schriftart: DejaVu Sans, Sans Bold, Sans Condensed Bold oder Serif. Die Schriften werden mit dem Modul geliefert, das Ergebnis ist auf jedem Hosting identisch.
- Farbe, Effekt (Keiner, Schatten oder Kontur) und Winkel von -90° bis 90°. Schatten oder Kontur halten den Text auf hellen und dunklen Fotos lesbar.
Verfügbare Variablen, Bild für Bild ersetzt:
{shop_name}: Name des Shops{domain}: Domain des Shops{year}: aktuelles Jahr{product_name}: Produktname{reference}: Artikelnummer des Produkts{manufacturer}: Marke des Produkts
Beispiel: © {shop_name} · {reference} ergibt „© Maison Lumen · NW-SNK-01“ auf den Bildern des Produkts mit der Artikelnummer NW-SNK-01.
Platzierung
- Position: 9 Ankerpunkte (Ecken, Mitte der Ränder, Zentrum) oder Kachelmuster, das das Wasserzeichen versetzt über das ganze Bild wiederholt. Das Kachelmuster schützt am stärksten vor Weiterverwendung, eine Ecke ergibt eine dezente Signatur.
- Deckkraft: 5 bis 100 %.
- Größe in % der Bildbreite: 5 bis 100 %.
- Abstand zu den Rändern: 0 bis 20 %, für die Ankerpositionen.
- Abstand zwischen den Wiederholungen: nur für das Kachelmuster.
Da Größe und Rand relativ zu jedem Bild sind, behält das Wasserzeichen auf allen Miniaturgrößen dieselben Proportionen.
Live-Vorschau
Die Vorschau wird von derselben Engine wie Ihre Bilder berechnet, anhand eines Ihrer neuesten Produkte. Das Menü Produkt und die Schaltfläche Anderes Produkt wechseln das angezeigte Foto, das Menü Größe wählt die Miniatur. Die Schaltflächen Original, Mit Wasserzeichen und Vergleichen wechseln die Ansicht; im Modus Vergleichen ziehen Sie den Schieberegler, um vorher und nachher zu sehen. Die Vorschau zeigt außerdem an, wenn das gewählte Produkt ausgeschlossen ist oder die angezeigte Größe unter der Mindestbreite liegt.
Reiter Regeln
Miniaturgrößen mit Wasserzeichen
Aktivieren Sie die zu verarbeitenden Produktbildtypen. Jeder Typ zeigt seine Abmessungen. Standardmäßig sind alle Größen ab 250 px Breite aktiviert.
Mindestbreite
Schmalere Miniaturen bleiben ohne Wasserzeichen, auch wenn ihre Größe aktiviert ist. Auf den kleinen Bildern in Warenkorb und Suche wäre ein Wasserzeichen unlesbar.
Dateiformate
JPG, PNG, WebP und AVIF. PrestaShop 8 und 9 können WebP- und AVIF-Kopien zusätzlich zum Hauptformat erzeugen: Lassen Sie alle Formate aktiviert, die Ihr Shop erzeugt, sonst bliebe eine Version des Bildes ohne Wasserzeichen. Formate, die GD auf Ihrem Server nicht schreiben kann, sind ausgegraut.
Ausschlüsse
- Titelbilder ohne Wasserzeichen lassen: Google Merchant Center lehnt Produktbilder mit Wasserzeichen oder Logo ab. Aktivieren Sie diese Option, wenn Ihre Titelbilder Google Shopping speisen; die übrigen Fotos des Produkts erhalten weiterhin das Wasserzeichen.
- Ausgeschlossene Kategorien: Ein Produkt, das mit einer dieser Kategorien verknüpft ist, behält Bilder ohne Wasserzeichen.
- Ausgeschlossene Marken und Ausgeschlossene Produkt-IDs.
Die Listen der Kategorien und Marken haben ein Suchfeld. Ein Bild mit Wasserzeichen, das ausgeschlossen wird, wird bei der nächsten Verarbeitung bereinigt.
Reiter Katalog
Statistiken
Vier Zähler: Bilder mit Wasserzeichen (in Dateien), Ausstehend (neue Bilder oder geänderte Einstellungen), Ausgeschlossen (durch Ihre Regeln ohne Wasserzeichen) und Fehler. Das Datum des letzten Laufs wird angezeigt.
Auf den Katalog anwenden
- Ausstehende Bilder verarbeiten: versieht neue Bilder mit dem Wasserzeichen und aktualisiert die von Ihren letzten Änderungen betroffenen. Aktuelle Dateien werden übersprungen. Diese Aktion verwenden Sie nach jeder Änderung der Einstellungen.
- Alles neu generieren: erstellt jede Miniatur aus ihrem Original neu und versieht sie dann mit dem Wasserzeichen. Nach dem Update von 1.0.x verwenden, oder wenn ein anderes Werkzeug Ihre Miniaturen verändert hat.
- Wasserzeichen entfernen: erstellt saubere Miniaturen aus den Originalen und schaltet das automatische Wasserzeichen aus.
Die Verarbeitung läuft in Stapeln von wenigen Sekunden, mit Fortschrittsbalken und der Schaltfläche Abbrechen. Sie funktioniert auf Shared Hosting mit begrenzter PHP-Laufzeit. Lassen Sie den Tab während der Verarbeitung geöffnet; wenn Sie sie unterbrechen, starten Sie dieselbe Aktion erneut, um sie abzuschließen.
An einem Produkt testen
Geben Sie eine Produkt-ID ein und klicken Sie auf Anwenden, um seine Bilder mit den aktuellen Einstellungen zu versehen, oder auf Bereinigen, um sie wieder ohne Wasserzeichen herzustellen. Prüfen Sie danach die Produktseite in Ihrem Shop (leeren Sie den Browser-Cache, wenn noch das alte Bild erscheint).
Funktionsweise
Das Modul nutzt den Hook actionWatermark, den PrestaShop nach dem Erstellen der Miniaturen eines Produktbildes auslöst. Für jede Miniatur, die Ihre Regeln erfüllt:
- prüft es den Fingerabdruck: Trägt die Datei bereits ein Wasserzeichen mit den aktuellen Einstellungen und wurde nicht verändert, bleibt sie unverändert;
- andernfalls erstellt es die Miniatur aus dem Originalbild neu, mit den Abmessungen und dem Skalierungsmodus von PrestaShop;
- setzt es das Wasserzeichen, speichert die Datei mit den Qualitätsstufen aus den Bildeinstellungen des Shops und speichert ihren Fingerabdruck.
So wird das Problem der Neugenerierung in PrestaShop 8 und 9 gelöst: Ist die Option zum Löschen der alten Bilder nicht aktiviert, erstellt PrestaShop nur die fehlenden Miniaturen und löst danach den Hook für alle Bilder aus. Ohne Fingerabdruck würde ein Wasserzeichen-Modul die vorhandenen Miniaturen ein zweites Mal stempeln.
Das Modul unterstützt außerdem die hochauflösenden Miniaturen (2x) von PrestaShop 1.7 und 8 sowie die Option „PNG für alle Bilder“, die PNG-Daten in .jpg-Dateien schreibt. Transparente Bilder behalten ihre Transparenz.
Die native Neugenerierung von PrestaShop bleibt nutzbar: Design > Bildeinstellungen oder per Kommandozeile unter PrestaShop 8 und 9:
php bin/console prestashop:thumbnails:regenerate products
Multishop
PrestaShop teilt die Produktbilddateien zwischen allen Shops. Die Einstellungen des Moduls gelten daher für alle Shops, unabhängig vom im Backoffice gewählten Kontext. Die Variablen {shop_name} und {domain} verwenden den Shop, der bei der Verarbeitung aktiv ist: Haben Ihre Shops unterschiedliche Namen, verwenden Sie besser einen festen Text oder ein Logo.
Deinstallation
Die Deinstallation löscht die Einstellungen, das Logo und die beiden Tabellen des Moduls. Miniaturen mit Wasserzeichen werden nicht verändert. Um wieder saubere Bilder zu erhalten, klicken Sie zuerst im Reiter Katalog auf Wasserzeichen entfernen und deinstallieren dann. Sie können auch deinstallieren und danach die Miniaturen unter Design > Bildeinstellungen mit aktivierter Option zum Löschen der alten Bilder neu generieren.
Fehlerbehebung
Das Wasserzeichen wird nicht angewendet. Prüfen Sie, ob der Schalter auf „an“ steht, ob ein Logo hochgeladen (oder ein Text eingegeben) ist, ob im Reiter Regeln mindestens eine Größe und ein Format aktiviert sind und ob das Produkt nicht ausgeschlossen ist. Führen Sie dann „Ausstehende Bilder verarbeiten“ oder „An einem Produkt testen“ aus.
- Im Shop erscheint noch das alte Bild: Browser oder CDN halten die alte Version im Cache. Laden Sie ohne Cache neu oder leeren Sie das CDN.
- Fehlerzähler über null: Das Originalbild fehlt meist auf dem Datenträger oder ist unlesbar. Öffnen Sie das Produkt, ersetzen Sie das Bild und starten Sie die Verarbeitung erneut.
- Der Textmodus ist nicht verfügbar: Die GD-Bibliothek des Servers hat kein FreeType. Bitten Sie Ihren Hoster, es zu aktivieren, oder verwenden Sie den Logomodus mit einem PNG, das Ihren Text enthält.
- WebP oder AVIF ausgegraut: GD kann dieses Format auf Ihrem Server nicht schreiben. Diese Dateien werden nicht verarbeitet.
- Wasserzeichen auf Miniaturen zu klein: Die Größe ist proportional, erhöhen Sie sie oder schließen Sie kleine Größen über die Mindestbreite aus.
- Zwei Wasserzeichen sichtbar nach dem Update von 1.0.1: Führen Sie im Reiter Katalog „Alles neu generieren“ aus.
FAQ
Werden meine Originalbilder verändert?
Nein. Nur die Miniaturen erhalten ein Wasserzeichen, immer aus einer frischen Kopie des Originals.
Muss ich nach jeder Änderung der Einstellungen neu generieren?
Nein. Die betroffenen Bilder werden als ausstehend markiert. Ein Klick auf „Ausstehende Bilder verarbeiten“ aktualisiert sie, ohne die anderen neu zu erstellen.
Kann ein Bild zwei Wasserzeichen erhalten?
Nein. Jede Datei mit Wasserzeichen behält einen Fingerabdruck. Eine aktuelle Datei wird übersprungen; eine mit älteren Einstellungen gestempelte oder von einem anderen Werkzeug veränderte Datei wird vor dem Stempeln aus dem Original neu erstellt.
Wird das Wasserzeichen auf per CSV importierte Bilder angewendet?
Ja. PrestaShop löst denselben Hook beim Import und über den Webservice aus.
Verlangsamt das Modul meinen Shop?
Nein. Das Wasserzeichen wird beim Erstellen der Miniaturen berechnet, nie beim Anzeigen der Seiten.
Ist das Modul mit PrestaShop 1.7 kompatibel?
Ja, von PrestaShop 1.7.0 bis 9.x, mit PHP 5.4 bis 8.4.