Se la tua libreria di documenti funziona perfettamente sulla sua pagina, ma i pulsanti Download (e a volte Anteprima) non fanno nulla una volta che la incorpori su un altro sito web, questo articolo spiega il motivo e cosa fare.
Cosa succede
Alcune piattaforme per siti web caricano i contenuti incorporati in un sandbox iframe, che è un contenitore bloccato a cui il browser impedisce deliberatamente di fare alcune cose, incluso scaricare file. Quando la tua libreria di documenti viene inserita in uno di questi ambienti sandbox, il browser blocca il download in modo silenzioso, quindi il pulsante sembra non fare nulla.
Anche l'anteprima può essere interessata. Per impostazione predefinita, l'anteprima si apre in una nuova scheda del browser, e la stessa sandbox blocca anche l'apertura di nuove schede.
Questa è una restrizione imposta dalla piattaforma di hosting e applicata dal browser. Non è un difetto di Document Library Pro. La stessa libreria scarica perfettamente dal proprio URL e su qualsiasi piattaforma che non inserisca gli incorporamenti in sandbox.
Wix è l'esempio più comune. Entrambe le opzioni di incorporamento di Wix (“Incorpora HTML/Codice” e “Incorpora un sito”) racchiudono la tua libreria in una sandbox che non consente i download.
Come verificare che sia questa la causa
Controlla prima questo, perché se i sintomi sono diversi potrebbe trattarsi di un problema a sé che noi possiamo risolvere:
- Apri l'URL diretto della libreria. Copia l'indirizzo dal tuo Embed Code (per esempio
https://your-library.documentlibrary.app/?dlp_embed=1) e aprilo in una nuova scheda del browser. Fai clic su Download. Se lì funziona ma non da incorporato, la causa è la sandbox di incorporamento. - Controlla la console del browser (facoltativo, tecnico). Nella pagina incorporata, apri la console per sviluppatori del browser. Un messaggio come "Download is disallowed. The frame… is sandboxed and the 'allow-downloads' permission is not set" oppure
ERR_BLOCKED_BY_CLIENTlo conferma.
Se il file anche non si scarica nemmeno dall'URL diretto, allora non il problema della sandbox, quindi contattare l'assistenza e ti aiuteremo a capire cosa succede.
Come risolvere
Wix
Installa e usa l'app Wix di Document Library Pro invece di incollare un Embed Code. L'app aggiunge la tua libreria come elemento Wix nativo non isolato, così download e anteprima funzionano normalmente. Se hai incollato l'Embed Code e riscontri questo problema, contattare l'assistenza e ti aiuteremo a passare all'app.
WordPress self-hosted, Webflow, Framer o siti in semplice HTML
Questi non inseriscono gli incorporamenti in sandbox, quindi il codice di incorporamento standard funziona, download inclusi. Se riscontri il problema su uno di questi, la causa è un'altra, quindi contattare l'assistenza.
Altri costruttori di siti web (Squarespace, Notion e simili)
Se la piattaforma offre un'app o un'integrazione ufficiale Document Library Pro, usa quella. Se offre solo una casella generica “codice di incorporamento” e la mette in sandbox, i download non possono essere abilitati su quella piattaforma. Puoi comunque lasciare che i visitatori visualizzare i tuoi documenti (vedi sotto).
Opzione sola visualizzazione (funziona anche in una sandbox)
Se sulla tua piattaforma non è possibile attivare i download, i visitatori possono comunque aprire e leggere i documenti in un visualizzatore nella pagina. Basta impostare il pulsante di download della libreria su off il pulsante di download nella scheda Visualizzazione delle impostazioni e lasciare il Anteprima attivo. In una sandbox l'anteprima apre automaticamente ogni documento in un visualizzatore nella pagina (invece che in una nuova scheda), quindi funziona anche dove i download non funzionano.
Funziona con PDF e immagini. I file Word ed Excel non possono essere visualizzati nel browser in questo modo, quindi la configurazione in sola visualizzazione è adatta alle librerie composte da PDF e immagini. Se vuoi una mano a impostarla, contattare l'assistenza.
Ancora bloccato?
Contattaci tramite l'assistenza indicando il nome della piattaforma e l'URL della pagina, e ti consiglieremo l'opzione migliore per la tua configurazione.