Conectar a Shopify com segurança

Este guia descreve o Fy2Press 1.0.0. As telas podem mudar em versões posteriores, então confira a versão exibida na tela Plugins antes de segui-lo.

Resultado esperado

Sua loja Shopify está conectada com o endereço da loja e um token público da Storefront API, o teste de conexão é bem-sucedido e o Fy2Press não mostra mais o status Desconectado.

Crie um token público da Storefront API no canal Headless da Shopify, insira-o com o endereço da loja e teste a conexão.

Antes de começar

• Permissão para gerenciar canais de vendas no painel administrativo da Shopify dessa loja.
• O Fy2Press instalado, com a tela Início aberta.
• O endereço myshopify.com da loja, por exemplo example-store.myshopify.com.
• Uma hospedagem WordPress que permita requisições HTTPS de saída para a Shopify.

Planeje uma forma de voltar atrás antes de começar: um backup ou uma cópia de teste do site (staging), o produto da Shopify que servirá de comparação e a página do WordPress que deve mostrar o resultado. Comece com um teste pequeno que você possa repetir.

O que este guia abrange

O FREE conecta uma loja Shopify. O campo espera um token público da Storefront API: um token privado ou um token da Admin API não serve como substituto. Um teste bem-sucedido confirma o acesso ao catálogo; nada é sincronizado ainda. O próprio tutorial da Shopify continua com um token privado para código de servidor, que não é o valor usado pelo Fy2Press.

Lembre-se de quem faz o quê: a Shopify mantém os produtos, o estoque, os pedidos, os pagamentos e o checkout; o Fy2Press traz o catálogo para o WordPress e o exibe; o WordPress hospeda suas páginas e seu conteúdo editorial. Nada neste guia transfere pedidos, clientes ou pagamentos para o WordPress.

Etapas

1. Na Shopify, instale o canal de vendas Headless pela Shopify App Store, se ele ainda não estiver lá, e abra-o.
2. Escolha Create storefront ou abra a vitrine (storefront) que você já usa para o WordPress e, em seguida, abra as configurações da Storefront API dela.
3. Copie o token público da Storefront API. Com o proprietário da loja, ative apenas estas permissões da Storefront API: produtos e coleções (unauthenticated_read_product_listings), tags de produtos (unauthenticated_read_product_tags), estoque de produtos (unauthenticated_read_product_inventory) e leitura e alteração do carrinho (unauthenticated_read_checkouts, unauthenticated_write_checkouts). Deixe desativadas as permissões de clientes, conteúdo e metaobjetos: o Fy2Press não lê dados de clientes nem de pedidos.
4. No WordPress, abra Fy2Press → Configurações de conexão. Em URL da loja, digite apenas a parte antes de .myshopify.com e cole o token em Token público da Storefront API.
5. Selecione Testar conexão, confirme que esta é a loja pretendida e selecione Salvar configurações.

Revise o resultado antes de tornar uma página pública. Uma mensagem de sucesso é um bom sinal, mas a página pública e o caminho de compra na Shopify também precisam coincidir.

Verificar o resultado

• O Status da conexão não mostra mais Desconectado após o teste.
• A tela Início não pede mais que você conecte a Shopify.
• O token fica oculto na tela de configurações, a menos que você selecione Mostrar, e nunca aparece em páginas públicas.

Confira o resultado onde os visitantes vão vê-lo: abra a página pública do WordPress, e não apenas a tela do Fy2Press, e compare um produto representativo com a Shopify, incluindo preço, disponibilidade, variantes e coleção. Repita uma pequena alteração uma vez para confirmar que o comportamento é estável.

Problemas comuns

• Unauthorized (não autorizado): o token não é o token público da Storefront API, pertence a outra loja ou foi revogado.
• Store not found (loja não encontrada): digite apenas o subdomínio myshopify.com, sem https://, sem caminho e sem seu domínio personalizado.
• Erro de rede: pergunte à sua hospedagem se o WordPress pode fazer requisições HTTPS de saída para a Shopify e envie a mensagem de erro, nunca o token.

Quando algo inesperado acontecer, interrompa as operações grandes e tente de novo com um único produto e uma única página. Guarde a mensagem de erro exata antes de alterar configurações ou limpar caches.

Solução de problemas

1. Confirme a versão e a edição do plugin (FREE ou PRO).
2. Reproduza o problema com um único produto de teste.
3. Determine se o problema vem da Shopify, do Fy2Press ou do seu tema do WordPress.
4. Compare o resultado com o que a sua edição inclui, conforme descrito no guia de edições.
5. Restaure sua configuração de teste, tente mais uma vez e anote se o resultado se repete.

Segurança e dados

O token público foi feito para requisições da vitrine, mas mantenha-o fora de capturas de tela, mensagens de suporte e documentos compartilhados. Nunca insira um token privado da Storefront API nem um token da Admin API no Fy2Press.

Se você pedir ajuda, anote a versão do plugin, as versões do WordPress e do PHP, seu tema ou construtor de páginas, o endereço da página e as etapas que você seguiu. Use produtos de teste e remova das capturas de tela os tokens, os dados de clientes, os detalhes de pedidos e os endereços privados antes de compartilhá-las.

Efeito nas buscas

Conectar uma loja não cria nenhuma página pública. Antes de sincronizar, decida em Google e SEO se o WordPress ou a Shopify deve ficar com o endereço principal dos produtos.

Informações para o suporte

Se você pedir ajuda, anote a versão do plugin, as versões do WordPress e do PHP, seu tema ou construtor de páginas, o endereço da página e as etapas que você seguiu. Use produtos de teste e remova das capturas de tela os tokens, os dados de clientes, os detalhes de pedidos e os endereços privados antes de compartilhá-las.

Guias relacionados

• Instalação
• Publicar com WordPress
• Google e SEO
• Segurança e dados

Versão e disponibilidade

Documentação do Fy2Press 1.0.0. O plugin gratuito está disponível no WordPress.org. O PRO é vendido separadamente pela Freemius, nossa fornecedora de licenças e pagamentos.