Референца способности
Способности су атомске радње које Gratis AI Agent може да позове у вашој WordPress инсталацији. Свака способност је регистрована PHP класа која излаже JSON шему — агент чита ову шему током извршавања да би разумео који су параметри потребни и шта способност враћа.
Ова страница документује све способности које се испоручују уз Gratis AI Agent v1.9.0.
Прилагођени типови објава
Ове способности управљају прилагођеним типовима објава (CPT) регистрованим преко агента. Регистрације се чувају у WordPress табели опција, тако да опстају након деактивације и поновне активације plugin-а.
register_post_type
Региструје нови прилагођени тип објаве.
Параметри
| Параметар | Тип | Обавезно | Опис |
|---|---|---|---|
slug | string | Да | Кључ типа објаве (највише 20 знакова, без великих слова, без размака) |
singular_label | string | Да | Једнински назив читљив људима, нпр. Portfolio Item |
plural_label | string | Да | Множински назив читљив људима, нпр. Portfolio Items |
public | boolean | Не | Да ли је тип објаве јавно доступан. Подразумевано true |
supports | array | Не | Функционалности за подршку: title, editor, thumbnail, excerpt, comments, revisions, custom-fields. Подразумевано ["title","editor"] |
has_archive | boolean | Не | Да ли је омогућена архивска страница типа објаве. Подразумевано false |
menu_icon | string | Не | Dashicons класа или URL за икону администраторског менија. Подразумевано "dashicons-admin-post" |
rewrite_slug | string | Не | URL slug за тип објаве. Подразумева се slug |
Пример
{
"slug": "portfolio",
"singular_label": "Portfolio Item",
"plural_label": "Portfolio Items",
"public": true,
"supports": ["title", "editor", "thumbnail"],
"has_archive": true,
"menu_icon": "dashicons-portfolio"
}
Враћа { "success": true, "slug": "portfolio" }
list_post_types
Враћа све прилагођене типове објава које је регистровао агент.
Параметри — нема
Враћа
{
"post_types": [
{
"slug": "portfolio",
"singular_label": "Portfolio Item",
"plural_label": "Portfolio Items",
"public": true
}
]
}
delete_post_type
Одјављује прилагођени тип објаве који је агент претходно регистровао. Постојеће објаве тог типа остају у бази података, али више нису доступне преко типа објаве.
Параметри
| Параметар | Тип | Обавезно | Опис |
|---|---|---|---|
slug | string | Да | Кључ типа објаве који треба уклонити |
Враћа { "success": true, "slug": "portfolio" }
Прилагођене таксономије
Ове способности управљају прилагођеним таксономијама. Као и CPT-ови, регистрације таксономија се чувају.
register_taxonomy
Региструје нову прилагођену таксономију.
Параметри
| Параметар | Тип | Обавезно | Опис |
|---|---|---|---|
slug | string | Да | Кључ таксономије (највише 32 знака) |
singular_label | string | Да | Једнински назив читљив људима, нпр. Project Category |
plural_label | string | Да | Множински назив читљив људима, нпр. Project Categories |
post_types | array | Да | Slug-ови типова објава за које ова таксономија треба да буде повезана |
hierarchical | boolean | Не | true за стил категорија, false за стил ознака. Подразумевано true |
public | boolean | Не | Да ли су термини јавно доступни. Подразумевано true |
rewrite_slug | string | Не | URL slug за таксономију. Подразумева се slug |
Пример
{
"slug": "project-category",
"singular_label": "Project Category",
"plural_label": "Project Categories",
"post_types": ["portfolio"],
"hierarchical": true
}
Враћа { "success": true, "slug": "project-category" }
list_taxonomies
Враћа све прилагођене таксономије које је регистровао агент.
Параметри — нема
Враћа
{
"taxonomies": [
{
"slug": "project-category",
"singular_label": "Project Category",
"post_types": ["portfolio"],
"hierarchical": true
}
]
}
delete_taxonomy
Одјављује прилагођену таксономију коју је агент претходно регистровао.
Параметри
| Параметар | Тип | Обавезно | Опис |
|---|---|---|---|
slug | string | Да | Кључ таксономије који треба уклонити |
Враћа { "success": true, "slug": "project-category" }
Систем дизајна
Способности система дизајна мењају визуелну презентацију WordPress сајта — од прилагођеног CSS-а до блок шаблона и логотипа сајта.
inject_custom_css
Додаје CSS у <head> сајта преко wp_add_inline_style. CSS се чува у опцији gratis_ai_agent_custom_css и чисто уклања из реда учитавања када се способност ресетује.
Параметри
| Параметар | Тип | Обавезно | Опис |
|---|---|---|---|
css | string | Да | Важећи CSS за убацивање |
label | string | Не | Ознака читљива људима за овај CSS блок, користи се у дневницима за отклањање грешака. Подразумевано "agent-injected" |
replace | boolean | Не | Ако је true, замењује сав претходно убачени CSS. Подразумевано false (додаје) |
Пример
{
"css": ":root { --primary: #1a1a2e; --accent: #e94560; } body { font-family: 'Inter', sans-serif; }",
"label": "brand-colours",
"replace": false
}
Враћа { "success": true, "bytes": 96 }
add_block_pattern
Региструје поновно употребљив блок шаблон у WordPress библиотеци шаблона.
Параметри
| Параметар | Тип | Обавезно | Опис |
|---|---|---|---|
slug | string | Да | Идентификатор шаблона, нпр. gratis/hero-dark |
title | string | Да | Назив шаблона читљив људима, приказан у уређивачу |
content | string | Да | Серијализована ознака блокова (HTML) за шаблон |
categories | array | Не | Slug-ови категорија шаблона, нпр. ["featured", "hero"] |
description | string | Не | Кратак опис приказан у бирачу шаблона |
keywords | array | Не | Кључне речи за претрагу |
Враћа { "success": true, "slug": "gratis/hero-dark" }
list_block_patterns
Наводи све блок шаблоне које је регистровао агент.
Параметри — нема
Враћа
{
"patterns": [
{
"slug": "gratis/hero-dark",
"title": "Dark Hero",
"categories": ["hero"]
}
]
}
set_site_logo
Поставља лого WordPress сајта на дати ID прилога или URL удаљене слике. Када је наведен URL, слика се преузима и увози у библиотеку медија.
Параметри
| Параметар | Тип | Обавезно | Опис |
|---|---|---|---|
attachment_id | integer | Не | ID постојећег прилога у библиотеци медија |
url | string | Не | URL удаљене слике за увоз и постављање као лого |
Мора бити наведен један од attachment_id или url.
Враћа { "success": true, "attachment_id": 42 }
apply_theme_json_preset
Примењује именовану предефинисану поставку боја/типографије на theme.json активне теме (или global-styles). Предефинисане поставке су курирани пакети које одржава тим Gratis AI Agent.
Параметри
| Параметар | Тип | Обавезно | Опис |
|---|---|---|---|
preset | string | Да | Назив предефинисане поставке, нпр. minimal-dark, warm-editorial, corporate-blue |
merge | boolean | Не | Ако је true, споји са постојећим вредностима уместо замене. Подразумевано је false |
Доступне предефинисане поставке
| Предефинисана поставка | Опис |
|---|---|
minimal-dark | Готово црна позадина, бели текст, једна акцентна боја |
warm-editorial | Топла прљавобела позадина, серифни наслови, земљане акцентне боје |
corporate-blue | Морнарскоплава и бела палета са професионалном типографијом |
vibrant-startup | Светли градијенти, заобљени углови, модерно безсерифно писмо |
classic-blog | Неутралне сиве, удобна висина реда, традиционални размак распореда |
Враћа { "success": true, "preset": "minimal-dark" }
Глобални стилови
Могућности глобалних стилова читају и уписују вредности theme.json кроз WordPress Global Styles API, утичући на све блокове и шаблоне на целом сајту.
get_global_styles
Враћа тренутну конфигурацију глобалних стилова.
Параметри
| Параметар | Тип | Обавезно | Опис |
|---|---|---|---|
path | string | Не | JSON показивач на одређену вредност, нпр. /color/palette или /typography/fontSizes. Враћа цео објекат ако је изостављено. |
Враћа цео објекат глобалних стилова или вредност на path.
set_global_styles
Ажурира једну или више вредности у конфигурацији глобалних стилова.
Параметри
| Параметар | Тип | Обавезно | Опис |
|---|---|---|---|
path | string | Да | JSON показивач на вредност за постављање, нпр. /color/palette |
value | any | Да | Нова вредност |