Desenvolvedores
Referência de habilidades do Page Builder Sandwich
O Page Builder Sandwich registra suas ações com a API de Habilidades do WordPress. As mesmas habilidades são ferramentas MCP no próprio servidor do site e rotas REST sob /wp-json/wp-abilities/v1. Esta página é gerada a partir do próprio registro do plugin.
Endpoints
| Habilidade | REST |
|---|---|
| MCP via HTTP (streamable) | /wp-json/pbs/v1/mcp |
| MCP via WP-CLI (entrada e saída padrão) | wp mcp-adapter serve --server=page-builder-sandwich --user=<login> |
| REST: listar as habilidades | /wp-json/wp-abilities/v1/abilities?category=page-builder-sandwich |
| REST: executar uma habilidade | /wp-json/wp-abilities/v1/abilities/<name>/run (GET com ?input= para habilidades somente leitura, POST {"input": {...}} caso contrário) |
Autenticação e permissões
As requisições HTTP autenticam com uma senha de aplicativo do WordPress (HTTP Basic). Conectar-se ao servidor MCP requer a capacidade mostrada abaixo; cada habilidade verifica então sua própria permissão, por objeto. Habilidades somente leitura são executadas com GET e sua entrada na query string; as demais com POST e um corpo JSON ‘{“input”: {…}}’.
uma senha de aplicativo do WordPress (HTTP) ou --user (WP-CLI); o usuário precisa da capacidade que cada habilidade especifica · Configurações: Permitir agentes de IA (MCP), ativado por padrão
Todas as habilidades
| Habilidade | Edição | REST | Permissão | Parâmetros |
|---|---|---|---|---|
pbs/activate-custom-fontDisponibiliza uma fonte personalizada enviada (um arquivo de fonte na biblioteca de mídia, por id) nos seletores de fontes. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/activate-custom-font/run | edit_theme_options (verificação própria da rota REST) | id inteiro (obrigatório) |
pbs/add-local-fontBaixa uma família de fontes do Google Fonts (família, pesos, itálico) e a disponibiliza a partir deste site. | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/add-local-font/run | manage_options (verificação própria da rota REST) | family texto (obrigatório)weights arrayitalic booleano |
pbs/add-sectionAdiciona uma seção pronta a uma página: no início, no final ou após a seção em uma determinada posição. | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/add-section/run | edit_post nessa página | id inteiro (obrigatório)section texto (obrigatório)position texto: start, end, afterafter inteiro |
pbs/add-shop-blockAdiciona um bloco do WooCommerce ao final de um post: um elemento do produto (part: title, gallery, image, price, rating, excerpt, description, add_to_cart, meta, tabs, related, upsells, sale_badge, stock; productId, ou 0 para o produto visualizado no momento) ou um minicarrinho (label). | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/add-shop-block/run | edit_post (verificação própria da rota REST) | post inteiro (obrigatório)block texto (obrigatório): product-element, mini-cartpart texto: title, gallery, image, price, rating, excerpt, add_to_cart, meta, tabs, related, upsells, sale_badge, stock, descriptionproductId inteirolabel texto |
pbs/ai-check-accessibilityLista os problemas de acessibilidade de uma página: imagens sem texto alternativo, cabeçalhos que pulam níveis, links cujo texto não tem significado isolado e links sem texto. Cada um indica se pode ser corrigido automaticamente. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/ai-check-accessibility/run | edit_post na página | post_id inteiro (obrigatório) |
pbs/ai-create-blockCria um componente reutilizável a partir de uma descrição (um cartão de preços, um cartão de equipe, um banner) e o salva como um padrão sincronizado em “Meus padrões” no editor, com cada texto editável por inserção. Retorna seu id e o bloco que o insere. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/ai-create-block/run | edit_posts e publish_posts; regras de função e gastos das configurações de IA | description texto (obrigatório)title texto |
pbs/ai-css-helpExplica, escreve ou corrige o CSS personalizado de um elemento, onde `selector` representa o elemento. Retorna o CSS e uma explicação; nada é salvo. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/ai-css-help/run | edit_posts e a permissão de código do construtor | action texto (obrigatório): explain, write, fixcss textoinstruction textoblock texto |
pbs/ai-design-fromRecria o layout de uma captura de tela (uma imagem na biblioteca de mídia) ou de uma página web pública (seu endereço) como blocos editáveis em uma nova página de rascunho: as mesmas seções, colunas, cabeçalhos, textos, listas e botões. Logotipos e imagens não são copiados. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/ai-design-from/run | edit_pages (edit_post na captura de tela); regras de função e gastos das configurações de IA | attachment_id inteirourl textotitle textoinstruction texto |
pbs/ai-edit-pageModifica uma página conforme solicitado em linguagem natural (“encurte o texto do banner”, “adicione um FAQ sobre entregas após os preços”, “traduza a página para o alemão”). A IA responde com operações de edição que são verificadas em relação aos blocos da página e suas configurações antes de aplicar qualquer alteração; as operações recusadas são listadas com o motivo. Uma revisão é salva primeiro e seu id é retornado como undo_revision. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/ai-edit-page/run | edit_post na página; regras de função e gastos das configurações de IA | post_id inteiro (obrigatório)instruction texto (obrigatório) |
pbs/ai-fix-accessibilityCorrige os problemas de acessibilidade que podem ser resolvidos (todos ou os ids dos problemas listados): texto alternativo gerado pela análise de cada imagem, níveis de cabeçalho corrigidos, textos de links vagos reescritos. Uma revisão é salva primeiro e seu id é retornado como undo_revision. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/ai-fix-accessibility/run | edit_post na página; regras de função e gastos das configurações de IA | post_id inteiro (obrigatório)issues array |
pbs/ai-generate-imageCria uma imagem a partir de uma descrição com o modelo de imagem do site (OpenAI ou Google) e salva na biblioteca de mídia com texto alternativo. Retorna o ID e o endereço. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/ai-generate-image/run | upload_files; função e regras de gastos das configurações de IA | prompt string (obrigatório)size string: square, landscape, portraitalt stringtitle stringpost_id integer |
pbs/ai-generate-sectionTransforma uma descrição de uma frase em uma seção pronta (blocos reais e editáveis no estilo da marca do site) com texto escrito para ela. Retorna a marcação do bloco e a adiciona ao início ou ao final de uma página quando um post_id é informado (uma revisão mantém o que existia antes). | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/ai-generate-section/run | edit_posts; edit_post para adicionar a uma página; função e regras de gastos das configurações de IA | description string (obrigatório)section stringpost_id integerposition string: start, end |
pbs/ai-plan-siteA partir da descrição do negócio, lista as páginas necessárias para o site (página inicial primeiro, contato por último), cada uma com título e um resumo para a página. Nada é criado; cada página pode ser criada depois a partir do resumo. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/ai-plan-site/run | edit_pages; função e regras de gastos das configurações de IA | brief string (obrigatório) |
pbs/ai-save-seo-metaSalva o título e a descrição meta no plugin de SEO que o site usa (Yoast SEO, Rank Math, SEOPress ou All in One SEO) e informa quais foram gravados. | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/ai-save-seo-meta/run | edit_post na página | post_id integer (obrigatório)title string (obrigatório)description string (obrigatório) |
pbs/ai-suggest-seo-metaLê uma página e sugere um título meta (até 60 caracteres) e uma descrição meta (até 155), opcionalmente com base em uma palavra-chave de foco. Nada é salvo. | Free | GET /wp-json/wp-abilities/v1/abilities/pbs/ai-suggest-seo-meta/run | edit_post na página; função e regras de gastos das configurações de IA | post_id integer (obrigatório)keyword string |
pbs/ai-undoRestaura uma página para o estado anterior a uma alteração por IA, a partir do undo_revision retornado pela alteração. | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/ai-undo/run | edit_post na página | post_id integer (obrigatório)revision integer (obrigatório) |
pbs/ai-write-alt-textExamina imagens e salva o texto alternativo para elas: uma imagem (attachment_id) ou todas as imagens sem texto alternativo em uma página (post_id). No máximo 20 imagens por chamada; a resposta informa quantas restam. | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/ai-write-alt-text/run | upload_files e edit_post na imagem ou página; função e regras de gastos das configurações de IA | attachment_id integerpost_id integeronly_missing booleanlanguage string |
pbs/ai-write-textEscreve novos textos ou aprimora, encurta, expande, altera o tom ou corrige a gramática de um trecho de texto, usando o próprio provedor de IA do site. Retorna o novo texto; nada no site é alterado. | Free | GET /wp-json/wp-abilities/v1/abilities/pbs/ai-write-text/run | edit_posts (edit_post quando post_id for informado); função e regras de gastos das configurações de IA | action string (obrigatório): write, improve, shorten, expand, tone, fix, customtext stringtone string: professional, friendly, confident, playful, formal, simpleinstruction stringcontext string |
pbs/apply-brand-kitAplica as cores e fontes do kit de marca salvo ao design do site. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/apply-brand-kit/run | edit_theme_options (verificação própria da rota REST) | nenhum |
pbs/apply-kitImporta as páginas de um kit de site (todas ou apenas as indicadas), podendo opcionalmente publicá-las, definir a página inicial e adicioná-las a um menu. Importar novamente atualiza as mesmas páginas. | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/apply-kit/run | edit_pages e publish_pages; manage_options para definir a página inicial; edit_theme_options para criar um menu | slug string (obrigatório)pages arraypublish booleanfront booleanmenu boolean |
pbs/apply-replaceAplica uma tarefa pré-visualizada. Cada post alterado mantém um backup para que a tarefa possa ser desfeita. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/apply-replace/run | manage_options (verificação própria da rota REST) | id string (obrigatório) |
pbs/build-landing-pageUm fluxo de trabalho guiado: o agente escolhe seções adequadas ao seu negócio, cria a página como rascunho e escreve o texto. | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/build-landing-page/run | edit_pages | business string (obrigatório) |
pbs/build-pagesCria até 50 páginas em uma única chamada, cada uma a partir de seções e/ou conteúdo de blocos. Cada página é verificada e criada individualmente; a resposta lista todas as páginas criadas e recusadas, com o motivo. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/build-pages/run | edit_pages; cada página é verificada individualmente (publish_pages para publicar) | pages (obrigatório) |
pbs/check-performanceInforma o quanto o conteúdo de uma página contribui para o seu peso: suas imagens (bytes, as superdimensionadas e o tamanho menor que serviria), as folhas de estilo dos blocos utilizados e suas incorporações de terceiros, com a solução para cada problema. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/check-performance/run | edit_post na página | post_id (obrigatório) |
pbs/connect-adobe-fontsConecta um projeto web do Adobe Fonts (Typekit) pelo ID do kit, para que as fontes apareçam nos seletores de fontes. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/connect-adobe-fonts/run | edit_theme_options (verificação própria da rota REST) | kit (obrigatório) |
pbs/connect-marketing-serviceConecta um serviço de lista de e-mails usando sua chave de API (service, key; account quando o serviço exigir), ou desconecta-o com uma chave vazia. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/connect-marketing-service/run | manage_options (verificação própria da rota REST) | service (obrigatório)keyaccount |
pbs/connect-supportConecta este site ao suporte da Zinn Digital® (name, email, consent). | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/connect-support/run | manage_options (verificação própria da rota REST) | email (obrigatório)nameconsent (obrigatório) |
pbs/convert-builder-exportConverte um arquivo de exportação (builder: elementor, divi, beaver ou wpbakery; content: o texto exportado) em um novo rascunho de página feito com blocos, copiando opcionalmente as imagens para a biblioteca de mídia (media). Responde com o rascunho e um relatório da conversão. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/convert-builder-export/run | edit_pages (verificação própria da rota REST) | builder (obrigatório): elementor, divi, beaver, wpbakerycontent (obrigatório)titlemediadryRunstatus: draft, pending, private, publish |
pbs/convert-builder-pageConverte uma página criada com Elementor, Divi, Beaver Builder ou WPBakery (id) em um novo rascunho composto por blocos, mantendo seu layout, tipografia, cores e imagens; a página original não é alterada. Responde com o rascunho e um relatório do que foi convertido, aproximado ou não convertido. dryRun converte sem salvar. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/convert-builder-page/run | edit_pages e edit_post (verificação própria da rota REST) | id (obrigatório)dryRunstatus: draft, pending, private, publish |
pbs/convert-postConverte uma página da versão 5.x para blocos (com backup prévio). | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/convert-post/run | verificação de permissão própria por item da rota REST | id (obrigatório) |
pbs/create-ab-testAdiciona um teste entre duas versões de uma seção ao final de um post (post, name, a, b; split e goal são opcionais). | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/create-ab-test/run | edit_post (verificação própria da rota REST) | post (obrigatório)namea (obrigatório)b (obrigatório)splitgoal |
pbs/create-classCria uma classe de estilo global reutilizável: rótulo, slug e seus estilos (s). | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/create-class/run | edit_theme_options (verificação própria da rota REST) | label (obrigatório)slugscat |
pbs/create-cookie-bannerCria um modelo pronto de banner de consentimento para começar. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/create-cookie-banner/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/create-formCria um formulário (contato, orçamento, cadastro ou em várias etapas: campos, etapas, configurações e ações como e-mail, salvar, webhook ou lista de e-mails), em uma nova página ou ao final de um post existente (post). | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/create-form/run | edit_pages (verificação própria da rota REST) | titlefields (obrigatório)stepsactionssubmitTextsuccessMessageredirectUrltrackEventpostpageTitlestatus: draft, publish, private |
pbs/create-pageCria uma página a partir de seções da biblioteca e/ou conteúdo de blocos. Uma nova página é criada como rascunho, a menos que outro status seja solicitado. | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/create-page/run | edit_pages; publish_pages para publicar ou tornar privado | title string (obrigatório)status string: draft, pending, publish, privatesections arraycontent string |
pbs/create-popupCria um pop-up, slide-in ou barra: seu conteúdo, gatilho (intenção de saída, rolagem, tempo, clique), frequência e as páginas em que aparece. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/create-popup/run | edit_pages (verificação própria da rota REST) | title string (obrigatório)content string (obrigatório)status string: draft, publishsettings object |
pbs/create-query-loopAdiciona um laço de consulta com um cartão pronto, em uma nova página (pageTitle, status) ou no final de um post (post): source posts|users|terms|field, postType (product para uma grade de loja), perPage, columns, orderBy, order, pagination e filtros dinâmicos [{type: search|taxonomy|meta|sort|price|onsale|instock, taxonomy, key, label, ui}]. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/create-query-loop/run | edit_post e edit_posts (verificação própria da rota REST) | post integerpageTitle stringstatus string: draft, publish, privatesource string: posts, users, terms, fieldpostType stringperPage integercolumns integerorderBy stringorder string: ASC, DESCpagination string: none, numbers, prevnexttaxonomy stringfieldKey stringfilters array |
pbs/create-teamCria uma biblioteca de equipe (name) na qual outros sites podem entrar usando um código de convite. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/create-team/run | manage_options (verificação própria da rota REST) | name string (obrigatório) |
pbs/create-theme-templateCria um modelo (title, type) que substitui essa parte de cada página correspondente, em temas clássicos e de blocos. Sem conteúdo, começa a partir de um design pronto para seu tipo. include/exclude são regras de condição de exibição ({kind, values, key, value, from, to, days}, os tipos que o construtor de temas deste site oferece); priority desempata; status publish (no ar) ou draft. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/create-theme-template/run | verificação própria de permissão por item da rota REST | title string (obrigatório)type string (obrigatório)content stringinclude arrayexclude arraypriority integerstatus string: publish, draft |
pbs/deactivate-custom-fontRemove uma fonte personalizada (por slug) dos seletores de fonte. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/deactivate-custom-font/run | edit_theme_options (verificação própria da rota REST) | slug string (obrigatório) |
pbs/delete-classExclui uma classe global. Os elementos que a usavam mantêm seu conteúdo e perdem seus estilos. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/delete-class/run | edit_theme_options (verificação própria da rota REST) | id string (obrigatório) |
pbs/delete-iconRemove um ícone enviado; os blocos que o usavam mantêm sua própria cópia. | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/delete-icon/run | delete_post (verificação própria da rota REST) | id string (obrigatório) |
pbs/delete-library-itemExclui um design da biblioteca na nuvem. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/delete-library-item/run | edit_posts (verificação própria da rota REST) | item string (obrigatório)team string |
pbs/delete-pageMove uma página para a lixeira. É possível restaurá-la de Páginas, Lixeira por 30 dias. | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/delete-page/run | delete_post nessa página | id integer (obrigatório) |
pbs/delete-teamExclui uma equipe e todos os designs de sua biblioteca. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/delete-team/run | manage_options (verificação própria da rota REST) | team string (obrigatório) |
pbs/delete-theme-templateMove um modelo (id) para a lixeira; o design padrão do tema volta a ser exibido onde ele se aplicava. Restaurável a partir da lixeira. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/delete-theme-template/run | verificação própria de permissão por item da rota REST | id string (obrigatório) |
pbs/disconnect-supportDesconecta este site do suporte. | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/disconnect-support/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/duplicate-classDuplica uma classe global com um novo id. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/duplicate-class/run | edit_theme_options (verificação própria da rota REST) | id string (obrigatório) |
pbs/duplicate-pageCopia uma página (título, conteúdo e modelo) para um novo rascunho. | Gratuito | POST /wp-json/wp-abilities/v1/abilities/pbs/duplicate-page/run | edit_post na página e edit_pages | id número inteiro (obrigatório)title texto |
pbs/export-designRetorna o arquivo de design do site: categorias, classes globais, variáveis, espaçamentos, escalas de arredondamento e sombras, e cores personalizadas (formato page-builder-sandwich-design, versão 1). | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/export-design/run | edit_theme_options (verificação própria da rota REST) | nenhum |
pbs/export-designsExporta os modelos e padrões escolhidos (ids) e, opcionalmente, as configurações como um único pacote para outro site. | Gratuito | POST /wp-json/wp-abilities/v1/abilities/pbs/export-designs/run | manage_options (verificação própria da rota REST) | ids arraysettings booleano |
pbs/find-builder-pagesLista as páginas e posts criados com Elementor, Divi, Beaver Builder ou WPBakery (page, per_page), cada um com seu construtor e, caso já tenha sido convertido antes, o rascunho convertido. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/find-builder-pages/run | edit_pages (verificação própria da rota REST) | page número inteiroper_page número inteiro |
pbs/generate-pageCria uma página a partir de seções (fornecidas ou escolhidas por IA da biblioteca de seções) e usa IA para reescrever todo o texto com base no seu briefing, mantendo o design. Usa o provedor de IA configurado nas opções de IA do plugin. A página fica como rascunho, a menos que outro status seja solicitado. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/generate-page/run | edit_pages; publish_pages para publicar; regras de papel e gastos das configurações de IA | brief texto (obrigatório)title textosections arraystatus texto: draft, pending, publish, private |
pbs/get-blockRetorna as configurações de um bloco (atributos com seus tipos, opções e padrões), suporte oferecido, blocos que pode conter e um exemplo pronto para uso na marcação de bloco. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/pbs/get-block/run | edit_posts | name texto (obrigatório) |
pbs/get-breakpointsRetorna as larguras para tablet e celular (e pontos de quebra personalizados no Pro) que os controles responsivos usam. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/pbs/get-breakpoints/run | edit_theme_options (verificação própria da rota REST) | nenhum |
pbs/get-conversion-trackingRetorna as configurações do Google Analytics 4, Google Tag Manager e Meta Pixel, além de quais cliques e envios de formulário são enviados. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/get-conversion-tracking/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/get-cookie-bannerRetorna o banner de consentimento: se está ativo, seu texto e design, as categorias e onde se aplica. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/get-cookie-banner/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/get-design-globalsRetorna as cores e fontes globais (títulos e corpo) que todos os blocos usam, conforme exibido na tela de design do site. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/pbs/get-design-globals/run | edit_theme_options (verificação própria da rota REST) | nenhum |
pbs/get-design-systemRetorna o sistema de design Pro: classes globais, variáveis, design tokens, modo escuro, kit de marca e fontes personalizadas. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/get-design-system/run | edit_theme_options (verificação própria da rota REST) | nenhum |
pbs/get-diagnosticsRetorna as informações de diagnóstico que acompanham um chamado de suporte: versões, plugins ativos, limites e erros recentes. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/pbs/get-diagnostics/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/get-figma-connectionRetorna se o site tem um token de acesso pessoal do Figma, a conta do Figma à qual ele pertence e seus últimos quatro caracteres. O token em si nunca é retornado. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/get-figma-connection/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/get-library-accountRetorna o uso de armazenamento da biblioteca na nuvem, a cota do plano e dados da equipe. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/get-library-account/run | edit_posts (verificação própria da rota REST) | nenhum |
pbs/get-library-itemRetorna um design salvo, pronto para inserir neste site (com imagens importadas para a biblioteca de mídia). | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/get-library-item/run | edit_posts (verificação própria da rota REST) | item texto (obrigatório)team texto |
pbs/get-library-storageRetorna as configurações de armazenamento próprio R2/S3 (a chave secreta nunca é retornada). | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/get-library-storage/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/get-licenceRetorna o plano do Page Builder Sandwich deste site, o status da licença, a data de renovação e o que o plano inclui. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/pbs/get-licence/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/get-maintenanceRetorna o modo de manutenção / em breve: modo, página, retry-after e quais funções ainda veem o site. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/get-maintenance/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/get-migrationRetorna o progresso e o relatório da conversão de conteúdo da versão 5.x. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/pbs/get-migration/run | verificação própria de permissão por item da rota REST | nenhum |
pbs/get-motion-optionsRetorna todas as configurações de movimento (animação de entrada, duração e atraso, efeito de rolagem, efeito ao passar o mouse, manter na visualização, paralaxe, seguir o ponteiro) com suas opções ou intervalos, e os pontos de quebra do site. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/get-motion-options/run | edit_posts (verificação própria da rota REST) | nenhum |
pbs/get-newsletter-keysInforma se uma chave do Mailchimp está salva (a chave em si nunca é retornada). | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/get-newsletter-keys/run | edit_posts (verificação própria da rota REST) | nenhum |
pbs/get-pageRetorna o título, status, links e conteúdo em blocos de uma página, além das seções (blocos de nível superior) que a compõem. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/pbs/get-page/run | edit_post nessa página | id número inteiro (obrigatório) |
pbs/get-replace-jobRetorna as correspondências de uma tarefa, página por página, para revisão antes de aplicar. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/get-replace-job/run | manage_options (verificação própria da rota REST) | id texto (obrigatório) |
pbs/get-reviews-sourcesRetorna as fontes do Google e da Trustpilot exibidas pelo bloco Avaliações. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/get-reviews-sources/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/get-rolesRetorna quais funções podem usar o construtor, design, código e modelos (modo cliente). | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/get-roles/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/get-settingsRetorna o prefixo de classe do front-end, o status de atualizações beta e se agentes de IA (MCP) são permitidos. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/pbs/get-settings/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/get-structured-dataLista os dados estruturados do schema.org exibidos pelos blocos de uma página (Perguntas frequentes, Passo a passo, Produto, Avaliação, Navegação estrutural) e quais tipos são deixados para o plugin de SEO do site para que nada seja exibido duas vezes. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/get-structured-data/run | edit_post na página | post_id número inteiro (obrigatório) |
pbs/get-support-connectionInforma se este site está conectado ao suporte da Zinn Digital® e sob qual usuário. | Gratuito | GET /wp-json/wp-abilities/v1/abilities/pbs/get-support-connection/run | manage_options (verificação própria da rota REST) | refresh booleano |
pbs/get-theme-builder-optionsRetorna os tipos de modelo, os tipos de condição de exibição (página, tipo de post, termo, arquivo, pesquisa, 404, conectado, função, dispositivo, data, hora, parâmetro de URL, referenciador, idioma, carrinho) com suas opções neste site (funções, idiomas, tipos de post, taxonomias) e o atributo de bloco (pbswConditions: {match, rules}) que exibe ou oculta qualquer bloco. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/get-theme-builder-options/run | edit_posts (verificação própria da rota REST) | nenhum |
pbs/get-white-labelRetorna as configurações de white label: ativado ou desativado, o nome exibido e quais usuários ainda veem o original. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/get-white-label/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/import-designValida um arquivo de design do site (file) e, com apply false, retorna o que merge ou replace (mode) adicionaria, alteraria e removeria; com apply true, grava as alterações. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/import-design/run | edit_theme_options (verificação própria da rota REST) | file objeto (obrigatório)mode texto: merge, replaceapply booleano |
pbs/import-designsImporta um pacote de design do Page Builder Sandwich (dryRun primeiro para ver o que mudaria; mode: skip ou replace; media; settings). | Gratuito | POST /wp-json/wp-abilities/v1/abilities/pbs/import-designs/run | manage_options (verificação própria da rota REST) | package objeto (obrigatório)mode texto: skip, replace, duplicatesettings booleanomedia booleanodryRun booleano |
pbs/import-figma-frameImporta um frame do Figma (url: o link do frame, com seu node-id) em uma nova página de rascunho feita de blocos: o layout automático se torna contêineres flex e grid, o texto mantém suas fontes e tamanhos, as imagens são copiadas para a biblioteca de mídia. Usa o próprio token do Figma do site. Responde com o rascunho e um relatório de conversão. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/import-figma-frame/run | edit_pages e upload_files (verificação própria da rota REST) | url string (obrigatório)title stringdryRun booleanstatus string: draft, pending, private, publish |
pbs/invite-team-memberCria um código de convite de uso único (função: read ou write; rótulo; dias de validade). O código é exibido uma única vez. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/invite-team-member/run | manage_options (verificação própria da rota REST) | team string (obrigatório)role string: read, writedays integerlabel string |
pbs/join-teamEntra em uma biblioteca de equipe com um código de convite. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/join-team/run | manage_options (verificação própria da rota REST) | code string (obrigatório) |
pbs/leave-teamSai da biblioteca de equipe da qual este site faz parte. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/leave-team/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/list-ab-testsLista os testes A/B com os visitantes e conversões de cada versão, e qual delas está ganhando. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/list-ab-tests/run | edit_pages (verificação própria da rota REST) | nenhum |
pbs/list-blocksLista todos os blocos do Page Builder Sandwich que este site pode usar (blocos Pro também, quando o Pro estiver ativo): nome, título, categoria e descrição. | Free | GET /wp-json/wp-abilities/v1/abilities/pbs/list-blocks/run | edit_posts | search string |
pbs/list-dynamic-sourcesRetorna com o que um bloco pode ser preenchido (post, author, site, archive, custom field, product) com os campos de cada fonte, os plugins de campos neste site (ACF, Meta Box, Pods, JetEngine, Toolset, post meta) e os campos de um tipo de post (postType). Um bloco é vinculado a uma fonte por meio de attributes.metadata.bindings, um {source, args} por atributo. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/list-dynamic-sources/run | edit_posts (verificação própria da rota REST) | postType string |
pbs/list-extensionsLista o que outros plugins adicionaram ao Page Builder Sandwich por meio de sua API de desenvolvedor: blocos, fontes de dados dinâmicos, condições de exibição e ações de formulário, cada um com seu nome, rótulo e plugin. | Free | GET /wp-json/wp-abilities/v1/abilities/pbs/list-extensions/run | edit_posts | nenhum |
pbs/list-form-submissionsLista o que os visitantes enviaram através dos formulários que salvam envios (form restringe o resultado), uma página por vez. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/list-form-submissions/run | verificação de permissão própria por item da rota REST | form stringper_page integerpage integer |
pbs/list-formsLista os formulários criados com o bloco Formulário e os plugins de formulário que ele pode incorporar. | Free | GET /wp-json/wp-abilities/v1/abilities/pbs/list-forms/run | edit_posts (verificação própria da rota REST) | nenhum |
pbs/list-kitsLista os kits de site (um conjunto de páginas prontas para um tipo de negócio) que este site pode importar. | Free | GET /wp-json/wp-abilities/v1/abilities/pbs/list-kits/run | edit_pages e publish_pages | refresh boolean |
pbs/list-library-itemsLista os designs salvos na biblioteca na nuvem (kind: section, page ou pattern; team: biblioteca de uma equipe). | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/list-library-items/run | edit_posts (verificação própria da rota REST) | team stringkind string: , section, page, style |
pbs/list-local-fontsLista as fontes do Google que este site hospeda localmente (baixadas uma vez, servidas pelo próprio site, sem requisições ao Google). | Free | GET /wp-json/wp-abilities/v1/abilities/pbs/list-local-fonts/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/list-lottieLista as animações Lottie enviadas. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/list-lottie/run | edit_posts (verificação própria da rota REST) | nenhum |
pbs/list-marketing-connectionsLista os serviços de lista de e-mails (Mailchimp, Brevo, MailerLite, Kit, ActiveCampaign) e quais estão conectados. As chaves nunca são retornadas. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/list-marketing-connections/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/list-marketing-formsLista todos os formulários criados com o construtor de formulários: a página em que está, seus campos e o que acontece quando ele é enviado. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/list-marketing-forms/run | edit_pages (verificação própria da rota REST) | nenhum |
pbs/list-marketing-listsLista os públicos ou listas de um serviço de lista de e-mails conectado, para a ação de inscrição de um formulário. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/list-marketing-lists/run | edit_posts (verificação própria da rota REST) | service string (obrigatório) |
pbs/list-pagesLista as páginas que você pode editar, as mais recentes primeiro, com uma busca opcional. | Free | GET /wp-json/wp-abilities/v1/abilities/pbs/list-pages/run | edit_pages; apenas as páginas que você pode editar são listadas | search stringstatus string: any, draft, pending, publish, privatepage integerper_page integer |
pbs/list-popupsLista os popups, slide-ins e barras com seus gatilhos, regras de frequência e onde aparecem. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/list-popups/run | edit_pages (verificação própria da rota REST) | nenhum |
pbs/list-replace-jobsLista as tarefas de busca e substituição em todo o site e seus estados. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/list-replace-jobs/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/list-sectionsLista as seções prontas (hero, recursos, FAQ, depoimentos, chamada para ação e muito mais) que podem ser adicionadas a uma página. | Free | GET /wp-json/wp-abilities/v1/abilities/pbs/list-sections/run | edit_pages | search string |
pbs/list-team-membersLista os sites em uma equipe e seus acessos. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/list-team-members/run | manage_options (verificação própria da rota REST) | team string (obrigatório) |
pbs/list-teamsLista as equipes às quais este site pertence ou das quais é proprietário. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/list-teams/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/list-theme-templatesLista os modelos do construtor de temas (cabeçalho, rodapé, post único, arquivo, pesquisa, 404 e, com o WooCommerce, produto, loja, carrinho, finalização de compra, página de agradecimento e Minha conta): tipo de cada um, onde é exibido (regras de inclusão/exclusão), prioridade, status e blocos. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/list-theme-templates/run | verificação própria de permissão por item da rota REST | nenhum |
pbs/list-transferableLista os modelos, padrões e configurações que podem ser exportados para outro site. | Free | GET /wp-json/wp-abilities/v1/abilities/pbs/list-transferable/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/list-uploaded-iconsLista os ícones SVG enviados para a biblioteca de ícones, os mais recentes primeiro. | Free | GET /wp-json/wp-abilities/v1/abilities/pbs/list-uploaded-icons/run | edit_posts (verificação própria da rota REST) | page integerper_page integer |
pbs/move-sectionMove uma seção de uma página de uma posição para outra (baseado em 0, na ordem em que a página as lista). | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/move-section/run | edit_post nessa página | id integer (obrigatório)from integer (obrigatório)to integer (obrigatório) |
pbs/open-support-ticketAbre um chamado de suporte (assunto, mensagem, tipo, e-mail), com os diagnósticos deste site quando houver concordância da administração. Nunca cria ou envia credenciais de login. | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/open-support-ticket/run | manage_options (verificação própria da rota REST) | subject string (obrigatório)message string (obrigatório)kind string: help, bug, feedback, feature_requestemail stringname stringdiagnostics boolean |
pbs/preview-dynamic-valueRetorna o que uma associação exibe em um post (post, fonte e campo ou provedor + chave, como text|url), para verificar uma associação antes ou depois de adicioná-la. | Pro | GET /wp-json/wp-abilities/v1/abilities/pbs/preview-dynamic-value/run | edit_post (verificação própria da rota REST) | post integer (obrigatório)source string (obrigatório)field stringprovider stringkey stringas string: text, url |
pbs/record-support-consentRegistra o consentimento da administração para enviar diagnósticos com chamados de suporte. | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/record-support-consent/run | manage_options (verificação própria da rota REST) | consent boolean (obrigatório) |
pbs/refresh-reviewsObtém as avaliações mais recentes do Trustpilot agora, em vez de esperar pela atualização diária. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/refresh-reviews/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/remove-blockRemove um bloco (uma seção inteira ou um bloco dentro de uma) de uma página, localizado pelo seu caminho. A versão anterior da página permanece nas revisões dela. | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/remove-block/run | edit_post nessa página | id integer (obrigatório)path array (obrigatório) |
pbs/remove-library-storageRemove as configurações de armazenamento próprio; o armazenamento do plano volta a ser usado. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/remove-library-storage/run | manage_options (verificação própria da rota REST) | nenhum |
pbs/remove-local-fontExclui os arquivos de uma família de fontes hospedada localmente. | Free | POST /wp-json/wp-abilities/v1/abilities/pbs/remove-local-font/run | manage_options (verificação própria da rota REST) | family (obrigatório) |
pbs/remove-team-memberRemove um site de uma equipe. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/remove-team-member/run | manage_options (verificação própria da rota REST) | team (obrigatório)member (obrigatório) |
pbs/reset-ab-testZera as contagens de um teste e o reinicia (test). | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/reset-ab-test/run | edit_pages (verificação própria da rota REST) | test (obrigatório) |
pbs/save-library-itemSalva a estrutura do bloco (title, kind, markup, styles, tags) na sua biblioteca na nuvem ou da equipe; imagens são empacotadas junto. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/save-library-item/run | edit_posts (verificação própria da rota REST) | teamkind (obrigatório): section, page, styletitle (obrigatório)tagsmarkupstyles |
pbs/set-block-motionDefine ou remove (null) as configurações de movimento em um bloco de uma página, localizado pelo caminho, em um ponto de interrupção (base por padrão). Funciona em qualquer bloco, incluindo blocos nativos cujo HTML está salvo na página. Visitantes que solicitam redução de movimento nunca veem a animação. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/set-block-motion/run | edit_post (verificação própria da rota REST) | post (obrigatório)path (obrigatório)breakpointmotion (obrigatório) |
pbs/set-library-storageSalva o armazenamento próprio: provider (r2 ou s3), bucket, region, endpoint, prefix, key_id, secret, enabled. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/set-library-storage/run | manage_options (verificação própria da rota REST) | enabledprovider: r2, s3, otherendpointregionbucketprefixkeyIdsecretpathStyle |
pbs/set-maintenanceAtiva ou desativa o modo de manutenção (503) ou em breve (mode), com a página a exibir (page_id), retry_after e as funções que o ignoram. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/set-maintenance/run | manage_options (verificação própria da rota REST) | mode: off, maintenance, coming_soonpage_idrolesretry_after |
pbs/set-newsletter-keysSalva (ou, com valor vazio, remove) a chave de API do Mailchimp que o bloco de newsletter usa. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/set-newsletter-keys/run | manage_options (verificação própria da rota REST) | mailchimp (obrigatório) |
pbs/set-reviews-sourcesDefine o local do Google e a empresa no Trustpilot que o bloco Avaliações lê. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/set-reviews-sources/run | manage_options (verificação própria da rota REST) | googletrustpilot |
pbs/set-rolesDefine por função o que o construtor permite (roles), por exemplo, uma função de cliente apenas para conteúdo. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/set-roles/run | manage_options (verificação própria da rota REST) | roles (obrigatório) |
pbs/set-white-labelAtiva ou desativa o white label e define o nome que os clientes veem (enabled, name, agency_users). | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/set-white-label/run | manage_options (verificação própria da rota REST) | enablednamestudio_nameauthorauthor_urldescriptionmenu_iconhide_pluginagency_users |
pbs/site-health-cleanLimpa um tipo de item encontrado: revisões (mantém as 5 mais recentes de cada post, exclui as mais antigas), padrões (move padrões sincronizados não utilizados para a lixeira), imagens (uma cópia dimensionada que o WordPress usa; a original é mantida), classes (remove classes de design não utilizadas, mantidas para restauração). Cada execução limpa um lote; “more” é verdadeiro enquanto restarem itens. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/site-health-clean/run | manage_options | what (obrigatório): revisions, patterns, images, classes |
pbs/site-health-reportEncontra revisões antigas, padrões sincronizados não usados por nada, imagens originais pesadas e classes de design que nenhuma página usa. Funciona em etapas curtas: cada execução continua de onde a última parou enquanto o status for “scanning”; reiniciar começa do início. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/site-health-report/run | manage_options | restart boolean |
pbs/start-migrationInicia (ou reinicia) a conversão de cada página 5.x para blocos; cada post é salvo em backup antes. | Gratuito | POST /wp-json/wp-abilities/v1/abilities/pbs/start-migration/run | a própria verificação de permissão por item da rota REST | nenhum |
pbs/start-replaceInicia uma busca e substituição segura para blocos (find, replace, kind: texto, link ou cor; match_case; types). Nada muda até que a tarefa pré-visualizada seja aplicada. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/start-replace/run | manage_options (a própria verificação da rota REST) | find string (obrigatório)replace stringkind string: text, link, colourtypes arraymatch_case boolean |
pbs/start-trialInicia o período de teste de 14 dias do Page Builder Sandwich Pro para este site (nenhum pagamento necessário). | Gratuito | POST /wp-json/wp-abilities/v1/abilities/pbs/start-trial/run | manage_options (a própria verificação da rota REST) | nenhum |
pbs/test-library-storageGrava, lê e exclui um objeto de teste em seu próprio armazenamento e relata cada etapa. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/test-library-storage/run | manage_options (a própria verificação da rota REST) | nenhum |
pbs/undo-convert-postRestaura uma página convertida a partir do seu backup. | Gratuito | POST /wp-json/wp-abilities/v1/abilities/pbs/undo-convert-post/run | a própria verificação de permissão por item da rota REST | id string (obrigatório) |
pbs/undo-migrationRestaura cada post convertido a partir do seu backup. | Gratuito | POST /wp-json/wp-abilities/v1/abilities/pbs/undo-migration/run | a própria verificação de permissão por item da rota REST | nenhum |
pbs/undo-replaceRestaura os posts alterados por uma tarefa (um post editado desde então mantém sua edição). | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/undo-replace/run | manage_options (a própria verificação da rota REST) | id string (obrigatório) |
pbs/update-blockAltera as configurações (atributos) de um bloco dentro de uma página, localizado pelo seu caminho; os atributos enviados são mesclados aos atuais. Funciona em blocos que o site renderiza a partir de suas configurações; um bloco cujo HTML está salvo na página é alterado substituindo a marcação da página. | Gratuito | POST /wp-json/wp-abilities/v1/abilities/pbs/update-block/run | edit_post nessa página | id integer (obrigatório)path array (obrigatório)attributes object (obrigatório) |
pbs/update-brand-kitSalva o kit de marca: nome, logotipo, cores, fontes de título e corpo, e o tom de voz da marca usado pela escrita por IA. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/update-brand-kit/run | edit_theme_options (a própria verificação da rota REST) | name stringlogo integercolors arrayheadingFont stringbodyFont stringvoice string |
pbs/update-breakpointsAltera as larguras de tablet e celular em pixels; com o Pro, pontos de quebra extras personalizados. | Gratuito | POST /wp-json/wp-abilities/v1/abilities/pbs/update-breakpoints/run | edit_theme_options (a própria verificação da rota REST) | tablet integermobile integercustom array |
pbs/update-classAltera o rótulo, o slug ou os estilos de uma classe global; cada elemento que a usa é atualizado. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/update-class/run | edit_theme_options (a própria verificação da rota REST) | id string (obrigatório)label stringslug strings objectcat string |
pbs/update-conversion-trackingAltera as configurações do Google Analytics 4, Google Tag Manager e Meta Pixel e quais eventos são enviados. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/update-conversion-tracking/run | manage_options (a própria verificação da rota REST) | ga4 stringgtm stringpixel stringloadTags booleanformEvent string |
pbs/update-cookie-bannerAltera o banner de consentimento. Enquanto estiver ativo, os scripts de rastreamento aguardam o consentimento do visitante. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/update-cookie-banner/run | manage_options (a própria verificação da rota REST) | enabled booleanpopup integerhandles arraycookieDays integeroptOutOutsideEu boolean |
pbs/update-dark-modeDefine o modo escuro (modo: desativado, automático ou alternar) e suas cores. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/update-dark-mode/run | edit_theme_options (a própria verificação da rota REST) | mode string (obrigatório): device, light, darkcolors object |
pbs/update-design-categoriesSubstitui uma lista de categorias (group: classes ou tokens; items: uma lista de slug e nome). Itens associados a uma categoria removida ficam sem categoria. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/update-design-categories/run | edit_theme_options (verificação própria da rota REST) | group string (obrigatório): classes, tokensitems array (obrigatório) |
pbs/update-design-globalsAltera as cores (colors) e fontes (fonts, headingFont, bodyFont) globais do site. Todas as páginas aplicam a alteração; o arquivo theme.json do tema é mantido sincronizado. | Gratuito | POST /wp-json/wp-abilities/v1/abilities/pbs/update-design-globals/run | edit_theme_options (verificação própria da rota REST) | colors objectfonts objectbodyFont stringheadingFont string |
pbs/update-formAltera um formulário (post, form): configurações e ações são combinadas com o que já existe; campos (e etapas) substituem os campos. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/update-form/run | edit_post (verificação própria da rota REST) | post string (obrigatório)form string (obrigatório)title stringfields arraysteps arrayactions objectsubmitText stringsuccessMessage stringredirectUrl stringtrackEvent string |
pbs/update-pageAltera o título, status ou conteúdo de blocos de uma página. O conteúdo enviado substitui o conteúdo da página. | Gratuito | POST /wp-json/wp-abilities/v1/abilities/pbs/update-page/run | edit_post nessa página; publish_pages para publicar ou tornar privada | id integer (obrigatório)title stringstatus string: draft, pending, publish, privatesections arraycontent string |
pbs/update-popupAltera um popup, slide-in ou barra (id): conteúdo, gatilho, frequência ou onde é exibido. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/update-popup/run | edit_post (verificação própria da rota REST) | id string (obrigatório)title stringcontent stringstatus string: draft, publishsettings object |
pbs/update-settingsAltera o prefixo de classe no front-end (de 1 a 8 letras minúsculas ou dígitos, começando com uma letra) e/ou ativa ou desativa agentes de IA (MCP) (mcp: false remove todas as habilidades e o endpoint MCP). | Gratuito | POST /wp-json/wp-abilities/v1/abilities/pbs/update-settings/run | manage_options (verificação própria da rota REST) | prefix stringmcp boolean |
pbs/update-theme-templateAltera um modelo (id): qualquer um dentre título, tipo, conteúdo (marcação de bloco), inclusão, exclusão, prioridade ou status. Apenas o que você envia é alterado. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/update-theme-template/run | verificação de permissão própria por item da rota REST | id string (obrigatório)title stringtype stringcontent stringinclude arrayexclude arraypriority integerstatus string: publish, draft |
pbs/update-tokensAltera as escalas de espaçamento, raio e sombra (space, radius, shadow), ou as redefine (reset). | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/update-tokens/run | edit_theme_options (verificação própria da rota REST) | space arrayradius arrayshadow arrayreset boolean |
pbs/update-variablesSubstitui as variáveis de design do site (variables: uma lista de name e value). | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/update-variables/run | edit_theme_options (verificação própria da rota REST) | variables array (obrigatório) |
pbs/upload-iconAdiciona um ícone SVG (name, marcação svg) à biblioteca de ícones; o SVG é sanitizado primeiro. | Gratuito | POST /wp-json/wp-abilities/v1/abilities/pbs/upload-icon/run | upload_files (verificação própria da rota REST) | name string (obrigatório)svg string (obrigatório) |
pbs/upload-lottieValida um documento JSON do Lottie (json, name) e o publica como arquivo estático para o bloco Lottie. | Pro | POST /wp-json/wp-abilities/v1/abilities/pbs/upload-lottie/run | upload_files (verificação própria da rota REST) | name string (obrigatório)json string (obrigatório) |
Gerado a partir do abilities.json do plugin, que por sua vez é gerado a partir de um site em execução; um teste falha quando os dois divergem.
Comandos WP-CLI
Execute estes comandos no servidor com o WP-CLI. Cada comando verifica as mesmas permissões que as telas do plugin; os exemplos foram extraídos do próprio texto de ajuda do plugin.
| Comando | O que faz | Edição |
|---|---|---|
wp pbs export [--types=<types>] [--no-settings] [--file=<name>] | Exporta modelos, padrões e configurações para um arquivo. | Gratuita |
wp pbs import <file> [--mode=<mode>] [--no-settings] [--media] [--dry-run] | Importa um arquivo de exportação. | Gratuita |
wp pbs importers run | Converte conteúdo legado: todos os posts ou um específico. | Gratuita |
wp pbs importers status | Mostra o status da migração. | Gratuita |
wp pbs importers undo | Desfaz conversões a partir dos backups: todos os posts ou um específico. | Gratuita |
wp pbs migrate run | Converte conteúdo legado: todos os posts ou um específico. | Gratuita |
wp pbs migrate status | Mostra o status da migração. | Gratuita |
wp pbs migrate undo | Desfaz conversões a partir dos backups: todos os posts ou um específico. | Gratuita |
wp pbs replace <find> <replace> [--kind=<kind>] [--types=<types>] [--ignore-case] [--dry-run] [--undo=<job>] | Localiza e substitui em todo o site. | Pro |
wp pbsw fonts download <family> [--weights=<weights>] [--italic] | Baixa uma família do Google Fonts para este site. | Gratuita |
wp pbsw fonts list | Lista as famílias salvas. | Gratuita |
wp pbsw fonts remove <family> | Remove uma família salva e seus arquivos. | Gratuita |
Ações e filtros
Cada hook que o plugin oferece, com a descrição do seu código-fonte. Filtros alteram um valor; ações permitem executar código em determinado momento; pontos de entrada são ações que você dispara para solicitar que o plugin faça algo.
| Gancho | Tipo | O que faz | Parâmetros | Edição |
|---|---|---|---|---|
pbs_assets_changed | Ação | É acionado quando os arquivos de front-end publicados do PBS mudam e os caches de página acessíveis foram esvaziados: use-o para limpar o que o PBS não alcança (uma CDN, um proxy, o cache da hospedagem). | nenhum | Gratuita |
pbs_enqueue_scripts | Ação | Ação legada: enfileira scripts que chamam window.pbsAddInspector(). | nenhum | Gratuita |
pbs_shortcodes | Filtro | Filtro legado: tag do shortcode => {label, desc, options[]} (Shortcode-API.md). | array $shortcodes | Gratuita |
pbsw_admin_data | Filtro | Filtra os dados com os quais o app de administração inicializa. A camada premium o usa para informar sua edição; nada confidencial deve ficar aqui, pois é impresso na página. | nenhum | Gratuita |
pbsw_admin_enqueue | Ação | É acionado após o script da tela de administração ser enfileirado, para que um módulo possa enfileirar um script que adiciona um painel pelo filtro JavaScript `pbs.admin.panels` (deve depender desse identificador; a tela renderiza no DOM ready, após todos os scripts do rodapé serem executados). | string $handle | Gratuita |
pbsw_ai_enqueue | Ação | É acionado após o pacote do editor de IA ser enfileirado, para que uma extensão (e a camada Pro) possa enfileirar seus próprios painéis de IA depois dele. | string $handle | Gratuita |
pbsw_ai_messages | Filtro | Filtra as mensagens de cada solicitação de IA que o plugin envia, com seu contexto (tarefa, finalidade, provedor, modelo, usuário); o kit de marca do Pro adiciona sua marca aqui. | array $messagesarray $context | Gratuita |
pbsw_ai_pro_features | Filtro | Filtra os recursos de IA do Pro que o editor oferece (a camada premium adiciona seus nomes: agent, site, block, design, image, css, a11y). | nenhum | Gratuita |
pbsw_ai_seo_plugins | Filtro | Filtra em quais plugins de SEO o assistente de SEO com IA grava o título e a descrição meta. | nenhum | Gratuita |
pbsw_ai_seo_write | Filtro | Filtra se outro plugin de SEO recebeu o título e a descrição meta. Um plugin adicionado em `pbsw_ai_seo_plugins` os salva aqui, à sua maneira, e retorna true. | bool $writtenstring $pluginint $post_idstring $titlestring $description | Gratuita |
pbsw_asset_sources | Filtro | Todas as origens do front-end: deste arquivo, as que a camada de desempenho registra com add_source() (CSS por bloco, módulos de visualização) e as que a camada premium adiciona para si por `pbsw_asset_sources` (seus arquivos ficam em seu próprio diretório, incluído apenas no pacote premium). Apenas caminhos relativos simples `.css`/`.js` dentro do plugin são aceitos, sob uma chave de segmentos em letras minúsculas (`legacy.css`, `block/row.css`, `module/tabs.js`). | nenhum | Gratuita |
pbsw_breakpoints_changed | Ação | É acionado quando os pontos de quebra mudam (as folhas de página compiladas são reconstruídas na próxima visualização, pois os pontos de quebra fazem parte de sua assinatura). | nenhum | Gratuita |
pbsw_cache_purged | Ação | É acionado após o PBS limpar um post dos plugins de cache ativos. | int $post_id | Gratuita |
pbsw_cache_purgers | Filtro | Filtra os limpadores extras executados quando os arquivos publicados mudam: nome => chamável. Uma hospedagem adiciona os seus próprios (uma CDN, um proxy); se um lançar exceção, é ignorado e não é informado como limpo. | nenhum | Gratuita |
pbsw_code_blocks | Filtro | Filtra os nomes de blocos tratados como código personalizado (apenas funções com a permissão `code` podem adicioná-los ou alterá-los). | nenhum | Pro |
pbsw_consent_country | Filtro | Filtra o país do visitante (ISO 3166-1 alfa-2) para a regra regional do banner de cookies. O plugin nunca consulta um país; retorne ” quando for desconhecido. | string $country | Pro |
pbsw_content_only | Filtro | Filtra se um usuário pode editar apenas texto e imagens, com o layout bloqueado. | bool $content_onlyint $user_id | Gratuita |
pbsw_design_class_css | Filtro | Filtra o CSS compilado de uma classe global antes de consultar o motor de design. Retorne uma string para usá-la em vez disso. | string|null $cssstring $selector | Pro |
pbsw_design_custom_breakpoints | Filtro | Filtra se pontos de quebra personalizados estão disponíveis (pbs-d3, Pro). | bool $allowed | Gratuita |
pbsw_design_element_css | Filtro | Filtra se o CSS personalizado por elemento é compilado (a camada premium o ativa, d8). | bool $enabled | Gratuita |
pbsw_design_layout_suffix | Filtro | Filtra o sufixo do seletor do elemento de layout para um bloco (” = o próprio elemento do bloco). | string $suffixstring $prefix | Gratuita |
pbsw_design_props | Filtro | Filtra as propriedades de design (a camada premium adiciona as suas próprias). | nenhum | Gratuita |
pbsw_dynamic_editor_sources | Filtro | Mais fontes no editor (campos de produtos do WooCommerce). | nenhum | Pro |
pbsw_dynamic_fields | Filtro | Catálogo de campos para provedores sem API de listagem que este plugin leia (JetEngine, Toolset): as chaves dos campos são digitadas no editor ou adicionadas aqui. | string $post_type | Pro |
pbsw_dynamic_sources | Filtro | Mais fontes (produtos do WooCommerce): nome → rótulo; os valores vêm de `pbsw_dynamic_value`. | nenhum | Pro |
pbsw_dynamic_value | Filtro | Um valor de outra fonte (WooCommerce). | string|null $valuestring $source | Pro |
pbsw_form_submitted | Ação | Disparada após o envio de um formulário passar pela validação e suas ações serem executadas. | nenhum | Pro |
pbsw_frontend_prefix | Filtro | Filtra o prefixo neutro de classe no front-end. | string $prefix | Gratuito |
pbsw_fs_loaded | Ação | Disparada quando o SDK de licenciamento for carregado (no arquivo principal, antes de qualquer código do Page Builder Sandwich). Conecte aqui para se comunicar com `pbsw_fs()`. | nenhum | Gratuito |
pbsw_is_agency | Filtro | Filtra se os recursos do plano Agency estão disponíveis neste site. | bool $agency | Gratuito |
pbsw_is_pro | Filtro | Filtra se a camada premium está ativa. Apenas a camada premium responde a ele. | bool $pro | Gratuito |
pbsw_kit_api_base | Filtro | Filtra a base da API Zinn Digital® chamada pelas telas de suporte. | string $base | Gratuito |
pbsw_kit_diagnostics | Filtro | Filtra o diagnóstico antes que quem gerencia o site possa vê-lo. Um plugin adiciona suas próprias informações em `extra`. ⛔ Isso roda ANTES da pré-visualização, nunca entre ela e o envio. | nenhum | Gratuito |
pbsw_kit_footprint_free | Filtro | Filtra se este site é livre de rastros (footprint-free), para que o Zinn® Ads nunca seja promovido nele. | bool $footprint_free | Gratuito |
pbsw_kit_imported | Ação | Disparada após a importação de um kit. | int $front | Gratuito |
pbsw_kit_promotions | Filtro | Filtra o registro de promoções antes de ser resolvido. Adicione uma linha para promover outro produto: `id`, `kind` (hosting|marketplace|platform|plugin|bundle|ads), `slot` (promo|cross-sell) e `url` ou (para um plugin) `name`, `site`, `main_files`. | nenhum | Gratuito |
pbsw_kit_tier | Filtro | Filtra o nível do plano que o kit informa para este plugin (testes e staging; a licença define em produção). | string $tier | Gratuito |
pbsw_lcp_fold | Filtro | A distância até onde o conteúdo é considerado a primeira dobra da tela, em pixels CSS a partir do topo. Blocos que começam acima disso são tratados como acima da dobra: suas imagens carregam imediatamente e a imagem com maior probabilidade de ser a LCP recebe `fetchpriority=”high”`; blocos abaixo carregam sob demanda (lazy-load). Aumente para um hero alto, diminua para um cabeçalho compacto. | int $fold | Gratuito |
pbsw_legacy_body_classes | Filtro | Filtra as classes de body legadas. A camada premium adiciona as classes responsivas legadas do premium aqui (diretriz 5: esse comportamento não está no plugin gratuito). | nenhum | Gratuito |
pbsw_legacy_script_enqueued | Ação | Um post legado foi examinado quanto ao comportamento no front-end (a camada premium adiciona o seu). | int $post_idstring $contentstring|null $handle | Gratuito |
pbsw_library_token | Filtro | Filtra o token bearer enviado com as requisições de kits (a biblioteca em nuvem premium o fornece). | string $token | Gratuito |
pbsw_link_base | Filtro | Filtra o caminho sob o qual os links curtos ficam (`/go/<slug>/`). | string $base | Pro |
pbsw_list_services | Filtro | Filtra os serviços de listas de e-mails nos quais os formulários podem inscrever usuários. | nenhum | Pro |
pbsw_loop_query_args | Filtro | A consulta do loop (WooCommerce: faixa de preço, em promoção, em estoque, ordenações por preço/popularidade/avaliação). | nenhum | Pro |
pbsw_loop_sorts | Filtro | Opções de ordenação (o WooCommerce adiciona preço, popularidade e avaliação). | nenhum | Pro |
pbsw_mcp_abilities | Ação | Disparada após os recursos gratuitos serem registrados: o Page Builder Sandwich Pro registra os seus aqui (sua inicialização só se conecta a isso quando a licença permite o código premium). | nenhum | Gratuito |
pbsw_migration_batch_size | Filtro | Quantos posts legados (5.x) uma etapa de migração em segundo plano converte. Cada etapa é uma ação do Action Scheduler; um lote menor é ideal para hospedagens lentas ou com pouca memória, um maior para hospedagens rápidas com muitos posts. Valores abaixo de 1 são tratados como 1. | int $size | Gratuito |
pbsw_migration_post_types | Filtro | Filtra os tipos de post que a migração de versões legadas converte. | list<string> $types | Gratuito |
pbsw_nav_menu_item_classes | Filtro | Filtra as classes de um item (as opções de item do Pro adicionam `nav-menu__item–hide-mobile` e `–hide-desktop`). Somente as classes `nav-menu__item–<name>` são mantidas. | int $depth | Grátis |
pbsw_nav_menu_item_label | Filtro | Filtra o rótulo de um item, que é HTML com escape (as opções de item do Pro adicionam um ícone, um emblema e a descrição). Um retorno de chamada deve retornar HTML com escape. | string $labelint $depthstring $prefix | Grátis |
pbsw_nav_menu_toggle | Filtro | Filtra o HTML do botão Menu: o designer da barra de alternância do Pro o coloca em uma barra com logotipo, caixa de pesquisa, links… (exibido somente quando o menu estiver recolhido). Um resultado que não contenha o botão inalterado é ignorado, para que o menu nunca o perca. | string $togglestring $prefix | Grátis |
pbsw_newsletter_form_settings | Filtro | As configurações de um formulário que não seja da versão 5.x (data-* ⇒ valor), ou uma matriz vazia. | int $post_idstring $form | Grátis |
pbsw_newsletter_providers | Filtro | Os serviços de newsletter aos quais este site pode se inscrever: service ⇒ callable( string $email, array $settings ): array{ok: bool, message: string}. A camada premium adiciona os três da versão 5.x. | nenhum | Grátis |
pbsw_page_css_changed | Ação | Acionado quando a folha de estilos compilada de um post for alterada (plugins de cache limpam com base nela). | int $post_id | Grátis |
pbsw_page_css_enqueued | Ação | Acionado após a folha de estilos compilada de uma página ser enfileirada (a camada premium de CSS crítico se conecta aqui). | string $handleint $post_id | Grátis |
pbsw_page_css_extra | Filtro | Filtra o CSS anexado à folha compilada de uma página após as folhas de estilo dos próprios blocos (pbs-p4: as regras `.<prefix>-s-<id>` do sistema de design). Compilado, não minificado aqui: um ouvinte retorna seu CSS pronto para uso. | string $extrastring $prefixint $post_id | Grátis |
pbsw_page_css_signature | Filtro | Filtra o que mais mantém um estado compilado atualizado (pbs-p4: os pontos de quebra). | string $extra\WP_Post $post | Grátis |
pbsw_page_css_state | Filtro | Filtra o estado compilado de um post antes de ser armazenado (o pbs-p4 registra quais regras de design a folha carrega, para que o filtro de renderização não as imprima novamente). | int $post_id | Grátis |
pbsw_permission | Filtro | Filtra se um usuário pode usar uma capacidade do construtor. O plugin gratuito permite a todos; o gerenciador de funções do Pro responde por função. Administradores devem ter permissão sempre. | bool $allowedstring $whatint $user_id | Grátis |
pbsw_popup_force | Filtro | Pop-ups exibidos em todas as páginas, independentemente da segmentação (o banner de cookies). | nenhum | Pro |
pbsw_replace_post_types | Filtro | Filtra os tipos de post em que o localizar e substituir pesquisa por padrão. | nenhum | Pro |
pbsw_schema_skip | Filtro | Filtra os tipos de dados estruturados que o Page Builder Sandwich omite porque o plugin de SEO do site já os exibe para esta página. | string $content | Pro |
pbsw_site_design_data | Filtro | Filtra os dados de inicialização do Site design. A camada premium relata sua edição e adiciona os dados de que suas seções precisam. | nenhum | Grátis |
pbsw_site_design_deps | Filtro | Filtra as dependências dos pacotes do Site design. A camada premium adiciona seu próprio script aqui, para que suas seções sejam registradas antes da primeira renderização do painel. | string $handle | Grátis |
pbsw_site_health_keep_revisions | Filtro | Filtra quantas revisões mais recentes de cada post a limpeza mantém (o padrão é 5). | int $keep | Pro |
pbsw_style_at_rules | Filtro | Filtra as predefinições de at-rules que o construtor de estilos oferece em Estilo › Condição: uma lista de `array( ‘id’ => ‘narrow-card’, ‘label’ => ‘Narrow card’, ‘type’ => ‘container’, ‘query’ => ‘card (max-width:400px)’ )`, onde `type` é `media`, `container` ou `supports`. Valores definidos sob uma condição são impressos como `@<type> <query>{…}` após as regras de tamanho de tela. As predefinições integradas são impressão, esquema de cores escuras, movimento reduzido e mouse ou trackpad; uma predefinição inválida é descartada e nomeada na ação `pbsw_style_at_rules_invalid`. | nenhum | Grátis |
pbsw_style_at_rules_invalid | Ação | Acionado quando predefinições de `pbsw_style_at_rules` foram descartadas por serem inválidas. | nenhum | Grátis |
pbsw_template_content_location | Filtro | Uma localização de conteúdo mais específica (WooCommerce: single_product, product_archive, cart…). | string $location | Pro |
pbsw_template_resolved | Filtro | Os modelos escolhidos para um local. | string $type | Pro |
pbsw_template_types | Filtro | Mais tipos de modelo (páginas do WooCommerce). | nenhum | Pro |
pbsw_theme_builder_editor_data | Filtro | Mais dados do editor (fontes de dados dinâmicos e plugins de campos, os elementos do WooCommerce). | nenhum | Pro |
pbsw_theme_globals_saved | Ação | Esta ação está documentada abaixo. | nenhum | Gratuito |
pbsw_transfer_imported | Ação | Executada após a importação de um pacote, para que os caches criados a partir de modelos e configurações (os estilos por página, a folha de estilos do site) possam ser reconstruídos. | nenhum | Gratuito |
pbsw_transfer_meta_keys | Filtro | Filtra as chaves de metadados do post que a importação e a exportação transferem com cada item. | nenhum | Gratuito |
pbsw_transfer_options | Filtro | Filtra as opções que a importação e a exportação podem mover entre sites. Apenas opções `pbsw_` são aceitas; tudo o mais é descartado para que um pacote nunca possa gravar uma opção do núcleo ou de terceiros. | nenhum | Gratuito |
pbsw_transfer_post_types | Filtro | Filtra os tipos de post que a importação e a exportação podem mover entre sites. | nenhum | Gratuito |
pbsw_visitor_country | Filtro | Filtra o país do visitante para o controle de idade e avisos de jogo responsável, em sites que obtêm essa informação de outra forma (um plugin de geolocalização, um perfil de membro). | string $country | Pro |
pbsw_white_label_map | Filtro | Filtra as substituições de white-label (texto de origem => texto exibido). | nenhum | Pro |