Разработчици

Справочник за способностите на Page Builder Sandwich

Page Builder Sandwich регистрира своите действия в WordPress Abilities API. Същите способности са MCP инструменти на собствения сървър на сайта и REST маршрути под /wp-json/wp-abilities/v1. Тази страница е генерирана от собствения регистър на разширението.

Ръководство за потребителя: свързване на AI приложение

Крайни точки

СпособностREST
MCP през HTTP (поточно предаване)/wp-json/pbs/v1/mcp
MCP през WP-CLI (стандартен вход и изход)wp mcp-adapter serve --server=page-builder-sandwich --user=<login>
REST: извеждане на списък със способностите/wp-json/wp-abilities/v1/abilities?category=page-builder-sandwich
REST: изпълнение на способност/wp-json/wp-abilities/v1/abilities/<name>/run (GET с ?input= за способности само за четене, в противен случай POST {"input": {...}})

Удостоверяване и права за достъп

HTTP заявките се удостоверяват с парола за приложение на WordPress (HTTP Basic). Свързването към MCP сървъра изисква показаното по-долу право; след това всяка способност проверява собственото си разрешение за всеки обект. Способностите само за четене се изпълняват с GET и техните входни данни в низа на заявката; останалите – с POST и JSON тяло ‘{„input“: {…}}’.

парола за приложение на WordPress (HTTP) или --user (WP-CLI); потребителят се нуждае от правото, посочено от всяка способност · Настройки: Разрешаване на AI агенти (MCP), включено по подразбиране

Всички способности

ВъзможностИзданиеRESTПраваПараметри
pbs/activate-custom-font
Прави качен потребителски шрифт (шрифтов файл в медийната библиотека, чрез id) достъпен в селекторите за шрифтове.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/activate-custom-font/runedit_theme_options (собствена проверка на REST маршрута)id integer (задължително)
pbs/add-local-font
Изтегля семейство шрифтове от Google (семейство, дебелини, курсив) и го зарежда локално от сайта.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/add-local-font/runmanage_options (собствена проверка на REST маршрута)family string (задължително)
weights array
italic boolean
pbs/add-section
Добавя готов раздел към страница: в началото, в края или след раздела на дадена позиция.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/add-section/runedit_post за съответната страницаid integer (задължително)
section string (задължително)
position string: start, end, after
after integer
pbs/add-shop-block
Добавя WooCommerce блок в края на публикация: продуктов елемент (part: title, gallery, image, price, rating, excerpt, description, add_to_cart, meta, tabs, related, upsells, sale_badge, stock; productId или 0 за разглеждания продукт) или миниколичка (label).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/add-shop-block/runedit_post (собствена проверка на REST маршрута)post integer (задължително)
block string (задължително): product-element, mini-cart
part string: title, gallery, image, price, rating, excerpt, add_to_cart, meta, tabs, related, upsells, sale_badge, stock, description
productId integer
label string
pbs/ai-check-accessibility
Извежда списък с проблемите с достъпността на дадена страница: изображения без заместващ текст (alt), заглавия, които прескачат нива, връзки с неясен самостоятелен текст и връзки без никакъв текст. За всеки се посочва дали може да бъде коригиран автоматично.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/ai-check-accessibility/runedit_post за страницатаpost_id integer (задължително)
pbs/ai-create-block
Проектира компонент за многократна употреба по описание (карта с цени, карта на екипа, банер) и го запазва като синхронизиран блок в редактора под „Моите блокове“, като всеки текст може да се променя индивидуално при вмъкване. Връща идентификатора му и блока, който го поставя.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/ai-create-block/runedit_posts и publish_posts; ролята и правилата за разходи в настройките на AIdescription string (задължително)
title string
pbs/ai-css-help
Обяснява, генерира или коригира персонализирания CSS на даден елемент, където `selector` означава елемента. Връща генерирания CSS и обяснение; нищо не се запазва.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/ai-css-help/runedit_posts и права за редактиране на код в конструктораaction string (задължително): explain, write, fix
css string
instruction string
block string
pbs/ai-design-from
Възпроизвежда оформлението от екранна снимка (изображение в медийната библиотека) или от публична уеб страница (нейния адрес) като редактируеми блокове в нова чернова на страница: същите раздели, колони, заглавия, текст, списъци и бутони. Логота и изображения не се копират.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/ai-design-from/runedit_pages (edit_post за екранната снимка); ролята и правилата за разходи в настройките на AIattachment_id integer
url string
title string
instruction string
pbs/ai-edit-page
Променя страница според зададени с прости думи инструкции („направи текста в основния банер по-кратък“, „добави ЧЗВ за доставката след цените“, „преведи страницата на немски“). Изкуственият интелект връща операции за редакция, които се проверяват спрямо блоковете на страницата и техните настройки преди прилагането им; отхвърлените операции се извеждат заедно с причината. Първо се запазва ревизия и идентификаторът ѝ се връща като undo_revision.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/ai-edit-page/runedit_post за страницата; ролята и правилата за разходи в настройките на AIpost_id integer (задължително)
instruction string (задължително)
pbs/ai-fix-accessibility
Коригира решимите проблеми с достъпността (всички или изброените по идентификатор): генерира заместващ текст (alt) чрез разпознаване на всяко изображение, коригира нивата на заглавията, пренаписва неясните текстове на връзки. Първо се запазва ревизия и идентификаторът ѝ се връща като undo_revision.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/ai-fix-accessibility/runedit_post за страницата; ролята и правилата за разходи в настройките на AIpost_id integer (задължително)
issues array
pbs/ai-generate-image
Генерира изображение по описание чрез модела за изображения на сайта (OpenAI или Google) и го запазва в медийната библиотека с алтернативен текст. Връща идентификатора и адреса му.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/ai-generate-image/runupload_files; ролята и правилата за разходи в настройките за AIprompt низ (задължителен)
size низ: square, landscape, portrait
alt низ
title низ
post_id цяло число
pbs/ai-generate-section
Превръща описание от едно изречение в готов за използване раздел (реални, редактируеми блокове в стила на марката на сайта) с готов текст. Връща кода на блоковете и го добавя в началото или в края на страница при посочен post_id (създава се ревизия за запазване на предишното състояние).
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/ai-generate-section/runedit_posts; edit_post за добавяне към страница; ролята и правилата за разходи в настройките за AIdescription низ (задължителен)
section низ
post_id цяло число
position низ: start, end
pbs/ai-plan-site
Въз основа на описание на дейността генерира списък с необходимите за уебсайта страници (началната страница първа, за контакти – последна), всяка със заглавие и кратко описание. Нищо не се създава автоматично; всяка страница може да бъде изградена впоследствие според описанието.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/ai-plan-site/runedit_pages; ролята и правилата за разходи в настройките за AIbrief низ (задължителен)
pbs/ai-save-seo-meta
Запазва мета заглавие и мета описание в използвания от сайта SEO плъгин (Yoast SEO, Rank Math, SEOPress или All in One SEO) и показва кои стойности са записани.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/ai-save-seo-meta/runedit_post за страницатаpost_id цяло число (задължително)
title низ (задължителен)
description низ (задължителен)
pbs/ai-suggest-seo-meta
Анализира страница и предлага мета заглавие (до 60 знака) и мета описание (до 155), по желание съобразени с ключова дума. Нищо не се запазва автоматично.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/ai-suggest-seo-meta/runedit_post за страницата; ролята и правилата за разходи в настройките за AIpost_id цяло число (задължително)
keyword низ
pbs/ai-undo
Връща страницата към състоянието преди промяната от AI, използвайки върнатия параметър undo_revision.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/ai-undo/runedit_post за страницатаpost_id цяло число (задължително)
revision цяло число (задължително)
pbs/ai-write-alt-text
Анализира изображения и записва алтернативен текст за тях: за конкретно изображение (attachment_id) или за всички изображения на страница, които нямат такъв (post_id). До максимум 20 изображения на извикване; отговорът съдържа броя на оставащите.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/ai-write-alt-text/runupload_files и edit_post за изображението или страницата; ролята и правилата за разходи в настройките за AIattachment_id цяло число
post_id цяло число
only_missing булев израз
language низ
pbs/ai-write-text
Генерира нов текст или подобрява, съкращава, разширява, променя тона или коригира граматиката на даден текст чрез доставчика на AI за сайта. Връща новия текст, без да променя съдържанието в сайта.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/ai-write-text/runedit_posts (edit_post при посочен post_id); ролята и правилата за разходи в настройките за AIaction низ (задължителен): write, improve, shorten, expand, tone, fix, custom
text низ
tone низ: professional, friendly, confident, playful, formal, simple
instruction низ
context низ
pbs/apply-brand-kit
Прилага цветовете и шрифтовете от запазения бранд пакет към дизайна на сайта.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/apply-brand-kit/runedit_theme_options (собствена проверка на маршрута за REST)няма
pbs/apply-kit
Импортира страници от шаблонен пакет за сайт (всички или посочените), с възможност за публикуване, задаване на начална страница и добавяне към меню. Повторното импортиране обновява същите страници.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/apply-kit/runedit_pages и publish_pages; manage_options за задаване на началната страница; edit_theme_options за създаване на менюslug низ (задължителен)
pages масив
publish булев израз
front булев израз
menu булев израз
pbs/apply-replace
Прилага прегледаната задача за замяна. Всяка променена публикация запазва резервно копие, така че действието да може да бъде отменено.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/apply-replace/runmanage_options (собствена проверка на маршрута за REST)id низ (задължителен)
pbs/build-landing-page
Направляван работен процес: агентът избира подходящи раздели за вашия бизнес, изгражда страницата като чернова и генерира текста ѝ.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/build-landing-page/runedit_pagesbusiness низ (задължителен)
pbs/build-pages
Създава до 50 страници с едно извикване, всяка от секции и/или блоково съдържание. Всяка страница се проверява и създава самостоятелно; отговорът изброява всяка създадена и всяка отказана страница заедно с причината.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/build-pages/runedit_pages; всяка страница се проверява самостоятелно (publish_pages за публикуване)pages (задължително)
pbs/check-performance
Отчита с какво съдържанието на дадена страница натоварва теглото ѝ: нейните изображения (байтове, твърде големи размери и по-малкия размер, който би свършил работа), стиловите таблици на използваните блокове и външните вграждания, като за всеки проблем е предложено решение.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/check-performance/runedit_post за страницатаpost_id (задължително)
pbs/connect-adobe-fonts
Свързва уеб проект от Adobe Fonts (Typekit) чрез идентификатора на комплекта (kit id), за да се показват шрифтовете му в списъците за избор на шрифт.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/connect-adobe-fonts/runedit_theme_options (собствена проверка на REST маршрута)kit (задължително)
pbs/connect-marketing-service
Свързва услуга за имейл бюлетин с нейния API ключ (service, key; акаунт, където услугата изисква такъв) или я прекъсва при празен ключ.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/connect-marketing-service/runmanage_options (собствена проверка на REST маршрута)service (задължително)
key
account
pbs/connect-support
Свързва сайта с поддръжката на Zinn Digital® (име, имейл, съгласие).
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/connect-support/runmanage_options (собствена проверка на REST маршрута)email (задължително)
name
consent (задължително)
pbs/convert-builder-export
Преобразува експортирано съдържание (builder: elementor, divi, beaver или wpbakery; content: експортираният текст) в нова чернова на страница, съставена от блокове, с възможност за копиране на изображенията в медийната библиотека (media). Връща като отговор черновата и доклад за преобразуването.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/convert-builder-export/runedit_pages (собствена проверка на REST маршрута)builder (задължително): elementor, divi, beaver, wpbakery
content (задължително)
title
media
dryRun
status: draft, pending, private, publish
pbs/convert-builder-page
Преобразува страница, създадена с Elementor, Divi, Beaver Builder или WPBakery (id), в нова чернова от блокове, запазвайки нейното оформление, типография, цветове и изображения; оригиналната страница не се променя. Връща като отговор черновата и доклад за преобразуваните, приблизително пресъздадените или непреобразуваните елементи. dryRun преобразува без запазване.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/convert-builder-page/runedit_pages и edit_post (собствена проверка на REST маршрута)id (задължително)
dryRun
status: draft, pending, private, publish
pbs/convert-post
Преобразува 5.x страница към блокове (след първоначално създаване на резервно копие).
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/convert-post/runсобствена проверка на правата за всеки елемент на REST маршрутаid (задължително)
pbs/create-ab-test
Добавя тест на две версии на секция в края на публикация (post, name, a, b; разпределението и целта не са задължителни).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/create-ab-test/runedit_post (собствена проверка на REST маршрута)post (задължително)
name
a (задължително)
b (задължително)
split
goal
pbs/create-class
Създава глобален клас за стилове за многократна употреба: етикет, кратко име (slug) и стилове (s).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/create-class/runedit_theme_options (собствена проверка на REST маршрута)label (задължително)
slug
s
cat
pbs/create-cookie-banner
Създава готов дизайн на банер за съгласие, който да послужи за основа.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/create-cookie-banner/runmanage_options (собствена проверка на REST маршрута)няма
pbs/create-form
Създава формуляр (за контакт, запитване за оферта, регистрация или многоетапен: полета, стъпки, настройки и действия като имейл, запазване, webhook или имейл бюлетин) на нова страница или в края на съществуваща публикация (post).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/create-form/runedit_pages (собствена проверка на REST маршрута)title
fields (задължително)
steps
actions
submitText
successMessage
redirectUrl
trackEvent
post
pageTitle
status: draft, publish, private
pbs/create-page
Създава страница от секции в библиотеката и/или блоково съдържание. Новата страница е чернова, освен ако не е зададен друг статус.
БезплатнаPOST /wp-json/wp-abilities/v1/abilities/pbs/create-page/runedit_pages; publish_pages за публикуване или задаване като личнаtitle низ (задължително)
status низ: draft, pending, publish, private
sections масив
content низ
pbs/create-popup
Създава изскачащ прозорец (popup), плъзгащ се панел (slide-in) или лента (bar): съдържание, задействане (намерение за напускане, превъртане, време, кликване), честота и страниците, на които да се показва.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/create-popup/runedit_pages (собствена проверка на маршрута на REST)title низ (задължително)
content низ (задължително)
status низ: draft, publish
settings обект
pbs/create-query-loop
Добавя цикъл за заявки с готова карта на нова страница (pageTitle, status) или в края на публикация (post): източник posts|users|terms|field, postType (product за решетка в магазин), perPage, columns, orderBy, order, пагинация и филтри в реално време [{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 и edit_posts (собствена проверка на маршрута на REST)post цяло число
pageTitle низ
status низ: draft, publish, private
source низ: posts, users, terms, field
postType низ
perPage цяло число
columns цяло число
orderBy низ
order низ: ASC, DESC
pagination низ: none, numbers, prevnext
taxonomy низ
fieldKey низ
filters масив
pbs/create-team
Създава екипна библиотека (name), към която други сайтове могат да се присъединят с код за покана.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/create-team/runmanage_options (собствена проверка на маршрута на REST)name низ (задължително)
pbs/create-theme-template
Създава шаблон (title, type), който заменя съответната част от всяка съвпадаща страница при класически теми и теми с блокове. Без съдържание започва с готов дизайн за съответния тип. include/exclude са правила за условия на показване ({kind, values, key, value, from, to, days}, видовете, които конструкторът на теми на сайта предлага); priority определя приоритета при дублиране; статус publish (публикуван) или draft (чернова).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/create-theme-template/runсобствена проверка на правата за всеки елемент на маршрута на RESTtitle низ (задължително)
type низ (задължително)
content низ
include масив
exclude масив
priority цяло число
status низ: publish, draft
pbs/deactivate-custom-font
Премахва персонализиран шрифт (по slug) от селекторите за шрифтове.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/deactivate-custom-font/runedit_theme_options (собствена проверка на маршрута на REST)slug низ (задължително)
pbs/delete-class
Изтрива глобален клас. Елементите, които са го използвали, запазват съдържанието си и губят стиловете му.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/delete-class/runedit_theme_options (собствена проверка на маршрута на REST)id низ (задължително)
pbs/delete-icon
Премахва качена икона; блоковете, които са я използвали, запазват собствено копие.
БезплатнаPOST /wp-json/wp-abilities/v1/abilities/pbs/delete-icon/rundelete_post (собствена проверка на маршрута на REST)id низ (задължително)
pbs/delete-library-item
Изтрива дизайн от облачната библиотека.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/delete-library-item/runedit_posts (собствена проверка на маршрута на REST)item низ (задължително)
team низ
pbs/delete-page
Премества страница в кошчето. Може да бъде възстановена от Страници > Кошче в рамките на 30 дни.
БезплатнаPOST /wp-json/wp-abilities/v1/abilities/pbs/delete-page/rundelete_post за съответната страницаid цяло число (задължително)
pbs/delete-team
Изтрива екип и всеки дизайн в неговата библиотека.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/delete-team/runmanage_options (собствена проверка на маршрута на REST)team низ (задължително)
pbs/delete-theme-template
Премества шаблон (id) в кошчето; дизайнът на самата тема се показва отново там, където е бил приложен. Възстановим от кошчето.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/delete-theme-template/runсобствена проверка на правата за всеки елемент на маршрута на RESTid низ (задължително)
pbs/disconnect-support
Прекъсва връзката на сайта с поддръжката.
БезплатнаPOST /wp-json/wp-abilities/v1/abilities/pbs/disconnect-support/runmanage_options (собствена проверка на маршрута на REST)няма
pbs/duplicate-class
Копира глобален клас под нов идентификатор (id).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/duplicate-class/runedit_theme_options (собствена проверка на маршрута на REST)id низ (задължително)
pbs/duplicate-page
Копира страница (нейното заглавие, съдържание и шаблон) в нова чернова.
БезплатноPOST /wp-json/wp-abilities/v1/abilities/pbs/duplicate-page/runedit_post за страницата и edit_pagesid цяло число (задължително)
title низ
pbs/export-design
Връща файла с дизайна на сайта: категории, глобални класове, променливи, отстояния, скали за заобляне и сенки, както и потребителски цветове (формат page-builder-sandwich-design, версия 1).
ProGET /wp-json/wp-abilities/v1/abilities/pbs/export-design/runedit_theme_options (собствена проверка на REST маршрута)няма
pbs/export-designs
Експортира избраните шаблони и мостри (ids) и, по желание, настройки като един пакет за друг сайт.
БезплатноPOST /wp-json/wp-abilities/v1/abilities/pbs/export-designs/runmanage_options (собствена проверка на REST маршрута)ids масив
settings булев
pbs/find-builder-pages
Извежда списък на страниците и публикациите, създадени с Elementor, Divi, Beaver Builder или WPBakery (page, per_page), всяка с нейния строител и предишно конвертираната чернова, ако е имало такова конвертиране.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/find-builder-pages/runedit_pages (собствена проверка на REST маршрута)page цяло число
per_page цяло число
pbs/generate-page
Изгражда страница от секции (зададени или избрани от изкуствен интелект от библиотеката със секции) и използва изкуствен интелект за пренаписване на целия текст според вашето задание, запазвайки дизайна. Използва доставчика на изкуствен интелект, конфигуриран в настройките за AI на разширението. Страницата е чернова, освен ако не е заявен друг статус.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/generate-page/runedit_pages; publish_pages за публикуване; правилата за роли и разходи в настройките за AIbrief низ (задължително)
title низ
sections масив
status низ: draft, pending, publish, private
pbs/get-block
Връща настройките на един блок (атрибути с техните типове, възможности за избор и стойности по подразбиране), какво поддържа, кои блокове може да съдържа и готов за употреба пример в блокова маркировка.
БезплатноGET /wp-json/wp-abilities/v1/abilities/pbs/get-block/runedit_postsname низ (задължително)
pbs/get-breakpoints
Връща ширините за таблет и мобилни устройства (и потребителските точки на пречупване в Pro), използвани от адаптивните контроли.
БезплатноGET /wp-json/wp-abilities/v1/abilities/pbs/get-breakpoints/runedit_theme_options (собствена проверка на REST маршрута)няма
pbs/get-conversion-tracking
Връща настройките за Google Analytics 4, Google Tag Manager и Meta Pixel, както и кои кликвания и изпращания на формуляри се предават.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-conversion-tracking/runmanage_options (собствена проверка на REST маршрута)няма
pbs/get-cookie-banner
Връща банера за съгласие: дали е включен, неговия текст и дизайн, категориите и къде е приложим.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-cookie-banner/runmanage_options (собствена проверка на REST маршрута)няма
pbs/get-design-globals
Връща глобалните цветове и шрифтове за сайта (за заглавия и основен текст), използвани от всеки блок, както се виждат в екрана за дизайн на сайта.
БезплатноGET /wp-json/wp-abilities/v1/abilities/pbs/get-design-globals/runedit_theme_options (собствена проверка на REST маршрута)няма
pbs/get-design-system
Връща системата за дизайн в Pro: глобални класове, променливи, дизайнерски токени, тъмен режим, бранд комплект и потребителски шрифтове.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-design-system/runedit_theme_options (собствена проверка на REST маршрута)няма
pbs/get-diagnostics
Връща диагностичните данни, необходими за запитване към поддръжката: версии, активни разширения, ограничения и скорошни грешки.
БезплатноGET /wp-json/wp-abilities/v1/abilities/pbs/get-diagnostics/runmanage_options (собствена проверка на REST маршрута)няма
pbs/get-figma-connection
Връща информация дали сайтът има персонален токън за достъп до Figma, профила във Figma, към който принадлежи, и последните му четири знака. Самият токън никога не се връща.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-figma-connection/runmanage_options (собствена проверка на REST маршрута)няма
pbs/get-library-account
Връща използваното място в облачната библиотека, квотата на плана и данни за екипа.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-library-account/runedit_posts (собствена проверка на REST маршрута)няма
pbs/get-library-item
Връща един запазен дизайн, готов за вмъкване в този сайт (като изображенията му се добавят в медийната библиотека).
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-library-item/runedit_posts (собствена проверка на REST маршрута)item низ (задължително)
team низ
pbs/get-library-storage
Връща настройките за собствено R2/S3 хранилище (тайната парола никога не се връща).
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-library-storage/runmanage_options (собствена проверка на REST маршрута)няма
pbs/get-licence
Връща плана на Page Builder Sandwich за сайта, състоянието на лиценза, датата на подновяване и съдържанието на плана.
БезплатноGET /wp-json/wp-abilities/v1/abilities/pbs/get-licence/runmanage_options (собствена проверка на REST маршрута)няма
pbs/get-maintenance
Връща режима на поддръжка / очаквайте скоро: режим, страница, период за повторен опит (retry-after) и кои роли все още виждат сайта.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-maintenance/runmanage_options (собствена проверка на REST маршрута)няма
pbs/get-migration
Връща напредъка и отчета за преобразуването на съдържанието от версия 5.x.
БезплатноGET /wp-json/wp-abilities/v1/abilities/pbs/get-migration/runсобствена проверка на правата за всеки елемент на REST маршрутаняма
pbs/get-motion-options
Връща всяка настройка за анимация (встъпителна анимация, продължителност и отлагане, ефект при превъртане, ефект при посочване, запазване в изгледа, паралакс, следване на показалеца) с нейните опции или диапазон, както и контролните точки (breakpoints) на сайта.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-motion-options/runedit_posts (собствена проверка на REST маршрута)няма
pbs/get-newsletter-keys
Показва дали е запазен ключ за Mailchimp (самият ключ никога не се връща).
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-newsletter-keys/runedit_posts (собствена проверка на REST маршрута)няма
pbs/get-page
Връща заглавието на страницата, състоянието, връзките и блоковото съдържание, както и секциите (блоковете от първо ниво), от които е съставена.
БезплатноGET /wp-json/wp-abilities/v1/abilities/pbs/get-page/runedit_post за съответната страницаid цяло число (задължително)
pbs/get-replace-job
Връща съвпаденията за дадена задача, страница по страница, за преглед преди прилагане.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-replace-job/runmanage_options (собствена проверка на REST маршрута)id низ (задължително)
pbs/get-reviews-sources
Връща източниците от Google и Trustpilot, които блокът за отзиви показва.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-reviews-sources/runmanage_options (собствена проверка на REST маршрута)няма
pbs/get-roles
Връща кои роли имат право да използват конструктора, дизайна, кода и шаблоните (клиентски режим).
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-roles/runmanage_options (собствена проверка на REST маршрута)няма
pbs/get-settings
Връща префикса на класовете за публичната част, състоянието на бета актуализациите и дали са разрешени AI агенти (MCP).
БезплатноGET /wp-json/wp-abilities/v1/abilities/pbs/get-settings/runmanage_options (собствена проверка на REST маршрута)няма
pbs/get-structured-data
Извежда структурираните данни от schema.org, генерирани от блоковете на страницата (ЧЗВ, Ръководство, Продукт, Отзив, Трохи), както и кои типове са оставени на SEO разширението на сайта, за да се избегне повторно отпечатване.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-structured-data/runedit_post за страницатаpost_id цяло число (задължително)
pbs/get-support-connection
Показва дали сайтът е свързан с поддръжката на Zinn Digital®, и като кого.
БезплатноGET /wp-json/wp-abilities/v1/abilities/pbs/get-support-connection/runmanage_options (собствена проверка на REST маршрута)refresh булева стойност
pbs/get-theme-builder-options
Връща типовете шаблони, видовете условия за показване (страница, тип публикация, термин, архив, търсене, 404, вписан потребител, роля, устройство, дата, час, URL параметър, референт, език, количка) с техните опции за сайта (роли, езици, типове публикации, таксономии), както и атрибута на блока (pbswConditions: {match, rules}), който показва или скрива произволен блок.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-theme-builder-options/runedit_posts (собствена проверка на REST маршрута)няма
pbs/get-white-label
Връща настройките за бял етикет (white-label): включено или изключено, показваното име и кои потребители все още виждат оригинала.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/get-white-label/runmanage_options (собствена проверка на REST маршрута)няма
pbs/import-design
Проверява файл с дизайн на сайта (file) и при зададен apply false връща какво би добавило, променило и премахнало сливането или замяната (mode); при apply true записва промените.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/import-design/runedit_theme_options (собствена проверка на REST маршрута)file обект (задължително)
mode низ: merge, replace
apply булева стойност
pbs/import-designs
Внася пакет с дизайни на Page Builder Sandwich (първо използвайте dryRun, за да видите какво би се променило; mode: skip или replace; media; settings).
БезплатноPOST /wp-json/wp-abilities/v1/abilities/pbs/import-designs/runmanage_options (собствена проверка на REST маршрута)package обект (задължително)
mode низ: skip, replace, duplicate
settings булева стойност
media булева стойност
dryRun булева стойност
pbs/import-figma-frame
Импортира една рамка от Figma (url: връзката към рамката с нейния node-id) в нова чернова на страница, съставена от блокове: автоматичното оформление се превръща в контейнери flex и grid, текстът запазва шрифтовете и размерите си, а изображенията се копират в медийната библиотека. Използва собствения токен за Figma на сайта. Връща черновата и отчет за преобразуването.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/import-figma-frame/runedit_pages и upload_files (собствена проверка на REST маршрута)url низ (задължително)
title низ
dryRun булева стойност
status низ: draft, pending, private, publish
pbs/invite-team-member
Създава еднократен код за покана (роля: read или write; етикет; валидност в дни). Кодът се показва само веднъж.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/invite-team-member/runmanage_options (собствена проверка на REST маршрута)team низ (задължително)
role низ: read, write
days цяло число
label низ
pbs/join-team
Присъединява към екипна библиотека с код за покана.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/join-team/runmanage_options (собствена проверка на REST маршрута)code низ (задължително)
pbs/leave-team
Напуска екипната библиотека, към която сайтът се е присъединил.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/leave-team/runmanage_options (собствена проверка на REST маршрута)няма
pbs/list-ab-tests
Извежда списък с A/B тестовете заедно с посетителите и реализациите за всяка версия, както и коя от тях е водеща.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-ab-tests/runedit_pages (собствена проверка на REST маршрута)няма
pbs/list-blocks
Извежда списък с всички блокове на Page Builder Sandwich, достъпни за сайта (също и блоковете от Pro версията, когато тя е активна): име, заглавие, категория и описание.
Безплатна версияGET /wp-json/wp-abilities/v1/abilities/pbs/list-blocks/runedit_postssearch низ
pbs/list-dynamic-sources
Връща източниците, от които може да се попълва блок (публикация, автор, сайт, архив, потребителско поле, продукт), заедно с полетата на всеки източник, разширенията за полета на сайта (ACF, Meta Box, Pods, JetEngine, Toolset, метаданни на публикация) и полетата на даден тип публикация (postType). Блокът се свързва с източник чрез attributes.metadata.bindings — по едно съответствие {source, args} за всеки атрибут.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-dynamic-sources/runedit_posts (собствена проверка на REST маршрута)postType низ
pbs/list-extensions
Извежда списък с допълненията, добавени към Page Builder Sandwich от други разширения чрез неговия API за разработчици: блокове, динамични източници на данни, условия за показване и действия във формуляри, всяко с име, етикет и разширение.
Безплатна версияGET /wp-json/wp-abilities/v1/abilities/pbs/list-extensions/runedit_postsняма
pbs/list-form-submissions
Извежда списък с подадените от посетителите данни през формулярите, които запазват подавания (параметърът form ограничава обхвата), страница по страница.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-form-submissions/runсобствена проверка на правата за всеки елемент от REST маршрутаform низ
per_page цяло число
page цяло число
pbs/list-forms
Извежда списък с формулярите, създадени с блока Form, и разширенията за формуляри, които могат да се вграждат.
Безплатна версияGET /wp-json/wp-abilities/v1/abilities/pbs/list-forms/runedit_posts (собствена проверка на REST маршрута)няма
pbs/list-kits
Извежда списък с готовите пакети от страници за уебсайтове (набор от готови страници за определен тип дейност), които сайтът може да импортира.
Безплатна версияGET /wp-json/wp-abilities/v1/abilities/pbs/list-kits/runedit_pages и publish_pagesrefresh булева стойност
pbs/list-library-items
Извежда списък със запазените в облачната библиотека дизайни (kind: раздел, страница или шаблон; team: библиотека на екип).
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-library-items/runedit_posts (собствена проверка на REST маршрута)team низ
kind низ: , section, page, style
pbs/list-local-fonts
Извежда списък с шрифтовете на Google, хоствани локално на сайта (изтеглят се еднократно, зареждат се директно от сайта, без заявки към Google).
Безплатна версияGET /wp-json/wp-abilities/v1/abilities/pbs/list-local-fonts/runmanage_options (собствена проверка на REST маршрута)няма
pbs/list-lottie
Извежда списък с качените Lottie анимации.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-lottie/runedit_posts (собствена проверка на REST маршрута)няма
pbs/list-marketing-connections
Извежда списък с платформите за имейл маркетинг (Mailchimp, Brevo, MailerLite, Kit, ActiveCampaign) и показва кои от тях са свързани. Ключовете никога не се връщат.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-marketing-connections/runmanage_options (собствена проверка на REST маршрута)няма
pbs/list-marketing-forms
Извежда списък с всички формуляри, създадени с конструктора на формуляри: страницата, на която се намират, техните полета и действието при изпращане.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-marketing-forms/runedit_pages (собствена проверка на REST маршрута)няма
pbs/list-marketing-lists
Извежда списък с аудиториите или списъците на свързана услуга за бюлетини, за действието по абониране на даден формуляр.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-marketing-lists/runedit_posts (собствена проверка на REST маршрута)service низ (задължително)
pbs/list-pages
Извежда страниците, които можете да редактирате, подредени от най-новите, с възможност за търсене.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/list-pages/runedit_pages; извеждат се само страници, които потребителят има право да редактираsearch низ
status низ: any, draft, pending, publish, private
page цяло число
per_page цяло число
pbs/list-popups
Извежда изскачащите прозорци, плъзгащите се панели и лентите заедно с техните задействания, правила за честота и места на показване.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-popups/runedit_pages (собствена проверка на REST маршрута)няма
pbs/list-replace-jobs
Извежда задачите за търсене и замяна в целия сайт и тяхното състояние.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-replace-jobs/runmanage_options (собствена проверка на REST маршрута)няма
pbs/list-sections
Извежда готовите секции (заглавна част, функции, ЧЗВ, отзиви, призив за действие и други), които могат да бъдат добавени към страница.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/list-sections/runedit_pagessearch низ
pbs/list-team-members
Извежда сайтовете в даден екип и техните нива на достъп.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-team-members/runmanage_options (собствена проверка на REST маршрута)team низ (задължително)
pbs/list-teams
Извежда екипите, към които този сайт принадлежи или притежава.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-teams/runmanage_options (собствена проверка на REST маршрута)няма
pbs/list-theme-templates
Извежда шаблоните от конструктора на теми (шапка, футър, единична публикация, архив, търсене, 404 и при наличие на WooCommerce – продукт, магазин, количка, поръчка, страница с благодарност и „Моят профил“): вида на всеки от тях, къде се показва (правила за включване/изключване), приоритет, статус и блокове.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/list-theme-templates/runсобствена проверка на правата на REST маршрута за всеки елементняма
pbs/list-transferable
Извежда шаблоните, готовите елементи и настройките, които могат да бъдат експортирани към друг сайт.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/list-transferable/runmanage_options (собствена проверка на REST маршрута)няма
pbs/list-uploaded-icons
Извежда SVG иконите, качени в библиотеката с икони, от най-новите към по-старите.
FreeGET /wp-json/wp-abilities/v1/abilities/pbs/list-uploaded-icons/runedit_posts (собствена проверка на REST маршрута)page цяло число
per_page цяло число
pbs/move-section
Премества секция на страница от една позиция на друга (индексирано от 0, според подредбата им в страницата).
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/move-section/runedit_post за съответната страницаid цяло число (задължително)
from цяло число (задължително)
to цяло число (задължително)
pbs/open-support-ticket
Подава запитване за поддръжка (тема, съобщение, вид, имейл), заедно с диагностичните данни на сайта, ако администраторът е дал съгласие. Никога не създава и не изпраща данни за вход.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/open-support-ticket/runmanage_options (собствена проверка на REST маршрута)subject низ (задължително)
message низ (задължително)
kind низ: help, bug, feedback, feature_request
email низ
name низ
diagnostics булева стойност
pbs/preview-dynamic-value
Връща стойността, която дадено свързване показва в дадена публикация (публикация, източник и поле или доставчик + ключ, във формат text|url), за проверка на свързването преди или след добавянето му.
ProGET /wp-json/wp-abilities/v1/abilities/pbs/preview-dynamic-value/runedit_post (собствена проверка на REST маршрута)post цяло число (задължително)
source низ (задължително)
field низ
provider низ
key низ
as низ: text, url
pbs/record-support-consent
Записва съгласието на администратора за изпращане на диагностични данни със запитванията за поддръжка.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/record-support-consent/runmanage_options (собствена проверка на REST маршрута)consent булева стойност (задължително)
pbs/refresh-reviews
Извлича най-новите отзиви от Trustpilot веднага, вместо да се чака ежедневното опресняване.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/refresh-reviews/runmanage_options (собствена проверка на REST маршрута)няма
pbs/remove-block
Премахва блок (цяла секция или блок в рамките на секция) от страница по зададен път. Предишната версия на страницата се запазва в нейните редакции.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/remove-block/runedit_post за съответната страницаid цяло число (задължително)
path масив (задължително)
pbs/remove-library-storage
Премахва настройките за собствено хранилище; отново се използва хранилището от плана.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/remove-library-storage/runmanage_options (собствена проверка на REST маршрута)няма
pbs/remove-local-font
Изтрива файловете на локално хоствано семейство шрифтове.
БезплатнаPOST /wp-json/wp-abilities/v1/abilities/pbs/remove-local-font/runmanage_options (собствена проверка на REST маршрута)family низ (задължително)
pbs/remove-team-member
Премахва сайт от екип.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/remove-team-member/runmanage_options (собствена проверка на REST маршрута)team низ (задължително)
member низ (задължително)
pbs/reset-ab-test
Нулира броячите на даден тест и го стартира отново (test).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/reset-ab-test/runedit_pages (собствена проверка на REST маршрута)test низ (задължително)
pbs/save-library-item
Запазва съдържанието на блок (заглавие, вид, разметка, стилове, етикети) в личната ви облачна библиотека или в тази на екип; изображенията се пакетират заедно с него.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/save-library-item/runedit_posts (собствена проверка на REST маршрута)team низ
kind низ (задължително): section, page, style
title низ (задължително)
tags масив
markup низ
styles обект
pbs/set-block-motion
Задава или премахва (null) настройки за анимация на блок от страница, открит по своя път, при определена контролна точка (по подразбиране: базова). Работи за всеки блок, включително вградените блокове, чийто HTML се запазва в страницата. Посетителите с предпочитание за намалено движение не виждат анимациите.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/set-block-motion/runedit_post (собствена проверка на REST маршрута)post низ (задължително)
path масив (задължително)
breakpoint низ
motion обект (задължително)
pbs/set-library-storage
Запазва собствено хранилище: доставчик (r2 или s3), контейнер (bucket), регион, крайна точка (endpoint), префикс, key_id, тайна (secret), enabled.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/set-library-storage/runmanage_options (собствена проверка на REST маршрута)enabled булев
provider низ: r2, s3, other
endpoint низ
region низ
bucket низ
prefix низ
keyId низ
secret низ
pathStyle булев
pbs/set-maintenance
Включва или изключва режим на поддръжка (503) или „Очаквайте скоро“ (mode), със страница за показване (page_id), retry_after и ролите, които го заобикалят.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/set-maintenance/runmanage_options (собствена проверка на REST маршрута)mode низ: off, maintenance, coming_soon
page_id цяло число
roles масив
retry_after цяло число
pbs/set-newsletter-keys
Запазва (или изтрива при празна стойност) API ключа за Mailchimp, използван от блока за бюлетин.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/set-newsletter-keys/runmanage_options (собствена проверка на REST маршрута)mailchimp низ (задължително)
pbs/set-reviews-sources
Задава обекта в Google и фирмата в Trustpilot, от които блокът за отзиви чете информация.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/set-reviews-sources/runmanage_options (собствена проверка на REST маршрута)google обект
trustpilot обект
pbs/set-roles
Задава по роли какво разрешава конструкторът (roles), напр. клиентска роля само за съдържание.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/set-roles/runmanage_options (собствена проверка на REST маршрута)roles обект (задължително)
pbs/set-white-label
Включва или изключва ребрандирането (white label) и задава името, което виждат клиентите (enabled, name, agency_users).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/set-white-label/runmanage_options (собствена проверка на REST маршрута)enabled булев
name низ
studio_name низ
author низ
author_url низ
description низ
menu_icon низ
hide_plugin булев
agency_users масив
pbs/site-health-clean
Почиства един вид намерени елементи: редакции (запазва последните 5 за всяка публикация, изтрива по-старите), синхронизирани образци (премества неизползваните в кошчето), изображения (мащабирано копие за WordPress; оригиналът се пази), класове (премахва неизползваните дизайнерски класове, запазени за възстановяване). Всяко изпълнение изчиства една партида; „more“ има стойност true, докато има останали находки.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/site-health-clean/runmanage_optionswhat низ (задължително): revisions, patterns, images, classes
pbs/site-health-report
Открива стари ревизии, неизползвани синхронизирани модели, тежки оригинални изображения и дизайн класове, които нито една страница не използва. Работи на кратки стъпки: всяко изпълнение продължава оттам, където е спряло предишното, докато състоянието е „scanning“; рестартирането започва отначало.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/site-health-report/runmanage_optionsrestart булева стойност
pbs/start-migration
Стартира (или рестартира) преобразуването на всяка страница от 5.x в блокове; за всяка публикация първо се създава резервно копие.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/start-migration/runсобствена проверка на правата за всеки елемент на REST маршрутаняма
pbs/start-replace
Стартира безопасно за блоковете търсене и замяна (find, replace, вид: text, link или colour; match_case; types). Нищо не се променя, докато прегледаната задача не бъде приложена.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/start-replace/runmanage_options (собствена проверка на REST маршрута)find низ (задължително)
replace низ
kind низ: text, link, colour
types масив
match_case булева стойност
pbs/start-trial
Активира 14-дневен пробен период на Page Builder Sandwich Pro за този сайт (не се изисква плащане).
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/start-trial/runmanage_options (собствена проверка на REST маршрута)няма
pbs/test-library-storage
Записва, прочита и изтрива тестов обект в собственото ви хранилище и докладва за всяка стъпка.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/test-library-storage/runmanage_options (собствена проверка на REST маршрута)няма
pbs/undo-convert-post
Възстановява една преобразувана страница от нейното резервно копие.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/undo-convert-post/runсобствена проверка на правата за всеки елемент на REST маршрутаid низ (задължително)
pbs/undo-migration
Възстановява всяка преобразувана публикация от нейното резервно копие.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/undo-migration/runсобствена проверка на правата за всеки елемент на REST маршрутаняма
pbs/undo-replace
Възстановява публикациите, променени от дадена задача (публикация, редактирана след това, запазва редакцията си).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/undo-replace/runmanage_options (собствена проверка на REST маршрута)id низ (задължително)
pbs/update-block
Променя настройките (атрибутите) на даден блок в страницата, открит по своя път; изпратените атрибути се обединяват с текущите. Работи за блокове, които сайтът визуализира от техните настройки; блок, чийто HTML код се съхранява в страницата, се променя чрез замяна на маркирането на страницата.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/update-block/runedit_post за съответната страницаid цяло число (задължително)
path масив (задължително)
attributes обект (задължително)
pbs/update-brand-kit
Запазва бранд комплекта: име, лого, цветове, шрифтове за заглавия и основен текст, както и тона на комуникация, използван от AI писането.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-brand-kit/runedit_theme_options (собствена проверка на REST маршрута)name низ
logo цяло число
colors масив
headingFont низ
bodyFont низ
voice низ
pbs/update-breakpoints
Променя ширините в пиксели за таблет и мобилни устройства; с Pro версията са налични и допълнителни потребителски точки на пречупване.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/update-breakpoints/runedit_theme_options (собствена проверка на REST маршрута)tablet цяло число
mobile цяло число
custom масив
pbs/update-class
Променя етикета, слъга или стиловете на глобален клас; всеки елемент, който го използва, се обновява.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-class/runedit_theme_options (собствена проверка на REST маршрута)id низ (задължително)
label низ
slug низ
s обект
cat низ
pbs/update-conversion-tracking
Променя настройките за Google Analytics 4, Google Tag Manager и Meta Pixel, както и кои събития се изпращат.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-conversion-tracking/runmanage_options (собствена проверка на REST маршрута)ga4 низ
gtm низ
pixel низ
loadTags булева стойност
formEvent низ
pbs/update-cookie-banner
Променя банера за съгласие. Докато е включен, проследяващите скриптове изчакват съгласието на посетителя.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-cookie-banner/runmanage_options (собствена проверка на REST маршрута)enabled булева стойност
popup цяло число
handles масив
cookieDays цяло число
optOutOutsideEu булева стойност
pbs/update-dark-mode
Задава тъмния режим (режим: off, auto или toggle) и неговите цветове.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-dark-mode/runedit_theme_options (собствена проверка на REST маршрута)mode низ (задължително): device, light, dark
colors обект
pbs/update-design-categories
Заменя списък с категории (group: classes или tokens; items: списък с кратко име и наименование). Записите, причислени към премахната категория, остават без категория.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-design-categories/runedit_theme_options (собствена проверка на REST маршрута)group string (задължително): classes, tokens
items array (задължително)
pbs/update-design-globals
Променя глобалните цветове за сайта (colors), шрифтовете (fonts, headingFont, bodyFont). Всяка страница приема промяната; файлът theme.json на темата се поддържа синхронизиран.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/update-design-globals/runedit_theme_options (собствена проверка на REST маршрута)colors object
fonts object
bodyFont string
headingFont string
pbs/update-form
Променя формуляр (post, form): настройките и действията се обединяват със съществуващите; полетата (и стъпките) заменят досегашните полета.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-form/runedit_post (собствена проверка на REST маршрута)post string (задължително)
form string (задължително)
title string
fields array
steps array
actions object
submitText string
successMessage string
redirectUrl string
trackEvent string
pbs/update-page
Променя заглавието, състоянието или блок-съдържанието на страница. Изпратеното съдържание заменя съдържанието на страницата.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/update-page/runedit_post за съответната страница; publish_pages за публикуване или задаване като личноid integer (задължително)
title string
status string: draft, pending, publish, private
sections array
content string
pbs/update-popup
Променя изскачащ прозорец, плъзгащ се панел или лента (id): съдържание, задействане, честота или къде да се показва.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-popup/runedit_post (собствена проверка на REST маршрута)id string (задължително)
title string
content string
status string: draft, publish
settings object
pbs/update-settings
Променя префикса на класовете за потребителската част (1 до 8 малки букви или цифри, започващи с буква) и/или включва/изключва AI агентите (MCP) (mcp: false премахва всяка възможност и крайната точка на MCP).
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/update-settings/runmanage_options (собствена проверка на REST маршрута)prefix string
mcp boolean
pbs/update-theme-template
Променя шаблон (id): някое от следните – заглавие, тип, съдържание (маркиране с блокове), включване, изключване, приоритет, състояние. Променя се само изпратеното.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-theme-template/runсобствена проверка за права за всеки елемент на REST маршрутаid string (задължително)
title string
type string
content string
include array
exclude array
priority integer
status string: publish, draft
pbs/update-tokens
Променя скалите за отстояния, заобляне на ъгли и сенки (space, radius, shadow) или ги нулира (reset).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-tokens/runedit_theme_options (собствена проверка на REST маршрута)space array
radius array
shadow array
reset boolean
pbs/update-variables
Заменя променливите за дизайн на сайта (variables: списък от име и стойност).
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/update-variables/runedit_theme_options (собствена проверка на REST маршрута)variables array (задължително)
pbs/upload-icon
Добавя SVG икона (name, svg маркиране) към библиотеката с икони; SVG файлът се валидира предварително.
FreePOST /wp-json/wp-abilities/v1/abilities/pbs/upload-icon/runupload_files (собствена проверка на REST маршрута)name string (задължително)
svg string (задължително)
pbs/upload-lottie
Валидира Lottie JSON документ (json, name) и го публикува като статичен файл за Lottie блока.
ProPOST /wp-json/wp-abilities/v1/abilities/pbs/upload-lottie/runupload_files (собствена проверка на REST маршрута)name string (задължително)
json string (задължително)

Генерирано от файла abilities.json на разширението, който сам по себе си е генериран от работещ сайт; тестът се проваля, когато двете се различават.

WP-CLI команди

Изпълнявайте ги на сървъра с WP-CLI. Всяка команда проверява същите права като екраните на разширението; примерите са взети от самия помощен текст на разширението.

КомандаДействиеИздание
wp pbs export [--types=<types>] [--no-settings] [--file=<name>]Експортиране на шаблони, мотиви и настройки във файл.Безплатна
wp pbs import <file> [--mode=<mode>] [--no-settings] [--media] [--dry-run]Импортиране на файл за експорт.Безплатна
wp pbs importers runКонвертиране на остаряло съдържание: всички публикации или една.Безплатна
wp pbs importers statusПоказване на състоянието на миграцията.Безплатна
wp pbs importers undoОтмяна на конвертиранията от резервните копия: всички публикации или една.Безплатна
wp pbs migrate runКонвертиране на остаряло съдържание: всички публикации или една.Безплатна
wp pbs migrate statusПоказване на състоянието на миграцията.Безплатна
wp pbs migrate undoОтмяна на конвертиранията от резервните копия: всички публикации или една.Безплатна
wp pbs replace <find> <replace> [--kind=<kind>] [--types=<types>] [--ignore-case] [--dry-run] [--undo=<job>]Търсене и замяна в целия сайт.Pro
wp pbsw fonts download <family> [--weights=<weights>] [--italic]Изтегляне на фамилия шрифтове от Google Fonts в сайта.Безплатна
wp pbsw fonts listСписък на съхранените фамилии.Безплатна
wp pbsw fonts remove <family>Премахване на съхранена фамилия и нейните файлове.Безплатна

Действия и филтри

Всяка кука (hook), която разширението предлага, с описанието от неговия изходен код. Филтрите променят стойност; действията ви позволяват да изпълните код в даден момент; входните точки са действия, които задействате, за да накарате разширението да извърши нещо.

КукаВидДействиеПараметриИздание
pbs_assets_changedДействиеЗадейства се при промяна на публикуваните публични файлове на PBS и изчистване на достъпните кешове на страници: използвайте го за изчистване на недостъпните за PBS ресурси (CDN, прокси, кеш на хостинга).нямаБезплатна
pbs_enqueue_scriptsДействиеОстаряло действие: нареждане на скриптове, извикващи window.pbsAddInspector().нямаБезплатна
pbs_shortcodesФилтърОстарял филтър: етикет на краткия код => {label, desc, options[]} (Shortcode-API.md).array $shortcodesБезплатна
pbsw_admin_dataФилтърФилтрира данните, с които се зарежда административният интерфейс. Премиум модулът го използва за съобщаване на своето издание; тук не бива да присъства чувствителна информация, тъй като се отпечатва в страницата.нямаБезплатна
pbsw_admin_enqueueДействиеЗадейства се след нареждането на скрипта за административния екран, позволявайки на даден модул да нареди скрипт за добавяне на панел чрез JavaScript филтъра `pbs.admin.panels` (трябва да зависи от този идентификатор; екранът се рендерира при готовност на DOM, след изпълнението на всички скриптове във футъра).string $handleБезплатна
pbsw_ai_enqueueДействиеЗадейства се след нареждането на AI пакета за редактора, така че разширение (и Pro модулът) да могат да наредят собствени AI панели след него.string $handleБезплатна
pbsw_ai_messagesФилтърФилтрира съобщенията на всяка AI заявка, изпращана от разширението, заедно с нейния контекст (задача, цел, доставчик, модел, потребител); фирменият пакет на Pro добавя бранда ви тук.array $messages
array $context
Безплатна
pbsw_ai_pro_featuresФилтърФилтрира Pro AI функциите, които редакторът предлага (премиум модулът добавя своите имена: agent, site, block, design, image, css, a11y).нямаБезплатна
pbsw_ai_seo_pluginsФилтърФилтрира кои SEO разширения получават мета заглавието и описанието от AI SEO помощника.нямаБезплатна
pbsw_ai_seo_writeФилтърФилтрира дали друго SEO разширение е приело мета заглавието и описанието. Разширение, добавено в `pbsw_ai_seo_plugins`, ги записва тук по свой начин и връща стойност true.bool $written
string $plugin
int $post_id
string $title
string $description
Безплатна
pbsw_asset_sourcesФилтърВсички публични източници: за този файл, регистрираните от слоя за производителност с add_source() (CSS на ниво блок, изгледни модули) и добавените от премиум модула за собствени нужди чрез `pbsw_asset_sources` (файловете му се намират в негова собствена директория, налична само в премиум пакета). Приемат се само стандартни относителни пътища към `.css`/`.js` файлове в разширението, под ключ от малки сегменти (`legacy.css`, `block/row.css`, `module/tabs.js`).нямаБезплатна
pbsw_breakpoints_changedДействиеЗадейства се при промяна на точките на пречупване (компилираните стилове на страниците се преизграждат при следващото им преглеждане, тъй като точките на пречупване са част от техния сигнатурен хеш).нямаБезплатна
pbsw_cache_purgedДействиеЗадейства се, след като PBS изчисти публикация от активните разширения за кеширане.int $post_idБезплатна
pbsw_cache_purgersФилтърФилтрира допълнителните модули за изчистване при промяна на публикуваните файлове: име => функция. Хостинг доставчикът добавя свои собствени (CDN, прокси); модул, който предизвика грешка, се пропуска и не се отчита като изчистен.нямаБезплатна
pbsw_code_blocksФилтърФилтрира имената на блоковете, третирани като персонализиран код (само роли с правото `code` могат да ги добавят или променят).нямаPro
pbsw_consent_countryФилтърФилтрира държавата на посетителя (ISO 3166-1 алфа-2) за регионалното правило на банера за бисквитки. Разширението никога не проверява държавата самостоятелно; върнете “, когато тя е неизвестна.string $countryPro
pbsw_content_onlyФилтърФилтрира дали потребителят има право да редактира само текст и изображения при заключено оформление.bool $content_only
int $user_id
Безплатна
pbsw_design_class_cssФилтърФилтрира компилирания CSS на глобален клас преди извикването на дизайнерския механизъм. Върнете низ, за да го използвате вместо него.string|null $css
string $selector
Pro
pbsw_design_custom_breakpointsФилтърФилтрира дали са достъпни персонализирани точки на пречупване (pbs-d3, Pro).bool $allowedБезплатна
pbsw_design_element_cssФилтърФилтрира дали се компилира персонализиран CSS на ниво елемент (премиум модулът го активира, d8).bool $enabledБезплатна
pbsw_design_layout_suffixФилтърФилтрира суфикса на селектора за оформление на даден блок (“ = собственият елемент на блока).string $suffix
string $prefix
Безплатна
pbsw_design_propsФилтърФилтрира дизайнерските свойства (премиум модулът добавя свои).нямаБезплатна
pbsw_dynamic_editor_sourcesФилтърДопълнителни източници в редактора (полета за продукти на WooCommerce).нямаPro
pbsw_dynamic_fieldsФилтърКаталог с полета за доставчици без API за извличане на списъци, с което разполага разширението (JetEngine, Toolset): техните ключове на полета се въвеждат в редактора или се добавят тук.string $post_typePro
pbsw_dynamic_sourcesФилтърДопълнителни източници (продукти на WooCommerce): име → етикет; стойностите им идват от `pbsw_dynamic_value`.нямаPro
pbsw_dynamic_valueФилтърСтойност от друг източник (WooCommerce).string|null $value
string $source
Pro
pbsw_form_submittedДействиеЗадейства се след успешно преминала валидация на изпратен формуляр и изпълнение на неговите действия.нямаPro
pbsw_frontend_prefixФилтърФилтрира неутралния префикс за класове във визуалната част.string $prefixБезплатна
pbsw_fs_loadedДействиеЗадейства се след зареждане на SDK-то за лицензиране (в основния файл, преди какъвто и да е код на Page Builder Sandwich). Закачете се тук за връзка с `pbsw_fs()`.нямаБезплатна
pbsw_is_agencyФилтърФилтрира дали възможностите на план Agency са достъпни на този сайт.bool $agencyБезплатна
pbsw_is_proФилтърФилтрира дали работи платената функционалност. Само платеният слой отговаря на това.bool $proБезплатна
pbsw_kit_api_baseФилтърФилтрира базовия URL адрес на Zinn Digital® API, към който се обръщат екраните за поддръжка.string $baseБезплатна
pbsw_kit_diagnosticsФилтърФилтрира диагностичните данни, преди собственикът на сайта да ги види. Разширението добавя собствена информация под `extra`. ⛔ Това се изпълнява ПРЕДИ предварителния преглед, никога между прегледа и изпращането.нямаБезплатна
pbsw_kit_footprint_freeФилтърФилтрира дали сайтът е без дигитален отпечатък, така че Zinn® Ads никога да не се рекламира на него.bool $footprint_freeБезплатна
pbsw_kit_importedДействиеЗадейства се след импортиране на комплект (kit).int $frontБезплатна
pbsw_kit_promotionsФилтърФилтрира регистъра с промоции преди неговата обработка. Добавете ред за промотиране на друг продукт: `id`, `kind` (hosting|marketplace|platform|plugin|bundle|membership|ads), `slot` (promo|cross-sell) и `url` или (за разширение) `name`, `site`, `main_files`.нямаБезплатна
pbsw_kit_tierФилтърФилтрира нивото на абонаментния план, което комплектът отчита за това разширение (тестове и междинна среда; при реална среда определя лицензът).string $tierБезплатна
pbsw_lcp_foldФилтърРазстоянието в съдържанието, което се счита за първи екран, в CSS пиксели от горния край. Блоковете над тази граница се третират като намиращи се в видимата част без превъртане: изображенията им се зареждат веднага, а най-вероятното LCP изображение получава `fetchpriority=“high“`; блоковете под нея се зареждат с отложено зареждане (lazy-load). Увеличете стойността при висок начален банер (hero) и я намалете при компактна заглавна част.int $foldБезплатна
pbsw_legacy_body_classesФилтърФилтрира класовете на body от наследената версия. Платеният слой добавя наследените адаптивни класове от платената версия тук (насока 5: това поведение не присъства в безплатното разширение).нямаБезплатна
pbsw_legacy_script_enqueuedДействиеНаследена публикация беше анализирана за поведението ѝ във визуалната част (платеният слой добавя собствено такова).int $post_id
string $content
string|null $handle
Безплатна
pbsw_library_tokenФилтърФилтрира bearer токена, изпратен със заявките за комплекта (осигурява се от платената облачна библиотека).string $tokenБезплатна
pbsw_link_baseФилтърФилтрира пътя, под който се намират кратките връзки (`/go/<slug>/`).string $basePro
pbsw_list_servicesФилтърФилтрира услугите за бюлетини, към които формулярите могат да абонират потребители.нямаPro
pbsw_loop_query_argsФилтърЗаявката на цикъла (WooCommerce: ценови диапазон, на промоция, в наличност, сортиране по цена/популярност/рейтинг).нямаPro
pbsw_loop_sortsФилтърВъзможности за сортиране (WooCommerce добавя цена, популярност и рейтинг).нямаPro
pbsw_mcp_abilitiesДействиеЗадейства се след регистриране на безплатните възможности: Page Builder Sandwich Pro регистрира своите тук (при първоначално зареждане това се закача само когато лицензът позволява платения код).нямаБезплатна
pbsw_migration_batch_sizeФилтърБрой наследени публикации (5.x), които се конвертират при една фонова стъпка на миграция. Всяка стъпка е едно действие в Action Scheduler; по-малък пакет е подходящ за бавен или ограничен откъм памет хостинг, а по-голям – за бърз сървър с много публикации. Стойности под 1 се третират като 1.int $sizeБезплатна
pbsw_migration_post_typesФилтърФилтрира типовете публикации, които миграцията от наследената версия конвертира.list<string> $typesБезплатна
pbsw_nav_menu_item_classesФилтърФилтрира класовете на елемент (настройките на елемента в Pro добавят `nav-menu__item–hide-mobile` и `–hide-desktop`). Запазват се само класове от вида `nav-menu__item–<име>`.int $depthБезплатна
pbsw_nav_menu_item_labelФилтърФилтрира етикета на елемент, представляващ екраниран HTML (настройките на елемента в Pro добавят икона, значка и описанието). Функция за обратно извикване трябва да връща екраниран HTML.string $label
int $depth
string $prefix
Безплатна
pbsw_nav_menu_toggleФилтърФилтрира HTML кода на бутона за меню: дизайнерът на лентата за превключване в Pro го поставя в лента с лого, поле за търсене, връзки… (показва се само при сгънато меню). Резултат, който не съдържа бутона в непроменен вид, се игнорира, за да не се загуби от менюто.string $toggle
string $prefix
Безплатна
pbsw_newsletter_form_settingsФилтърНастройките на форма, различна от версия 5.x (data-* ⇒ стойност), или празен масив.int $post_id
string $form
Безплатна
pbsw_newsletter_providersФилтърУслугите за бюлетин, към които сайтът може да записва абонати: услуга ⇒ callable( string $email, array $settings ): array{ok: bool, message: string}. Платеният слой добавя трите услуги от версия 5.x.нямаБезплатна
pbsw_page_css_changedДействиеЗадейства се при промяна на компилирания стилов файл на публикация (приставките за кеширане изчистват кеша при него).int $post_idБезплатна
pbsw_page_css_enqueuedДействиеЗадейства се след нареждане на компилирания стилов файл на страница на опашката (платеният слой за критичен CSS се закача тук).string $handle
int $post_id
Безплатна
pbsw_page_css_extraФилтърФилтрира CSS кода, добавен към компилирания стилов файл на страница след собствените стилове на блоковете (pbs-p4: правилата `.<prefix>-s-<id>` от дизайн системата). Компилиран, но не и минифициран тук: слушателят връща CSS, готов за зареждане.string $extra
string $prefix
int $post_id
Безплатна
pbsw_page_css_signatureФилтърФилтрира допълнителните фактори, определящи компилираното състояние като актуално (pbs-p4: точките на пречупване).string $extra
\WP_Post $post
Безплатна
pbsw_page_css_stateФилтърФилтрира компилираното състояние на публикация преди записването му (pbs-p4 отбелязва кои дизайнерски правила се съдържат в стиловия файл, за да не се извеждат повторно от филтъра за рендиране).int $post_idБезплатна
pbsw_permissionФилтърФилтрира дали потребител има право да използва дадена възможност на визуалния редактор. Безплатната приставка разрешава всички; мениджърът на роли в Pro определя правата според ролята. Администраторите винаги трябва да имат права.bool $allowed
string $what
int $user_id
Безплатна
pbsw_popup_forceФилтърИзскачащи прозорци, показвани на всяка страница независимо от правилата за насочване (лентата за бисквитки).нямаPro
pbsw_replace_post_typesФилтърФилтрира типовете публикации, в които търсенето и замяната търсят по подразбиране.нямаPro
pbsw_schema_skipФилтърФилтрира типовете структурирани данни, които Page Builder Sandwich пропуска, тъй като SEO приставката на сайта вече ги извежда за тази страница.string $contentPro
pbsw_site_design_dataФилтърФилтрира първоначалните данни на Дизайн на сайта. Платеният слой съобщава своята версия и добавя данните, необходими за разделите му.нямаБезплатна
pbsw_site_design_depsФилтърФилтрира зависимостите на пакетите за Дизайн на сайта. Платеният слой добавя своя скрипт тук, така че разделите му да бъдат регистрирани преди първото рендиране на панела.string $handleБезплатна
pbsw_site_health_keep_revisionsФилтърФилтрира колко от най-новите редакции на всяка публикация се запазват при почистване (по подразбиране 5).int $keepPro
pbsw_style_at_rulesФилтърФилтрира готовите at-правила, предлагани от редактора на стилове в Стил › Условие: списък от `array( ‘id’ => ‘narrow-card’, ‘label’ => ‘Narrow card’, ‘type’ => ‘container’, ‘query’ => ‘card (max-width:400px)’ )`, където `type` е `media`, `container` или `supports`. Стойностите, зададени под дадено условие, се извеждат като `@<type> <query>{…}` след правилата за размер на екрана. Вградените шаблони са за печат, тъмна цветова схема, намалено движение и мишка или тракпад; невалидните шаблони се отхвърлят и посочват в действието `pbsw_style_at_rules_invalid`.нямаБезплатна
pbsw_style_at_rules_invalidДействиеЗадейства се при отхвърляне на невалидни шаблони от `pbsw_style_at_rules`.нямаБезплатна
pbsw_template_content_locationФилтърПо-конкретно местоположение на съдържанието (WooCommerce: single_product, product_archive, cart…).string $locationPro
pbsw_template_resolvedФилтърИзбраните шаблони за дадено местоположение.string $typePro
pbsw_template_typesФилтърДопълнителни типове шаблони (страници на WooCommerce).нямаPro
pbsw_theme_builder_editor_dataФилтърОще данни за редактора (динамични източници на данни и добавки за полета, елементите на WooCommerce).нямаPro
pbsw_theme_globals_savedДействиеТова действие е документирано по-долу.нямаFree
pbsw_transfer_importedДействиеЗадейства се след импортиране на пакет, за да могат кешовете, изградени от шаблони и настройки (стиловете за всяка страница, стиловият лист на сайта), да бъдат изградени отново.нямаFree
pbsw_transfer_meta_keysФилтърФилтрира мета ключовете на публикациите, които импортирането и експортирането пренасят с всеки елемент.нямаFree
pbsw_transfer_optionsФилтърФилтрира настройките, които импортирането и експортирането могат да прехвърлят между сайтове. Приемат се само настройки с `pbsw_`; всичко останало се отхвърля, така че даден пакет никога да не може да запише системна или външна настройка.нямаFree
pbsw_transfer_post_typesФилтърФилтрира типовете публикации, които импортирането и експортирането могат да прехвърлят между сайтове.нямаFree
pbsw_visitor_countryФилтърФилтрира държавата на посетителя за възрастовата проверка и известията за отговорен хазарт при сайтове, които я определят по друг начин (добавка за геолокация, потребителски профил).string $countryPro
pbsw_white_label_mapФилтърФилтрира заместванията за white-label (изходен текст => показван текст).нямаPro