Diagnosticar conexão e renderização

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

Um relato de defeito identifica a versão instalada, o sistema afetado, os passos reproduzíveis, o comportamento esperado e o observado, e evidências seguras que não vazam credenciais nem dados de clientes.

Separe o acesso à Shopify, o HTTP do WordPress, os dados de sincronização e a renderização do tema antes de alterar credenciais ou templates.

Antes de começar

• A versão instalada, a edição e a procedência do pacote.
• Uma página de teste ou registro de catálogo reproduzível com dados controlados.
• As versões de navegador, WordPress, PHP e do construtor ou plugin de SEO ativo.
• Um backup do banco de dados antes de diagnóstico destrutivo ou sincronizações repetidas.

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 formulário de suporte permanece deliberadamente fechado até que seus controles de borda estejam configurados. Um relato pode ser preparado localmente, mas o site não deve dar a entender que um formulário não configurado o enviou.

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. Classifique a falha como conexão, descoberta, sincronização, dados do WordPress, renderização, compra, SEO ou ciclo de vida.
2. Reduza o caso a um produto, uma coleção, um shortcode, um bloco ou uma URL sempre que possível.
3. Registre os passos exatos e compare o comportamento esperado com o estado de capacidade entregue, parcial ou ausente.
4. Capture a página renderizada e a tela pertinente do Fy2Press após remover tokens, domínios que devem permanecer privados e dados pessoais.
5. Restaure o ambiente após os experimentos e confirme se o defeito persiste no estado limpo.

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

• Outro administrador consegue reproduzir o defeito a partir do relato sem adivinhar passos ausentes.
• O relato distingue as camadas de fonte Shopify, transporte Fy2Press e apresentação WordPress.
• Nenhum anexo contém tokens, registros de clientes, detalhes de pedidos ou URLs privadas.

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

• Comportamento intermitente: capture carimbos de tempo e a sequência de mudanças de estado em vez de repetir a ação várias vezes.
• Somente a pré-visualização do construtor falha: teste o renderizador do frontend e identifique se o problema ocorre apenas no editor.
• A saída de SEO é inesperada: salve o HTML final e a lista de integrações ativas antes de limpar caches.

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

Higienize as evidências antes de compartilhá-las. Substitua tokens, informações de clientes, identificadores de pedido e domínios privados da loja por marcadores controlados, preservando a estrutura necessária para reproduzir o problema.

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

Para defeitos de SEO, inclua o status exato da resposta, o canônico, o robots, o hreflang quando pertinente, a participação no sitemap, os dados estruturados e os links internos. Uma captura de tela sozinha não basta.

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.