Pular para o conteúdo principal

Controlar a apresentação de PDFs por tipo de extensão

Quando liga vários PDFs ao mesmo recurso e o template tem ambas as Theme App Extensions (incorporado e botão), pode controlar que PDFs aparecem em cada extensão.

O desafio com vários PDFs​

Quando liga vários PDFs ao mesmo recurso (por exemplo, um produto) e adiciona ao template as extensões PDF Embedded Viewer e PDF Button:

Comportamento por defeito: Todos os PDFs ligados aparecem em AMBAS as extensões

O que pode querer: PDFs diferentes em cada extensão

Exemplo:

  • Manual do produto → Mostrar apenas no visualizador incorporado, abaixo da descrição do produto
  • Informação de garantia → Mostrar apenas na extensão de botão, no fim da página

Quando a opção aparece​

As checkboxes para controlar a apresentação por extensão só aparecem quando:

  1. Ligou vários PDFs ao mesmo recurso
  2. O template tem ambas as Theme App Extensions adicionadas (embedded E button)

Verá isto na secção Publish da página de detalhes do PDF.

Usar as checkboxes de controlo por extensão​

Na secção Publish, verá:

Published extensions:
☑ pdf_embedded (enabled)
☑ pdf_button (enabled)

Para ocultar um PDF numa extensão específica:

  • Desmarque a checkbox desse tipo de extensão
  • O PDF é removido do array desse template/extensão
  • O PDF deixa de aparecer nessa extensão

Exemplo:

Published extensions:
☑ pdf_embedded (enabled)  ← PDF shows in embedded viewer
☐ pdf_button (disabled)   ← PDF hidden from button extension

Casos de uso​

Cenário 1: conteúdo principal vs. complementar​

Produto com 2 PDFs:

  • Manual de utilizador (principal) → Apenas no visualizador incorporado
  • Cartão/termos de garantia (complementar) → Apenas na extensão de botão

Configuração:

  1. Ligue ambos os PDFs ao produto
  2. Adicione ambas as extensões ao template de produto
  3. Manual: ☑ embedded, ☐ button
  4. Garantia: ☐ embedded, ☑ button

Cenário 2: referência rápida vs. documentação detalhada​

Coleção com 3 PDFs:

  • Guia rápido de compra → Visualizador incorporado
  • Catálogo completo → Extensão de botão
  • Tabela de tamanhos → Extensão de botão

Configuração:

  1. Ligue todos os PDFs à coleção
  2. Adicione ambas as extensões ao template de coleção
  3. Guia rápido: ☑ embedded, ☐ button
  4. Catálogo completo: ☐ embedded, ☑ button
  5. Tabela de tamanhos: ☐ embedded, ☑ button

Cenário 3: mostrar todos os PDFs em ambas as extensões​

Produto com vários manuais:

  • Todos os PDFs disponíveis tanto no visualizador como no botão

Configuração:

  1. Ligue todos os PDFs
  2. Adicione ambas as extensões
  3. Mantenha todas as checkboxes marcadas (por defeito)

Registo por ficheiro de template​

Para cada PDF, a app regista:

Exemplo de template de artigo:

article.articleTemp2 - 1 extension
  Published extensions:
    pdf_button

blog.blogTemp2 - 2 extensions
  Published extensions:
    ☑ pdf_embedded (enabled)
    ☐ pdf_button (disabled)

Isto indica:

  • O template de artigo tem apenas a extensão de botão
  • O template do blog tem ambas as extensões, mas este PDF aparece apenas no visualizador incorporado

Gerir vários templates​

Se o mesmo tipo de recurso usar ficheiros de template diferentes, verá cada template listado separadamente, com os seus próprios controlos por extensão:

Article Pages - Published

  article.articleTemp1 - 1 extension
    ☑ pdf_button

  article.articleTemp2 - 1 extension  
    ☑ pdf_button

Cada template pode ter configurações diferentes para o mesmo PDF.

Boas práticas​

Comece simples​

Comece com uma Theme App Extension por template. Adicione a segunda extensão apenas se precisar de uma organização diferente dos PDFs.

Planeie a hierarquia dos PDFs​

Antes de adicionar ambas as extensões, decida que PDFs são principais (embedded) vs. complementares (button).

Use padrões consistentes​

Se usar ambas as extensões em vários templates, mantenha atribuições semelhantes de PDFs para facilitar a gestão.

Teste a experiência do cliente​

Veja as páginas como um cliente veria e confirme que os PDFs certos aparecem nos locais certos.

Resolução de problemas​

As checkboxes não aparecem:

  • Só existe um tipo de extensão adicionado ao template
  • Adicione ambas as extensões para ver as checkboxes

O PDF aparece na extensão errada:

  • Verifique as checkboxes na secção Publish
  • Confirme que está a ver o ficheiro de template correto

O PDF não aparece em lado nenhum:

  • Pelo menos uma checkbox tem de estar marcada
  • Confirme que o PDF está ligado ao recurso
  • Verifique se o estado do PDF está Active

As alterações não aparecem no storefront:

  • Atualize a página (pode demorar alguns segundos)
  • Limpe a cache do browser
  • Confirme que guardou as alterações na app

Próximos passos​