Pular para o conteúdo principal

Blocos de URL manual (templates de produto)

Os blocos de URL manual permitem mostrar PDFs em templates de produto sem ter de ligar PDFs na app primeiro.

Use esta opção quando quer os mesmos um ou mais URLs de PDF em todo um template de produto (por exemplo, todos os produtos que usam product ou product.custom).

O que são blocos manuais​

O PDF Connect disponibiliza dois blocos manuais para produto:

  • PDF Embedded Manual - Mostra PDFs incorporados na página
  • PDF Button Manual - Mostra botões clicáveis que abrem PDFs

Ao contrário de blocos ligados, blocos manuais:

  • Não leem recursos ligados
  • Não leem metafields de PDF
  • Não exigem ligação por produto
  • São apresentados apenas com base nas definições do bloco no editor de temas da Shopify

Como adicionar blocos manuais​

A partir da app (recomendado)​

  1. Abra a página de detalhes de um PDF no PDF Connect
  2. Abra o seletor Link/Add
  3. Escolha Add PDF block to product template (manual URLs)
  4. Selecione:
    • Um template de produto (por exemplo, product ou product.custom)
    • O tipo de bloco (pdf_embedded_manual ou pdf_button_manual)
  5. Continue para abrir o editor de temas da Shopify
  6. Cole um ou vários URLs de PDF nas definições do bloco
  7. Guarde o tema

Diretamente no editor de temas da Shopify​

  1. Vá a Online Store > Themes > Customize
  2. Abra um template de produto
  3. Adicione um bloco de app de PDF Connect
  4. Escolha PDF Embedded Manual ou PDF Button Manual
  5. Preencha URLs/definições e guarde

Tipos de visualizador nos blocos manuais​

Os blocos manuais suportam os mesmos quatro tipos de visualizador:

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

Em blocos manuais, o comportamento do visualizador é configurado nas definições do bloco (não através de uma configuração guardada por PDF na app), e um perfil de visualizador ao nível do bloco aplica-se a todos os URLs dentro desse bloco.

Vários URLs e etiquetas​

  • Insira vários URLs de PDF, um por linha.
  • No bloco manual do botão, as etiquetas são opcionais e também são introduzidas uma por linha.
  • Se existirem menos etiquetas do que URLs, os URLs restantes usam o nome do ficheiro/texto por defeito.

Blocos ligados vs. blocos manuais​

TipoFonte de dadosIdeal para
Blocos ligados (pdf_embedded, pdf_button)Ligação na app + metafieldsPDFs por recurso, configuração de visualizador por PDF na app
Blocos manuais (pdf_embedded_manual, pdf_button_manual)Apenas definições do schema do bloco no temaPDFs partilhados ao nível do template, sem ligação

Limitações importantes​

  • O rollout atual é apenas para templates de produto no fluxo manual inicial da app.
  • Os blocos manuais têm âmbito de template, não de recurso.
  • Os blocos manuais não sincronizam automaticamente com registos de PDF na biblioteca da app.

Verificações rápidas (resolução de problemas)​

Se um bloco manual não apresentar conteúdo:

  1. Confirme que está definido pelo menos um URL https:// válido para PDF
  2. Confirme que o bloco foi adicionado ao template de produto ativo
  3. Guarde as alterações do tema e faça hard refresh no storefront
  4. Experimente mudar o tipo de visualizador para Native Browser para isolar problemas específicos do visualizador

Próximos passos​