Opzioni Immagine

Controlla quale formato di immagine, quante immagini e in quale ordine i tuoi prodotti compaiono nel feed del catalogo Facebook e Instagram.

note

Disponibile dalla v1.0.0

Panoramica

Ogni voce prodotto nel feed richiede almeno un URL immagine. Facebook accetta anche fino a 10 URL di immagini aggiuntive per prodotto tramite il campo additional_image_link, utilizzato per mostrare diverse angolazioni negli annunci dinamici e nel catalogo del negozio.

La scheda Images Options nella configurazione del modulo consente di decidere quale formato immagine di PrestaShop utilizzare, se verificare l'esistenza fisica dei file immagine prima di includerli, come codificare gli URL e quante immagini includere per prodotto. Configurare correttamente queste impostazioni influisce sia sulla qualità dei tuoi annunci sia sul tempo necessario per generare il feed.

Configurazione

Vai su Moduli > Gestione moduli, trova Facebook & Instagram Product Catalogue Feed Pro e clicca su Configura. Poi clicca sulla scheda Images Options.

Campo	Valori	Predefinito	Descrizione
Select image size to show with products	Qualsiasi tipo di immagine PS registrato per i prodotti	fpf_image (se disponibile)	Il formato di miniatura PrestaShop utilizzato per costruire gli URL delle immagini nel feed.
Disable check image exists	Abilitato / Disabilitato	Disabilitato	Quando disabilitato, il modulo verifica l'esistenza fisica del file sul disco prima di includere l'immagine. Abilitare per saltare il controllo.
Disable image URL encoding	Abilitato / Disabilitato	Disabilitato	Quando disabilitato, il modulo applica la translitterazione iconv per rimuovere i caratteri non ASCII dagli URL delle immagini. Abilitare per conservare i caratteri speciali così come sono.
Disable Additional Images	Abilitato / Disabilitato	Disabilitato	Quando disabilitato, tutte le immagini aggiuntive del prodotto vengono incluse come voci additional_image_link. Abilitare per esportare solo l'immagine di copertina.
Ignore cover?	Abilitato / Disabilitato	Disabilitato	Quando abilitato, il modulo ignora l'immagine di copertina designata del prodotto e utilizza la prima immagine in ordine di posizione come immagine principale.
Images limit	Intero	0 (nessun limite)	Numero massimo di immagini (copertina + aggiuntive) da includere per prodotto. Impostare su 0 per includere tutte le immagini disponibili.
Image Position Start	Intero	0 (disabilitato)	Indice di posizione da cui iniziare la selezione delle immagini. Impostare su 0 per partire dalla copertina. Qualsiasi valore maggiore di 0 abilita automaticamente Ignore cover.

Raccomandazione sul formato immagine: Facebook funziona meglio con immagini quadrate o quasi quadrate. Scegli un tipo di immagine con un rapporto d'aspetto vicino a 1:1. Se nessuno dei tuoi tipi esistenti corrisponde, il modulo installa un tipo fpf_image dedicato — ma devi rigenerare le miniature in PrestaShop (Design > Preferenze Immagini) dopo averlo selezionato.

Come Funziona Ogni Impostazione

Selettore del tipo di immagine

PrestaShop archivia le immagini dei prodotti in più formati pre-generati (miniature). Il selettore elenca tutti i tipi di immagine registrati per il contesto "prodotti". Il modulo utilizza il nome del tipo selezionato quando chiama getImageLink() di PrestaShop per costruire l'URL di ciascun prodotto.

Se selezioni fpf_image, devi rigenerare le miniature nel Back Office almeno una volta — altrimenti quei file non esisteranno sul disco e nel feed appariranno errori relativi alle immagini.

WebP e AVIF: PrestaShop può archiviare le immagini in WebP o AVIF in base alle impostazioni di qualità delle immagini (Design > Preferenze Immagini > Formato Immagine). L'importatore di cataloghi di Facebook non accetta in modo affidabile URL WebP o AVIF per tutti i formati di annunci. Se nel tuo negozio utilizzi un formato immagine moderno, abilita Disable check image exists affinché il modulo non salti silenziosamente le immagini che non riesce a trovare come .jpg, e verifica in Facebook Commerce Manager che le immagini vengano recuperate correttamente.

Disable check image exists

Per impostazione predefinita, prima di aggiungere un URL immagine al feed, il modulo verifica che il file .jpg (o .png) corrispondente esista nel filesystem del server. Questo impedisce che URL di immagini non funzionanti raggiungano Facebook.

Abilita questa impostazione in due situazioni:

• Il tuo negozio utilizza un formato immagine non standard (WebP, AVIF, JPEG 2000, derivati HEIC) in cui il controllo di esistenza del modulo cerca un .jpg che non è mai presente.
• Il tuo catalogo è molto grande e la generazione del feed è lenta — saltare il controllo sul filesystem velocizza notevolmente la generazione.

Disable image URL encoding

Per impostazione predefinita, il modulo applica la translitterazione UTF-8 tramite iconv agli URL delle immagini prima di scriverli nel feed. Questo converte i caratteri accentati o speciali (comuni nei slug di prodotto in francese, spagnolo, tedesco e altre lingue) nei loro equivalenti ASCII, producendo URL più puliti e sicuri per tutti i parser XML.

Abilita Disable image URL encoding se i tuoi URL di immagini utilizzano già una corretta codifica percentuale o se la translitterazione sta corrompendo gli URL nella tua lingua specifica.

Disable Additional Images

Quando disabilitato (impostazione predefinita), il modulo raccoglie tutte le immagini associate a un prodotto oltre alla copertina e le scrive come campi additional_image_link nel feed. Facebook accetta fino a 10 valori additional_image_link per prodotto — il modulo applica automaticamente questo limite indipendentemente dal numero di immagini presenti nel prodotto.

Abilita questa impostazione per omettere completamente le immagini aggiuntive e includere solo la copertina. Questo può ridurre significativamente i tempi di generazione del feed per cataloghi grandi con molte immagini per prodotto.

Ignore cover

Quando disabilitato (impostazione predefinita), il modulo utilizza l'immagine contrassegnata come copertina del prodotto in PrestaShop come image_link principale nel feed.

Abilita Ignore cover per utilizzare invece la prima immagine in ordine di posizione, ignorando il flag di copertina. Questo è utile se le tue immagini di copertina non sono le creatività con le migliori prestazioni per gli annunci, ma il tuo ordinamento per posizione lo è.

Images limit

Imposta un numero per limitare quante immagini per prodotto vengono scritte nel feed. La copertina conta come prima immagine; le immagini aggiuntive occupano le posizioni dalla 2 in poi. Il limite viene applicato prima del limite massimo di 10 immagini imposto da Facebook.

Lascia 0 per esportare tutte le immagini disponibili (Facebook applica comunque un limite di 10 immagini aggiuntive).

Image Position Start

Inserisci un numero di posizione (a partire da 1) per iniziare la selezione delle immagini da quella posizione nell'elenco delle immagini del prodotto, anziché dalla prima. Ad esempio, inserendo 2 il modulo utilizza la seconda immagine (per posizione) come image_link principale e salta la prima.

Quando questa impostazione è maggiore di 0, Ignore cover viene attivato automaticamente — perché il modulo non sta più utilizzando l'immagine di copertina, e l'opzione copertina sarebbe ridondante.

Controlla la scheda Errori: Se imposti Image Position Start su un numero superiore al totale delle immagini presenti in alcuni prodotti, quei prodotti appariranno nella scheda Errors sotto "Products with less than N images." L'etichetta della scheda riflette dinamicamente il valore di inizio configurato.

Esempi d'Uso

Esempio: Catalogo grande con immagini WebP Il tuo negozio è configurato per generare immagini WebP. Il controllo del filesystem del modulo cerca file .jpg e contrassegna centinaia di prodotti come aventi immagini mancanti. Abilita Disable check image exists affinché gli URL vengano inclusi indipendentemente dal formato, e verifica in Facebook Commerce Manager che le immagini si carichino correttamente.

Esempio: Catalogo moda — salta la copertina lifestyle, usa la foto prodotto pulita I tuoi prodotti hanno una foto lifestyle come copertina, ma la seconda immagine è una foto pulita del prodotto su sfondo bianco. Imposta Image Position Start su 2. Il modulo utilizzerà la posizione 2 come image_link per tutti i prodotti e abiliterà automaticamente Ignore cover.

Esempio: Velocizzare la generazione per 50.000 prodotti Il tuo feed impiega 40 minuti per essere generato. Abilita Disable Additional Images per saltare il ciclo di raccolta immagini per prodotto, e abilita Disable check image exists per saltare le verifiche sul filesystem. Queste due modifiche riducono tipicamente i tempi di generazione del 20–40% per i cataloghi grandi.

Note Importanti

• Il limite di additional_image_link di Facebook è 10 immagini. Il modulo applica questo limite rigido in FeedImage::getAdditionalImages() indipendentemente dall'impostazione Images limit.
• Se utilizzi le combinazioni (varianti prodotto), le immagini assegnate a una combinazione specifica vengono utilizzate per le voci di quella variante. Se non esistono immagini specifiche per la combinazione, vengono utilizzate le immagini condivise del prodotto.
• Gli URL delle immagini utilizzano sempre il dominio SSL del tuo negozio quando SSL è abilitato (PS_SSL_ENABLED). Se il dominio delle immagini differisce da quello del negozio (ad esempio, una CDN), il modulo corregge la parte host dell'URL affinché corrisponda al dominio del negozio corrente.
• Queste impostazioni sono per-negozio nelle configurazioni multi-negozio. Regolale separatamente per ogni contesto di negozio.

Risoluzione dei Problemi

Problema	Soluzione
Molti errori immagine nella scheda Errors anche se i prodotti hanno immagini	Abilita Disable check image exists — le tue immagini potrebbero essere salvate in formato WebP o AVIF, che il controllo del filesystem non individua.
Gli URL delle immagini contengono caratteri illeggibili o non si caricano	Disabilita Disable image URL encoding (ovvero mantieni la codifica abilitata) affinché il modulo rimuova i caratteri non ASCII dagli URL.
La generazione del feed è molto lenta per un catalogo grande	Abilita Disable Additional Images e/o Disable check image exists per saltare le operazioni per immagine più dispendiose in termini di tempo.
Facebook mostra l'immagine sbagliata come copertina del prodotto	Abilita Ignore cover se la designazione della copertina in PrestaShop non corrisponde all'immagine che vuoi usare su Facebook, oppure usa Image Position Start per selezionare una posizione specifica.
I prodotti scompaiono dal feed dopo aver impostato Image Position Start	Quei prodotti hanno meno immagini di quante ne richieda la posizione di inizio. Abbassa il valore o aggiungi più immagini ai prodotti interessati.
È stato selezionato il tipo fpf_image ma le immagini nel feed sono rotte	Devi rigenerare le miniature in PrestaShop (Design > Preferenze Immagini > Rigenera miniature) dopo aver selezionato fpf_image.

Domande Frequenti

Quale formato di immagine dovrei scegliere per gli annunci Facebook?

Facebook consiglia immagini con un rapporto d'aspetto 1:1 (quadrate). Osserva i tipi di immagine elencati nel selettore e scegli quello le cui dimensioni si avvicinano al quadrato, tipicamente 800×800 px o più grande. Evita i formati banner molto larghi, poiché Facebook potrebbe ritagliarli o rifiutarli.

Facebook accetta immagini WebP nel feed del catalogo?

L'importatore di cataloghi di Facebook può recuperare immagini WebP da un URL, ma il supporto varia in base al formato e al posizionamento dell'annuncio. In caso di dubbi, mantieni l'impostazione della qualità immagine di PrestaShop su JPEG e usa un tipo di immagine .jpg in modo che il feed punti sempre a file JPEG.

Perché abilitare Image Position Start attiva automaticamente Ignore cover?

Quando si indica al modulo di partire da una posizione specifica, la designazione della copertina diventa irrilevante — il modulo seleziona per ordine, non in base al flag di copertina. Il modulo abilita Ignore cover automaticamente per evitare un conflitto tra le due impostazioni.

Posso includere più di 10 immagini aggiuntive per prodotto?

No. La specifica del feed di Facebook consente un massimo di 10 valori additional_image_link per prodotto. Il modulo applica questo limite e smette di aggiungere immagini una volta raggiunte le 10, indipendentemente dal numero di immagini presenti nel prodotto in PrestaShop.

Disabilitare il controllo dell'esistenza delle immagini causa URL rotti su Facebook?

Solo se i file immagine non esistono davvero. Il controllo è un filtro di sicurezza — disabilitarlo significa che il modulo assume che tutti gli URL immagine che costruisce siano validi. Se le tue immagini esistono ma in un formato non standard (WebP, AVIF), disabilitare il controllo è la soluzione corretta. Se le immagini sono davvero mancanti, produrranno errori in Facebook Commerce Manager.

Come interagisce Image Position Start con le immagini delle combinazioni?

Per le combinazioni, il modulo cerca prima le immagini assegnate alla combinazione specifica. Se trovate, FPF_IMG_START viene applicato all'elenco immagini di quella combinazione tramite array_slice. Se non esistono immagini specifiche per la combinazione, viene utilizzato l'elenco immagini condiviso del prodotto con lo stesso offset di inizio.

Funzionalità Correlate

• Combinations
• Cycle Generation