Configuração do tema
Adicione Theme App Extensions do PDF Connect ao seu tema Shopify para que os clientes consigam ver PDFs no storefront.
Porque a configuração do tema é importante
Ligar PDFs e defini-los como active não é suficiente. Tem de adicionar Theme App Extensions ao tema para os PDFs aparecerem na sua loja.
Pense assim:
- Ligação = Ligar PDFs a páginas/recursos
- Theme App Extensions = Tornar os PDFs visíveis para os clientes através do editor de temas. Só é necessário uma vez por template.
Ambos são necessários para mostrar um PDF no storefront.
- Viewer Configuration = Como os PDFs são apresentados (native, custom, light ou flipbook) - Saiba mais →
É apenas um passo de configuração no processo de adicionar PDFs.
Duas formas de publicar PDFs ligados
1. Publicar diretamente a partir da página de detalhes do PDF (recomendado)
A forma mais rápida de adicionar uma Theme App Extension:
- Abra a secção Publish na página de detalhes do PDF
- Se a Theme App Extension ainda não tiver sido adicionada ao template, verá um aviso para Publish
- Clique em Publish e escolha o estilo de apresentação (Embedded Viewer ou Button)
- Abre-se um novo separador/janela para o editor de temas, já com a extensão adicionada
- Se necessário, ajuste as definições da extensão e clique em Save no editor de temas
2. Adicionar uma Theme App Extension manualmente no editor de temas
Para ter mais controlo sobre a colocação da extensão:
- Vá a Online Store > Themes
- Clique em Customize no tema ativo
- Navegue até a uma página onde ligou um PDF (por exemplo, uma página de produto)
- Clique em Add section ou Add block (depende do tema)
- Procure PDF Connect na secção Apps
- Adicione PDF Embedded Viewer ou PDF Button
- Clique em Save
Ou veja Personalizar opções de apresentação →
Blocos de URL manual (sem ligação obrigatória)
Em templates de produto, também pode adicionar blocos manuais que leem URLs de PDF diretamente das definições do tema.
É a melhor opção para PDFs partilhados ao nível do template quando não quer ligar cada produto separadamente.
Fluxo do bloco manual
- Abra a página de detalhes de qualquer PDF na app
- Use a ação Add PDF block to product template (manual URLs) no menu
- Escolha um template de produto e um tipo de bloco manual
- Continue para o editor de temas e cole um ou vários URLs
- Guarde as alterações do tema
Detalhes: Blocos de URL manual →
Onde encontrar Theme App Extensions do PDF Connect
As Theme App Extensions do PDF Connect aparecem em Apps no editor de temas. Procure:
- PDF Embedded Viewer - Mostra PDFs incorporados na página
- PDF Button - Mostra botões clicáveis que abrem PDFs numa sobreposição
- PDF Embedded Manual - Apresentação incorporada a partir de URLs manuais nas definições
- PDF Button Manual - Popup/lista a partir de URLs manuais nas definições
Blocos ligados estão disponíveis para todos os tipos de página suportados. Blocos manuais são, por agora, para templates de produto.
Tipos de página suportados
Adicione extensões do PDF Connect a estes templates de página:
- Páginas de produto - Editor do template de produto
- Páginas de coleção - Editor do template de coleção
- Páginas - Editor do template de página
- Blog - Editor do template de blog
- Artigos - Editor do template de artigo do blog
- Página inicial - Editor do template Index
- Página de pesquisa - Editor do template de pesquisa
Posicionar as extensões
Controle onde os PDFs aparecem:
Páginas de produto:
- Acima do botão “Add to Cart”
- Num separador (tab) separado
- Abaixo da descrição do produto
- Numa barra lateral
Páginas de coleção:
- Acima da grelha de produtos
- Abaixo da descrição da coleção
- Numa barra lateral
Outras páginas:
- Acima do conteúdo principal
- Abaixo do conteúdo principal
- Em secções dedicadas
A posição depende da estrutura de secções do seu tema.
Uma extensão mostra todos os PDFs ligados
Basta adicionar uma Theme App Extension por tipo de página:
- Adicione a extensão PDF Button ao template de produto
- A extensão mostra automaticamente PDFs para todos os produtos
- Mostra apenas PDFs ligados a esse produto específico
- Não precisa de adicionar extensões a produtos individualmente
- Se precisar de excluir um PDF, veja Controlar PDFs por tipo de extensão →
O mesmo aplica-se a coleções, páginas e outros recursos.
Blocos manuais comportam-se de forma diferente:
- Não leem PDFs ligados
- Só apresentam URLs introduzidos nas definições desse bloco
- Aplicam-se a todo o template onde foram adicionados
Definições da Theme App Extension
Personalize como as extensões aparecem na página (não as funcionalidades do visualizador):
For Embedded Viewer extension:
- Mostrar título (toggle)
- Texto do título
- Altura do visualizador (percentagem do viewport; apenas desktop)
- Mostrar borda do contentor
For PDF Button extension:
- Mostrar título (toggle)
- Texto do título
- Texto do botão e fonte do texto (genérico, nome do PDF ou descrição)
- Alinhamento do botão (esquerda, centro, direita)
- Alinhamento do texto do botão
- Layout para vários PDFs (vertical ou horizontal)
- Mostrar ícone de PDF
- Mostrar borda do contentor
- Cor de fundo do botão
- Cor do texto do botão
- Cor de fundo do botão ao passar o rato (hover)
- Tamanho do modal do visualizador (60%, 70%, 80%, 90%)
Para blocos ligados: As funcionalidades do visualizador (zoom, download, toolbar, navegação, etc.) são configuradas na página do PDF na app. Configuração do visualizador →
Para blocos manuais: As funcionalidades do visualizador são configuradas nas definições do bloco no editor de temas. Opções do visualizador em blocos manuais →
Combinar estilos de apresentação
Pode usar estilos de apresentação diferentes em tipos de página diferentes:
- Visualizador incorporado em páginas de produto
- Apresentação por botão em páginas de coleção
- Incorporado na página inicial
Ou combine-os na mesma página, se o seu tema permitir várias extensões.
Temas sem suporte para Theme App Extensions
Temas antigos ou muito personalizados podem não suportar Theme App Extensions:
- Verifique se o seu tema é compatível com Theme App Extensions
- Se necessário, atualize para uma versão mais recente do tema
- Contacte o programador do tema para suporte
- Considere mudar para um tema compatível com Online Store 2.0
A maioria dos temas modernos da Shopify (Online Store 2.0) suporta Theme App Extensions.
Pré-visualizar antes de publicar
Teste a configuração antes de publicar:
- Adicione extensões no editor de temas
- Use a pré-visualização para ver como os PDFs ficam
- Experimente ambos os estilos de apresentação
- Verifique a pré-visualização em mobile
- Ajuste o que for necessário
- Clique em Save quando estiver satisfeito
Remover extensões
Para remover a apresentação de PDFs de um tipo de página:
- Vá ao editor de temas
- Navegue até esse tipo de página
- Encontre a extensão do PDF Connect
- Clique nas definições da extensão
- Escolha Remove block
- Clique em Save
Isto oculta os PDFs sem os desligar.
Resolução de problemas de apresentação
Os PDFs não aparecem:
- Verifique se a extensão foi adicionada ao tipo de página correto
- Confirme que o estado do PDF está Active
- Confirme que o PDF está ligado ao recurso
- Atualize a página
O bloco manual não mostra nada:
- Garanta que existe pelo menos um URL válido nas definições manuais
- Confirme que o bloco foi adicionado ao template de produto ativo
- Guarde o tema e faça hard refresh
A extensão não aparece em Apps:
- O tema pode não suportar Theme App Extensions
- Tente atualizar o tema
- Verifique compatibilidade (requer Online Store 2.0)
Aparecem PDFs errados:
- Confirme que está a ver o recurso correto
- Verifique as ligações na biblioteca de PDFs
- Reveja filtros de template (se estiverem a ser usados)
Ver guia completo de resolução de problemas →