Extensão de tema da Shopify
Ative a incorporação global do app e configure a visibilidade dos widgets na sua loja virtual Shopify.
Extensão de tema da Shopify
A incorporação de app (Theme App Embed) do Umbrella fornece o script principal que alimenta todos os widgets de garantia da sua loja virtual. Depois de ativada, o Umbrella cuida do resto — não é preciso posicionar widgets manualmente.
Ativar a incorporação global do app
- Acesse Admin da Shopify → Loja virtual → Temas e clique em Personalizar no seu tema ativo
- Clique no ícone Incorporações de app (peça de quebra-cabeça) na barra lateral esquerda
- Encontre Umbrella e ative a opção
- Clique em Salvar
O widget aparece aqui quando ativado
Configuração do widget da PDP
O widget de seleção de garantia nas páginas de detalhes do produto (PDP) é controlado inteiramente pelo painel do Umbrella — não pelo editor de temas da Shopify.
Depois que a incorporação global do app estiver ativada e o widget da PDP estiver ligado no painel do Umbrella, as opções de garantia aparecem automaticamente nas páginas de produto. O widget exibe as opções de garantia antes do botão Adicionar ao carrinho, sem modificar o código do seu tema.
O que o widget exibe
O widget da PDP mostra:
- Nome e logotipo do plano de garantia no topo
- Descrição da proteção com um link “Saiba mais”
- Níveis de garantia disponíveis (por exemplo, Básico 1 ano, Premium 2 anos) como opções selecionáveis
- Preços dinâmicos que se atualizam quando o cliente troca a variante do produto
O widget detecta automaticamente o produto e a variante atuais. Ele não aparece nas páginas dos próprios produtos de garantia.
Como funciona
A incorporação global do app injeta o JavaScript do Umbrella em todas as páginas. Quando um cliente visita uma página de produto, o script procura planos de garantia correspondentes e exibe o widget. Tanto a incorporação no tema quanto a configuração do widget da PDP precisam estar ativas para que o widget apareça.
As configurações de exibição do widget (modo em linha, modal ou individual, seleção automática, modelos personalizados) são controladas em Configurações → Aparência → Widget da PDP no painel do Umbrella.
Solução de problemas
| Problema | Solução |
|---|---|
| O widget não aparece nas páginas de produto | Verifique se a incorporação global do app está ativada no editor de temas e se o widget da PDP está ligado em Configurações → Aparência → Widget da PDP |
| O widget aparece nas páginas de produtos de garantia | Confirme que os produtos de garantia têm o tipo definido como “warranty” |
| Os preços não se atualizam ao trocar de variante | Atualize a página; verifique se a incorporação global do app está ativa |
| O widget aparece, mas não mostra opções | Verifique se os planos de garantia estão ativos e se a elegibilidade de produtos inclui o produto |
| Conflitos de estilo com o tema | Use modelos de widget personalizados em Configurações → Aparência para combinar com o design do seu tema |
Relacionados
- Integração com a Shopify — Configuração geral da conexão com a Shopify
- Criação de planos de garantia — Configure os planos exibidos no widget
- Extensões de checkout da Shopify — Opções de garantia no checkout
