Filigrane Automatique des Images Produit — Guide complet

Présentation

Le module Filigrane Automatique appose votre logo ou votre nom sur les miniatures de vos images produit, sans intervention manuelle. Le filigrane est appliqué dès qu’une image est ajoutée à un produit et lors de chaque régénération des miniatures. Point essentiel : vos fichiers originaux ne sont jamais modifiés. Seules les déclinaisons par type d’image (large, home, catégorie, etc.) sont tamponnées, ce qui garantit qu’une nouvelle régénération repart toujours d’une source propre.

Le module propose deux modes — un logo PNG transparent ou un texte — avec un réglage fin de l’opacité, de la taille, de la position et des formats traités. Il est compatible PrestaShop 1.7, 8 et 9, et ne requiert que l’extension PHP GD, présente sur la quasi-totalité des hébergements.

Installation

1. Depuis le back-office, ouvrez Modules > Gestionnaire de modules.
2. Cliquez sur Installer un module et déposez l’archive ZIP du module.
3. Une fois l’installation terminée, cliquez sur Configurer.

À l’installation, le module enregistre le hook actionWatermark et applique des réglages par défaut prêts à l’emploi (opacité 60 %, position en bas à droite, taille du logo à 25 % de la largeur, tous les types d’images sélectionnés). L’extension GD est vérifiée : si elle est absente, l’installation est interrompue avec un message explicite.

Configuration

La page de configuration est organisée en trois panneaux : Type de filigrane, Apparence & position et Application. Un aperçu du logo actuellement téléversé est affiché en haut de la page, ainsi qu’un bouton direct vers la régénération des miniatures.

Type de filigrane

• Mode — choisissez entre Logo (image PNG) et Texte.
• Logo du filigrane — téléversez votre image (PNG transparent recommandé, 4 Mo maximum). Le fichier est converti en PNG pour préserver la transparence. Laissez ce champ vide pour conserver le logo actuel.
• Supprimer le logo — cochez cette case pour retirer le logo enregistré.
• Texte du filigrane — le texte à incruster en mode Texte (nom de boutique, copyright, URL…).
• Couleur du texte — la couleur du texte, en mode Texte.

Apparence & position

• Opacité (%) — de 1 (très transparent) à 100 (opaque).
• Taille du logo (% largeur image) — la largeur du logo exprimée en pourcentage de la largeur de l’image. La valeur 0 conserve la taille native du logo. Exprimer la taille en pourcentage permet au filigrane de garder des proportions cohérentes sur tous les formats d’image, de la grande fiche produit à la vignette de catégorie.
• Taille du texte (% largeur image) — même principe, pour le mode Texte.
• Angle du texte (°) — inclinaison du texte, en mode Texte.
• Position — neuf ancrages (haut/centre/bas × gauche/centre/droite) ou le mode Mosaïque, qui répète le filigrane sur toute l’image.
• Marges horizontale et verticale (px) — l’écart en pixels par rapport au bord, pour les positions d’ancrage.
• Espacement mosaïque (%) — l’écart entre les répétitions, utilisé uniquement avec la position Mosaïque.

Application

• Largeur minimale (px) — les images plus étroites que cette valeur ne sont pas filigranées. Cela évite de tamponner les micro-vignettes (panier, recherche), où un filigrane serait illisible.
• Types d’images à filigraner — sélectionnez les types d’images concernés (large_default, home_default, etc.). Chaque type affiche ses dimensions pour vous aider à choisir.
• Formats à traiter — JPG, PNG, WebP et AVIF. Sélectionnez les formats générés par votre boutique. PrestaShop 8 et 9 produisent souvent WebP et AVIF en plus du format principal.

Comment fonctionne le filigrane

Le module s’accroche au hook natif actionWatermark de PrestaShop, déclenché à chaque (re)génération des miniatures d’une image produit. Pour chaque type d’image sélectionné et chaque format actif, le module charge la miniature générée, applique le filigrane, puis réenregistre le fichier en reprenant les niveaux de qualité définis dans les paramètres d’images de votre boutique.

Seules les déclinaisons par type d’image sont traitées : le fichier original reste intact. Vous pouvez donc changer de filigrane et régénérer autant de fois que nécessaire sans jamais dégrader la source.

Appliquer le filigrane aux produits existants

Le hook ne traite une image qu’au moment où elle est générée. Pour filigraner tout un catalogue déjà en ligne, lancez une régénération des miniatures :

1. Ouvrez Design > Paramètres d’images (un bouton direct est présent sur la page du module).
2. Lancez la régénération des miniatures pour les images produit.

La régénération recrée les miniatures à partir des originaux, puis le module y applique le filigrane. Sur les très gros catalogues, préférez la régénération native de PrestaShop, conçue pour traiter de grands volumes. La régénération est aussi disponible en ligne de commande :

bin/console prestashop:thumbnails:regenerate products

Mode logo ou mode texte

Le mode logo convient si vous avez une identité visuelle forte : un PNG transparent posé en bas à droite, à 60 % d’opacité, suffit à signer vos visuels sans gêner la lecture du produit.

Le mode texte est idéal pour une mention rapide sans préparer de fichier. La police DejaVuSans est embarquée dans le module, ce qui garantit un rendu identique sur tous les hébergements, sans dépendre des polices installées sur le serveur.

Compatibilité

• PrestaShop — 1.7, 8.x et 9.x. La compatibilité 9.x couvre la nouvelle régénération basée sur Symfony : le module résout ses chemins de fichiers de façon défensive pour fonctionner même lorsque les constantes historiques ne sont pas chargées.
• PHP — 7.2 et supérieur, avec l’extension GD.
• Formats — JPG, PNG, WebP et AVIF, ainsi que les variantes haute densité @2x. Le traitement de WebP et AVIF dépend du support de ces formats par la bibliothèque GD du serveur.

Désinstallation

La désinstallation supprime la configuration du module et son hook. Les filigranes déjà appliqués restent présents sur les miniatures jusqu’à la prochaine régénération. Pour retrouver des images sans filigrane, désinstallez le module puis régénérez les miniatures : elles repartent des fichiers originaux, restés intacts.

Dépannage

• Le logo apparaît trop petit ou trop grand — ajustez la Taille du logo (en % de la largeur), ou mettez-la à 0 pour conserver la taille native.
• WebP ou AVIF non filigranés — le serveur doit disposer d’une bibliothèque GD compilée avec le support de ces formats. Si ce n’est pas le cas, les fichiers concernés sont simplement ignorés, sans erreur.
• Filigrane sur les vignettes minuscules — augmentez la Largeur minimale pour exclure les petits formats.

FAQ

Mes images originales sont-elles modifiées ?

Non. Seules les miniatures générées par type d’image sont filigranées. Le fichier original reste intact.

Comment appliquer le filigrane aux produits déjà en ligne ?

Configurez le module, puis lancez une régénération des miniatures depuis Design > Paramètres d’images. Les nouvelles images uploadées sont filigranées automatiquement.

Le module fonctionne-t-il avec WebP et AVIF ?

Oui, ainsi qu’avec les variantes @2x, à condition que l’extension GD du serveur supporte ces formats.

Faut-il préparer un fichier pour le mode texte ?

Non. Il suffit de saisir le texte ; la police est embarquée dans le module.

La transparence de mon logo PNG est-elle conservée ?

Oui, grâce à une fusion alpha sur mesure qui préserve la transparence tout en appliquant l’opacité choisie.

Le module est-il compatible PrestaShop 9 ?

Oui, le module est compatible PrestaShop 1.7, 8 et 9, y compris la nouvelle régénération via le moteur Symfony.