Como corrigir o JetWooBuilder que não edita templates de produto
O que é o JetWooBuilder que não edita template de produto?
O JetWooBuilder é o plugin da Crocoblock que permite montar templates visuais das páginas de loja do WooCommerce (Produto Único, Catálogo, Carrinho, Finalizar Compra e Minha Conta) dentro do editor Elementor, na versão gratuita, usando widgets próprios como Single Title, Single Images, Single Add to Cart e Single Meta. Quando ele não edita o template de produto, você cria o template em Crocoblock, Woo Page Builder, mas os widgets do JetWooBuilder não aparecem na barra lateral do Elementor, ou o template salva mas a página de produto no frontend continua com o layout padrão do tema. Isso acontece porque o JetWooBuilder depende de três etapas separadas: habilitar os widgets de Single Product nas configurações do plugin, criar o template do tipo Single, e atribuir esse template ao produto em WooCommerce, Settings, JetWooBuilder marcando a opção que ativa o single page customizado. Pular qualquer uma dessas etapas faz o template existir mas nunca substituir a página real.
Como identificar
- Os widgets do JetWooBuilder, como Single Title, Single Images e Single Add to Cart, não aparecem na barra lateral de widgets do editor Elementor ao abrir o template.
- O template de Single foi salvo em Crocoblock, Woo Page Builder, mas a página de produto no frontend continua com o layout padrão do tema e ignora o design.
- Em WooCommerce, Settings, JetWooBuilder, a seção Single Product não mostra o template no dropdown Single Product Template, ou a opção Enable custom product single page aparece desmarcada.
- Ao abrir o produto no frontend, o design só aparece no editor, mas a página pública mostra o template antigo do tema ou da loja.
- Depois de uma atualização do JetWooBuilder, do WooCommerce ou do Elementor, o template parou de ser aplicado e o produto voltou ao layout do tema.
Como prevenir
- Atualize JetWooBuilder, WooCommerce e Elementor sempre juntos, nunca apenas um, para evitar incompatibilidade de versão que derruba o template de produto
- Sempre confirme a opção Enable custom product single page em WooCommerce, Settings, JetWooBuilder logo após criar o template, antes de testar no frontend
- Use um tema neutro como o Hello Elementor em lojas montadas inteiramente no JetWooBuilder, para o WooCommerce do tema não competir com o template do plugin
- Teste cada template novo em ambiente de staging e confirme a atribuição antes de publicar na loja em produção
Causa
- A opção Enable custom product single page em WooCommerce, Settings, JetWooBuilder, seção Single Product, está desmarcada, então o template salvo nunca é atribuído à página de produto.
- Os widgets de Single Product estão desativados em Crocoblock, JetPlugins Settings, JetWooBuilder, Widgets, então os widgets Single Title, Single Images e Single Add to Cart não aparecem na barra lateral do Elementor.
- O template do JetWooBuilder está salvo como rascunho ou privado em Templates, Saved Templates, e não como Público, então o frontend não consegue carregá-lo.
- O Elementor não está habilitado para o post type product em Elementor, Settings, General, deixando o editor sem assumir as páginas do WooCommerce.
- Um tema com WooCommerce próprio, como Astra ou Storefront, registra seu próprio template de produto pelo Theme Builder e sobrescreve o template do JetWooBuilder.
- Os arquivos CSS do Elementor para o template estão corrompidos ou desatualizados após uma atualização, então o template carrega sem estilo ou não aplica as mudanças no frontend.
Como resolver
- Confirme JetWooBuilder, WooCommerce e Elementor ativos e atualizados: em Plugins, Plugins Instalados, garanta que o JetWooBuilder, o WooCommerce e o Elementor estão os três ativos. Em Crocoblock, Update and Installation, clique em Check For Updates e atualize o JetWooBuilder se houver versão nova, porque arquivos desatualizados criam conflito com o template.
wp plugin list --status=active --field=name wp plugin activate jet-woo-builder woocommerce elementor - Habilite os widgets de Single Product: vá em Crocoblock, JetPlugins Settings, JetWooBuilder, aba Widgets, role até o bloco Single Product Widgets e ligue os widgets que vai usar, como Single Title, Single Images e Single Add to Cart. Sem isso eles não aparecem na barra lateral do Elementor e você não consegue editar o template.
- Crie o template do tipo Single: abra Crocoblock, Woo Page Builder e clique em Create New Template. No campo This Template For escolha a opção Single, defina o Template Name e clique em Create Template para abrir o Elementor. Monte a página com os widgets do JetWooBuilder e clique em Update para salvar.
- Atribua o template ao produto no WooCommerce: este é o passo que a maioria pula. Vá em WooCommerce, Settings, aba JetWooBuilder e role até a seção Single Product. Marque a opção Enable custom product single page, escolha o template criado no dropdown Single Product Template e clique em Save changes no rodapé. Sem isso o template fica salvo mas nunca substitui a página real.
- Garanta que o template está Público e o Elementor habilitado: vá em Templates, Saved Templates e confirme que o template do JetWooBuilder está como Público, não como rascunho ou privado. Depois, em Elementor, Settings, General, confirme que o post type product está marcado, para o Elementor assumir as páginas de produto.
- Regenere o CSS e limpe os caches: vá em Elementor, Tools, General, clique em Regenerate CSS e depois em Sync Library, para reconstruir os arquivos de estilo do template. Em seguida limpe o cache do plugin de cache e o cache de servidor da hospedagem, já que conteúdo antigo em cache faz o frontend mostrar o layout velho.
- Isole conflito de tema e plugins: se o template tem condição certa mas ainda não aplica, troque temporariamente para um tema neutro como o Twenty Twenty-Four e desative os plugins não essenciais, deixando só JetWooBuilder, WooCommerce e Elementor. Se o template voltar a aplicar, reative um plugin por vez para achar o conflito ou ajuste o WooCommerce override do tema.
<?php
// Diagnostico: confirma os pre-requisitos do template de produto do JetWooBuilder.
// Rode via wp eval-file diagnostico.php ou cole num snippet temporario.
if ( ! is_plugin_active( 'jet-woo-builder/jet-woo-builder.php' ) ) {
error_log( 'JetWooBuilder: plugin INATIVO' );
}
if ( ! is_plugin_active( 'woocommerce/woocommerce.php' ) ) {
error_log( 'JetWooBuilder: WooCommerce INATIVO' );
}
// Le as opcoes do JetWooBuilder: single page customizado ligado e qual template.
$opts = get_option( 'jet_woo_builder', array() );
$enabled = ! empty( $opts['enable_custom_single'] ) ? 'SIM' : 'NAO';
$template = isset( $opts['single_template'] ) ? $opts['single_template'] : '0';
error_log( sprintf( 'Single page customizado: %s | Template ID atribuido: %s', $enabled, $template ) );
if ( $template && 'publish' !== get_post_status( (int) $template ) ) {
error_log( 'JetWooBuilder: template existe mas NAO esta publicado (rascunho/privado)' );
}














