Catalogo PDF per PrestaShop — Guida completa

Panoramica

DFPDFCatalog pubblica i tuoi cataloghi PDF direttamente sul tuo negozio PrestaShop. Il modulo crea due tipi di pagine nel front-office: una pagina vetrina che elenca tutti i tuoi cataloghi come banner cliccabili (/catalogues-pdf) e una pagina visualizzatore per catalogo (/catalogue-pdf/{id}-{slug}) con un lettore PDF integrato di livello professionale: modalità doppia pagina rivista, miniature cliccabili, schermo intero, zoom, link cliccabili e testo selezionabile.

Installazione

1. Scarica il file ZIP del modulo dal tuo account DataFirefly.
2. Nel back-office PrestaShop, vai su Moduli → Gestore moduli → Carica un modulo.
3. Seleziona il file dfpdfcatalog.zip e conferma.
4. Il modulo si installa automaticamente: tabelle di database, tab admin e rotte front vengono creati senza alcuna configurazione manuale.

Dopo l’installazione, un nuovo tab Cataloghi PDF appare nel menu Catalogo del back-office.

Aggiornamento da una versione precedente

1. Carica la nuova versione tramite Moduli → Gestore moduli → Carica un modulo (o sostituisci la cartella /modules/dfpdfcatalog/ via FTP).
2. Svuota la cache di PrestaShop: Parametri avanzati → Prestazioni → Svuota cache.

L’aggiornamento conserva i tuoi cataloghi esistenti: le tabelle di database e i file caricati (banner e PDF) non vengono toccati.

Aggiungere un catalogo

1. Vai su Catalogo → Cataloghi PDF e clicca su Aggiungi un catalogo.
2. Inserisci il titolo (traducibile per lingua) — genera anche lo slug dell’URL e il meta title della pagina.
3. Inserisci la descrizione (traducibile) — mostrata sulla pagina del visualizzatore e usata come meta description.
4. Carica l’immagine banner — è quella che appare nella griglia della pagina vetrina.
5. Carica il file PDF.
6. Definisci la posizione (ordine di visualizzazione nella griglia) e lo stato attivo/inattivo.
7. In configurazione multinegozio, spunta i negozi in cui il catalogo deve apparire.
8. Salva: il catalogo è immediatamente visibile su /catalogues-pdf.

Pagine front-office

Pagina vetrina

La pagina /catalogues-pdf mostra tutti i cataloghi attivi del negozio corrente come una griglia di banner, ordinati per posizione. Ogni banner rimanda al visualizzatore del catalogo. La pagina genera il proprio meta title e la propria meta description e si integra con i breadcrumb nativi di PrestaShop.

Pagina del visualizzatore

Ogni catalogo ha la propria pagina su /catalogue-pdf/{id}-{slug}. Il PDF viene mostrato nel visualizzatore integrato, con un pulsante di ritorno alla vetrina e un pulsante di download diretto. Il PDF viene servito tramite un controller PHP con l’header Content-Disposition inline, che forza la visualizzazione nel browser.

Usare il visualizzatore

Il visualizzatore è basato su PDF.js (Mozilla) e offre i seguenti controlli nella barra degli strumenti:

• Miniature — mostra o nasconde la barra laterale delle miniature delle pagine. Le miniature sono cliccabili e si generano progressivamente allo scorrimento (rendering lazy), anche per cataloghi molto lunghi. La o le pagine attive sono evidenziate.
• Doppia pagina — alterna tra la visualizzazione pagina per pagina e la modalità doppia pagina rivista: copertina sola, poi coppie 2-3, 4-5, ecc. Questa modalità è attivata per default sugli schermi di almeno 1024 px di larghezza.
• Navigazione — pulsanti precedente/successivo e indicatore di pagina (per esempio «Pagina 4-5 / 24» in modalità doppia pagina). Funzionano anche le frecce sinistra/destra della tastiera.
• Zoom — zoom avanti/indietro a passi del 25% e pulsante di adattamento automatico alla larghezza.
• Schermo intero — porta il visualizzatore a schermo intero tramite l’API nativa del browser. Su iOS Safari viene usata automaticamente una modalità schermo intero simulata. Il tasto Esc permette di uscire.

Gli hyperlink contenuti nel PDF restano cliccabili: i link esterni si aprono in una nuova scheda e i link interni (sommario, rimandi) navigano direttamente nel visualizzatore. Se il PDF contiene uno strato di testo, il testo è selezionabile, copiabile, e la ricerca Ctrl+F del browser funziona sul contenuto.

Il rendering usa la densità di pixel dello schermo (HiDPI): le pagine sono nitide su schermi Retina e 4K.

SEO e URL

Il modulo registra le sue rotte tramite l’hook moduleRoutes di PrestaShop:

• /catalogues-pdf — pagina vetrina con meta title e meta description dedicati.
• /catalogue-pdf/{id}-{slug} — un URL pulito per catalogo, dove lo slug viene generato automaticamente dal titolo. Il meta title usa il titolo del catalogo e la meta description usa la sua descrizione.

Nessuna pagina CMS da creare: le rotte vengono registrate automaticamente all’installazione.

Multilingua e multinegozio

I titoli e le descrizioni si traducono campo per campo nel modulo di modifica (selettore di lingua standard di PrestaShop). Ogni lingua genera il proprio slug e i propri meta. In multinegozio, l’associazione catalogo/negozio si gestisce con caselle di controllo: ogni negozio mostra solo i cataloghi che gli sono assegnati.

Risoluzione dei problemi

Il PDF non viene visualizzato

• Verifica che il file PDF sia stato effettivamente caricato (rimodifica il catalogo nel back-office).
• Svuota la cache di PrestaShop e ricarica la pagina in navigazione privata.
• Se appare un messaggio di errore nel visualizzatore, viene proposto in alternativa un link di download diretto del PDF.

Il testo non è selezionabile o Ctrl+F non trova nulla

La selezione del testo richiede che il PDF contenga uno strato di testo. I PDF scansionati o esportati come puro bitmap non ne hanno: in questo caso è possibile solo la visualizzazione grafica. Passa il documento in uno strumento OCR se hai bisogno del testo.

I link del PDF non sono cliccabili

I link devono essere vere annotazioni di link nel PDF (create dallo strumento di esportazione: InDesign, Word, LibreOffice…). Un testo che assomiglia a un URL ma senza annotazione non sarà cliccabile.

Le pagine appaiono allungate o sfocate

Questo problema della versione 1.0.0 è corretto dalla versione 1.0.1 (rendering HiDPI e neutralizzazione dei reset CSS dei temi). Aggiorna il modulo e svuota la cache di PrestaShop.

Cronologia delle versioni

• 1.0.4 (2026-05-11) — Modalità schermo intero (API nativa + fallback iOS Safari); correzione del fit-width della copertina in modalità doppia pagina; evidenziazione dei pulsanti attivi.
• 1.0.3 (2026-05-11) — Modalità doppia pagina rivista (copertina sola, poi 2-3, 4-5…); auto-attivazione su schermi larghi; annullamento pulito dei rendering obsoleti nelle navigazioni rapide.
• 1.0.2 (2026-05-11) — Barra laterale di miniature cliccabili con rendering lazy; strato di testo (selezione + Ctrl+F); pulsante miniature.
• 1.0.1 (2026-05-11) — Rendering HiDPI nitido su Retina/4K; link del PDF cliccabili (strato annotazioni); correzione dello stretching verticale delle pagine.
• 1.0.0 (2026-05-08) — Prima versione: pagina vetrina, visualizzatore integrato, URL SEO, multilingua, multinegozio.