Documentação

Guia de configuração e testes

Tudo o que é preciso para instalar, configurar e verificar o Persistent Cart. O recurso principal (carrinhos salvos restaurados no login) funciona no plano Free, sem nenhum pagamento para testá-lo.

01 - Antes de começar

Requisitos

Limite da plataforma

Carrinhos de visitantes (não logados) ficam guardados localmente no dispositivo e não podem ser sincronizados entre dispositivos. Essa é uma restrição da Shopify, não uma limitação do app: a restauração entre dispositivos exige um cliente cadastrado e logado.

02 - Dois minutos

Instalação

O Persistent Cart é ativado pelo admin da Shopify. Sem código, sem desenvolvedor. Dois passos: instale o app e depois ative a incorporação de app no tema.

  1. Instale o app pela página do app na Shopify App Store e aprove o acesso solicitado. Você chega ao painel do app dentro do admin e escolhe um plano na página de planos da Shopify; o plano Free não exige pagamento.
  2. Ative a incorporação de app no tema (obrigatório). Acesse Loja virtual → Temas → Personalizar → Incorporações de app, ative “Persistent cart” e clique em Salvar.
  3. Pronto. Agora os carrinhos são salvos para clientes logados, e o botão “Compartilhar este carrinho” aparece no carrinho. A configuração leva menos de 60 segundos.
Este passo é obrigatório

Sem a incorporação de app ativada, nada funciona: nem a persistência, nem o botão de compartilhamento. Se algo não estiver funcionando, verifique primeiro se a incorporação está ativada.

Primeiros passos

Você escolhe um plano na página de planos da Shopify ao abrir o app pela primeira vez. O plano Free não exige pagamento.

  1. Acesse Loja virtual, depois Editar tema e depois Incorporações de app.
  2. Ative "Persistent cart" na lista de Incorporações de app.
  3. Clique em Salvar.

Depois de salvar: clientes logados mantêm o carrinho entre dispositivos, e um botão "Compartilhar este carrinho" aparece no carrinho.

Calculadora de frete (opcional)

O carrinho pode mostrar uma estimativa de frete antes do checkout. É um bloco separado, então ele aparece somente onde você o colocar.

  1. Acesse Loja virtual, depois Editar tema e abra o template Carrinho.
  2. Se o template Carrinho não tiver uma seção Apps, clique em Adicionar seção e escolha Apps.
  3. Na seção Apps, clique em Adicionar bloco e escolha “Shipping calculator”.
  4. Clique em Salvar.

A estimativa usa as formas de envio da sua própria loja, para o carrinho que o cliente está vendo. Ela exige um tema hospedado pela Shopify: em uma loja personalizada o bloco não aparece.

Se você não conseguir colocar o bloco (avançado)

Alguns temas mostram o carrinho em uma gaveta lateral, onde o bloco “Shipping calculator” não pode ser colocado. Para esses temas, o app pode inserir a calculadora no carrinho do tema por conta própria. Isso fica desativado por padrão: use o bloco acima sempre que puder.

  1. Acesse Loja virtual, depois Editar tema e depois Incorporações de app, e abra “Persistent cart”.
  2. Ative “Insert the shipping calculator into this theme's cart (advanced)”.
  3. Clique em Salvar.
  4. Na sua loja, adicione ao carrinho um produto que precise de frete. Depois, confira a página do carrinho e também a gaveta do carrinho.

A configuração pertence ao tema em que você a salvou: ao mudar para outro tema, ative-a novamente nele. Em uma página onde o bloco “Shipping calculator” aparece, a calculadora inserida fica desligada, então um carrinho nunca mostra duas calculadoras.

Não está funcionando? Verifique nesta ordem:
  1. A incorporação de app está ativada? Sem ela, nada funciona: nem a persistência do carrinho, nem o botão de compartilhamento.
  2. O cliente está logado? O app salva e sincroniza carrinhos somente para clientes logados. O carrinho de um visitante é o carrinho padrão da Shopify, guardado no navegador, então ele fica naquele dispositivo.

03 - Opcional

Configuração

As configurações padrão funcionam sem nenhum ajuste. Para personalizar, abra a página Configurações do app no admin. As configurações são salvas na sua loja e lidas automaticamente pela loja virtual.

ConfiguraçãoO que fazPlano
Janela de confirmaçãoQuando um carrinho compartilhado encontra um carrinho com itens, mostra uma janela com Mesclar / Substituir / Cancelar.Todos os planos
Mostrar ícone no botãoTipo de íconeMostra o botão de compartilhamento e define o estilo dele (ícone Link / Compartilhar / Carrinho).Pro+
Destino do redirecionamentoLeva o cliente direto para o checkout quando ele abre um link de carrinho compartilhado.Planos pagos
Período de expiraçãoPor quanto tempo um carrinho salvo inativo é mantido (7 / 14 / 30 / 60 dias). No Free, é fixo em 2 dias.Planos pagos
Classe CSS personalizada para o botão de compartilhamentoClasse CSS personalizada para a janela modalConecta o botão de compartilhamento e a janela de confirmação aos estilos do seu tema.Pro+

04 - Verifique se funciona

Testes

Persistência entre dispositivos

  1. Faça login como cliente na loja virtual e adicione alguns produtos ao carrinho.
  2. Abra a loja em um segundo dispositivo ou em um navegador que você ainda não usou nesta loja, logado como o mesmo cliente, com o carrinho vazio.
  3. Abra qualquer página. O carrinho salvo é restaurado automaticamente e a página recarrega com os itens de volta.

Compartilhar este carrinho

  1. Na página do carrinho ou na gaveta do carrinho, clique em “Compartilhar este carrinho” (ao lado do botão de checkout). Um link curto é copiado para a área de transferência.
  2. Abra esse link em outro navegador. Aparece a mensagem “Mesclando seu carrinho…” e os itens são adicionados.
  3. Se você já tinha itens e a janela de confirmação estiver ativada, aparece a janela Mesclar / Substituir / Cancelar.

05 - Conformidade

Dados e privacidade