Gerenciar tokens, pacotes e telemetria

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

Os administradores conseguem explicar o que o Fy2Press lê da Shopify, o que armazena no WordPress, quais serviços opcionais estão envolvidos e quais dados sensíveis nunca devem entrar nas evidências ou no conteúdo das páginas.

Mantenha distintas as credenciais públicas e privadas, limite o acesso administrativo e entenda o fluxo opcional de dados do Freemius.

Antes de começar

• Os registros de autoridade de produto e comercial da versão apresentada.
• Um inventário dos administradores do WordPress autorizados a gerenciar a conexão.
• O token Storefront público da Shopify e os escopos de catálogo pretendidos.
• Uma decisão sobre a adesão opcional ao Freemius e o licenciamento premium.

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

A versão apresentada usa um token Storefront público para as requisições de catálogo e de carrinho. Ela não torna o WordPress o sistema de registro de clientes, pedidos, pagamentos ou checkout, e não envia à Pagup nenhuma telemetria de uso do plugin nem requisição de licença de forma direta. Alguns componentes de exibição podem consultar a Shopify entre execuções manuais. Em uma loja, dois cookies próprios mantêm o carrinho por sete dias: fy2press_cart_ contém uma referência de carrinho Shopify criptografada e autenticada (HttpOnly); fy2press_has_cart_ contém apenas um indicador 1 legível por scripts, sem ID nem segredo. Ambos usam SameSite=Lax e Secure em HTTPS. Apagá-los ou bloqueá-los pode interromper a continuidade do carrinho, sem cancelar um pedido da Shopify. Uma integração pode fornecer campos opcionais de e-mail ou telefone ao criar um carrinho; esses campos passam pelo WordPress até a Shopify. Os botões padrão não devem ser descritos como se os coletassem automaticamente. Por outro lado, afirmar que o plugin nunca pode processar esses campos seria impreciso.

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. Documente o endpoint da loja Shopify e confirme que a credencial é um token Storefront público.
2. Liste os tipos de conteúdo, as taxonomias e as opções do WordPress criados ou atualizados por esta versão.
3. Revise a adesão ao Freemius e o caminho de licenciamento separadamente das requisições de catálogo da Shopify.
4. Verifique se suporte, logs, capturas de tela e vídeos não contêm token nem dados de clientes, pedidos, pagamentos ou endereços privados.
5. Teste o comportamento de downgrade e de desinstalação em um ambiente descartável antes de decidir qual limpeza operacional é aceitável.

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

• Os registros de catálogo são identificáveis como posts de produto e termos de taxonomia do WordPress.
• As requisições de carrinho e de checkout permanecem associadas à Shopify.
• Os serviços opcionais são descritos como opcionais e nenhum fluxo comercial público é inferido a partir da configuração do código-fonte.

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

• Uma credencial privada aparece nas evidências: interrompa a distribuição, remova o artefato e rotacione a credencial quando a exposição não puder ser descartada.
• Um serviço é contatado inesperadamente: capture o destino e a ação que o dispara e depois compare com a fronteira de serviços documentada.
• Conteúdo desaparece durante os testes de ciclo de vida: restaure o banco de dados e verifique os contratos de desinstalação delimitada e de downgrade não destrutivo.

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

Aplique o menor privilégio à administração do WordPress, proteja backups e logs e nunca trate um token Storefront público como permissão para divulgá-lo com leviandade. Público não significa irrelevante para a prevenção de abuso.

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

Escolhas de privacidade e segurança afetam o que pode ser renderizado e indexado. Mantenha ambientes de teste privados em noindex, impeça que templates internos entrem nos sitemaps e assegure que os dados estruturados públicos não contenham material administrativo nem credenciais.

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.