Ligar uma loja Shopify

Instalar a aplicação, ligar a pesquisa na montra, e os blocos de semelhantes e recomendados, pela ordem certa.

Numa loja Shopify não há código para colar nem ficheiros para editar: instala-se a aplicação Buskara, aprova-se o acesso de leitura, e liga-se um interruptor no editor do tema. O catálogo sincroniza-se sozinho a partir daí, alterações de produtos e de stock incluídas, segundos depois de serem gravadas na loja. O que a app de pesquisa para Shopify muda na loja, o que fica na mesma e o que custa está contado no blog; este guia é só o caminho, pela ordem certa.

1. Instalar a aplicação

O caminho normal começa na Shopify:

1. Na Shopify App Store, abra a página do Buskara e carregue em Instalar. A Shopify mostra o ecrã de consentimento com os acessos pedidos, todos de leitura: produtos, inventário, publicações, idiomas, mercados e encomendas. Carregue em Instalar.
2. A aplicação abre dentro da administração da loja. A conta Buskara é criada nesse momento com o email da loja, e a primeira sincronização do catálogo arranca sozinha.
3. Carregue em Escolher um plano. A Shopify mostra os planos e os dias de avaliação, e o plano escolhido é faturado pela Shopify, na mesma fatura da loja; mudar de plano, cancelar e a avaliação tratam-se a partir daí, em Aplicações → Buskara.

Quem já tem conta Buskara com o mesmo email da loja fica com a loja nessa conta. Quem começa pelo Buskara, em /ativar, escolhe Shopify e é levado à página do Buskara na Shopify App Store: a instalação começa sempre na Shopify, nunca por um endereço escrito no Buskara, e o consentimento é o mesmo.

E é tudo: a loja aparece no painel, em Conta → Lojas, e o botão Abrir o painel do Buskara dentro da administração da loja entra nele sem palavra-passe. A primeira passagem do catálogo demora normalmente menos de um minuto, e um catálogo grande demora alguns.

O Buskara não pede nenhuma autorização de escrita sobre a loja, e o acesso às encomendas serve apenas para atribuir vendas à pesquisa, a pedido do lojista.

2. Mostrar a pesquisa na montra

A pesquisa só aparece aos visitantes quando o lojista a ligar, e o interruptor está no editor do tema:

1. Na administração da loja, abra Loja online → Personalizar.
2. Na barra de ícones do painel esquerdo, abra as incorporações de aplicações (o ícone dos quadrados, ao lado das definições do tema).
3. Ligue o interruptor Buskara e carregue em Guardar.

Não altere o campo "Endereço do serviço" dentro da incorporação: o apoio do Buskara indica se alguma vez for preciso.

A partir daqui, a barra e a lupa de pesquisa do tema passam a abrir o painel do Buskara, com o cursor pronto a escrever. Desligar o interruptor devolve a pesquisa nativa do tema, no momento.

3. O botão "produtos semelhantes" nas fichas

Um botão discreto na ficha de produto que abre o painel de semelhantes, com filtros e comparação. Coloca-se onde o lojista o quiser:

1. No editor do tema, abra um modelo de produto (seletor de páginas no topo → Produtos → o modelo em uso).
2. Na secção dos detalhes do produto, carregue em Adicionar bloco e escolha "Buskara: botão produtos semelhantes".
3. Arraste o bloco para a posição desejada (por baixo do botão de compra é o sítio habitual) e Guardar.

4. O bloco "também pode gostar"

O carrossel de recomendações, alimentado pelo que se vê e se compra na loja:

1. No mesmo editor, em qualquer modelo (fichas de produto incluídas), Adicionar secção ou bloco e escolha "Buskara: bloco também pode gostar".
2. Numa ficha de produto, as sugestões partem desse produto; noutra página qualquer, o carrossel mostra os recomendados gerais da loja.
3. Arraste para a posição e Guardar.

Os dois blocos só se desenham quando há resultados para mostrar: um bloco sem nada para dizer não ocupa lugar.

Os dois têm guia próprio, com o resto da história: o botão de semelhantes e a faixa "também pode gostar" conta o que cada um mostra, o que se afina no painel e o que fazer quando não aparecem.

5. O dia-a-dia

Depois da primeira sincronização, o catálogo mantém-se em dia sozinho:

• Em tempo real: criar, alterar ou apagar um produto, ou mexer no stock, chega ao índice segundos depois, pela própria Shopify.
• Rede periódica: em ciclos regulares, o Buskara confere o que mudou desde a última passagem, para nada ficar para trás.
• Manual: o botão Reindexar tudo na ficha da loja, no painel. As sincronizações automáticas não têm custo nenhum; forçar uma reindexação completa custa 1 bToken por cada 1.000 documentos, e o aviso com a conta aparece antes de confirmar.

O índice segue a língua e a moeda principais da loja, mais as línguas publicadas: uma loja em duas línguas fica com a pesquisa nas duas, com as traduções de produtos que existirem na Shopify e o original onde não existirem.

6. Ligação por token, para casos especiais

Lojas headless ou montagens fora do comum podem ligar-se sem a aplicação, com um token de acesso criado à mão: na administração da loja, em Definições → Aplicações e canais de vendas → Desenvolver aplicações, cria-se uma aplicação com as autorizações de leitura (produtos, inventário, publicações, idiomas, mercados), instala-se, e cola-se o token shpat_ no ecrã de ativação do Buskara, no atalho "Montagem especial: ligar com um token de acesso". O resto do comportamento é o mesmo.

7. Se algo não bater certo

• A pesquisa não aparece na montra: confirme o interruptor das incorporações de aplicações (passo 2) e que gravou.
• Faltam produtos: rascunhos, produtos arquivados e produtos não publicados no canal da loja online ficam fora do índice de propósito, porque não têm página para onde apontar. O guia dos produtos que não aparecem percorre as restantes causas.
• A sincronização parou: o sinal habitual de a aplicação ter sido desinstalada ou o acesso revogado. Volte a instalar pelo passo 1; a loja liga-se à mesma conta e nada se perde.
• O limite de lojas do plano foi atingido: a mensagem diz o plano e o limite; voltar a ligar uma loja que já existe nunca é bloqueado.