Passa al contenuto principale

Blocchi URL manuali (template prodotto)

I blocchi URL manuali ti permettono di mostrare PDF sui template di prodotto senza dover collegare prima i PDF nell'app.

Usali quando vuoi uno o più URL PDF identici su un intero template di prodotto (ad esempio, tutti i prodotti che usano product o product.custom).

Cosa sono i blocchi manuali​

PDF Connect fornisce due blocchi manuali per i prodotti:

  • PDF Embedded Manual - Mostra i PDF incorporati nella pagina
  • PDF Button Manual - Mostra pulsanti cliccabili che aprono i PDF

A differenza dei blocchi con collegamento, i blocchi manuali:

  • Non leggono le risorse collegate
  • Non leggono i metafield PDF
  • Non richiedono il collegamento per singolo prodotto
  • Vengono visualizzati solo dalle impostazioni del blocco nell'editor del tema Shopify

Come aggiungere blocchi manuali​

Dall'app (consigliato)​

  1. Apri la pagina dei dettagli di un PDF in PDF Connect
  2. Apri il menu a tendina Link/Add
  3. Scegli Add PDF block to product template (manual URLs)
  4. Seleziona:
    • Un template di prodotto (ad esempio product o product.custom)
    • Il tipo di blocco (pdf_embedded_manual o pdf_button_manual)
  5. Continua per aprire l'editor del tema Shopify
  6. Incolla uno o più URL PDF nelle impostazioni del blocco
  7. Salva il tema

Direttamente nell'editor del tema Shopify​

  1. Vai su Online Store > Themes > Customize
  2. Apri un template di prodotto
  3. Aggiungi un blocco app da PDF Connect
  4. Scegli PDF Embedded Manual o PDF Button Manual
  5. Inserisci URL/impostazioni e salva

Tipi di visualizzatore nei blocchi manuali​

I blocchi manuali supportano gli stessi quattro tipi di visualizzatore:

  • Native Browser
  • Custom Viewer (PDF.js)
  • Flipbook
  • Light Viewer

Per i blocchi manuali, il comportamento del visualizzatore è configurato nelle impostazioni del blocco (non dalla configurazione per-PDF salvata nell'app), e un profilo di visualizzatore a livello di blocco si applica a tutti gli URL all'interno di quel blocco.

Più URL ed etichette​

  • Inserisci più URL PDF come valori separati da a capo.
  • Nel blocco pulsante manuale, le etichette sono opzionali e anch'esse separate da a capo.
  • Se le etichette sono in numero inferiore agli URL, gli URL rimanenti usano il nome del file o il testo predefinito.

Blocchi con collegamento vs blocchi manuali​

TipoFonte datiIdeale per
Blocchi con collegamento (pdf_embedded, pdf_button)Collegamento app + metafieldPDF per risorsa, configurazione visualizzatore per-PDF nell'app
Blocchi manuali (pdf_embedded_manual, pdf_button_manual)Solo impostazioni schema blocco temaPDF condivisi a livello di template senza collegamento

Limitazioni importanti​

  • Il rilascio attuale supporta solo i template di prodotto per il flusso manuale dell'app.
  • I blocchi manuali hanno ambito template, non ambito risorsa.
  • I blocchi manuali non si sincronizzano automaticamente con i record PDF nella libreria dell'app.

Controlli rapidi per la risoluzione dei problemi​

Se un blocco manuale non mostra contenuto:

  1. Verifica che sia impostato almeno un URL PDF valido con https://
  2. Verifica che il blocco sia aggiunto al template di prodotto attivo
  3. Salva le modifiche al tema e aggiorna la vetrina con un hard refresh
  4. Prova a cambiare il tipo di visualizzatore su Native Browser per isolare problemi specifici del visualizzatore

Passaggi successivi​