Sviluppatori

Riferimento delle abilità di Page Builder Sandwich

Page Builder Sandwich registra le proprie azioni con l’API WordPress Abilities. Le stesse abilità sono strumenti MCP sul server del sito e route REST sotto /wp-json/wp-abilities/v1. Questa pagina è generata dal registro del plugin stesso.

Guida per l’utente: connettere un’app IA

Endpoint

AbilitàREST
MCP su HTTP (in streaming)/wp-json/pbs/v1/mcp
MCP su WP-CLI (standard input e output)wp mcp-adapter serve --server=page-builder-sandwich --user=<login>
REST: elenca le abilità/wp-json/wp-abilities/v1/abilities?category=page-builder-sandwich
REST: esegui un’abilità/wp-json/wp-abilities/v1/abilities/<name>/run (GET con ?input= per le abilità di sola lettura, POST {"input": {...}} altrimenti)

Autenticazione e permessi

Le richieste HTTP si autenticano con una password applicativa di WordPress (HTTP Basic). La connessione al server MCP richiede la capacità indicata di seguito; ciascuna abilità verifica quindi la propria autorizzazione, per oggetto. Le abilità di sola lettura vengono eseguite con GET e il relativo input nella query string; le altre con POST e un corpo JSON ‘{“input”: {…}}’.

una password applicativa di WordPress (HTTP) o --user (WP-CLI); l'utente necessita della capacità specificata da ciascuna abilità · Impostazioni: Consenti agenti IA (MCP), attiva per impostazione predefinita

Tutte le abilità

FunzionalitàEdizioneRESTPermessoParametri
pbs/activate-custom-font
Rende disponibile nei selettori dei font un font personalizzato caricato (un file di font nella libreria media, tramite ID).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/activate-custom-font/runedit_theme_options (il controllo interno della route REST)id intero (obbligatorio)
pbs/add-local-font
Scarica una famiglia di Google Font (famiglia, pesi, corsivo) e la distribuisce da questo sito.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/add-local-font/runmanage_options (il controllo interno della route REST)family stringa (obbligatorio)
weights array
italic booleano
pbs/add-section
Aggiunge una sezione predefinita a una pagina: all’inizio, alla fine o dopo la sezione in una determinata posizione.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/add-section/runedit_post su quella paginaid intero (obbligatorio)
section stringa (obbligatorio)
position stringa: start, end, after
after intero
pbs/add-shop-block
Aggiunge un blocco WooCommerce alla fine di un articolo: un elemento del prodotto (parte: title, gallery, image, price, rating, excerpt, description, add_to_cart, meta, tabs, related, upsells, sale_badge, stock; productId, oppure 0 per il prodotto attualmente visualizzato) o un mini carrello (label).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/add-shop-block/runedit_post (il controllo interno della route REST)post intero (obbligatorio)
block stringa (obbligatorio): product-element, mini-cart
part stringa: title, gallery, image, price, rating, excerpt, add_to_cart, meta, tabs, related, upsells, sale_badge, stock, description
productId intero
label stringa
pbs/ai-check-accessibility
Elenca i problemi di accessibilità di una pagina: immagini senza testo alternativo, titoli che saltano un livello, link il cui testo non ha senso da solo e link privi di testo. Per ciascuno indica se può essere corretto automaticamente.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/ai-check-accessibility/runedit_post sulla paginapost_id intero (obbligatorio)
pbs/ai-create-block
Progetta un componente riutilizzabile a partire da una descrizione (una tabella prezzi, una scheda del team, un banner) e lo salva come pattern sincronizzato in “I miei pattern” dell’editor, con ciascun testo sovrascrivibile per singola posizione. Restituisce il suo ID e il blocco che lo inserisce.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/ai-create-block/runedit_posts e publish_posts; regole su ruoli e spesa nelle impostazioni AIdescription stringa (obbligatorio)
title stringa
pbs/ai-css-help
Spiega, scrive o corregge il CSS personalizzato di un elemento, dove `selector` rappresenta l’elemento. Restituisce il CSS e una spiegazione; non salva nulla.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/ai-css-help/runedit_posts e il permesso per il codice del builderaction stringa (obbligatorio): explain, write, fix
css stringa
instruction stringa
block stringa
pbs/ai-design-from
Ricrea il layout di uno screenshot (un’immagine nella libreria media) o di una pagina web pubblica (il suo indirizzo) come blocchi modificabili in una nuova bozza di pagina: le stesse sezioni, colonne, titoli, testi, elenchi e pulsanti. I loghi e le immagini non vengono copiati.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/ai-design-from/runedit_pages (edit_post sullo screenshot); regole su ruoli e spesa nelle impostazioni AIattachment_id intero
url stringa
title stringa
instruction stringa
pbs/ai-edit-page
Modifica una pagina in base a richieste in linguaggio naturale (“accorcia il testo dell’hero”, “aggiungi una FAQ sulle spedizioni dopo i prezzi”, “traduci la pagina in tedesco”). L’AI risponde con operazioni di modifica verificate a confronto con i blocchi della pagina e le relative impostazioni prima di applicare qualsiasi cosa; le operazioni rifiutate vengono elencate con il motivo. Viene prima salvata una revisione e il suo ID viene restituito come undo_revision.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/ai-edit-page/runedit_post sulla pagina; regole su ruoli e spesa nelle impostazioni AIpost_id intero (obbligatorio)
instruction stringa (obbligatorio)
pbs/ai-fix-accessibility
Corregge i problemi di accessibilità risolvibili (tutti o solo gli ID problema indicati): testi alternativi scritti analizzando ogni immagine, livelli dei titoli corretti, testi generici dei link riscritti. Viene prima salvata una revisione e il suo ID viene restituito come undo_revision.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/ai-fix-accessibility/runedit_post sulla pagina; regole su ruoli e spesa nelle impostazioni AIpost_id intero (obbligatorio)
issues array
pbs/ai-generate-image
Crea un’immagine a partire da una descrizione con il modello di immagini del sito (OpenAI o Google) e la salva nella libreria media con il testo alternativo. Restituisce il suo id e l’indirizzo.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/ai-generate-image/runupload_files; il ruolo delle impostazioni AI e le regole di spesaprompt string (obbligatorio)
size string: square, landscape, portrait
alt string
title string
post_id integer
pbs/ai-generate-section
Trasforma una descrizione di una frase in una sezione già progettata (blocchi reali e modificabili nello stile del brand del sito) con testi scritti appositamente. Restituisce il markup dei blocchi e lo aggiunge all’inizio o alla fine di una pagina quando viene fornito un post_id (una revisione mantiene i contenuti precedenti).
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/ai-generate-section/runedit_posts; edit_post per aggiungerlo a una pagina; il ruolo delle impostazioni AI e le regole di spesadescription string (obbligatorio)
section string
post_id integer
position string: start, end
pbs/ai-plan-site
A partire da una descrizione dell’attività, elenca le pagine necessarie per il sito web (la home per prima, i contatti per ultimi), ciascuna con un titolo e un brief per quella pagina. Non viene creato nulla; ogni pagina può essere costruita successivamente a partire dal suo brief.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/ai-plan-site/runedit_pages; il ruolo delle impostazioni AI e le regole di spesabrief string (obbligatorio)
pbs/ai-save-seo-meta
Salva un meta title e una meta description nel plugin SEO utilizzato dal sito (Yoast SEO, Rank Math, SEOPress o All in One SEO) e indica quali sono stati salvati.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/ai-save-seo-meta/runedit_post sulla paginapost_id integer (obbligatorio)
title string (obbligatorio)
description string (obbligatorio)
pbs/ai-suggest-seo-meta
Legge una pagina e suggerisce un meta title (fino a 60 caratteri) e una meta description (fino a 155), facoltativamente attorno a una parola chiave principale. Non viene salvato nulla.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/ai-suggest-seo-meta/runedit_post sulla pagina; il ruolo delle impostazioni AI e le regole di spesapost_id integer (obbligatorio)
keyword string
pbs/ai-undo
Ripristina una pagina allo stato precedente a una modifica IA, a partire dalla undo_revision restituita da quella modifica.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/ai-undo/runedit_post sulla paginapost_id integer (obbligatorio)
revision integer (obbligatorio)
pbs/ai-write-alt-text
Analizza le immagini e salva il testo alternativo: per una singola immagine (attachment_id) o per ogni immagine di una pagina che ne è priva (post_id). Massimo 20 immagini per chiamata; la risposta indica quante ne rimangono.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/ai-write-alt-text/runupload_files ed edit_post sull’immagine o sulla pagina; il ruolo delle impostazioni AI e le regole di spesaattachment_id integer
post_id integer
only_missing boolean
language string
pbs/ai-write-text
Scrive un nuovo testo, oppure migliora, accorcia, espande, cambia il tono o corregge la grammatica di una porzione di testo, con il fornitore IA del sito. Restituisce il nuovo testo; non viene modificato nulla sul sito.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/ai-write-text/runedit_posts (edit_post quando viene fornito post_id); il ruolo delle impostazioni AI e le regole di spesaaction string (obbligatorio): write, improve, shorten, expand, tone, fix, custom
text string
tone string: professional, friendly, confident, playful, formal, simple
instruction string
context string
pbs/apply-brand-kit
Applica i colori e i font del brand kit salvato al design del sito.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/apply-brand-kit/runedit_theme_options (controllo interno della route REST)nessuno
pbs/apply-kit
Importa le pagine di un kit per siti web (tutte o solo quelle indicate), con la possibilità di pubblicarle, impostare la home page e aggiungerle a un menu. Importando di nuovo, le stesse pagine vengono aggiornate.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/apply-kit/runedit_pages e publish_pages; manage_options per impostare la home page; edit_theme_options per creare un menuslug string (obbligatorio)
pages array
publish boolean
front boolean
menu boolean
pbs/apply-replace
Applica un’operazione visualizzata in anteprima. Ogni articolo modificato conserva un backup, consentendo di annullare l’operazione.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/apply-replace/runmanage_options (controllo interno della route REST)id string (obbligatorio)
pbs/build-landing-page
Un flusso di lavoro guidato: l’agente seleziona le sezioni adatte alla tua attività, crea la pagina come bozza e ne scrive i testi.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/build-landing-page/runedit_pagesbusiness string (obbligatorio)
pbs/build-pages
Crea fino a 50 pagine in una sola chiamata, ciascuna a partire da sezioni e/o contenuti a blocchi. Ogni pagina viene verificata e creata singolarmente; la risposta elenca ogni pagina creata e ogni pagina rifiutata, specificandone il motivo.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/build-pages/runedit_pages; ciascuna pagina viene verificata singolarmente (publish_pages per pubblicare)pages (obbligatorio)
pbs/check-performance
Segnala l’impatto del contenuto di una pagina sul suo peso: le immagini (byte, quelle sovradimensionate e le dimensioni ridotte consigliate), i fogli di stile dei blocchi utilizzati e gli elementi incorporati di terze parti, ciascun problema con la relativa soluzione.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/check-performance/runedit_post sulla paginapost_id (obbligatorio)
pbs/connect-adobe-fonts
Collega un progetto web Adobe Fonts (Typekit) tramite l’ID del kit, rendendo disponibili i relativi font nei selettori di caratteri.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/connect-adobe-fonts/runedit_theme_options (verifica integrata dell’endpoint REST)kit (obbligatoria)
pbs/connect-marketing-service
Collega un servizio di mailing list con la relativa chiave API (service, key; account dove richiesto dal servizio), oppure lo disconnette passando una chiave vuota.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/connect-marketing-service/runmanage_options (verifica integrata dell’endpoint REST)service (obbligatoria)
key
account
pbs/connect-support
Collega questo sito al supporto di Zinn Digital® (name, email, consent).
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/connect-support/runmanage_options (verifica integrata dell’endpoint REST)email (obbligatoria)
name
consent (obbligatorio)
pbs/convert-builder-export
Converte un’esportazione (builder: elementor, divi, beaver o wpbakery; content: il testo esportato) in una nuova bozza di pagina composta da blocchi, copiando facoltativamente le immagini nella libreria multimediale (media). Risponde con la bozza e un report di conversione.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/convert-builder-export/runedit_pages (verifica integrata dell’endpoint REST)builder (obbligatoria): elementor, divi, beaver, wpbakery
content (obbligatoria)
title
media
dryRun
status: draft, pending, private, publish
pbs/convert-builder-page
Converte una pagina creata con Elementor, Divi, Beaver Builder o WPBakery (id) in una nuova bozza a blocchi, mantenendone layout, tipografia, colori e immagini; la pagina originale non viene modificata. Risponde con la bozza e un report con gli elementi convertiti, approssimati o non convertiti. dryRun converte senza salvare.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/convert-builder-page/runedit_pages ed edit_post (verifica integrata dell’endpoint REST)id (obbligatorio)
dryRun
status: draft, pending, private, publish
pbs/convert-post
Converte una pagina 5.x in blocchi (previa creazione di un backup).
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/convert-post/runverifica dei permessi per singolo elemento propria dell’endpoint RESTid (obbligatoria)
pbs/create-ab-test
Aggiunge un test su due versioni di una sezione alla fine di un articolo (post, name, a, b; split e goal facoltativi).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/create-ab-test/runedit_post (verifica integrata dell’endpoint REST)post (obbligatorio)
name
a (obbligatoria)
b (obbligatoria)
split
goal
pbs/create-class
Crea una classe di stile globale riutilizzabile: label, slug e relativi stili (s).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/create-class/runedit_theme_options (verifica integrata dell’endpoint REST)label (obbligatoria)
slug
s
cat
pbs/create-cookie-banner
Crea un banner di consenso preimpostato da cui partire per la personalizzazione.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/create-cookie-banner/runmanage_options (verifica integrata dell’endpoint REST)nessuno
pbs/create-form
Crea un modulo (contatto, preventivo, registrazione o a più passaggi: fields, steps, impostazioni e azioni come email, salvataggio, webhook o mailing list), in una nuova pagina o al termine di un articolo esistente (post).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/create-form/runedit_pages (verifica integrata dell’endpoint REST)title
fields (obbligatorio)
steps
actions
submitText
successMessage
redirectUrl
trackEvent
post
pageTitle
status: draft, publish, private
pbs/create-page
Crea una pagina da sezioni della libreria e/o dal contenuto dei blocchi. Una nuova pagina è una bozza a meno che non venga richiesto un altro stato.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/create-page/runedit_pages; publish_pages per pubblicare o rendere privatatitle string (obbligatorio)
status string: draft, pending, publish, private
sections array
content string
pbs/create-popup
Crea un popup, slide-in o barra: il suo contenuto, il trigger (intento di uscita, scorrimento, tempo, clic), la frequenza e le pagine su cui viene mostrato.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/create-popup/runedit_pages (il controllo proprio della route REST)title string (obbligatorio)
content string (obbligatorio)
status string: draft, publish
settings object
pbs/create-query-loop
Aggiunge un query loop con una scheda predefinita, su una nuova pagina (pageTitle, status) o alla fine di un articolo (post): source posts|users|terms|field, postType (product per una griglia di negozio), perPage, columns, orderBy, order, pagination e filtri live [{type: search|taxonomy|meta|sort|price|onsale|instock, taxonomy, key, label, ui}].
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/create-query-loop/runedit_post ed edit_posts (il controllo proprio della route REST)post integer
pageTitle string
status string: draft, publish, private
source string: posts, users, terms, field
postType string
perPage integer
columns integer
orderBy string
order string: ASC, DESC
pagination string: none, numbers, prevnext
taxonomy string
fieldKey string
filters array
pbs/create-team
Crea una libreria di team (name) a cui altri siti possono unirsi con un codice di invito.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/create-team/runmanage_options (il controllo proprio della route REST)name string (obbligatorio)
pbs/create-theme-template
Crea un template (title, type) che sostituisce quella parte di ogni pagina corrispondente, sui temi classici e a blocchi. Senza contenuto, parte da un design predefinito per il suo tipo. include/exclude sono regole di condizioni di visualizzazione ({kind, values, key, value, from, to, days}, i tipi offerti dal theme builder di questo sito); priority risolve i pareggi; status publish (pubblicato) o draft.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/create-theme-template/runil controllo dei permessi specifico per elemento della route RESTtitle string (obbligatorio)
type string (obbligatorio)
content string
include array
exclude array
priority integer
status string: publish, draft
pbs/deactivate-custom-font
Rimuove un font personalizzato (tramite slug) dai selettori di font.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/deactivate-custom-font/runedit_theme_options (il controllo proprio della route REST)slug string (obbligatorio)
pbs/delete-class
Elimina una classe globale. Gli elementi che la usavano mantengono il loro contenuto e perdono i suoi stili.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/delete-class/runedit_theme_options (il controllo proprio della route REST)id string (obbligatorio)
pbs/delete-icon
Rimuove un’icona caricata; i blocchi che la usavano mantengono la propria copia.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/delete-icon/rundelete_post (il controllo proprio della route REST)id string (obbligatorio)
pbs/delete-library-item
Elimina un design dalla libreria cloud.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/delete-library-item/runedit_posts (il controllo proprio della route REST)item string (obbligatorio)
team string
pbs/delete-page
Sposta una pagina nel cestino. Può essere ripristinata da Pagine, Cestino per 30 giorni.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/delete-page/rundelete_post su quella paginaid integer (obbligatorio)
pbs/delete-team
Elimina un team e ogni design presente nella sua libreria.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/delete-team/runmanage_options (il controllo proprio della route REST)team string (obbligatorio)
pbs/delete-theme-template
Sposta un template (id) nel cestino; il design del tema viene mostrato di nuovo dove veniva applicato. Ripristinabile dal cestino.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/delete-theme-template/runil controllo dei permessi specifico per elemento della route RESTid string (obbligatorio)
pbs/disconnect-support
Disconnette questo sito dal supporto.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/disconnect-support/runmanage_options (il controllo proprio della route REST)none
pbs/duplicate-class
Copia una classe globale con un nuovo id.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/duplicate-class/runedit_theme_options (il controllo proprio della route REST)id string (obbligatorio)
pbs/duplicate-page
Copia una pagina (titolo, contenuto e template) in una nuova bozza.
GratisPOST /wp-json/wp-abilities/v1/abilities/pbs/duplicate-page/runedit_post sulla pagina ed edit_pagesid intero (obbligatorio)
title stringa
pbs/export-design
Restituisce il file di design del sito: categorie, classi globali, variabili, scale di spaziatura, raggio e ombreggiature e colori personalizzati (formato page-builder-sandwich-design, versione 1).
ProGET /wp-json/wp-abilities/v1/abilities/pbs/export-design/runedit_theme_options (controllo interno della route REST)nessuno
pbs/export-designs
Esporta i template e i pattern selezionati (id) e, facoltativamente, le impostazioni in un unico pacchetto per un altro sito.
GratisPOST /wp-json/wp-abilities/v1/abilities/pbs/export-designs/runmanage_options (controllo interno della route REST)ids array
settings booleano
pbs/find-builder-pages
Elenca le pagine e gli articoli creati con Elementor, Divi, Beaver Builder o WPBakery (page, per_page), ciascuno con il rispettivo builder e, se convertito in precedenza, la bozza convertita.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/find-builder-pages/runedit_pages (controllo interno della route REST)page intero
per_page intero
pbs/generate-page
Crea una pagina a partire dalle sezioni (fornite o scelte dall’IA dalla libreria delle sezioni) e fa riscrivere tutto il testo all’IA in base al tuo brief, mantenendo il design. Utilizza il fornitore di IA configurato nelle impostazioni IA del plugin. La pagina è una bozza a meno che non venga richiesto un altro stato.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/generate-page/runedit_pages; publish_pages per pubblicare; ruolo e regole di spesa delle impostazioni IAbrief stringa (obbligatorio)
title stringa
sections array
status stringa: draft, pending, publish, private
pbs/get-block
Restituisce le impostazioni di un blocco (attributi con tipi, opzioni e valori predefiniti), cosa supporta, quali blocchi può contenere e un esempio pronto all’uso nel markup dei blocchi.
GratisGET /wp-json/wp-abilities/v1/abilities/pbs/get-block/runedit_postsname stringa (obbligatorio)
pbs/get-breakpoints
Restituisce le larghezze per tablet e dispositivi mobili (e i breakpoint personalizzati nella versione Pro) usate dai controlli responsivi.
GratisGET /wp-json/wp-abilities/v1/abilities/pbs/get-breakpoints/runedit_theme_options (controllo interno della route REST)nessuno
pbs/get-conversion-tracking
Restituisce le impostazioni di Google Analytics 4, Google Tag Manager e Meta Pixel e indica quali clic e invii di moduli vengono inviati.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-conversion-tracking/runmanage_options (controllo interno della route REST)nessuno
pbs/get-cookie-banner
Restituisce il banner di consenso: se è attivo, testo e design, categorie e dove viene applicato.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-cookie-banner/runmanage_options (controllo interno della route REST)nessuno
pbs/get-design-globals
Restituisce i colori e i font globali del sito (titoli e corpo del testo) utilizzati da ogni blocco, così come mostrati nella schermata Design del sito.
GratisGET /wp-json/wp-abilities/v1/abilities/pbs/get-design-globals/runedit_theme_options (controllo interno della route REST)nessuno
pbs/get-design-system
Restituisce il design system della versione Pro: classi globali, variabili, token di design, modalità scura, brand kit e font personalizzati.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-design-system/runedit_theme_options (controllo interno della route REST)nessuno
pbs/get-diagnostics
Restituisce i dati di diagnostica inclusi in un ticket di supporto: versioni, plugin attivi, limiti ed errori recenti.
GratisGET /wp-json/wp-abilities/v1/abilities/pbs/get-diagnostics/runmanage_options (controllo interno della route REST)nessuno
pbs/get-figma-connection
Restituisce se il sito dispone di un token di accesso personale di Figma, l’account Figma a cui appartiene e i suoi ultimi quattro caratteri. Il token stesso non viene mai restituito.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-figma-connection/runmanage_options (controllo interno della route REST)nessuno
pbs/get-library-account
Restituisce l’utilizzo dello spazio di archiviazione della libreria cloud, la quota del piano e le informazioni sul team.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-library-account/runedit_posts (controllo interno della route REST)nessuno
pbs/get-library-item
Restituisce un design salvato, pronto per essere inserito in questo sito (con le immagini importate nella libreria multimediale).
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-library-item/runedit_posts (controllo interno della route REST)item stringa (obbligatorio)
team stringa
pbs/get-library-storage
Restituisce le impostazioni per lo storage R2/S3 personalizzato (il segreto non viene mai restituito).
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-library-storage/runmanage_options (controllo interno della route REST)nessuno
pbs/get-licence
Restituisce il piano Page Builder Sandwich di questo sito, lo stato della licenza, la data di rinnovo e cosa include il piano.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/get-licence/runmanage_options (il controllo interno della route REST)nessuno
pbs/get-maintenance
Restituisce la modalità manutenzione / coming soon: modalità, pagina, retry-after e quali ruoli vedono ancora il sito.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-maintenance/runmanage_options (il controllo interno della route REST)nessuno
pbs/get-migration
Restituisce l’avanzamento e il report della conversione dei contenuti 5.x.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/get-migration/runil controllo dei permessi per elemento interno della route RESTnessuno
pbs/get-motion-options
Restituisce ogni impostazione di movimento (animazione di entrata, durata e ritardo, effetto di scorrimento, effetto hover, mantieni visibile, parallasse, segui il puntatore) con le relative opzioni o intervalli, e i breakpoint del sito.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-motion-options/runedit_posts (il controllo interno della route REST)nessuno
pbs/get-newsletter-keys
Indica se è presente una chiave Mailchimp salvata (la chiave stessa non viene mai restituita).
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-newsletter-keys/runedit_posts (il controllo interno della route REST)nessuno
pbs/get-page
Restituisce il titolo, lo stato, i link e il contenuto a blocchi di una pagina, nonché le sezioni (blocchi di primo livello) che la compongono.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/get-page/runedit_post su quella paginaid intero (obbligatorio)
pbs/get-replace-job
Restituisce le corrispondenze di un’attività, pagina per pagina, da verificare prima di applicarle.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-replace-job/runmanage_options (il controllo interno della route REST)id stringa (obbligatorio)
pbs/get-reviews-sources
Restituisce le origini Google e Trustpilot mostrate dal blocco Recensioni.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-reviews-sources/runmanage_options (il controllo interno della route REST)nessuno
pbs/get-roles
Restituisce quali ruoli possono usare il builder, la personalizzazione grafica, il codice e i template (modalità cliente).
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-roles/runmanage_options (il controllo interno della route REST)nessuno
pbs/get-settings
Restituisce il prefisso delle classi del front-end, lo stato degli aggiornamenti beta e se gli agenti IA (MCP) sono autorizzati.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/get-settings/runmanage_options (il controllo interno della route REST)nessuno
pbs/get-structured-data
Elenca i dati strutturati schema.org generati dai blocchi di una pagina (FAQ, How-To, Prodotto, Recensione, Breadcrumb) e quali tipi sono demandati al plugin SEO del sito per evitare duplicazioni.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-structured-data/runedit_post sulla paginapost_id intero (obbligatorio)
pbs/get-support-connection
Indica se questo sito è connesso al supporto di Zinn Digital® e con quale identità.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/get-support-connection/runmanage_options (il controllo interno della route REST)refresh booleano
pbs/get-theme-builder-options
Restituisce i tipi di template, le tipologie di condizioni di visualizzazione (pagina, tipo di articolo, termine, archivio, ricerca, 404, utente autenticato, ruolo, dispositivo, data, ora, parametro URL, referrer, lingua, carrello) con le relative opzioni su questo sito (ruoli, lingue, tipi di articolo, tassonomie) e l’attributo del blocco (pbswConditions: {match, rules}) che mostra o nasconde qualsiasi blocco.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-theme-builder-options/runedit_posts (il controllo interno della route REST)nessuno
pbs/get-white-label
Restituisce le impostazioni del white-label: abilitato o disabilitato, il nome mostrato e quali utenti vedono ancora la versione originale.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-white-label/runmanage_options (il controllo interno della route REST)nessuno
pbs/import-design
Valida un file di stile del sito (file) e, con apply impostato su false, restituisce cosa aggiungerebbe, modificherebbe ed eliminerebbe l’unione o la sostituzione (mode); con apply impostato su true, applica le modifiche.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/import-design/runedit_theme_options (il controllo interno della route REST)file oggetto (obbligatorio)
mode stringa: merge, replace
apply booleano
pbs/import-designs
Importa un pacchetto di design di Page Builder Sandwich (esegui prima una dryRun per verificare cosa cambierebbe; mode: skip o replace; media; impostazioni).
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/import-designs/runmanage_options (il controllo interno della route REST)package oggetto (obbligatorio)
mode stringa: skip, replace, duplicate
settings booleano
media booleano
dryRun booleano
pbs/import-figma-frame
Importa un frame di Figma (url: il link del frame con il relativo node-id) in una nuova bozza di pagina composta da blocchi: l’auto layout diventa contenitori flex e grid, il testo mantiene font e dimensioni, le immagini vengono copiate nella libreria media. Usa il token Figma del sito stesso. Risponde con la bozza e un report di conversione.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/import-figma-frame/runedit_pages e upload_files (controllo interno della route REST)url stringa (obbligatorio)
title stringa
dryRun booleano
status stringa: draft, pending, private, publish
pbs/invite-team-member
Crea un codice d’invito monouso (ruolo: lettura o scrittura; etichetta; giorni di validità). Il codice viene mostrato una sola volta.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/invite-team-member/runmanage_options (controllo interno della route REST)team stringa (obbligatorio)
role stringa: read, write
days intero
label stringa
pbs/join-team
Consente di unirsi alla libreria di un team tramite un codice d’invito.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/join-team/runmanage_options (controllo interno della route REST)code stringa (obbligatorio)
pbs/leave-team
Abbandona la libreria del team a cui questo sito si è unito.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/leave-team/runmanage_options (controllo interno della route REST)nessuno
pbs/list-ab-tests
Elenca gli A/B test con visitatori e conversioni di ogni versione, indicando quale sta vincendo.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-ab-tests/runedit_pages (controllo interno della route REST)nessuno
pbs/list-blocks
Elenca tutti i blocchi di Page Builder Sandwich che questo sito può usare (anche i blocchi Pro quando Pro è attivo): nome, titolo, categoria e descrizione.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/list-blocks/runedit_postssearch stringa
pbs/list-dynamic-sources
Restituisce gli elementi da cui è possibile popolare un blocco (articolo, autore, sito, archivio, campo personalizzato, prodotto) con i campi di ogni sorgente, i plugin per i campi presenti su questo sito (ACF, Meta Box, Pods, JetEngine, Toolset, post meta) e i campi di un tipo di articolo (postType). Un blocco è collegato a una sorgente tramite attributes.metadata.bindings, un {source, args} per attributo.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-dynamic-sources/runedit_posts (controllo interno della route REST)postType stringa
pbs/list-extensions
Elenca cosa hanno aggiunto gli altri plugin a Page Builder Sandwich tramite la sua API per sviluppatori: blocchi, sorgenti di dati dinamici, condizioni di visualizzazione e azioni del modulo, ciascuno con nome, etichetta e plugin.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/list-extensions/runedit_postsnessuno
pbs/list-form-submissions
Elenca ciò che i visitatori hanno inviato tramite i moduli che salvano gli invii (il parametro form consente di filtrare), una pagina alla volta.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-form-submissions/runcontrollo dei permessi per singolo elemento interno della route RESTform stringa
per_page intero
page intero
pbs/list-forms
Elenca i moduli creati con il blocco Modulo e i plugin di moduli che può incorporare.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/list-forms/runedit_posts (controllo interno della route REST)nessuno
pbs/list-kits
Elenca i kit di siti web (un insieme di pagine pronte all’uso per una determinata attività) che questo sito può importare.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/list-kits/runedit_pages e publish_pagesrefresh booleano
pbs/list-library-items
Elenca i design salvati nella libreria cloud (tipo: sezione, pagina o pattern; team: la libreria di un team).
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-library-items/runedit_posts (controllo interno della route REST)team stringa
kind stringa: , section, page, style
pbs/list-local-fonts
Elenca i font di Google ospitati localmente da questo sito (scaricati una volta, distribuiti dal sito, nessuna richiesta a Google).
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/list-local-fonts/runmanage_options (controllo interno della route REST)nessuno
pbs/list-lottie
Elenca le animazioni Lottie caricate.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-lottie/runedit_posts (controllo interno della route REST)nessuno
pbs/list-marketing-connections
Elenca i servizi di mailing list (Mailchimp, Brevo, MailerLite, Kit, ActiveCampaign) e indica quali sono collegati. Le chiavi non vengono mai restituite.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-marketing-connections/runmanage_options (controllo interno della route REST)nessuno
pbs/list-marketing-forms
Elenca tutti i moduli creati con il costruttore di moduli: la pagina in cui si trovano, i relativi campi e cosa accade al momento dell’invio.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-marketing-forms/runedit_pages (controllo interno della route REST)nessuno
pbs/list-marketing-lists
Elenca i destinatari o le liste di un servizio di mailing list collegato, per l’azione di iscrizione di un modulo.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-marketing-lists/runedit_posts (controllo interno della route REST)service string (obbligatorio)
pbs/list-pages
Elenca le pagine che puoi modificare, dalla più recente, con ricerca facoltativa.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/list-pages/runedit_pages; vengono elencate solo le pagine che l’utente può modificaresearch string
status string: any, draft, pending, publish, private
page integer
per_page integer
pbs/list-popups
Elenca popup, slide-in e barre con i relativi trigger, regole di frequenza e posizioni di visualizzazione.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-popups/runedit_pages (controllo interno della route REST)nessuno
pbs/list-replace-jobs
Elenca le attività di cerca e sostituisci a livello di sito e il loro stato.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-replace-jobs/runmanage_options (controllo interno della route REST)nessuno
pbs/list-sections
Elenca le sezioni pronte all’uso (hero, funzionalità, FAQ, testimonianze, call to action e altro) che puoi aggiungere a una pagina.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/list-sections/runedit_pagessearch string
pbs/list-team-members
Elenca i siti in un team e il loro accesso.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-team-members/runmanage_options (controllo interno della route REST)team string (obbligatorio)
pbs/list-teams
Elenca i team a cui questo sito appartiene o di cui è proprietario.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-teams/runmanage_options (controllo interno della route REST)nessuno
pbs/list-theme-templates
Elenca i template del theme builder (header, footer, singolo, archivio, ricerca, 404 e, con WooCommerce, prodotto, negozio, carrello, cassa, pagina di ringraziamento e Il mio account): tipo di ciascuno, dove viene mostrato (regole di inclusione/esclusione), priorità, stato e blocchi.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-theme-templates/runcontrollo permessi specifico per voce della route RESTnessuno
pbs/list-transferable
Elenca template, pattern e impostazioni esportabili su un altro sito.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/list-transferable/runmanage_options (controllo interno della route REST)nessuno
pbs/list-uploaded-icons
Elenca le icone SVG caricate nella libreria icone, dalla più recente.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/list-uploaded-icons/runedit_posts (controllo interno della route REST)page integer
per_page integer
pbs/move-section
Sposta una sezione di una pagina da una posizione a un’altra (in base 0, nell’ordine in cui la pagina le elenca).
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/move-section/runedit_post su quella paginaid integer (obbligatorio)
from integer (obbligatorio)
to integer (obbligatorio)
pbs/open-support-ticket
Invia un ticket di supporto (oggetto, messaggio, tipo, email), con la diagnostica di questo sito se l’amministratore ha acconsentito. Non crea mai un account di accesso né ne invia uno.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/open-support-ticket/runmanage_options (controllo interno della route REST)subject string (obbligatorio)
message string (obbligatorio)
kind string: help, bug, feedback, feature_request
email string
name string
diagnostics boolean
pbs/preview-dynamic-value
Restituisce ciò che un binding mostra su un articolo (post, source e field oppure provider + key, come text|url), per verificare un binding prima o dopo averlo aggiunto.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/preview-dynamic-value/runedit_post (controllo interno della route REST)post integer (obbligatorio)
source string (obbligatorio)
field string
provider string
key string
as string: text, url
pbs/record-support-consent
Registra il consenso dell’amministratore all’invio della diagnostica con i ticket di supporto.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/record-support-consent/runmanage_options (controllo interno della route REST)consent boolean (obbligatorio)
pbs/refresh-reviews
Recupera subito le ultime recensioni di Trustpilot invece di attendere l’aggiornamento giornaliero.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/refresh-reviews/runmanage_options (controllo interno della route REST)nessuno
pbs/remove-block
Rimuove un blocco (un’intera sezione o un blocco al suo interno) da una pagina, individuato dal relativo percorso. La versione precedente della pagina rimane salvata nelle revisioni.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/remove-block/runedit_post su quella paginaid integer (obbligatorio)
path array (obbligatorio)
pbs/remove-library-storage
Rimuove le impostazioni dello storage personalizzato; viene utilizzato di nuovo lo storage del piano.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/remove-library-storage/runmanage_options (controllo interno della route REST)nessuno
pbs/remove-local-font
Elimina i file di una famiglia di font self-hosted.
GratuitoPOST /wp-json/wp-abilities/v1/abilities/pbs/remove-local-font/runmanage_options (controllo interno della route REST)family (obbligatorio)
pbs/remove-team-member
Rimuove un sito da un team.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/remove-team-member/runmanage_options (controllo interno della route REST)team (obbligatorio)
member (obbligatorio)
pbs/reset-ab-test
Azzera i conteggi di un test e lo riavvia (test).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/reset-ab-test/runedit_pages (controllo interno della route REST)test (obbligatorio)
pbs/save-library-item
Salva il markup del blocco (title, kind, markup, styles, tags) nella tua libreria cloud o in quella di un team; le immagini sono incluse.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/save-library-item/runedit_posts (controllo interno della route REST)team
kind (obbligatorio): section, page, style
title (obbligatorio)
tags
markup
styles
pbs/set-block-motion
Imposta o rimuove (null) le impostazioni di movimento su un blocco di una pagina, individuato tramite il relativo percorso, a un breakpoint (base per impostazione predefinita). Funziona su qualsiasi blocco, compresi i blocchi core il cui codice HTML è salvato nella pagina. Chi richiede la riduzione del movimento non vedrà mai l’animazione.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/set-block-motion/runedit_post (controllo interno della route REST)post (obbligatorio)
path (obbligatorio)
breakpoint
motion (obbligatorio)
pbs/set-library-storage
Salva lo storage personalizzato: provider (r2 o s3), bucket, region, endpoint, prefix, key_id, secret, enabled.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/set-library-storage/runmanage_options (controllo interno della route REST)enabled
provider: r2, s3, other
endpoint
region
bucket
prefix
keyId
secret
pathStyle
pbs/set-maintenance
Attiva o disattiva la modalità manutenzione (503) o coming soon (mode), indicando la pagina da mostrare (page_id), retry_after e i ruoli che la ignorano.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/set-maintenance/runmanage_options (controllo interno della route REST)mode: off, maintenance, coming_soon
page_id
roles
retry_after
pbs/set-newsletter-keys
Salva (o rimuove, con un valore vuoto) la chiave API di Mailchimp utilizzata dal blocco newsletter.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/set-newsletter-keys/runmanage_options (controllo interno della route REST)mailchimp (obbligatorio)
pbs/set-reviews-sources
Imposta la sede Google e l’attività Trustpilot lette dal blocco Reviews.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/set-reviews-sources/runmanage_options (controllo interno della route REST)google
trustpilot
pbs/set-roles
Imposta per ruolo cosa consente il builder (roles), per esempio un ruolo cliente per soli contenuti.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/set-roles/runmanage_options (controllo interno della route REST)roles (obbligatorio)
pbs/set-white-label
Attiva o disattiva il white label e imposta il nome visibile ai clienti (enabled, name, agency_users).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/set-white-label/runmanage_options (controllo interno della route REST)enabled
name
studio_name
author
author_url
description
menu_icon
hide_plugin
agency_users
pbs/site-health-clean
Pulisce un tipo di elemento: revisioni (mantiene le 5 più recenti di ogni articolo ed elimina quelle più vecchie), pattern (sposta nel cestino i pattern sincronizzati inutilizzati), immagini (una copia scalata usata da WordPress; l’originale viene conservato), classi (rimuove le classi di stile inutilizzate, conservate per il ripristino). Ogni esecuzione pulisce un batch; \”more\” è true finché rimangono elementi.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/site-health-clean/runmanage_optionswhat (obbligatorio): revisions, patterns, images, classes
pbs/site-health-report
Trova le vecchie revisioni, i pattern sincronizzati non usati, le immagini originali pesanti e le classi di design non utilizzate da alcuna pagina. Funziona a piccoli passi: ogni esecuzione riprende da dove si era interrotta l’ultima mentre lo stato è “scanning”; il riavvio ricomincia da capo.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/site-health-report/runmanage_optionsrestart boolean
pbs/start-migration
Avvia (o riavvia) la conversione in blocchi di ogni pagina 5.x; prima viene eseguito il backup di ciascun articolo.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/start-migration/runcontrollo dei permessi per elemento della route RESTnessuno
pbs/start-replace
Avvia un trova e sostituisci sicuro per i blocchi (find, replace, tipo: text, link o colour; match_case; types). Non cambia nulla finché non applichi l’operazione visualizzata in anteprima.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/start-replace/runmanage_options (controllo interno della route REST)find string (obbligatorio)
replace string
kind string: text, link, colour
types array
match_case boolean
pbs/start-trial
Avvia la prova di 14 giorni di Page Builder Sandwich Pro per questo sito (nessun pagamento richiesto).
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/start-trial/runmanage_options (controllo interno della route REST)nessuno
pbs/test-library-storage
Scrive, legge ed elimina un oggetto di prova nel tuo archivio e segnala ogni passaggio.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/test-library-storage/runmanage_options (controllo interno della route REST)nessuno
pbs/undo-convert-post
Ripristina una pagina convertita dal relativo backup.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/undo-convert-post/runcontrollo dei permessi per elemento della route RESTid string (obbligatorio)
pbs/undo-migration
Ripristina ogni articolo convertito dal relativo backup.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/undo-migration/runcontrollo dei permessi per elemento della route RESTnessuno
pbs/undo-replace
Ripristina gli articoli modificati da un’operazione (un articolo modificato nel frattempo mantiene le sue modifiche).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/undo-replace/runmanage_options (controllo interno della route REST)id string (obbligatorio)
pbs/update-block
Modifica le impostazioni (attributi) di un blocco all’interno di una pagina, individuato dal relativo percorso; gli attributi inviati vengono uniti a quelli attuali. Funziona sui blocchi che il sito visualizza a partire dalle impostazioni; per un blocco il cui HTML è salvato nella pagina, la modifica avviene sostituendo il markup della pagina.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/update-block/runedit_post su quella paginaid integer (obbligatorio)
path array (obbligatorio)
attributes object (obbligatorio)
pbs/update-brand-kit
Salva il brand kit: nome, logo, colori, font dei titoli e del corpo, e il brand voice utilizzato dalla scrittura con IA.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-brand-kit/runedit_theme_options (controllo interno della route REST)name string
logo integer
colors array
headingFont string
bodyFont string
voice string
pbs/update-breakpoints
Modifica le larghezze in pixel per tablet e cellulare; con Pro, breakpoint personalizzati aggiuntivi.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/update-breakpoints/runedit_theme_options (controllo interno della route REST)tablet integer
mobile integer
custom array
pbs/update-class
Modifica l’etichetta, lo slug o gli stili di una classe globale; ogni elemento che la utilizza si aggiorna.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-class/runedit_theme_options (controllo interno della route REST)id string (obbligatorio)
label string
slug string
s object
cat string
pbs/update-conversion-tracking
Modifica le impostazioni di Google Analytics 4, Google Tag Manager e Meta Pixel, oltre a quali eventi vengono inviati.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-conversion-tracking/runmanage_options (controllo interno della route REST)ga4 string
gtm string
pixel string
loadTags boolean
formEvent string
pbs/update-cookie-banner
Modifica il banner di consenso. Finché è attivo, gli script di tracciamento attendono il consenso del visitatore.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-cookie-banner/runmanage_options (controllo interno della route REST)enabled boolean
popup integer
handles array
cookieDays integer
optOutOutsideEu boolean
pbs/update-dark-mode
Imposta la modalità scura (mode: disattivata, automatica o interruttore) e i suoi colori.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-dark-mode/runedit_theme_options (controllo interno della route REST)mode string (obbligatorio): device, light, dark
colors object
pbs/update-design-categories
Sostituisce un elenco di categorie (gruppo: classes o tokens; elementi: un elenco di slug e name). Le voci inserite in una categoria rimossa diventano non categorizzate.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-design-categories/runedit_theme_options (controllo interno della route REST)group string (obbligatorio): classes, tokens
items array (obbligatorio)
pbs/update-design-globals
Modifica i colori (colors) e i font (fonts, headingFont, bodyFont) globali del sito. Ogni pagina recepisce la modifica; il file theme.json del tema viene mantenuto sincronizzato.
GratisPOST /wp-json/wp-abilities/v1/abilities/pbs/update-design-globals/runedit_theme_options (controllo interno della route REST)colors object
fonts object
bodyFont string
headingFont string
pbs/update-form
Modifica un modulo (post, form): impostazioni e azioni vengono unite a quelle esistenti; i campi (e i passaggi) sostituiscono i campi esistenti.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-form/runedit_post (controllo interno della route REST)post string (obbligatorio)
form string (obbligatorio)
title string
fields array
steps array
actions object
submitText string
successMessage string
redirectUrl string
trackEvent string
pbs/update-page
Modifica il titolo, lo stato o il contenuto dei blocchi di una pagina. Il contenuto che invii sostituisce quello della pagina.
GratisPOST /wp-json/wp-abilities/v1/abilities/pbs/update-page/runedit_post su quella pagina; publish_pages per pubblicare o rendere privataid integer (obbligatorio)
title string
status string: draft, pending, publish, private
sections array
content string
pbs/update-popup
Modifica un popup, uno slide-in o una barra (id): contenuto, trigger, frequenza o dove viene mostrato.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-popup/runedit_post (controllo interno della route REST)id string (obbligatorio)
title string
content string
status string: draft, publish
settings object
pbs/update-settings
Modifica il prefisso delle classi front-end (da 1 a 8 lettere minuscole o cifre, che iniziano con una lettera) e/o attiva o disattiva gli agenti IA (MCP) (mcp: false rimuove ogni ability e l’endpoint MCP).
GratisPOST /wp-json/wp-abilities/v1/abilities/pbs/update-settings/runmanage_options (controllo interno della route REST)prefix string
mcp boolean
pbs/update-theme-template
Modifica un template (id): uno qualsiasi tra title, type, content (markup dei blocchi), include, exclude, priority, status. Viene modificato solo ciò che invii.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-theme-template/runcontrollo dei permessi per elemento interno della route RESTid string (obbligatorio)
title string
type string
content string
include array
exclude array
priority integer
status string: publish, draft
pbs/update-tokens
Modifica le scale di spaziatura, raggio e ombreggiatura (space, radius, shadow) o le ripristina (reset).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-tokens/runedit_theme_options (controllo interno della route REST)space array
radius array
shadow array
reset boolean
pbs/update-variables
Sostituisce le variabili di design del sito (variables: un elenco di name e value).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-variables/runedit_theme_options (controllo interno della route REST)variables array (obbligatorio)
pbs/upload-icon
Aggiunge un’icona SVG (name, markup svg) alla libreria di icone; l’SVG viene prima sanitizzato.
GratisPOST /wp-json/wp-abilities/v1/abilities/pbs/upload-icon/runupload_files (controllo interno della route REST)name string (obbligatorio)
svg string (obbligatorio)
pbs/upload-lottie
Valida un documento JSON Lottie (json, name) e lo pubblica come file statico per il blocco Lottie.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/upload-lottie/runupload_files (controllo interno della route REST)name string (obbligatorio)
json string (obbligatorio)

Generato da abilities.json del plugin, che è a sua volta generato da un sito attivo; un test fallisce quando i due non concordano.

Comandi WP-CLI

Eseguili sul server con WP-CLI. Ciascun comando verifica gli stessi permessi delle schermate del plugin; gli esempi sono tratti dal testo di aiuto del plugin stesso.

ComandoDescrizioneEdizione
wp pbs export [--types=<types>] [--no-settings] [--file=<name>]Esporta template, pattern e impostazioni in un file.Free
wp pbs import <file> [--mode=<mode>] [--no-settings] [--media] [--dry-run]Importa un file di esportazione.Free
wp pbs importers runConverti i vecchi contenuti: tutti gli articoli o solo uno.Free
wp pbs importers statusMostra lo stato della migrazione.Free
wp pbs importers undoAnnulla le conversioni dai rispettivi backup: tutti gli articoli o solo uno.Free
wp pbs migrate runConverti i vecchi contenuti: tutti gli articoli o solo uno.Free
wp pbs migrate statusMostra lo stato della migrazione.Free
wp pbs migrate undoAnnulla le conversioni dai rispettivi backup: tutti gli articoli o solo uno.Free
wp pbs replace <find> <replace> [--kind=<kind>] [--types=<types>] [--ignore-case] [--dry-run] [--undo=<job>]Trova e sostituisci in tutto il sito.Pro
wp pbsw fonts download <family> [--weights=<weights>] [--italic]Scarica una famiglia di Google Fonts su questo sito.Free
wp pbsw fonts listElenca le famiglie salvate.Free
wp pbsw fonts remove <family>Rimuovi una famiglia salvata e i suoi file.Free

Azioni e filtri

Tutti gli hook offerti dal plugin, con la descrizione tratta dal suo codice sorgente. I filtri modificano un valore; le azioni consentono di eseguire codice in un determinato momento; gli entry point sono azioni che attivi per chiedere al plugin di fare qualcosa.

HookTipoCosa faParametriEdizione
pbs_assets_changedActionViene eseguita quando i file front-end pubblicati di PBS cambiano e le cache di pagina raggiungibili sono state svuotate: agganciala per ripulire ciò che PBS non può raggiungere (una CDN, un proxy, la cache dell’hosting).nessunoFree
pbs_enqueue_scriptsActionAzione legacy: accoda gli script che chiamano window.pbsAddInspector().nessunoFree
pbs_shortcodesFilterFiltro legacy: tag dello shortcode => {label, desc, options[]} (Shortcode-API.md).array $shortcodesFree
pbsw_admin_dataFilterFiltra i dati con cui si avvia l’app di amministrazione. Il livello premium lo usa per segnalare la propria edizione; non inserire dati sensibili qui, perché vengono stampati nella pagina.nessunoFree
pbsw_admin_enqueueActionViene eseguita dopo l’accodamento dello script della schermata di amministrazione, consentendo a un modulo di accodare uno script che aggiunge un pannello tramite il filtro JavaScript `pbs.admin.panels` (deve dipendere da questo handle; la schermata viene renderizzata al DOM ready, dopo l’esecuzione di ogni script nel footer).string $handleFree
pbsw_ai_enqueueActionViene eseguita dopo l’accodamento del bundle dell’editor AI, così che un add-on (e il livello Pro) possa accodare i propri pannelli AI successivamente.string $handleFree
pbsw_ai_messagesFilterFiltra i messaggi di ogni richiesta AI inviata dal plugin, con il relativo contesto (task, purpose, provider, model, user); il brand kit di Pro aggiunge qui il tuo brand.array $messages
array $context
Free
pbsw_ai_pro_featuresFilterFiltra le funzionalità AI Pro offerte dall’editor (il livello premium aggiunge i suoi nomi: agent, site, block, design, image, css, a11y).nessunoFree
pbsw_ai_seo_pluginsFilterFiltra i plugin SEO in cui l’helper SEO AI scrive il meta title e la descrizione.nessunoFree
pbsw_ai_seo_writeFilterFiltra se un altro plugin SEO ha acquisito il meta title e la descrizione. Un plugin aggiunto in `pbsw_ai_seo_plugins` li salva qui a modo suo e restituisce true.bool $written
string $plugin
int $post_id
string $title
string $description
Free
pbsw_asset_sourcesFilterOgni sorgente front-end: quelle di questo file, quelle registrate dal livello delle prestazioni con add_source() (CSS per blocco, moduli di visualizzazione) e tutte quelle aggiunte dal livello premium per se stesso tramite `pbsw_asset_sources` (i suoi file risiedono nella sua directory, inclusa solo nel pacchetto premium). È accettato solo un percorso relativo semplice `.css`/`.js` all’interno del plugin, sotto una chiave di segmenti in minuscolo (`legacy.css`, `block/row.css`, `module/tabs.js`).nessunoFree
pbsw_breakpoints_changedActionViene eseguita quando cambiano i breakpoint (i fogli di stile compilati delle pagine vengono rigenerati alla visualizzazione successiva, poiché i breakpoint fanno parte della loro firma).nessunoFree
pbsw_cache_purgedActionViene eseguita dopo che PBS ha svuotato la cache di un articolo dai plugin di cache attivi.int $post_idFree
pbsw_cache_purgersFilterFiltra gli strumenti di svuotamento aggiuntivi eseguiti alla modifica dei file pubblicati: name => callable. L’hosting aggiunge i propri (una CDN, un proxy); se uno di essi genera un’eccezione viene ignorato e non segnalato come svuotato.nessunoFree
pbsw_code_blocksFilterFiltra i nomi dei blocchi trattati come codice personalizzato (solo i ruoli con il permesso `code` possono aggiungerli o modificarli).nessunoPro
pbsw_consent_countryFilterFiltra il paese del visitatore (ISO 3166-1 alpha-2) per la regola regionale del banner dei cookie. Il plugin non effettua mai ricerche geografiche del paese; restituisci ” quando non è noto.string $countryPro
pbsw_content_onlyFilterFiltra se un utente può modificare solo testo e immagini, con il layout bloccato.bool $content_only
int $user_id
Free
pbsw_design_class_cssFilterFiltra il CSS compilato di una classe globale prima che venga richiesto al motore di design. Restituisci una stringa per usarla al suo posto.string|null $css
string $selector
Pro
pbsw_design_custom_breakpointsFilterFiltra se i breakpoint personalizzati sono disponibili (pbs-d3, Pro).bool $allowedFree
pbsw_design_element_cssFilterFiltra se viene compilato il CSS personalizzato per singolo elemento (il livello premium lo abilita, d8).bool $enabledFree
pbsw_design_layout_suffixFilterFiltra il suffisso del selettore dell’elemento di layout per un blocco (” = l’elemento stesso del blocco).string $suffix
string $prefix
Free
pbsw_design_propsFilterFiltra le proprietà di design (il livello premium aggiunge le proprie).nessunoFree
pbsw_dynamic_editor_sourcesFilterAltre origini nell’editor (campi del prodotto WooCommerce).nonePro
pbsw_dynamic_fieldsFilterCatalogo dei campi per i provider che non hanno un’API di elenco letta da questo plugin (JetEngine, Toolset): le relative chiavi dei campi vengono digitate nell’editor o aggiunte qui.string $post_typePro
pbsw_dynamic_sourcesFilterAltre origini (prodotti WooCommerce): nome → etichetta; i relativi valori provengono da `pbsw_dynamic_value`.nonePro
pbsw_dynamic_valueFilterUn valore da un’altra origine (WooCommerce).string|null $value
string $source
Pro
pbsw_form_submittedActionViene eseguito dopo che l’invio di un modulo ha superato la convalida e le sue azioni sono state eseguite.nonePro
pbsw_frontend_prefixFilterFiltra il prefisso neutrale della classe per il front-end.string $prefixFree
pbsw_fs_loadedActionViene eseguito una volta caricato l’SDK di gestione delle licenze (nel file principale, prima di qualsiasi codice di Page Builder Sandwich). Agganciati qui per comunicare con `pbsw_fs()`.noneFree
pbsw_is_agencyFilterFiltra la disponibilità o meno delle funzionalità del piano Agency su questo sito.bool $agencyFree
pbsw_is_proFilterFiltra l’esecuzione o meno del livello premium. Solo il livello premium risponde ad esso.bool $proFree
pbsw_kit_api_baseFilterFiltra la base dell’API di Zinn Digital® chiamata dalle schermate di supporto.string $baseFree
pbsw_kit_diagnosticsFilterFiltra la diagnostica prima che il proprietario del sito la visualizzi. Un plugin aggiunge i propri dati in `extra`. ⛔ Questo viene eseguito PRIMA dell’anteprima, mai tra l’anteprima e l’invio.noneFree
pbsw_kit_footprint_freeFilterFiltra se questo sito è privo di tracciamenti (footprint-free), in modo da non promuovervi mai Zinn® Ads.bool $footprint_freeFree
pbsw_kit_importedActionViene eseguito dopo l’importazione di un kit.int $frontFree
pbsw_kit_promotionsFilterFiltra il registro delle promozioni prima che venga elaborato. Aggiungi una riga per promuovere un altro prodotto: `id`, `kind` (hosting|marketplace|platform|plugin|bundle|ads), `slot` (promo|cross-sell) e `url` o (per un plugin) `name`, `site`, `main_files`.noneFree
pbsw_kit_tierFilterFiltra il livello del piano segnalato dal kit per questo plugin (test e staging; la licenza decide in produzione).string $tierFree
pbsw_lcp_foldFilterFino a che punto della pagina il contenuto viene considerato come prima schermata, in pixel CSS partendo dalla parte superiore. I blocchi che iniziano al di sopra vengono trattati come “above the fold”: le loro immagini vengono caricate subito e l’immagine più probabile per l’LCP riceve `fetchpriority=”high”`; i blocchi sottostanti vengono caricati in modalità lazy load. Aumentalo per un hero imponente, riducilo per un’intestazione compatta.int $foldFree
pbsw_legacy_body_classesFilterFiltra le classi del body legacy. Il livello premium aggiunge qui le classi responsive del pacchetto legacy premium (linea guida 5: questo comportamento non è presente nel plugin gratuito).noneFree
pbsw_legacy_script_enqueuedActionUn articolo legacy è stato esaminato per il suo comportamento front-end (il livello premium aggiunge il proprio).int $post_id
string $content
string|null $handle
Free
pbsw_library_tokenFilterFiltra il token bearer inviato con le richieste del kit (viene fornito dalla libreria cloud premium).string $tokenFree
pbsw_link_baseFilterFiltra il percorso in cui risiedono i link brevi (`/go/<slug>/`).string $basePro
pbsw_list_servicesFilterFiltra i servizi di mailing list a cui i moduli possono effettuare l’iscrizione.nonePro
pbsw_loop_query_argsFilterLa query del loop (WooCommerce: fascia di prezzo, in saldo, disponibile, ordinamenti per prezzo/popolarità/valutazione).nonePro
pbsw_loop_sortsFilterScelte di ordinamento (WooCommerce aggiunge prezzo, popolarità e valutazione).nonePro
pbsw_mcp_abilitiesActionViene eseguito dopo che le abilità gratuite sono state registrate: Page Builder Sandwich Pro registra le proprie qui (il suo boot si aggancia a questo solo quando la licenza consente il codice premium).noneFree
pbsw_migration_batch_sizeFilterIl numero di articoli legacy (5.x) convertiti da ogni passaggio della migrazione in background. Ciascun passaggio corrisponde a un’azione di Action Scheduler; un batch più piccolo è ideale per un hosting lento o con memoria limitata, uno più grande per un hosting veloce con molti articoli. I valori inferiori a 1 vengono considerati pari a 1.int $sizeFree
pbsw_migration_post_typesFilterFiltra i tipi di articolo convertiti dalla migrazione legacy.list<string> $typesFree
pbsw_nav_menu_item_classesFilterFiltra le classi di una voce (le opzioni per le voci Pro aggiungono `nav-menu__item–hide-mobile` e `–hide-desktop`). Vengono mantenute solo le classi `nav-menu__item–<name>`.int $depthFree
pbsw_nav_menu_item_labelFilterFiltra l’etichetta di una voce, che è HTML con caratteri di escape (le opzioni per le voci Pro aggiungono un’icona, un badge e la descrizione). Il callback deve restituire HTML con caratteri di escape.string $label
int $depth
string $prefix
Free
pbsw_nav_menu_toggleFilterFiltra l’HTML del pulsante Menu: il designer della barra di attivazione/disattivazione Pro lo inserisce in una barra con logo, casella di ricerca, link… (mostrato solo quando il menu è chiuso). Un risultato che non contiene il pulsante invariato viene ignorato, così il menu non lo perde mai.string $toggle
string $prefix
Free
pbsw_newsletter_form_settingsFilterLe impostazioni di un modulo diverso da 5.x (data-* ⇒ valore), oppure un array vuoto.int $post_id
string $form
Free
pbsw_newsletter_providersFilterI servizi di newsletter a cui questo sito può iscriversi: service ⇒ callable( string $email, array $settings ): array{ok: bool, message: string}. Il livello premium aggiunge i tre della versione 5.x.nessunoFree
pbsw_page_css_changedActionSi attiva quando il foglio di stile compilato di un articolo è cambiato (i plugin di cache eseguono lo svuotamento qui).int $post_idFree
pbsw_page_css_enqueuedActionSi attiva dopo che il foglio di stile compilato di una pagina è stato accodato (il livello premium per il critical-CSS si aggancia qui).string $handle
int $post_id
Free
pbsw_page_css_extraFilterFiltra il CSS aggiunto al foglio compilato di una pagina dopo i fogli di stile propri dei blocchi (pbs-p4: le regole `.<prefix>-s-<id>` del design system). Compilato, non minificato qui: un listener restituisce il suo CSS pronto per l’uso.string $extra
string $prefix
int $post_id
Free
pbsw_page_css_signatureFilterFiltra cos’altro rende attuale uno stato compilato (pbs-p4: i breakpoint).string $extra
\WP_Post $post
Free
pbsw_page_css_stateFilterFiltra lo stato compilato di un articolo prima del salvataggio (pbs-p4 registra quali regole di design contiene il foglio, in modo che il filtro di rendering non le stampi di nuovo).int $post_idFree
pbsw_permissionFilterFiltra se un utente può usare una funzionalità del builder. Il plugin gratuito le consente a tutti; la gestione dei ruoli Pro risponde per ruolo. Gli amministratori dovrebbero essere sempre autorizzati.bool $allowed
string $what
int $user_id
Free
pbsw_popup_forceFilterPopup stampati su ogni pagina a prescindere dal loro targeting (il banner dei cookie).nessunoPro
pbsw_replace_post_typesFilterFiltra i tipi di articolo in cui cerca in modo predefinito la funzione trova e sostituisci.nessunoPro
pbsw_schema_skipFilterFiltra i tipi di dati strutturati esclusi da Page Builder Sandwich perché il plugin SEO del sito li stampa già per questa pagina.string $contentPro
pbsw_site_design_dataFilterFiltra i dati di avvio di Design del sito. Il livello premium segnala la propria edizione e aggiunge i dati necessari alle sue sezioni.nessunoFree
pbsw_site_design_depsFilterFiltra le dipendenze dei bundle di Design del sito. Il livello premium aggiunge qui il proprio script, così le sue sezioni vengono registrate prima del primo rendering del pannello.string $handleFree
pbsw_site_health_keep_revisionsFilterFiltra quante delle revisioni più recenti di ogni articolo vengono mantenute dalla pulizia (predefinito 5).int $keepPro
pbsw_style_at_rulesFilterFiltra i preset delle at-rule offerti dal generatore di stili sotto Stile › Condizione: un elenco di `array( ‘id’ => ‘narrow-card’, ‘label’ => ‘Narrow card’, ‘type’ => ‘container’, ‘query’ => ‘card (max-width:400px)’ )`, dove `type` è `media`, `container` o `supports`. I valori impostati sotto una condizione vengono stampati come `@<type> <query>{…}` dopo le regole per le dimensioni dello schermo. I preset integrati sono stampa, schema colori scuro, movimento ridotto e mouse o trackpad; un preset non valido viene scartato e indicato nell’azione `pbsw_style_at_rules_invalid`.nessunoFree
pbsw_style_at_rules_invalidActionSi attiva quando dei preset di `pbsw_style_at_rules` sono stati scartati perché non validi.nessunoFree
pbsw_template_content_locationFilterUna posizione dei contenuti più specifica (WooCommerce: single_product, product_archive, cart…).string $locationPro
pbsw_template_resolvedFilterI template scelti per una posizione.string $typePro
pbsw_template_typesFilterAltri tipi di template (pagine di WooCommerce).nessunoPro
pbsw_theme_builder_editor_dataFilterAltri dati dell’editor (origini dati dinamiche e plugin per campi, gli elementi di WooCommerce).nonePro
pbsw_theme_globals_savedActionQuesta action è documentata di seguito.noneFree
pbsw_transfer_importedActionViene eseguita dopo l’importazione di un pacchetto, in modo da poter ricostruire le cache create da template e impostazioni (gli stili per singola pagina, il foglio di stile del sito).noneFree
pbsw_transfer_meta_keysFilterFiltra le chiavi dei post meta che l’importazione e l’esportazione trasferiscono con ciascun elemento.noneFree
pbsw_transfer_optionsFilterFiltra le opzioni che l’importazione e l’esportazione possono spostare tra i siti. Vengono accettate solo le opzioni `pbsw_`; tutte le altre vengono ignorate in modo che un pacchetto non possa mai scrivere un’opzione di sistema o di terze parti.noneFree
pbsw_transfer_post_typesFilterFiltra i tipi di contenuto che l’importazione e l’esportazione possono spostare tra i siti.noneFree
pbsw_visitor_countryFilterFiltra il paese del visitatore per il blocco dell’età e gli avvisi sul gioco responsabile, per i siti che rilevano questa informazione in altro modo (un plugin di geolocalizzazione, un profilo utente).string $countryPro
pbsw_white_label_mapFilterFiltra le sostituzioni white label (testo di origine => testo visualizzato).nonePro