Automatisch watermerk op productafbeeldingen: volledige handleiding

Overzicht

De module DataFirefly Watermerk plaatst uw logo of een tekst op de miniaturen van uw productafbeeldingen. Het watermerk wordt toegepast wanneer een afbeelding aan een product wordt toegevoegd, bij de CSV-import, via de webservice en bij elke nieuwe generatie van de miniaturen. De originele bestanden worden nooit gewijzigd: elke miniatuur wordt gestempeld vanuit een verse kopie van het origineel, en elk bestand met watermerk krijgt een vingerafdruk die een tweede watermerk voorkomt.

Deze handleiding beschrijft versie 1.1.1.

Vereisten

• PrestaShop 1.7.0 tot 9.x.
• PHP 5.4 tot 8.4, met de extensie GD. Zonder GD wordt de installatie geweigerd.
• FreeType (meegecompileerd in GD) voor de tekstmodus. Als het ontbreekt, meldt de configuratiepagina dat en blijft de logomodus beschikbaar.
• De verwerking van WebP– en AVIF-bestanden hangt af van wat de GD-bibliotheek van de server kan schrijven. Niet-ondersteunde formaten zijn grijs in het tabblad Regels.

Installatie

1. Open in de back-office Modules > Modulebeheer.
2. Klik op Een module uploaden en sleep het ZIP-archief erin.
3. Klik na de installatie op Configureren.

De standaardinstellingen zijn direct bruikbaar: logo rechtsonder, dekking 60%, formaat 25% van de breedte, marge 3%, minimale breedte 250 px, alle miniatuurformaten van minstens 250 px breed en alle formaten die de server ondersteunt. In de tekstmodus is de standaardtekst © {shop_name}. U hoeft alleen nog uw logo te uploaden.

Bijwerken vanaf versie 1.0.x

1. Upload het archief 1.1.1 over de oude versie heen via de modulebeheerder. PrestaShop voert het updatescript uit.
2. Uw instellingen blijven behouden: logo, dekking, formaat, positie, aangevinkte formaten, bestandsformaten. De marges in pixels van 1.0.x worden vervangen door een marge in procenten. In de tekstmodus blijft het normale lettertype zonder effect, zodat het resultaat er hetzelfde uitziet.
3. De melding Nog één stap na de update verschijnt. Klik op Catalogus openen en daarna op Alles opnieuw genereren.

Deze nieuwe generatie maakt elke miniatuur opnieuw vanuit het origineel voordat het watermerk wordt geplaatst. Ze verwijdert de watermerken die versie 1.0.1 bij herhaald opnieuw genereren in PrestaShop 8 en 9 op elkaar had gestapeld. De melding verdwijnt aan het einde van de verwerking.

De configuratiepagina

Bovenaan de pagina toont een schakelaar Automatisch watermerk aan of uit. Staat hij uit, dan laat de module toegevoegde of opnieuw gegenereerde afbeeldingen ongemoeid, en miniaturen die al een watermerk hebben blijven zoals ze zijn. Een link verwijst naar deze documentatie.

De instellingen zijn verdeeld over drie tabbladen: Ontwerp, Regels en Catalogus. Zodra een instelling verandert, verschijnt onderaan een balk Niet-opgeslagen wijzigingen met twee knoppen: Verwerpen en Opslaan. Er wordt niets op de afbeeldingen toegepast voordat u opslaat.

Tabblad Ontwerp

Type watermerk

Kies Logo of Tekst.

Logo

• Sleep uw bestand naar Sleep uw logo hierheen of klik om te bladeren. Geaccepteerde formaten: PNG (transparant aanbevolen), WebP, GIF of JPG, maximaal 5 MB en 40 megapixel.
• Het logo wordt omgezet naar PNG, verkleind tot 1600 px als het groter is, en de transparante randen worden bijgesneden. Formaat en marge gelden zo voor de zichtbare afbeelding en niet voor een lege zone eromheen.
• Vervangen uploadt een nieuw bestand, Verwijderen wist het logo.

Tekst

• Watermerktekst: maximaal 120 tekens. De knop Variabele invoegen voegt een variabele toe op de positie van de cursor.
• Lettertype: DejaVu Sans, Sans Bold, Sans Condensed Bold of Serif. De lettertypen worden met de module meegeleverd, het resultaat is op elke hosting identiek.
• Kleur, Effect (Geen, Schaduw of Omtrek) en Hoek van -90° tot 90°. Schaduw of omtrek houden de tekst leesbaar op lichte en donkere foto’s.

Beschikbare variabelen, per afbeelding ingevuld:

• {shop_name}: naam van de winkel
• {domain}: domein van de winkel
• {year}: huidig jaar
• {product_name}: productnaam
• {reference}: referentie van het product
• {manufacturer}: merk van het product

Voorbeeld: © {shop_name} · {reference} geeft “© Maison Lumen · NW-SNK-01” op de afbeeldingen van het product met referentie NW-SNK-01.

Plaatsing

• Positie: 9 ankerpunten (hoeken, midden van de randen, midden) of Tegelpatroon, dat het watermerk verspringend over de hele afbeelding herhaalt. Het tegelpatroon beschermt het best tegen hergebruik, een hoek geeft een discrete signatuur.
• Dekking: 5 tot 100%.
• Formaat, in % van de afbeeldingsbreedte: 5 tot 100%.
• Marge vanaf de randen: 0 tot 20%, voor de verankerde posities.
• Afstand tussen herhalingen: alleen voor het tegelpatroon.

Omdat formaat en marge relatief zijn aan elke afbeelding, behoudt het watermerk dezelfde verhoudingen op alle miniatuurformaten.

Live voorbeeld

Het voorbeeld wordt berekend door dezelfde engine als uw afbeeldingen, op basis van een van uw recente producten. Het menu Product en de knop Ander product wisselen de getoonde foto, het menu Formaat kiest de miniatuur. De knoppen Origineel, Met watermerk en Vergelijken wisselen de weergave; in de modus Vergelijken sleept u de schuifregelaar om voor en na te zien. Het voorbeeld meldt ook wanneer het gekozen product is uitgesloten of wanneer het getoonde formaat onder de minimale breedte ligt.

Tabblad Regels

Miniatuurformaten met watermerk

Vink de productafbeeldingstypen aan die verwerkt moeten worden. Elk type toont zijn afmetingen. Standaard zijn alle formaten van minstens 250 px breed aangevinkt.

Minimale breedte

Miniaturen die smaller zijn dan deze waarde blijven zonder watermerk, ook als hun formaat is aangevinkt. Op de kleine afbeeldingen in winkelwagen en zoekresultaten zou een watermerk onleesbaar zijn.

Bestandsformaten

JPG, PNG, WebP en AVIF. PrestaShop 8 en 9 kunnen naast het hoofdformaat WebP- en AVIF-kopieën genereren: laat alle formaten aangevinkt die uw winkel genereert, anders blijft één versie van de afbeelding zonder watermerk. Formaten die GD op uw server niet kan schrijven, zijn grijs.

Uitsluitingen

• Hoofdafbeeldingen zonder watermerk houden: Google Merchant Center weigert productafbeeldingen met een watermerk of logo. Vink deze optie aan als uw hoofdafbeeldingen Google Shopping voeden; de andere foto’s van het product krijgen nog steeds een watermerk.
• Uitgesloten categorieën: een product dat aan een van deze categorieën is gekoppeld, behoudt afbeeldingen zonder watermerk.
• Uitgesloten merken en Uitgesloten product-ID’s.

De lijsten met categorieën en merken hebben een zoekveld. Een afbeelding met watermerk die wordt uitgesloten, wordt bij de volgende verwerking opgeschoond.

Tabblad Catalogus

Statistieken

Vier tellers: Afbeeldingen met watermerk (in aantal bestanden), In de wachtrij (nieuwe afbeeldingen of gewijzigde instellingen), Uitgesloten (zonder watermerk volgens uw regels) en Fouten. De datum van de laatste run wordt getoond.

Toepassen op de catalogus

• Wachtende afbeeldingen verwerken: zet een watermerk op nieuwe afbeeldingen en werkt de afbeeldingen bij die door uw laatste wijzigingen worden geraakt. Actuele bestanden worden overgeslagen. Dit is de actie na elke wijziging van de instellingen.
• Alles opnieuw genereren: maakt elke miniatuur opnieuw vanuit het origineel en zet er daarna het watermerk op. Gebruik dit na het bijwerken vanaf 1.0.x of als een ander hulpmiddel uw miniaturen heeft gewijzigd.
• Watermerk verwijderen: maakt schone miniaturen opnieuw vanuit de originelen en schakelt het automatische watermerk uit.

De verwerking loopt in batches van enkele seconden, met een voortgangsbalk en een knop Annuleren. Ze werkt op shared hosting met een beperkte PHP-uitvoeringstijd. Laat het tabblad open tijdens de verwerking; als u haar onderbreekt, start u dezelfde actie opnieuw om haar af te ronden.

Testen op één product

Voer een Product-ID in en klik op Toepassen om de afbeeldingen met de huidige instellingen van een watermerk te voorzien, of op Opschonen om ze weer zonder watermerk te maken. Controleer daarna de productpagina in uw winkel (leeg de browsercache als de oude afbeelding nog verschijnt).

Werking

De module gebruikt de hook actionWatermark, die PrestaShop activeert nadat de miniaturen van een productafbeelding zijn aangemaakt. Voor elke miniatuur die aan uw regels voldoet:

1. controleert ze de vingerafdruk: als het bestand al een watermerk met de huidige instellingen heeft en niet is gewijzigd, blijft het zoals het is;
2. anders maakt ze de miniatuur opnieuw vanuit de originele afbeelding, met de afmetingen en schaalmodus van PrestaShop;
3. plaatst ze het watermerk, slaat het bestand op met de kwaliteitsniveaus uit de afbeeldingsinstellingen van de winkel en bewaart de vingerafdruk.

Zo wordt het probleem van de nieuwe generatie in PrestaShop 8 en 9 opgelost: als de optie om oude afbeeldingen te wissen niet is aangevinkt, maakt PrestaShop alleen de ontbrekende miniaturen aan en activeert daarna de hook voor alle afbeeldingen. Zonder vingerafdruk zou een watermerkmodule de bestaande miniaturen een tweede keer stempelen.

De module ondersteunt ook de miniaturen met hoge resolutie (2x) van PrestaShop 1.7 en 8 en de optie “PNG voor alle afbeeldingen”, die PNG-gegevens in .jpg-bestanden opslaat. Transparante afbeeldingen behouden hun transparantie.

De ingebouwde nieuwe generatie van PrestaShop blijft beschikbaar: Uiterlijk > Afbeeldingsinstellingen, of via de opdrachtregel in PrestaShop 8 en 9:

php bin/console prestashop:thumbnails:regenerate products

Multistore

PrestaShop deelt de productafbeeldingsbestanden tussen alle winkels. De instellingen van de module gelden daarom voor alle winkels, ongeacht de context die in de back-office is gekozen. De variabelen {shop_name} en {domain} gebruiken de winkel die actief is op het moment van verwerking: als uw winkels verschillende namen hebben, kiest u beter een vaste tekst of een logo.

Verwijderen

Bij het verwijderen worden de instellingen, het logo en de twee tabellen van de module gewist. Miniaturen met watermerk worden niet gewijzigd. Wilt u weer schone afbeeldingen, klik dan eerst op Watermerk verwijderen in het tabblad Catalogus en verwijder daarna de module. U kunt ook de module verwijderen en vervolgens de miniaturen opnieuw genereren via Uiterlijk > Afbeeldingsinstellingen met de optie om oude afbeeldingen te wissen aangevinkt.

Probleemoplossing

• De winkel toont nog de oude afbeelding: de browser of een CDN houdt de oude versie in de cache. Herlaad zonder cache of leeg de CDN.
• Foutenteller boven nul: de originele afbeelding ontbreekt meestal op de schijf of is onleesbaar. Open het product, vervang de afbeelding en start de verwerking opnieuw.
• De tekstmodus is niet beschikbaar: de GD-bibliotheek van de server heeft geen FreeType. Vraag uw hostingprovider om het te activeren, of gebruik de logomodus met een PNG die uw tekst bevat.
• WebP of AVIF grijs: GD kan dit formaat op uw server niet schrijven. Deze bestanden worden niet verwerkt.
• Watermerk te klein op miniaturen: het formaat is proportioneel, verhoog het of sluit kleine formaten uit met de minimale breedte.
• Twee watermerken zichtbaar na het bijwerken vanaf 1.0.1: voer “Alles opnieuw genereren” uit in het tabblad Catalogus.

FAQ

Worden mijn originele afbeeldingen gewijzigd?

Nee. Alleen de miniaturen krijgen een watermerk, altijd vanuit een verse kopie van het origineel.

Moet ik na elke wijziging van de instellingen opnieuw genereren?

Nee. De betrokken afbeeldingen komen in de wachtrij. Eén klik op “Wachtende afbeeldingen verwerken” werkt ze bij zonder de andere opnieuw te maken.

Kan een afbeelding twee watermerken krijgen?

Nee. Elk bestand met watermerk houdt een vingerafdruk bij. Een actueel bestand wordt overgeslagen; een bestand met oudere instellingen of gewijzigd door een ander hulpmiddel wordt vanuit het origineel opnieuw gemaakt voordat het wordt gestempeld.

Krijgen afbeeldingen die via CSV worden geïmporteerd een watermerk?

Ja. PrestaShop activeert dezelfde hook bij de import en via de webservice.

Vertraagt de module mijn winkel?

Nee. Het watermerk wordt berekend bij het aanmaken van de miniaturen, nooit bij het tonen van pagina’s.

Is de module compatibel met PrestaShop 1.7?

Ja, van PrestaShop 1.7.0 tot 9.x, met PHP 5.4 tot 8.4.