Configuração do visualizador de PDF
Configure como os PDFs são apresentados aos clientes ao escolher um de quatro tipos de visualizador na app.
Onde configurar
Defina o tipo de visualizador na página de detalhes do PDF, na secção Viewer Configuration.
Esta configuração aplica-se às Theme App Extensions ligadas desse PDF (tanto popups do botão como visualizadores incorporados).
Blocos de URL manual usam as definições do visualizador no schema do bloco no tema. Blocos de URL manual →
Quatro tipos de visualizador
Custom Viewer (Full Featured)
A opção mais completa, com controlo total sobre a experiência de visualização.
Features: Funcionalidades:
- Todos os controlos de navegação
- Funcionalidade de pesquisa
- Ferramentas de zoom e opções de apresentação personalizáveis
- Visualização otimizada para mobile
Opções de configuração:
Definições do visualizador:
- Initial Page - Que página mostrar primeiro (1, 2, 3, etc.)
- Initial Zoom - Nível de zoom por defeito (Auto Fit, Fit Width, Fit Page, 50%, 75%, 100%, 125%, 150%, 200%)
- Page Layout - Layout da página (Single Page, Two Pages Odd, Two Pages Even)
- Scroll Direction - Direção de scroll (Vertical, Horizontal, Wrapped, Page Scrolling)
Toolbar e funcionalidades:
- Enable Download - Permitir que os clientes façam download do PDF
- Show Toolbar - Mostrar a barra de navegação
- Enable Add Image/Stamp Tool - Permitir adicionar imagens ou carimbos (stamps)
- Enable Highlighter Tool - Permitir sublinhar/destacar texto
- Enable Drawing Tools - Permitir desenhar à mão livre no PDF
- Enable Text Selection - Permitir selecionar e copiar texto
Best for: Melhor para:
- Documentos técnicos que precisam de zoom e pesquisa
- Manuais de produto que exigem navegação
- Documentos em que os clientes precisam de destacar ou anotar
- Visualização em desktop e mobile
Light Viewer (Fast & Simple)
Um visualizador simplificado, otimizado para rapidez e simplicidade.
Funcionalidades:
- Visualizador simples e com carregamento rápido
- Interface minimalista
- Perfeito para pré-visualização rápida
- Otimizado para mobile
Opções de configuração:
- Nenhuma — funciona automaticamente
Melhor para:
- Documentos de consulta rápida
- PDFs simples que não precisam de funcionalidades avançadas
- Lojas mobile-first que priorizam tempos de carregamento rápidos
- Cartões/termos de garantia, certificados e formulários simples
Native Browser Viewer (Standard)
Usa o visualizador de PDF integrado no browser para uma experiência standard e familiar.
Funcionalidades:
- Capacidades de visualização de PDF nativas do browser
- Fiável e amplamente suportado
- Não requer configurações adicionais
- Nota: A experiência pode variar entre browsers (Chrome, Safari, Firefox, etc.)
Opções de configuração:
- Nenhuma — usa as definições por defeito do browser
Melhor para:
- Clientes habituados à visualização standard de PDF no browser
- Documentos simples que não precisam de funcionalidades personalizadas
- Máxima compatibilidade entre browsers
- Apresentação direta do PDF, sem personalização
Importante: Como usa o visualizador nativo de cada browser, a experiência pode variar entre browsers e dispositivos.
Flipbook Viewer (Interactive Pages)
Uma experiência interativa de virar páginas, semelhante à leitura de um livro físico.
Funcionalidades:
- Animação de virar páginas
- Experiência realista de leitura tipo livro/revista
- Ótimo para conteúdo visual, estilo catálogo
- Não é otimizado para mobile
Opções de configuração:
- Animation Style - Smooth Animation, Fast Animation, No Animation
- Page Shadows - Adicionar sombras realistas e efeito de profundidade
- Background Color - Escolher entre Light Gray, White, Off White, Medium Gray, Dark Gray
Melhor para:
- Catálogos e brochuras
- Materiais de marketing e lookbooks
- Conteúdo estilo revista
- Visualização em desktop
Não recomendado para:
- Lojas mobile-first
- Documentos técnicos
- PDFs longos, com muito texto
Configuração do visualizador: ligado vs. manual
| Fluxo | Onde é configurado | Âmbito |
|---|---|---|
Blocos ligados (pdf_embedded, pdf_button) | Página de detalhes do PDF na app | Por PDF |
Blocos manuais (pdf_embedded_manual, pdf_button_manual) | Definições do bloco no tema | Por bloco |
Os blocos manuais suportam os mesmos quatro tipos de visualizador:
- Native Browser
- Custom Viewer
- Flipbook
- Light Viewer
Em blocos manuais, um perfil de visualizador aplica-se a todos os URLs introduzidos nesse bloco.
Como definir a configuração do visualizador
- Vá à sua biblioteca de PDFs na app
- Clique no PDF que quer configurar
- Encontre a secção Viewer Configuration
- Clique para expandir a secção
- Selecione o Viewer Type no seletor
- Configure as opções disponíveis para esse tipo de visualizador
- Clique em Save Configuration
O visualizador aplica-se em todo o lado
A configuração de visualizador que escolher aplica-se a:
- ✅ Popups da extensão de botão (quando o cliente clica no botão)
- ✅ Visualizadores incorporados (PDFs mostrados na página)
- ✅ Todos os templates onde este PDF é apresentado
- ✅ Todos os recursos a que este PDF está ligado
Define uma vez e funciona em todos os locais onde esse PDF aparece.
Em blocos manuais, define as opções do visualizador no próprio bloco e essas opções aplicam-se a todos os URLs nesse bloco.
Definições da extensão vs. configuração do visualizador
Não confunda estas duas coisas:
| Configuração do visualizador (app) | Definições da extensão (editor de temas) |
|---|---|
| Custom, Light, Native Browser ou Flipbook | Cores do botão, texto, alinhamento |
| Zoom, toolbar, opções de download | Altura do visualizador, texto do título |
| Layout da página, direção de scroll | Borda do contentor, tamanho do modal |
| Definido uma vez por PDF | Definido por extensão no tema |
| Controla a funcionalidade do PDF | Controla o estilo e o layout |
Blocos manuais combinam as duas coisas nas definições do tema: lista de URLs + tipo de visualizador + opções do visualizador.
Exemplo:
- Escolher Custom Viewer com download ativo e zoom inicial 100% → configuração do visualizador
- Definir a cor do botão como azul e o modal a 80% → definições da extensão
Alterar a configuração do visualizador a qualquer momento
Pode mudar o tipo de visualizador em qualquer altura:
- Abra a página de detalhes do PDF
- Expanda Viewer Configuration
- Selecione um tipo de visualizador diferente
- Ajuste as definições
- Clique em Save Configuration
As alterações aplicam-se de imediato a todas as Theme App Extensions que apresentem esse PDF.
Dicas de configuração do visualizador
Comece com o Custom Viewer:
- Opção mais versátil
- Funciona bem na maioria dos casos
- Muito configurável
Mude para o Light Viewer se:
- Os PDFs estiverem a carregar lentamente
- Quiser a experiência mais simples
- A velocidade em mobile for crítica
Use o Native Browser Viewer quando:
- Os clientes preferirem a experiência standard do browser
- Precisar de compatibilidade máxima
- Não precisar de funcionalidades custom
Use o Flipbook Viewer quando:
- A visualização em desktop for o principal
- A apresentação visual for o mais importante
- Tiver conteúdo do tipo catálogo
Teste a sua escolha:
- Pré-visualize em desktop e mobile
- Peça feedback a clientes
- Monitorize o uso/interação com PDFs