Helm

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

Começar

Primeiros passos

Da biblioteca de temas a uma primeira página em quatro passos.

  1. 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.

  2. 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.

  3. 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.

  4. 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

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.

  • Canvas
  • Hero
  • Hero with image
  • Features grid
  • Stats row
  • How it works
  • FAQ
  • Reviews grid
  • Story split
  • Newsletter
  • CTA banner
  • Logo bar
Páginas

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.
Blocos

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.

  • Heading
  • Text
  • Rich text
  • Quote
  • Pull quote
  • Stat
  • Badge
  • Divider
  • Link list

Mídia

Imagens, vídeo, galerias, ícones, espaçamentos, um comparador de antes e depois e uma faixa rolante.

  • Image
  • Video
  • Gallery
  • Icon
  • Spacer
  • Before / after
  • Marquee

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.

  • Group
  • Columns
  • Split
  • Hero
  • CTA banner
  • Slideshow
  • Slide
  • Tabs
  • Tab
  • Accordion
  • Accordion 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.

  • Button
  • Email capture
  • Countdown
  • Pricing card
  • Comparison table
  • Comparison row

Confiança

Depoimentos, cartões de avaliação, selos de confiança, logos, ícones de pagamento e links de redes sociais.

  • Testimonial
  • Review card
  • Trust badges
  • Logo list
  • Payment icons
  • Social icons

Perguntas e passos

Perguntas frequentes e uma lista de passos numerados.

  • FAQ
  • FAQ item
  • Step list
  • Step

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 location
  • Collection card
  • Recently viewed
  • Cookie 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 title
  • Product vendor
  • Product SKU
  • Product price
  • Product description
  • Product rating
  • Variant picker
  • Quantity selector
  • Buy buttons
  • Pickup availability
  • Shop Pay Installments
  • Share button
  • Product tabs
  • Stock status
  • Product bundle
  • Product 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

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 page
  • Collection page
  • Collections list page
  • Cart page
  • Search results page
  • Blog page
  • Article page
  • Page
  • Contact form
  • 404 page
  • Password page

Cabeçalho, rodapé e carrinho

A barra de avisos, o cabeçalho, o rodapé, o carrinho lateral e a busca preditiva.

  • Header
  • Footer
  • Announcement bar
  • Cart drawer
  • Predictive 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 cart
  • Recommendations

Moldura de destino

Um cabeçalho e um rodapé reduzidos para as páginas que usam o layout de destino.

  • Landing header
  • Landing footer

Utilitários

Apps recebe blocos de app. Custom Liquid recebe seu próprio código.

  • Apps
  • Custom Liquid

Grupos de seções

  • header-group
  • footer-group
  • overlay-group
  • landing-header-group
  • landing-footer-group
Modelos

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.

  • index
  • product
  • collection
  • list-collections
  • search
  • cart
  • 404
  • password

Páginas de conteúdo

O blog, os artigos e as páginas: sobre, contato, perguntas frequentes, avaliações e um localizador de lojas.

  • blog
  • article
  • page
  • page.about
  • page.contact
  • page.faq
  • page.review
  • page.locator-store

Páginas de destino

Páginas advertorial e lead magnet, no layout de destino com cabeçalho e rodapé reduzidos.

  • page.advertorial
  • page.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_card
  • gift_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

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 image
  • Logo width
  • Favicon

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 font
  • Heading size scale
  • Heading transform
  • Body font
  • Body size scale
  • Accent font

Layout

Largura máxima do conteúdo, escala de espaçamento (Compact, Regular, Spacious) e raio dos cantos (Sharp, Soft, Round).

  • Max content width
  • Spacing scale
  • Corner 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 animations
  • Use 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 type
  • Show order note
  • Free 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 links
  • Add noreferrer to external links
  • Open external links in new tab
  • Auto-noindex landing pages
  • Allow 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 image
  • Facebook
  • Instagram
  • X
  • TikTok
  • YouTube
  • Pinterest
  • LinkedIn
  • Threads
  • Snapchat
Carrinho

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

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.
Privacidade

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

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

Perguntas frequentes

Posso adicionar uma seção própria?
O Helm monta as páginas a partir do Canvas. Para seu próprio código, use a seção ou o bloco Custom Liquid; para um app, a seção Apps ou um bloco de app dentro do Canvas.
Como reordeno os blocos da página inicial?
Abra o editor de temas, arraste os blocos de cada seção Canvas pela alça na barra lateral e salve.
Como mostro avaliações de produtos?
Os blocos Review card mostram avaliações de um metaobjeto product_review ou digitadas à mão, e Product rating mostra as estrelas dos metacampos reviews.rating. Para coletar avaliações dos clientes, é preciso um app de avaliações.
Posso vender cartões-presente?
Sim. Os produtos de cartão-presente usam o modelo product.gift_card. Nele, o comprador pode enviar o cartão para alguém, com o e-mail do destinatário, um nome, uma mensagem de até 200 caracteres e uma data de envio até 90 dias depois. O modelo gift_card é a página em que o cartão é entregue.
O suporte está incluído?
Sim, para bugs do tema e perguntas sobre o uso. Personalizações e serviços não estão incluídos no preço do tema.

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.