Risoluzione problemi di visualizzazione
Risolvi i problemi più comuni quando i PDF non appaiono nel tuo storefront.
I PDF non vengono visualizzati affatto
Controlla questi tre requisiti:
✅ Il PDF è collegato alla risorsa (prodotto, pagina, ecc.)
✅ Lo stato del PDF è Attivo (non inattivo)
✅ L'estensione del tema è aggiunta al tuo tema
Tutti e tre devono essere soddisfatti. Controlla ciascuno:
- Apri la tua libreria PDF
- Clicca sul PDF che dovrebbe apparire
- Verifica che sia collegato alla risorsa corretta
- Controlla che lo stato sia impostato su Attivo
- Vai nell'editor del tema e conferma che l'estensione sia aggiunta
Se stai usando blocchi manuali (PDF Embedded Manual o PDF Button Manual), questi controlli per i PDF collegati non si applicano. Usa i controlli per blocchi manuali sotto.
Il blocco URL manuale non mostra nulla
- Conferma di aver inserito almeno un URL
https://...pdfvalido - Conferma che il blocco sia nel template di prodotto attivo
- Salva nell'editor del tema e aggiorna il negozio con hard refresh
- Imposta temporaneamente il tipo di visualizzatore su Native Browser per isolare i problemi con i parametri del visualizzatore personalizzato
- Se usi etichette pulsante manuali, verifica che il numero di righe delle etichette corrisponda al numero di righe degli URL
I PDF appaiono sulle pagine sbagliate
Possibili cause:
Risorsa sbagliata collegata
- Controlla a quali risorse è collegato il PDF
- Scollega dalle risorse non corrette
- Collega alle risorse corrette
Mismatch del filtro template
- Controlla le impostazioni del filtro template
- Verifica che la pagina stia usando il template previsto
- Rimuovi o regola il filtro template
Scopri il filtro per template →
Alcuni PDF appaiono, altri no
Controlla lo stato dei singoli PDF:
- I PDF nascosti sono probabilmente impostati su Inattivo
- Cambia lo stato su Attivo per i PDF mancanti
Controlla i filtri template:
- Alcuni PDF potrebbero avere filtri template applicati
- Esamina le impostazioni del filtro per i PDF che non vengono visualizzati
L'estensione del tema non è nell'editor del tema
Problema di compatibilità del tema:
Il tuo tema potrebbe non supportare le estensioni app:
- Controlla la documentazione del tema per il supporto alle estensioni app
- Aggiorna il tema all'ultima versione
- Contatta lo sviluppatore del tema per supporto
- Considera il passaggio a un tema compatibile con le estensioni
La maggior parte dei temi Shopify moderni (2.0+) supporta le estensioni app.
I PDF si caricano lentamente
Ottimizza la dimensione del file:
- Comprimi i PDF prima di caricarli
- Mantieni i file sotto i 5 MB quando possibile
- Rimuovi le pagine o le immagini non necessarie
Controlla la connessione internet:
- Le connessioni lente influenzano il caricamento
- Testa su reti diverse
- Prova con dati mobili vs WiFi
Usa la visualizzazione a pulsante:
- Lo stile a pulsante si carica più velocemente di quello incorporato
- I clienti caricano solo i PDF che cliccano
- Migliore per gli utenti mobile
Il visualizzatore incorporato mostra uno schermo bianco
Il PDF potrebbe essere corrotto:
- Prova a ricaricare il PDF
- Apri prima il PDF sul tuo computer per verificare che funzioni
- Risalva il PDF usando un software diverso
Compatibilità del browser:
- Prova un browser diverso
- Aggiorna il browser all'ultima versione
- Svuota la cache del browser
Appare il PDF sbagliato
Controlla le connessioni dei collegamenti:
- Visualizza le risorse collegate per quel PDF
- Scollega dalle pagine dove non dovrebbe apparire
- Verifica che il PDF corretto sia collegato a ogni risorsa
Più PDF collegati:
- Se sono collegati diversi PDF, appaiono tutti
- Scollega i PDF indesiderati
- Riordina se necessario
Per i blocchi manuali, controlla le righe degli URL direttamente nelle impostazioni del blocco invece dei collegamenti.
Il pulsante PDF non si apre
Problema JavaScript:
- Controlla la console del browser per errori
- Prova un browser diverso
- Disabilita temporaneamente le app in conflitto
Conflitto con il tema:
- Alcuni temi bloccano i popup
- Controlla le impostazioni del tema
- Contatta lo sviluppatore del tema
Il filtro template non funziona
Errori comuni:
Nome template sbagliato:
- I nomi dei template sono case-sensitive
- Controlla attentamente l'ortografia
- Verifica che il template esista nel tuo tema
Template non attivo:
- La pagina potrebbe usare un template diverso
- Controlla il template effettivo nell'editor del tema
- Assegna il template corretto alla pagina
Risolvi i problemi di template →
Le modifiche non appaiono
Ritardo della cache:
- Aspetta 30-60 secondi dopo aver apportato modifiche
- Aggiorna la pagina (hard refresh: Cmd/Ctrl + Shift + R)
- Svuota la cache del browser se necessario
Tema non salvato:
- Assicurati di aver cliccato Save nell'editor del tema
- Controlla l'indicatore delle modifiche non salvate
Hai ancora problemi?
Prova questi passaggi:
-
Aggiorna tutto:
- Hard refresh del browser
- Risalva il tema nell'editor
- Aspetta qualche minuto
-
Testa in modalità incognito:
- Apre una sessione browser nuova
- Bypassa i problemi di cache
- Esclude le estensioni del browser
-
Controlla pagine diverse:
- Visualizza una risorsa diversa (prodotto/pagina)
- Testa homepage vs pagina prodotto
- Isola dove si verifica il problema
-
Contatta il supporto:
- Descrivi cosa vedi vs cosa ti aspetti
- Condividi screenshot se possibile
- Indica il nome del tuo tema
- Includi il tipo di piano