Diagnosticar conexão e renderização

Este guia se aplica à versão do ShopiPress indicada no cabeçalho da página, publicada oficialmente no Freemius. Confirme a versão instalada antes de aplicar o procedimento. Versões posteriores podem alterar telas, valores padrão ou fronteiras de serviço.

Resultado esperado

Um relato de defeito identifica o candidato exato, 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.

Prepare um ponto de restauração e identifique o registro de referência na Shopify e a URL ou tela de administração do WordPress que comprovará o resultado. O teste deve ser pequeno o bastante para ser repetido sem criar um estado de catálogo ambíguo.

Escopo e limites atuais

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.

Mantenha o modelo de responsabilidade visível durante toda a tarefa: a Shopify continua sendo a fonte comercial e o sistema de pagamento; o ShopiPress conecta, sincroniza e renderiza o catálogo conforme os contratos entregues; o WordPress detém o contexto de publicação. Um resultado bem-sucedido no WordPress não deve ser interpretado como transferência de pedidos, clientes, pagamentos ou autoridade sobre o estoque.

Procedimento

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 ShopiPress 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.

Não pule a etapa de revisão entre uma ação administrativa e a publicação pública. Uma resposta de controle bem-sucedida é apenas uma camada de evidência; o registro salvo no WordPress, a página renderizada e o caminho comercial da Shopify 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 ShopiPress e apresentação WordPress.
• Nenhum anexo contém tokens, registros de clientes, detalhes de pedidos ou URLs privadas.

Verifique o resultado na página WordPress renderizada e na superfície autoritativa da Shopify, não apenas na tela de administração do ShopiPress. Use um produto representativo com dados de preço, disponibilidade, variante e coleção. Repita a menor operação segura quando a idempotência importar e registre qualquer diferença antes de ampliar o teste.

Erros frequentes

• 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 um resultado for inesperado, interrompa as ações amplas e reduza o caso a um registro, uma URL e um renderizador. Preserve a resposta com falha antes de alterar configurações ou limpar caches, para que o diagnóstico permaneça reproduzível.

Solução de problemas

1. Confirme a versão e a edição do pacote.
2. Reproduza o menor caso seguro com dados controlados.
3. Identifique se a Shopify, o ShopiPress ou o WordPress responde pela etapa que falha.
4. Compare o resultado observado com o estado de capacidade entregue, parcial ou ausente.
5. Restaure o ambiente de teste, repita uma vez e registre se o resultado é estável.

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.

Registre a versão instalada, a edição, as versões do WordPress e do PHP, o construtor ou a integração de SEO ativa, a URL exata, o viewport e as ações ordenadas que produziram o resultado. Capture apenas dados de catálogo controlados. Oculte o token Storefront, dados de clientes, informações de pedidos, domínios privados e qualquer segredo de ambiente antes que um artefato saia do espaço de validação.

Consequências de SEO

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.

Evidências a registrar

Registre a versão instalada, a edição, as versões do WordPress e do PHP, o construtor ou a integração de SEO ativa, a URL exata, o viewport e as ações ordenadas que produziram o resultado. Capture apenas dados de catálogo controlados. Oculte o token Storefront, dados de clientes, informações de pedidos, domínios privados e qualquer segredo de ambiente antes que um artefato saia do espaço de validação.

Guias relacionados

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

Versão e estado do produto

O ShopiPress está publicado oficialmente no Freemius. Este guia descreve a versão documentada. Os links de compra e download serão adicionados a este site quando seus destinos estiverem configurados.