Filigrana Automatica sulle Immagini Prodotto — Guida completa
Installare, configurare e usare la filigrana automatica sulle immagini prodotto: modalità logo PNG e testo, opacità, dimensione in percentuale, 9 posizioni e mosaico, formati JPG/PNG/WebP/AVIF, rigenerazione delle miniature e buone pratiche per PrestaShop 8 e 9.
Panoramica
Il modulo Filigrana Automatica applica il tuo logo o il tuo nome sulle miniature delle tue immagini prodotto, senza alcun intervento manuale. La filigrana viene applicata non appena un’immagine viene aggiunta a un prodotto e a ogni rigenerazione delle miniature. Il punto chiave: i tuoi file originali non vengono mai modificati. Solo le varianti per tipo di immagine (large, home, categoria, ecc.) ricevono la filigrana, il che garantisce che una nuova rigenerazione riparta sempre da una sorgente pulita.
Il modulo offre due modalità — un logo PNG trasparente o un testo — con un controllo preciso di opacità, dimensione, posizione e formati elaborati. È compatibile con PrestaShop 1.7, 8 e 9 e richiede solo l’estensione PHP GD, presente su quasi tutti gli hosting.
Installazione
- Dal back-office, apri Moduli > Gestore dei moduli.
- Clicca su Carica un modulo e trascina l’archivio ZIP del modulo.
- Al termine dell’installazione, clicca su Configura.
All’installazione, il modulo registra l’hook actionWatermark e applica impostazioni predefinite pronte all’uso (opacità 60 %, posizione in basso a destra, dimensione del logo al 25 % della larghezza, tutti i tipi di immagine selezionati). L’estensione GD viene verificata: se manca, l’installazione viene interrotta con un messaggio esplicito.
Configurazione
La pagina di configurazione è organizzata in tre pannelli: Tipo di filigrana, Aspetto e posizione e Applicazione. In alto è mostrata un’anteprima del logo attualmente caricato, insieme a un pulsante diretto alla rigenerazione delle miniature.
Tipo di filigrana
- Modalità — scegli tra Logo (immagine PNG) e Testo.
- Logo della filigrana — carica la tua immagine (PNG trasparente consigliato, 4 MB massimo). Il file viene convertito in PNG per preservare la trasparenza. Lascia questo campo vuoto per conservare il logo attuale.
- Elimina il logo — spunta questa casella per rimuovere il logo salvato.
- Testo della filigrana — il testo da incorporare in modalità Testo (nome del negozio, copyright, URL…).
- Colore del testo — il colore del testo, in modalità Testo.
Aspetto e posizione
- Opacità (%) — da 1 (molto trasparente) a 100 (opaco).
- Dimensione del logo (% larghezza immagine) — la larghezza del logo espressa in percentuale della larghezza dell’immagine. Il valore 0 conserva la dimensione nativa del logo. Esprimere la dimensione in percentuale permette alla filigrana di mantenere proporzioni coerenti su tutti i formati di immagine, dalla scheda prodotto grande alla miniatura di categoria.
- Dimensione del testo (% larghezza immagine) — stesso principio, per la modalità Testo.
- Angolo del testo (°) — inclinazione del testo, in modalità Testo.
- Posizione — nove ancoraggi (alto/centro/basso × sinistra/centro/destra) o la modalità Mosaico, che ripete la filigrana su tutta l’immagine.
- Margini orizzontale e verticale (px) — la distanza in pixel dal bordo, per le posizioni di ancoraggio.
- Spaziatura mosaico (%) — la distanza tra le ripetizioni, usata solo con la posizione Mosaico.
Applicazione
- Larghezza minima (px) — le immagini più strette di questo valore non ricevono la filigrana. Questo evita di applicarla sulle micro-miniature (carrello, ricerca), dove una filigrana sarebbe illeggibile.
- Tipi di immagine da filigranare — seleziona i tipi di immagine pertinenti (large_default, home_default, ecc.). Ogni tipo mostra le sue dimensioni per aiutarti nella scelta.
- Formati da elaborare — JPG, PNG, WebP e AVIF. Seleziona i formati generati dal tuo negozio. PrestaShop 8 e 9 producono spesso WebP e AVIF oltre al formato principale.
Dopo ogni modifica, ricordati di salvare e poi di rigenerare le miniature per applicare le nuove impostazioni alle immagini già pubblicate. Le nuove immagini caricate ricevono la filigrana automaticamente con le impostazioni correnti.
Come funziona la filigrana
Il modulo si aggancia all’hook nativo actionWatermark di PrestaShop, attivato a ogni (ri)generazione delle miniature di un’immagine prodotto. Per ogni tipo di immagine selezionato e ogni formato attivo, il modulo carica la miniatura generata, applica la filigrana e poi risalva il file riutilizzando i livelli di qualità definiti nelle impostazioni delle immagini del tuo negozio.
Vengono elaborate solo le varianti per tipo di immagine: il file originale resta intatto. Puoi quindi cambiare la filigrana e rigenerare quante volte vuoi senza mai degradare la sorgente.
In modalità logo, la trasparenza del tuo PNG è preservata grazie a una fusione alfa su misura che combina l’opacità globale che imposti con la trasparenza nativa dell’immagine. Non viene aggiunta alcuna cornice né sfondo opaco attorno al logo.
Applicare la filigrana ai prodotti esistenti
L’hook elabora un’immagine solo nel momento in cui viene generata. Per filigranare un catalogo già pubblicato, avvia una rigenerazione delle miniature:
- Apri Design > Impostazioni immagini (un pulsante diretto è presente sulla pagina del modulo).
- Avvia la rigenerazione delle miniature per le immagini prodotto.
La rigenerazione ricrea le miniature a partire dagli originali, poi il modulo vi applica la filigrana. Sui cataloghi molto grandi, preferisci la rigenerazione nativa di PrestaShop, progettata per grandi volumi. La rigenerazione è disponibile anche da riga di comando:
bin/console prestashop:thumbnails:regenerate productsModalità logo o modalità testo
La modalità logo fa per te se hai un’identità visiva forte: un PNG trasparente posizionato in basso a destra al 60 % di opacità basta a firmare i tuoi visual senza disturbare il prodotto.
La modalità testo è ideale per un avviso rapido senza preparare alcun file. Il font DejaVuSans è incluso nel modulo, il che garantisce una resa identica su qualsiasi hosting, indipendentemente dai font installati sul server.
Compatibilità
- PrestaShop — 1.7, 8.x e 9.x. La compatibilità 9.x copre la nuova rigenerazione basata su Symfony: il modulo risolve i suoi percorsi di file in modo difensivo per funzionare anche quando le costanti legacy non sono caricate.
- PHP — 7.2 e superiore, con l’estensione GD.
- Formati — JPG, PNG, WebP e AVIF, così come le varianti ad alta densità
@2x. L’elaborazione di WebP e AVIF dipende dal supporto di questi formati da parte della libreria GD del server.
Disinstallazione
La disinstallazione rimuove la configurazione del modulo e il suo hook. Le filigrane già applicate restano sulle miniature fino alla rigenerazione successiva. Per riottenere immagini senza filigrana, disinstalla il modulo e poi rigenera le miniature: ripartono dai file originali, rimasti intatti.
Risoluzione dei problemi
La filigrana non viene applicata. Verifica che almeno un tipo di immagine e un formato siano spuntati nel pannello Applicazione, che un logo sia effettivamente caricato in modalità logo (o un testo inserito in modalità testo), e che la larghezza minima non escluda il tipo di immagine desiderato. Poi avvia una rigenerazione delle miniature.
- Il logo appare troppo piccolo o troppo grande — regola la Dimensione del logo (in % della larghezza), oppure mettila a 0 per conservare la dimensione nativa.
- WebP o AVIF senza filigrana — il server deve disporre di una libreria GD compilata con il supporto di questi formati. In caso contrario, i file interessati vengono semplicemente ignorati, senza errore.
- Filigrana sulle miniature minuscole — aumenta la Larghezza minima per escludere i formati piccoli.
FAQ
Le mie immagini originali vengono modificate?
No. Solo le miniature generate per tipo di immagine ricevono la filigrana. Il file originale resta intatto.
Come applico la filigrana ai prodotti già online?
Configura il modulo, poi avvia una rigenerazione delle miniature da Design > Impostazioni immagini. Le nuove immagini caricate ricevono la filigrana automaticamente.
Il modulo funziona con WebP e AVIF?
Sì, così come con le varianti @2x, a condizione che l’estensione GD del server supporti tali formati.
Bisogna preparare un file per la modalità testo?
No. Basta digitare il testo; il font è incluso nel modulo.
La trasparenza del mio logo PNG viene preservata?
Sì, grazie a una fusione alfa su misura che preserva la trasparenza applicando al contempo l’opacità scelta.
Il modulo è compatibile con PrestaShop 9?
Sì, il modulo è compatibile con PrestaShop 1.7, 8 e 9, inclusa la nuova rigenerazione tramite il motore Symfony.