Pular para o conteúdo principal

Resolver problemas de apresentação

Resolva problemas comuns quando os PDFs não aparecem no storefront.

PDFs não aparecem de todo​

Verifique estes três requisitos:

✅ O PDF está ligado ao recurso (produto, página, etc.)
✅ O estado do PDF está Active (não Inactive)
✅ A Theme App Extension foi adicionada ao seu tema

Os três têm de ser verdade. Confirme um a um:

  1. Abra a biblioteca de PDFs
  2. Clique no PDF que deveria aparecer
  3. Confirme que está ligado ao recurso correto
  4. Verifique se o estado está Active
  5. Vá ao editor de temas e confirme que a extensão foi adicionada

Se estiver a usar blocos manuais (PDF Embedded Manual ou PDF Button Manual), estas verificações de PDF ligado não se aplicam. Use as verificações manuais abaixo.

Bloco de URL manual não mostra nada​

  1. Confirme que introduziu pelo menos um URL https://...pdf válido
  2. Confirme que o bloco está no template de produto ativo
  3. Guarde no editor de temas e faça hard refresh no storefront
  4. Temporariamente, defina o tipo de visualizador como Native Browser para isolar problemas de parâmetros do visualizador custom
  5. Se estiver a usar etiquetas no botão manual, confirme que o número de linhas de etiquetas corresponde ao número de linhas de URLs

PDFs aparecem em páginas erradas​

Possíveis causas:

Recurso errado ligado

  • Verifique a que recursos o PDF está ligado
  • Desligue dos recursos incorretos
  • Ligue aos recursos corretos

Filtro de template não coincide

  • Verifique as definições do filtro de template
  • Confirme que a página está a usar o template esperado
  • Remova ou ajuste o filtro

Saiba mais sobre filtro por template →

Alguns PDFs aparecem, outros não​

Verifique o estado de cada PDF:

  • PDFs ocultos provavelmente estão como Inactive
  • Altere para Active nos PDFs em falta

Verifique filtros de template:

  • Alguns PDFs podem ter filtros de template aplicados
  • Reveja as definições de filtro nos PDFs que não aparecem

Theme App Extension não aparece no editor de temas​

Problema de compatibilidade do tema:

O seu tema pode não suportar app extensions:

  1. Consulte a documentação do tema sobre suporte a app extensions
  2. Atualize o tema para a versão mais recente
  3. Contacte o programador do tema para suporte
  4. Considere mudar para um tema compatível com extensions

A maioria dos temas modernos da Shopify (2.0+) suporta app extensions.

PDFs carregam lentamente​

Otimize o tamanho do ficheiro:

  • Comprima PDFs antes do upload
  • Sempre que possível, mantenha os ficheiros abaixo de 5 MB
  • Remova páginas ou imagens desnecessárias

Verifique a ligação à internet:

  • Ligações lentas afetam o carregamento
  • Teste noutra rede
  • Compare dados móveis vs. Wi‑Fi

Use apresentação por botão:

  • O botão carrega mais rápido do que incorporado
  • Os clientes só carregam PDFs em que clicam
  • Melhor para utilizadores em mobile

Visualizador incorporado aparece em branco​

O PDF pode estar corrompido:

  • Tente fazer upload novamente
  • Abra o PDF no seu computador para confirmar que funciona
  • Volte a guardar o PDF usando outro software

Compatibilidade do browser:

  • Experimente outro browser
  • Atualize o browser para a versão mais recente
  • Limpe a cache do browser

Aparece o PDF errado​

Verifique as ligações:

  • Veja os recursos ligados desse PDF
  • Desligue das páginas onde não deveria aparecer
  • Confirme que o PDF certo está ligado a cada recurso

Vários PDFs ligados:

  • Se vários PDFs estiverem ligados, todos aparecem
  • Desligue PDFs que não quer mostrar
  • Reordene, se necessário

Em blocos manuais, verifique diretamente as linhas de URL nas definições do bloco, em vez das ligações.

Botão de PDF não abre​

Problema de JavaScript:

  • Verifique a consola do browser para erros
  • Experimente outro browser
  • Desative temporariamente apps que possam estar em conflito

Conflito com o tema:

  • Alguns temas bloqueiam popups
  • Verifique definições do tema
  • Contacte o programador do tema

Filtro de template não funciona​

Erros comuns:

Nome de template errado:

  • Nomes de template distinguem maiúsculas/minúsculas
  • Verifique a escrita com cuidado
  • Confirme que o template existe no tema

Template não está ativo:

  • A página pode estar a usar outro template
  • Confirme o template no editor de temas
  • Atribua o template correto à página

Resolver problemas de template →

Alterações não aparecem​

Atraso de cache:

  • Aguarde 30–60 segundos após fazer alterações
  • Atualize a página (hard refresh: Cmd/Ctrl + Shift + R)
  • Se necessário, limpe a cache do browser

Tema não foi guardado:

  • Confirme que clicou em Save no editor de temas
  • Verifique se há indicador de alterações por guardar

Ainda com problemas?​

Experimente estes passos:

  1. Atualize tudo:

    • Hard refresh your browser
    • Re-save theme in editor
    • Wait a few minutes

  2. Teste em modo incógnito:

    • Opens fresh browser session
    • Bypasses cache issues
    • Rules out browser extensions

  3. Teste páginas diferentes:

    • View different resource (product/page)
    • Test homepage vs product page
    • Isolate where issue occurs

  4. Contacte o suporte:

    • Descreva o que vê vs. o que esperava ver
    • Partilhe screenshots, se possível
    • Indique o nome do tema
    • Indique o seu plano

Próximos passos​