O botão “Editar com o Page Builder Sandwich” não aparece
Se você não conseguir ver o botão “Editar com o Page Builder Sandwich” no frontend do seu site, aqui estão algumas coisas que você pode tentar:
Certifique-se de que sua barra de administração esteja visível
O botão de edição do PB Sandwich está disponível na barra de administração no seu frontend. Certifique-se de que a barra de administração esteja visível acessando seu painel administrativo e navegando até Usuários > Seu perfil e verificando se a opção Mostrar barra de ferramentas ao ver o site está marcada.

Certifique-se de que você está em uma página, post ou tipo de post personalizado
Apenas Posts, Páginas e Tipos de Post Personalizados são editáveis no Frontend. Você só pode editar itens no frontend se puder editá-los usando o editor de conteúdo do WordPress no backend. As outras áreas do seu site — por exemplo, a lista de posts do blog na página inicial, lista de todos os posts do blog, listagens de categorias, páginas 404, páginas de busca — são páginas dinâmicas criadas pelo WordPress em conjunto com o tema que você está usando e não podem ser editadas com o PB Sandwich.
Um indicativo de que a página da web atual é editável é se você consegue ver “Editar post” ou “Editar página” na sua barra de administração.
Certifique-se de que seu conteúdo não seja gerado dinamicamente pelo seu tema ou por um plugin
Se a sua página/post for gerada dinamicamente por um tema ou plugin, ela não será editável com o Page Builder Sandwich (e muito provavelmente em outros construtores de páginas também). Se você notar que o seu editor de conteúdo no backend está vazio, mas ao visualizar a página no frontend ela está cheia de conteúdo, esse é um bom indicativo de que sua página é gerada dinamicamente.
Para verificar se sua página é gerada dinamicamente, veja o código-fonte da página da web (clique com o botão direito e escolha “Exibir código-fonte da página”). Pesquise pelo texto “pbs-main-wrapper”; se você não encontrar esse texto em lugar nenhum, sua página é gerada dinamicamente.
Aqui estão alguns exemplos de conteúdo gerado dinamicamente:
- Sua página é composta por vários widgets que você adiciona/edita usando o Personalizador,
- Sua página é composta por páginas diferentes unidas por um tema “one page” (neste caso, você ainda pode editar as páginas individuais, mas não a combinada), ou
- Sua página é composta pelos posts mais recentes do blog.
Tente adicionar algum conteúdo primeiro
Houve casos em que o tema não exibia o conteúdo de forma alguma se ele estivesse em branco, e isso fazia o PBS pensar erroneamente que a página não era editável. Para verificar se esse é o caso, edite sua página/post no editor do backend, tente adicionar qualquer texto ao seu conteúdo (por exemplo, “olá”) e, em seguida, clique no botão “Editar com o Page Builder Sandwich” a partir de lá.
Obrigado a Mathias Hellquist por esta dica!
Certifique-se de que sua página não pertença a outro construtor de páginas
Alguns construtores de páginas fazem você escolher entre usar o editor de conteúdo padrão do WordPress ou o editor próprio do construtor de páginas. Se você já editou sua página usando outro construtor de páginas, é possível que esse construtor de páginas já tenha “reivindicado” o conteúdo, e outros hooks/filtros de conteúdo não consigam mais ser executados. Por causa disso, às vezes o Page Builder Sandwich não conseguirá detectar onde está o seu conteúdo e não mostrará o botão de edição porque não há nada para editar.
Para corrigir isso, basta optar por não usar esse construtor de páginas para essa página/post específico e optar por usar apenas o editor de conteúdo padrão do WordPress.
Certifique-se de ter permissões de edição na página
O botão de edição não aparecerá se você não puder editar a página. Por exemplo, se você é um editor ou colaborador e pode escrever posts de blog e artigos no site, isso não significa necessariamente que você pode editar a página inicial ou a página de contato. Se você consegue ver o botão “Editar post” na sua barra de administração, você também deve ser capaz de editá-la usando o PB Sandwich. Peça privilégios de edição ao administrador do seu site se precisar deles.
Pode haver um erro de Javascript impedindo o PB Sandwich de funcionar
O PB Sandwich utiliza Javascript extensivamente. Se houver erros de Javascript provenientes de outros scripts em seu site, isso pode impedir o funcionamento do PB Sandwich. Para verificar se esse é o caso, você pode abrir o console de desenvolvedor no seu navegador para verificar a existência de erros.
Eu recomendaria usar o Chrome para isso. Clique com o botão direito em qualquer elemento da página e, em seguida, clique na opção “Inspecionar”. Isso abrirá uma nova área na parte inferior do seu navegador; clique na aba “console”. Se houver erros, você deverá ver algo como isto:

Se você tiver um erro, também poderá obter uma pista de onde ele está vindo ao clicar ou passar o mouse sobre o nome do script:

Esses erros podem vir do seu tema ou de outros plugins que você possa ter. A correção desses erros pode fazer o PB Sandwich voltar a funcionar.
Se o seu tema ou um dos seus plugins estiver causando o erro de Javascript, por favor, avise-nos por e-mail em [email protected] e faremos o nosso melhor para corrigir o problema 🙂
Se você estiver usando a CloudFlare, certifique-se de que o Rocket Loader esteja desativado
A CloudFlare é uma CDN/DNS gratuita amplamente utilizada. Ela é excelente, mas o PBS atualmente apresenta problemas em relação ao recurso Rocket Loader. O Rocket Loader melhora o tempo de carregamento de arquivos Javascript, mas prejudica a ordem de dependências e de chamadas dos scripts do PBS. Se você estiver com o Rocket Loader ativado, o botão de edição do Page Builder Sandwich não aparecerá (e nenhum erro de Javascript será exibido no console).
Para verificar se o seu site está usando o Rocket Loader da CloudFlare, veja o código-fonte da sua página (clique com o botão direito e escolha “Exibir código-fonte da página”) e, em seguida, pesquise pelo texto “rocketscript”; se encontrar esse texto, significa que você está com o Rocket Loader ativado.

Leia o artigo sobre a Compatibilidade com CloudFlare e Rocket Loader para instruções completas sobre como desativá-lo.
Eu fiz tudo isso e o botão de edição ainda não está lá!
Certo, a este ponto, se nenhuma das soluções acima funcionar, talvez seja hora de explicar o porquê de não estar aparecendo e o que fazer a respeito. Pronto? Vamos lá!
O “Porquê” (em termos não técnicos)
O Page Builder Sandwich precisa saber onde o conteúdo da sua página/post está localizado. Fazemos isso monitorando quando o WordPress carrega o conteúdo do post e “marcando” essa área, para que, quando tudo for carregado, possamos encontrar onde estão os dados corretos.
Às vezes, alguns plugins substituem ou ignoram esse processo e, em vez disso, tentam carregar o conteúdo à sua própria maneira. Às vezes isso não causa problemas, mas em determinados cenários, especialmente quando se trata do carregamento do conteúdo principal do post, isso pode fazer com que alguns plugins parem de funcionar. Quando outro plugin ignora esse processo de carregamento, as “marcações” que fizemos podem ser perdidas e, quando chega o momento de o editor entrar em ação, ele não consegue mais encontrar onde está o seu conteúdo. Portanto, o botão de edição não aparece! Você também pode notar que alguns plugins que adicionam conteúdo à sua página, como certos plugins de compartilhamento em redes sociais, também podem parar de funcionar exatamente pelo mesmo motivo.
O “Porquê” (em termos técnicos)
O Page Builder Sandwich precisa saber onde o conteúdo da sua página/post está localizado, e faz isso conectando-se ao filtro the_content e adicionando um wrapper em torno do seu conteúdo principal. Alguns plugins podem substituir isso e, em vez disso, sobrescrever o conteúdo com uma função get_the_content() mais adiante no fluxo. Infelizmente, fazer isso impede que TODOS os filtros the_content sejam chamados e, portanto, o wrapper do PBS é perdido. As alterações de qualquer outro plugin também seriam perdidas.
Não há nada de errado em usar get_the_content() por si só, mas pode haver efeitos adversos se isso for usado na consulta principal e dentro da página de modelo de post único em vez da chamada normal de the_content(), onde todos os filtros the_content são executados.
O que fazer a respeito
Você pode verificar se as “marcações” do Page Builder Sandwich não estão presentes acessando sua página/post no frontend e visualizando o código-fonte da página enquanto estiver conectado. Procure no emaranhado de código se consegue encontrar a string:
data-name="main-content"
Se você conseguir encontrá-la, pode ser apenas um problema de Javascript em algum lugar; basta nos informar o tema e os plugins que você está usando para que possamos corrigir isso.
Mas se você não conseguir encontrá-la, pode ser apenas que o seu tema (ou um plugin, mas é mais provável que seja o tema se for uma página ou post de blog) esteja fazendo algo com o conteúdo do post. Se for esse o caso, você deve entrar em contato com o autor do tema e informá-lo sobre o problema! Você também pode mostrar a ele a explicação técnica do “porquê” acima, pois isso pode ajudar na depuração 🙂
Se você se sente seguro para fazer alterações no PHP, pode tentar corrigir o problema localizando o arquivo de modelo que gerencia o conteúdo do post. Uma solução que encontramos é substituir as chamadas para:
$content = get_the_content();
por:
ob_start();
the_content();
$content = ob_get_clean();<br>
Observação: A variável PHP pode variar no seu caso, mas o conceito deve ser o mesmo. Se funcionar, seria melhor também criar um tema filho em vez de implementar essa alteração diretamente no seu tema. Também pode haver efeitos colaterais por conta da alteração, portanto, é melhor consultar o autor do seu tema sobre isso.