Publicar com blocos e shortcodes

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

Produtos e coleções sincronizados são colocados em páginas do WordPress com os blocos entregues, os shortcodes públicos ou os construtores compatíveis, enquanto todo caminho de compra continua na Shopify.

Coloque os dados de catálogo sincronizados no Gutenberg, em temas e áreas de conteúdo com 17 blocos e 27 shortcodes prefixados.

Antes de começar

• Pelo menos um produto e uma coleção sincronizados e verificados.
• Um tema ou template de página cuja largura de conteúdo e tipografia sejam conhecidas.
• Um método de renderização escolhido: Gutenberg, shortcode, Elementor PRO ou WPBakery PRO.
• Uma decisão canônica e de indexação para a superfície de produto do WordPress.

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

A presença de um construtor não prova atributos, controles, marcação ou saída idênticos. Onze shortcodes públicos não têm componente dedicado em nenhum dos três construtores, e CollectionProductsPerPage existe apenas nos construtores no candidato exato.

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. Abra a área Adicionar às minhas páginas e decida se uma saída composta de produto ou coleção ou componentes granulares se encaixam na página.
2. Insira o bloco Gutenberg entregue ou copie o shortcode exato com seu prefixo na área de conteúdo pretendida.
3. Para construtores PRO, adicione o componente nativo e compare seus controles com a referência de shortcodes ou blocos em vez de presumir paridade.
4. Pré-visualize a página em larguras de desktop e mobile, incluindo variantes, disponibilidade, preço e estados vazios.
5. Siga a ação de compra até a criação do carrinho e confirme que o pagamento é hospedado pela Shopify.

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

• A identidade e o preço do produto renderizado correspondem ao registro sincronizado.
• O layout funciona com navegação por teclado e a 320 pixels sem rolagem horizontal.
• O link de compra ou a ação de carrinho aponta para o caminho comercial pretendido na Shopify.

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

• Componente granular em branco: confirme que a página fornece o contexto de produto ou coleção exigido.
• A saída do construtor diverge: consulte a matriz de cobertura e teste o renderizador específico do construtor; não trate cobertura conceitual como paridade de marcação.
• A compra falha: verifique a identidade do produto e da variante, a conexão Storefront pública e a resposta do carrinho da Shopify.

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

Não cole tokens em campos de construtores de página nem em HTML personalizado. Trate o CSS fornecido pelo usuário e o acesso ao construtor como capacidades de publicação privilegiadas.

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

Inspecione a URL final, os títulos, os links internos, o canônico, o robots e os dados estruturados. Uma pré-visualização visualmente correta no construtor não prova que os rastreadores recebem o HTML pretendido.

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.