Pular para o conteúdo principal

FAQ e Troubleshooting

Respostas rápidas para as perguntas que aparecem com mais frequência.

Instalação e configuração​

O Vertex exige um plano Shopify Plus ou Advanced?​

Não. O Vertex instala em qualquer plano Shopify. Porém, os recursos B2B nativos (companies, B2B catalogs, NET-terms, isenção de imposto, multi-localização) exigem Shopify Plus ou Advanced com o B2B add-on. Sem eles, o Vertex ainda funciona como um tema B2C polido de suprimentos industriais — cada recurso B2B se degrada com elegância.

Preciso de algum aplicativo complementar?​

Não. O Vertex usa os recursos B2B nativos da Shopify de ponta a ponta. Sem app de gestão de cotações, sem app de preço de atacado, sem app multi-currency, sem app de comparação.

Quanto tempo leva a instalação completa?​

  • Instalação básica (somente tema): 5 minutos
  • Instalação B2B completa (tema + B2B nativo + companies + catálogos + metafields): 45–60 minutos na primeira vez. Empresas subsequentes levam 5 minutos cada.

Posso usar o Vertex em uma loja de desenvolvimento primeiro?​

Sim. Instale o Vertex em qualquer dev store e customize sem afetar sua vitrine ao vivo. Publique somente quando estiver pronto.

Visibilidade do chrome B2B​

Por que a barra de saudação B2B âmbar não aparece?​

Em ordem de probabilidade:

  1. Você não está logado como cliente B2B. A barra só renderiza quando customer.b2b? é true E customer.current_company está definido.
  2. O modo de Storefront está definido como B2C-only. Abra Theme settings ▸ B2B ▸ Storefront mode e mude para Hybrid (auto) ou B2B-only.
  3. O B2B nativo não está habilitado no admin da Shopify. Vá para Settings ▸ Customer accounts ▸ B2B ▸ Manage ▸ Enable B2B.
  4. A empresa do comprador foi deletada ou revogada. O Vertex pula defensivamente a barra quando customer.current_company é nil no meio da sessão.

Por que a pill do representante de vendas não aparece no header?​

A pill do representante só renderiza quando todas as três condições são verdadeiras:

  1. O comprador está logado como B2B (customer.b2b? == true)
  2. A empresa do comprador tem um metafield vertex.rep_name definido
  3. O modo de Storefront não é B2C-only

Verifique em Customers ▸ Companies ▸ [Nome da empresa] ▸ Metafields se vertex.rep_name está populado.

Por que as faixas de preços por volume não aparecem na PDP?​

O Vertex lê as faixas de volume a partir do quantity_price_breaks nativo da Shopify. A tabela de volume na PDP só renderiza quando:

  1. O comprador está logado em uma empresa
  2. A empresa está atribuída a um catálogo B2B
  3. A lista de preços do catálogo inclui o produto com faixas de preço baseadas em quantidade

Se a tabela estiver vazia, verifique novamente a lista de preços em B2B ▸ Catalogs ▸ [Nome do catálogo] ▸ Price list.

Por que meu comprador B2B vê "Log in to see pricing" mesmo estando logado?​

O toggle Theme settings ▸ B2B ▸ Hide prices until customer logs in está ligado. Esse recurso oculta preços para visitantes apenas. Clientes logados (B2C OU B2B) devem sempre ver os preços. Se não veem, desative a configuração e salve.

Por que a vitrine parece "B2C" mesmo eu estando logado como B2B?​

Ou:

  1. O modo de Storefront está definido como B2C-only. Mude para Hybrid ou B2B-only.
  2. O registro do cliente não está vinculado a uma empresa. Abra Customers ▸ [Nome do cliente] e confirme que ele está vinculado a uma empresa na aba Companies.

Customização​

Como mudo a cor da marca?​

  1. Abra Theme settings ▸ Colors
  2. Escolha uma Starter color palette para recolorir em um clique, OU selecione Custom e sobrescreva cada cor individualmente

Como adiciono uma fonte customizada?​

Os font pickers em Theme settings ▸ Typography usam a biblioteca de fontes da Shopify. Para usar uma fonte fora dela, adicione um <link> em theme.liquid e atualize as custom properties CSS --font-body / --font-heading.

  1. Abra o editor de tema e clique em Header no painel de seções
  2. Clique em Logo image e faça upload do seu arquivo
  3. Altura recomendada: ~40 px; SVG preferido

Como customizo o texto da announcement bar?​

  1. Abra Header group ▸ Announcement bar no editor de tema
  2. Edite o campo Text
  3. A barra tem um × dispensável embutido que respeita o localStorage

Como adiciono/edito a navegação secundária (Special offers / Guides / Services / FAQ)?​

  1. Vá para Online Store ▸ Navigation
  2. Crie um novo menu com o handle secondary-menu (auto-detectado pelo Vertex)
  3. Adicione links — eles aparecem alinhados à direita no header desktop

Como alterno entre as 4 vitrines demo (Vertex / Throttle / OfficeIT / Inkline)?​

Duas formas:

  1. Recoloração permanente — Theme settings ▸ Colors ▸ Starter color palette — escolha um dos 4 presets
  2. Preview temporário — anexe ?view=throttle (ou officeit / printsupply) a qualquer URL em sua vitrine

→ Veja Guia de presets demo para detalhes.

Performance​

Qual é a pontuação Lighthouse em uma vitrine Vertex?​

Registrado no demo showcase:

  • Mobile Performance: 65–100 (dependendo do tipo de página)
  • Desktop Performance: 90+ em cada página
  • Accessibility: 92–95
  • Best Practices: 95+
  • SEO: 100

Como melhoro ainda mais o Lighthouse Performance?​

  1. Otimize imagens hero. Use WebP em múltiplas larguras; mire em menos de 300 KB por slide.
  2. Limite o hero a 1 slide. Hero rotators multi-slide custam LCP. O padrão vem com 1 slide.
  3. Limite Shopify app embeds. Cada app de terceiros injeta JS — cada um adiciona ao TBT.

Por que meu Performance mobile é menor que meu Performance desktop?​

Padrão para temas Shopify — mobile é throttled no Lighthouse (CPU mais lenta + rede mais lenta). Usuários reais de iPhone 14 / Galaxy S22 obtêm pontuações muito melhores do que o número do Lighthouse.

Acessibilidade e internacionalização​

O Vertex está em conformidade com WCAG 2.1 AA?​

Sim. Navegação por teclado, foco visível, contraste mínimo de 4.5:1, áreas de toque de 24 px em mobile, roles ARIA adequados, link skip-to-content, inputs de formulário com label.

Quais idiomas o Vertex traz?​

5: Inglês (padrão), Francês, Italiano, Alemão, Espanhol. Strings de UI + labels de schema são ambos traduzidos.

O Vertex suporta idiomas RTL?​

Sim — totalmente. <html dir> é invertido automaticamente para Árabe, Hebraico, Persa, Urdu, Iídiche, Curdo, Dhivehi e Pashto. O CSS usa logical properties para que o layout espelhe de forma limpa.

Posso adicionar outro idioma?​

Sim. Traduza locales/en.default.json para seu idioma alvo, salve como locales/{code}.json. Os labels de schema vivem em locales/en.default.schema.json — traduza para locales/{code}.schema.json para localizar também a UI do editor.

Metafields e dados do produto​

Quais metafields o Vertex usa?​

No namespace vertex:

  • vertex.mpn (product) — Manufacturer Part Number, indexado na busca preditiva
  • vertex.ships_from (product) — Cidade ships-from por produto
  • vertex.price_history (product) — Lista JSON de entradas {date, price}
  • vertex.datasheet, vertex.msds, vertex.brochure, vertex.tech_sheet, vertex.install_guide, vertex.warranty (product) — file pickers para PDFs
  • vertex.rep_name, vertex.rep_email, vertex.rep_phone (company) — Representante de vendas por empresa
  • vertex.payment_terms (company) — Override do label do badge de prazos NET

Além de um metaobject tech_spec_row (lista, vinculado a produto) para a tabela de especificações técnicas.

→ Referência completa: Guia de configuração de metafield.

O que acontece se um metafield estiver faltando?​

O bloco correspondente da PDP auto-oculta. O Vertex é defensivo sobre metafields ausentes — valores vazios nunca renderizam UI quebrada.

Preços e licenciamento​

Quanto custa o Vertex?​

$399 USD licença de loja única. Inclui atualizações gratuitas para todos os releases v1.x.

Posso usar uma licença Vertex em várias lojas?​

Não — a licença padrão da Theme Store é de loja única. Para licenciamento multi-loja, abra um ticket através do portal de suporte da Theme Store.

O Vertex receberá atualizações?​

Sim. Releases v1.x incluem correções de bugs, melhorias de performance e novas seções. Veja o Changelog.

Erros comuns e correções​

"O Theme Check mostra 18 avisos na minha versão customizada"​

Você provavelmente editou templates Liquid e introduziu variáveis não utilizadas ou rotas hardcoded. Execute shopify theme check localmente para ver detalhes. O Vertex em si vem com 0 ofensas de Theme Check.

"Meu CSS customizado está sendo sobrescrito"​

Os arquivos CSS por seção do Vertex têm maior especificidade do que uma folha de estilo genérica. Adicione overrides via:

  1. Theme settings ▸ Colors ▸ Custom (preferido — a maioria das coisas é dirigida por variáveis CSS)
  2. CSS customizado em assets/vertex.css após as regras existentes
  3. Um novo assets/custom-overrides.css com !important (último recurso)

Ainda com problemas?​