Configurazione viewer PDF
Configura come i PDF vengono visualizzati dai clienti scegliendo tra quattro tipi di viewer nell'app.
Dove configurare
Imposta il tipo di viewer nella pagina dei dettagli del PDF, nella sezione Viewer Configuration.
Questa configurazione si applica alle Theme App Extension collegate a quel PDF (sia i popup del pulsante che i viewer incorporati).
I blocchi con URL manuale usano le impostazioni del viewer nello schema del blocco del tema. Blocchi URL manuali →
Quattro tipi di viewer
Custom Viewer (completo)
L'opzione più potente, con controllo completo sull'esperienza di visualizzazione del PDF.
Funzionalità:
- Tutti i controlli di navigazione
- Funzione di ricerca
- Strumenti di zoom e opzioni di visualizzazione personalizzabili
- Visualizzazione ottimizzata per mobile
Opzioni di configurazione:
Impostazioni viewer PDF:
- Initial Page – Quale pagina mostrare per prima (1, 2, 3, ecc.)
- Initial Zoom – Livello di zoom predefinito (Auto Fit, Fit Width, Fit Page, 50%, 75%, 100%, 125%, 150%, 200%)
- Page Layout – Single Page, Two Pages Odd, Two Pages Even
- Scroll Direction – Vertical, Horizontal, Wrapped, Page Scrolling
Barra degli strumenti e funzionalità:
- Enable Download – Permette ai clienti di scaricare il PDF
- Show Toolbar – Mostra la barra di navigazione
- Enable Add Image/Stamp Tool – Permette ai clienti di aggiungere immagini o timbri
- Enable Highlighter Tool – Funzione di evidenziazione del testo
- Enable Drawing Tools – Disegno a mano libera sui PDF
- Enable Text Selection – Consente la selezione e la copia del testo
Ideale per:
- Documenti tecnici che richiedono zoom e ricerca
- Manuali di prodotto con navigazione
- Documenti in cui i clienti devono evidenziare o annotare
- Visualizzazione su desktop e mobile
Light Viewer (veloce e semplice)
Un viewer semplificato, ottimizzato per velocità e semplicità.
Funzionalità:
- Viewer semplice e a caricamento rapido
- Interfaccia minimale
- Perfetto per l'anteprima rapida di documenti
- Ottimizzato per mobile
Opzioni di configurazione:
- Nessuna – funziona immediatamente!
Ideale per:
- Documenti di consultazione rapida
- PDF semplici che non richiedono funzioni avanzate
- Negozi mobile-first che privilegiano la velocità di caricamento
- Schede di garanzia, certificati, moduli semplici
Native Browser Viewer (standard)
Utilizza il visualizzatore PDF integrato del browser per un'esperienza familiare e standard.
Funzionalità:
- Capacità di visualizzazione PDF native del browser
- Affidabile e universalmente supportato
- Nessuna configurazione aggiuntiva necessaria
- Nota: L'esperienza di visualizzazione può variare tra browser diversi (Chrome, Safari, Firefox, ecc.)
Opzioni di configurazione:
- Nessuna – usa le impostazioni predefinite del browser
Ideale per:
- Clienti abituati alla visualizzazione PDF standard del browser
- Documenti semplici che non richiedono funzioni personalizzate
- Massima compatibilità con tutti i browser
- Visualizzazione PDF senza personalizzazioni
Importante: Poiché utilizza il viewer PDF nativo di ogni browser, l'esperienza può risultare incoerente tra browser e dispositivi diversi.
Flipbook Viewer (sfoglio interattivo)
Un'esperienza di sfoglio interattivo che simula la lettura di un libro fisico.
Funzionalità:
- Animazione di sfoglio delle pagine
- Esperienza di lettura realistica stile libro/rivista
- Ottimo per contenuti visivi e cataloghi
- Non ottimizzato per mobile
Opzioni di configurazione:
- Animation Style – Smooth Animation, Fast Animation, No Animation
- Page Shadows – Aggiunge ombre realistiche ed effetti di profondità
- Background Color – Scegli tra Light Gray, White, Off White, Medium Gray, Dark Gray
Ideale per:
- Cataloghi e brochure
- Materiali di marketing e lookbook
- Contenuti in stile rivista
- Esperienze di visualizzazione su desktop
Non consigliato per:
- Negozi mobile-first
- Documenti tecnici
- PDF lunghi con molto testo
Configurazione viewer: collegato vs manuale
| Flusso | Dove si configura il viewer | Ambito |
|---|---|---|
Blocchi collegati (pdf_embedded, pdf_button) | Pagina dettaglio PDF nell'app | Per PDF |
Blocchi manuali (pdf_embedded_manual, pdf_button_manual) | Impostazioni blocco nel tema | Per blocco |
I blocchi manuali supportano gli stessi quattro tipi di viewer:
- Native Browser
- Custom Viewer
- Flipbook
- Light Viewer
Per i blocchi manuali, un unico profilo viewer si applica a tutti gli URL presenti in quel blocco.
Come impostare la configurazione del viewer
- Vai alla tua libreria PDF nell'app
- Clicca sul PDF che vuoi configurare
- Trova la sezione Viewer Configuration
- Clicca per espandere la sezione
- Seleziona il Viewer Type dal menu a tendina
- Configura le opzioni disponibili per quel tipo di viewer
- Clicca Save Configuration
Il viewer si applica ovunque
La configurazione del viewer scelta si applica a:
- ✅ Popup del pulsante (quando i clienti cliccano il pulsante)
- ✅ Viewer incorporati (PDF mostrati direttamente nelle pagine)
- ✅ Tutti i template in cui questo PDF viene visualizzato
- ✅ Tutte le risorse a cui questo PDF è collegato
La imposti una volta sola, e funziona ovunque quel PDF venga mostrato.
Per i blocchi manuali, le opzioni del viewer vengono impostate nel blocco stesso e si applicano a tutti gli URL presenti in quel blocco.
Impostazioni extension vs configurazione viewer
Non confondere questi due aspetti:
| Configurazione viewer (app) | Impostazioni extension (editor tema) |
|---|---|
| Custom, Light, Native Browser o Flipbook | Colori del pulsante, testo, allineamento |
| Zoom, barra degli strumenti, opzioni di download | Altezza del viewer, testo dell'intestazione |
| Layout pagina, direzione di scorrimento | Bordo contenitore, dimensione modale |
| Impostato una volta per PDF | Impostato per extension nel tema |
| Controlla le funzionalità del PDF | Controlla stile e layout |
I blocchi manuali combinano entrambe le configurazioni nelle impostazioni del tema: elenco URL + tipo di viewer + opzioni del viewer.
Esempio:
- Scegliere Custom Viewer con download abilitato e zoom iniziale al 100% → è configurazione viewer
- Impostare il colore del pulsante su blu e la dimensione della modale all'80% → sono impostazioni dell'extension
Modificare la configurazione del viewer in qualsiasi momento
Puoi cambiare il tipo di viewer quando vuoi:
- Apri la pagina dei dettagli del PDF
- Espandi Viewer Configuration
- Seleziona un tipo di viewer diverso
- Regola le impostazioni
- Clicca Save Configuration
Le modifiche si applicano immediatamente a tutte le Theme App Extension che mostrano quel PDF.
Consigli per la configurazione del viewer
Inizia con il Custom Viewer:
- L'opzione più versatile
- Funziona ottimamente nella maggior parte dei casi
- Altamente configurabile
Passa al Light Viewer se:
- I PDF si caricano lentamente
- Preferisci l'esperienza più semplice possibile
- La velocità su mobile è prioritaria
Usa il Native Browser Viewer quando:
- I clienti preferiscono la visualizzazione PDF standard del browser
- È necessaria la massima compatibilità
- Non sono richieste funzioni personalizzate