Documentação do tema Helm
Como instalar o Helm, montar páginas com seus blocos e configurar o tema, para lojistas. Escrita para a versão 1.0.8.
Versão 1.0.8
Primeiros passos
Da biblioteca de temas a uma primeira página em quatro passos.
Adicione o Helm à sua loja
O Helm é distribuído pela Shopify Theme Store. Depois de adicionado, ele aparece na sua biblioteca de temas, em Online Store no seu admin da Shopify.
Abra o editor de temas
No cartão do Helm, clique em Edit theme. A página inicial abre com a composição padrão: um hero, uma linha de números, um como funciona, cartões de coleção, perguntas frequentes e uma chamada para ação, cada um em uma seção Canvas.
Defina suas cores e fontes
Clique no ícone Theme settings. Em Colors, ajuste os esquemas de cores; em Typography, escolha as fontes de títulos, texto e destaque.
Conecte seus menus e publique
Crie seus menus em Content > Menus, escolha o menu principal nas configurações da seção Header e depois substitua os textos e as imagens de exemplo. Publique o tema quando suas páginas estiverem prontas.
Os rótulos do admin da Shopify estão escritos aqui em inglês, como a central de ajuda da Shopify os escreve. Seu admin os mostra no próprio idioma. As configurações próprias do Helm aparecem em inglês no editor de temas: a versão 1.0.8 traz os rótulos do editor só em inglês.
Presets
A versão 1.0.8 traz um preset de tema, Helm, e 12 presets da seção Canvas.
O preset Helm
O preset define os valores iniciais de Theme settings. Mude o que quiser depois: o preset é só o ponto de partida da loja.
| Valor inicial | |
|---|---|
Max content width | 1280 px |
Heading font | Assistant, bold |
Body font | Assistant, regular |
Color schemes | 4 |
Corner radius | Soft |
Spacing scale | Regular |
Cart type | Drawer |
Show order note | Off |
Free shipping threshold | 50 |
Auto-noindex landing pages | On |
Allow AI engines to read your content | On |
Fundos dos esquemas de cores
#FFFFFF#0E0E0E#FFF3D6#C2410C
Presets da seção Canvas
Quando você adiciona uma seção, o editor oferece estas composições de Canvas. Todas, menos o Canvas vazio, vêm com seus blocos e um texto de exemplo.
CanvasHeroHero with imageFeatures gridStats rowHow it worksFAQReviews gridStory splitNewsletterCTA bannerLogo bar
Como as páginas são montadas
O Helm monta as páginas a partir de uma seção universal, Canvas, preenchida com blocos de tema.
- Adicionar uma seção. Na barra lateral do editor, clique em Add section e escolha Canvas ou um dos seus presets.
- Adicionar um bloco. Passe o cursor sobre uma seção Canvas e clique em Add block. O Canvas aceita todos os blocos de tema e os blocos de app.
- Reorganizar. Arraste um bloco ou uma seção pela alça e clique em Save.
- Ocultar sem excluir. Passe o cursor sobre o nome de um bloco ou de uma seção e clique em Hide.
- Configurações da seção. Cada seção Canvas define sua largura, o espaço entre seus blocos, o espaçamento superior e inferior no computador e no celular, seu esquema de cores e um ID de âncora para links.
- Blocos dentro de blocos. Estes blocos recebem outros blocos: Group, Columns, Split, Hero, Slide, Tab, Accordion item.
Referência de blocos
A versão 1.0.8 tem 64 blocos de tema, todos disponíveis no Canvas. Os nomes são os que o editor mostra.
Texto
Títulos, parágrafos, citações, números, etiquetas e listas de links.
HeadingTextRich textQuotePull quoteStatBadgeDividerLink list
Mídia
Imagens, vídeo, galerias, ícones, espaçamentos, um comparador de antes e depois e uma faixa rolante.
ImageVideoGalleryIconSpacerBefore / afterMarquee
Layout
Contêineres para outros blocos: grupos, colunas, um layout dividido, um hero, um banner de chamada para ação, uma apresentação de slides, abas e acordeões.
GroupColumnsSplitHeroCTA bannerSlideshowSlideTabsTabAccordionAccordion item
Ações e ofertas
Botões, uma inscrição por e-mail, uma contagem regressiva, um cartão de preço e uma tabela comparativa.
ButtonEmail captureCountdownPricing cardComparison tableComparison row
Confiança
Depoimentos, cartões de avaliação, selos de confiança, logos, ícones de pagamento e links de redes sociais.
TestimonialReview cardTrust badgesLogo listPayment iconsSocial icons
Perguntas e passos
Perguntas frequentes e uma lista de passos numerados.
FAQFAQ itemStep listStep
Loja
Um endereço de loja, um cartão de coleção, produtos vistos recentemente e um link que reabre as preferências de cookies.
Store locationCollection cardRecently viewedCookie preferences
Produto
As partes de uma página de produto. Elas leem o produto da página, então ficam nos modelos de produto.
Product titleProduct vendorProduct SKUProduct priceProduct descriptionProduct ratingVariant pickerQuantity selectorBuy buttonsPickup availabilityShop Pay InstallmentsShare buttonProduct tabsStock statusProduct bundleProduct features
Avançado
Seu próprio Liquid ou HTML, dentro de um bloco.
Custom Liquid
Blocos com um comportamento que vale conhecer
- Heading. O nível do título e o tamanho visual são duas configurações separadas, então um título pequeno pode continuar sendo o título principal da página. Mantenha um só título principal por página.
- Button. Estilos Primary, Secondary e Ghost, tamanhos Small, Medium e Large. Link relationship aplica nofollow, sponsored, ugc ou noreferrer só a esse link; Default segue Theme settings.
- Video. Envie um vídeo para a Shopify ou cole uma URL do YouTube ou do Vimeo, depois ajuste reprodução automática, repetição, som desligado e controles.
- Icon. Escolha um dos 18 ícones, depois o tamanho, a cor e o alinhamento.
- Countdown. Faz a contagem regressiva até a data definida em End date, a mesma para todos. Não mostra nada sem uma data futura, e se oculta quando a data já passou.
- Email capture. Cria um cliente na Shopify com a tag definida em Customer tag, leadmagnet por padrão, para sua ferramenta de e-mail segmentar por ela.
- Review card. Vincule-o a uma entrada de um metaobjeto product_review, com os campos title, review, rating, author_name e author_avatar, ou preencha à mão. Os metaobjetos ficam em Content > Metaobjects.
- Product rating. Mostra estrelas a partir dos metacampos de produto reviews.rating e reviews.rating_count, e nada enquanto estiverem vazios.
- Step list. Preencha HowTo name (for SEO) e a lista também emite dados estruturados HowTo para os seus passos.
- Store location. Endereço, horário de funcionamento, telefone, coordenadas e faixa de preço. O bloco também emite dados estruturados LocalBusiness.
- Product price. Mostra o preço da variante escolhida, com o preço comparativo e o preço unitário, e acompanha a variante que o cliente seleciona. A retirada na loja e o banner do Shop Pay Installments também a acompanham.
- Product bundle. Lista a primeira variante disponível de cada produto escolhido pelo preço real, depois o total real, sem desconto. Um botão adiciona todos ao carrinho; produtos esgotados ficam de fora.
Seções
Além do Canvas, o Helm tem as seções que a Shopify exige por modelo, o cabeçalho, o rodapé e o carrinho da loja, e alguns utilitários: 23 seções no total.
Universal
O Canvas aceita qualquer bloco de tema ou de app, em qualquer modelo. Ele não é oferecido nos grupos de cabeçalho e de rodapé.
Canvas
Seções de página
Uma por tipo de modelo, como a Shopify exige. A seção Product page recebe os blocos de produto.
Product pageCollection pageCollections list pageCart pageSearch results pageBlog pageArticle pagePageContact form404 pagePassword page
Cabeçalho, rodapé e carrinho
A barra de avisos, o cabeçalho, o rodapé, o carrinho lateral e a busca preditiva.
HeaderFooterAnnouncement barCart drawerPredictive search
Extras da página de produto
Sticky add to cart aparece nas páginas de produto assim que o visitante rola além do produto. Recommendations mostra os produtos relacionados ou complementares da Shopify, e se oculta quando a Shopify não retorna nenhum.
Sticky add to cartRecommendations
Moldura de destino
Um cabeçalho e um rodapé reduzidos para as páginas que usam o layout de destino.
Landing headerLanding footer
Utilitários
Apps recebe blocos de app. Custom Liquid recebe seu próprio código.
AppsCustom Liquid
Grupos de seções
header-groupfooter-groupoverlay-grouplanding-header-grouplanding-footer-group
Modelos
20 modelos. Para usar um, escolha-o no seletor de modelo da página, do produto ou da coleção no seu admin, depois monte-o no editor.
Páginas da loja
A página inicial, os produtos, as coleções, a busca, o carrinho, a página não encontrada e a página de senha.
indexproductcollectionlist-collectionssearchcart404password
Páginas de conteúdo
O blog, os artigos e as páginas: sobre, contato, perguntas frequentes, avaliações e um localizador de lojas.
blogarticlepagepage.aboutpage.contactpage.faqpage.reviewpage.locator-store
Páginas de destino
Páginas advertorial e lead magnet, no layout de destino com cabeçalho e rodapé reduzidos.
page.advertorialpage.leadmagnet
Cartões-presente
O modelo dos produtos de cartão-presente, com a opção de enviar o cartão a um destinatário, e a página que seu cliente recebe com o cartão.
product.gift_cardgift_card
O modelo de produto começa com o título, o preço, a avaliação, o seletor de variante, a quantidade, os botões de compra, a retirada na loja, o Shop Pay Installments e a descrição, depois os produtos complementares, diferenciais, uma garantia, os produtos relacionados, perguntas frequentes e a barra fixa de adicionar ao carrinho.
Não há modelo customers: a Shopify hospeda as contas de cliente, e o ícone de conta no cabeçalho abre o login.
Configurações do tema
8 categorias, sob o ícone Theme settings do editor.
Logo
A imagem do seu logo e a largura dela, e o favicon.
Logo imageLogo widthFavicon
Colors
Os esquemas de cores que cada seção e cada bloco podem usar: fundo, texto, botões e seus rótulos, sombra.
Color schemes
Typography
Fontes de títulos, texto e destaque da biblioteca de fontes da Shopify, uma escala de tamanho para títulos e para texto, e uma transformação de caixa para títulos. Sem escolha própria, a fonte de destaque usa a dos títulos.
Heading fontHeading size scaleHeading transformBody fontBody size scaleAccent font
Layout
Largura máxima do conteúdo, escala de espaçamento (Compact, Regular, Spacious) e raio dos cantos (Sharp, Soft, Round).
Max content widthSpacing scaleCorner radius
Motion
Animações de entrada e transições entre páginas. Navegadores que não suportam transições de página simplesmente as ignoram.
Use animationsUse page transitions
Cart
O tipo de carrinho, o campo de observação do pedido e o limite de frete grátis na moeda da sua loja. Defina o limite como zero para ocultar a barra de progresso.
Cart typeShow order noteFree shipping threshold
SEO
Atributos dos links para outros sites, noindex automático para os modelos de destino e o acesso dos mecanismos de IA. Veja SEO e dados estruturados abaixo.
Add nofollow to external linksAdd noreferrer to external linksOpen external links in new tabAuto-noindex landing pagesAllow AI engines to read your content
Social media
A imagem de compartilhamento padrão, usada quando uma página da sua loja é compartilhada, e suas contas em Facebook, Instagram, X, TikTok, YouTube, Pinterest, LinkedIn, Threads, Snapchat.
Default share imageFacebookInstagramXTikTokYouTubePinterestLinkedInThreadsSnapchat
Carrinho lateral
Com Cart type em Drawer, como no preset, o carrinho abre ao lado da página.
- Os produtos do carrinho, com a quantidade e um botão para remover.
- Uma barra de progresso até o frete grátis, quando o limite é maior que zero.
- Os descontos já aplicados ao carrinho, como descontos automáticos. Não há campo de código de desconto: os clientes informam os códigos no checkout.
- Uma observação do pedido, quando Show order note está ativado.
- Os dados do destinatário de um cartão-presente, abaixo da linha correspondente.
- Recomendações de produtos, definidas na seção Cart drawer.
Com outro Cart type, o ícone do carrinho leva à página do carrinho.
SEO e dados estruturados
O que o Helm escreve no cabeçalho de cada página, e as configurações que mudam isso.
Indexação
- Fora da busca por padrão. O carrinho, os resultados de uma busca, as coleções filtradas por tag e cada página depois da primeira são marcados como noindex.
- Modelos de destino. Auto-noindex landing pages, ativado no preset, marca como noindex os modelos cujo nome contém landing, leadmagnet ou advertorial.
- Página por página. Um metacampo de texto seo.robots em uma página, um produto, um artigo ou uma coleção substitui o valor para esse item, por exemplo noindex,follow.
- Mecanismos de IA. Quando Allow AI engines to read your content está desativado, o Helm adiciona tags noindex dirigidas a GPTBot, ClaudeBot, PerplexityBot, CCBot e Google-Extended.
- Links para outros sites. Os botões, os links de imagem, a barra de avisos, o rodapé e o endereço de loja adicionam nofollow, noreferrer e uma nova aba aos links que saem da sua loja, conforme as configurações de SEO. Um botão ou uma imagem pode mudar isso com o seu Link relationship.
Dados estruturados
O JSON-LD que o Helm emite, e o que aciona cada tipo.
- Organization. Em todas as páginas, com seu logo, a descrição da sua loja e as contas sociais de Theme settings. A página inicial acrescenta WebSite com uma ação de busca.
- Product. Nas páginas de produto, com a oferta da variante escolhida.
- BlogPosting. Nos artigos.
- CollectionPage. Nas páginas de coleção.
- BreadcrumbList. Onde a trilha de navegação é exibida.
- FAQPage. A partir do metacampo de página faq.items, uma lista de metaobjetos com uma pergunta e uma resposta, nas páginas que usam page.faq ou têm esse metacampo.
- HowTo. A partir de um Step list com o HowTo name preenchido.
- LocalBusiness. A partir de cada bloco Store location.
Rastreamento e privacidade
O Helm deixa o rastreamento e o consentimento com a Shopify.
- Nenhum script de rastreamento. O Helm não adiciona nenhum script de análise nem de publicidade. Conecte seus pixels em Settings > Customer events, ou pelos apps que os oferecem.
- Consentimento. O Helm lê o consentimento dos visitantes da Customer Privacy API da Shopify. Ative o banner de cookies em Settings > Customer privacy.
- Preferências de cookies. O bloco Cookie preferences, no rodapé por exemplo, reabre as escolhas de privacidade do visitante.
- Um script seu. Use uma seção ou um bloco Custom Liquid nos modelos que precisam dele.
Idiomas
A loja nos idiomas dos seus clientes, o editor em inglês.
- Traduções da loja. Os textos da loja vêm em inglês, francês, espanhol e alemão.
- Adicionar um idioma. Adicione e publique um idioma em Settings > Languages. Para um idioma que o Helm não traz, traduza com o app Translate & Adapt da Shopify ou outro app de tradução.
- Editor de temas. Os rótulos das configurações do Helm estão só em inglês, seja qual for o idioma do admin.
- Da direita para a esquerda. Para árabe, hebraico, persa, urdu e os outros idiomas escritos da direita para a esquerda, o Helm inverte a direção da página.
Perguntas frequentes
Posso adicionar uma seção própria?
Como reordeno os blocos da página inicial?
Como mostro avaliações de produtos?
Posso vender cartões-presente?
O suporte está incluído?
Suporte
Escreva para a BoostEcom pelo formulário de suporte do Helm. Uma pessoa responde em até 2 dias úteis, e bugs críticos são corrigidos primeiro.