क्षमतांचा संदर्भ
क्षमता या Gratis AI Agent तुमच्या WordPress स्थापनेवर वापरू शकणाऱ्या मूलभूत क्रिया आहेत. प्रत्येक क्षमता ही नोंदणीकृत PHP class असते जी JSON schema उघड करते — agent रनटाइमवर हे schema वाचून कोणते parameters आवश्यक आहेत आणि क्षमता काय परत करते हे समजतो.
हे पृष्ठ Gratis AI Agent v1.9.0 सोबत येणाऱ्या सर्व क्षमत ांचे दस्तऐवजीकरण करते.
सानुकूल पोस्ट प्रकार
या क्षमता agent द्वारे नोंदणीकृत सानुकूल पोस्ट प्रकार (CPTs) व्यवस्थापित करतात. नोंदणी WordPress options तक्त्यात कायम ठेवली जाते, त्यामुळे plugin निष्क्रिय करून पुन्हा सक्रिय केले तरी ती टिकून राहते.
register_post_type
नवीन सानुकूल पोस्ट प्रकार नोंदणीकृत करते.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
slug | string | Yes | पोस्ट प्रकाराची key (कमाल 20 अक्षरे, मोठी अक्षरे नाहीत, जागा नाहीत) |
singular_label | string | Yes | मानव-वाचनीय एकवचनी नाव, उदा. Portfolio Item |
plural_label | string | Yes | मानव-वाचनीय अनेकवचनी ना व, उदा. Portfolio Items |
public | boolean | No | पोस्ट प्रकार सार्वजनिकरीत्या प्रवेशयोग्य आहे का. Default true |
supports | array | No | समर्थित करावयाची वैशिष्ट्ये: title, editor, thumbnail, excerpt, comments, revisions, custom-fields. Default ["title","editor"] |
has_archive | boolean | No | पोस्ट प्रकाराचे संग्रह पृष्ठ सक्षम आहे का. Default false |
menu_icon | string | No | admin menu icon साठी Dashicons class किंवा URL. Default "dashicons-admin-post" |
rewrite_slug | string | No | पोस्ट प्रकारासाठी URL slug. Default 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
agent द्वारे नोंदणीकृत सर्व सानुकूल पोस्ट प्रकार परत करते.
Parameters — काहीही नाही
परत करते
{
"post_types": [
{
"slug": "portfolio",
"singular_label": "Portfolio Item",
"plural_label": "Portfolio Items",
"public": true
}
]
}
delete_post_type
agent द्वारे पूर्वी नोंदणीकृत केलेला सानुकूल पोस्ट प्रकार अनोंदणीकृत करते. त्या प्रकारच्या विद्यमान पोस्ट database मध्ये राहतात, पण त्या पोस्ट प्रकाराद्वारे पुढे प्रवेशयोग्य राहत नाहीत.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
slug | string | Yes | काढून टाकावयाची पोस्ट प्रकार key |
परत करते { "success": true, "slug": "portfolio" }
सानुकूल वर्गीकरणे
या क्षमता सानुकूल वर्गीकरणे व्यवस्थापित करतात. CPTs प्रमाणेच, taxonomy नोंदणी कायम ठेवली जाते.
register_taxonomy
नवीन सानुकूल taxonomy नोंदणीकृत करते.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
slug | string | Yes | taxonomy key (कमाल 32 अक्षरे) |
singular_label | string | Yes | मानव-वाचनीय एकवचनी नाव, उदा. Project Category |
plural_label | string | Yes | मानव-वाचनीय अनेकवचनी नाव, उदा. Project Categories |
post_types | array | Yes | ही taxonomy जोडली जावी असे पोस्ट प्रकार slugs |
hierarchical | boolean | No | category-शैलीसाठी true, tag-शैलीसाठी false. Default true |
public | boolean | No | terms सार्वजनिकरीत्या प्रवेशयोग्य आहेत का. Default true |
rewrite_slug | string | No | taxonomy साठी URL slug. Default slug |
उदाहरण
{
"slug": "project-category",
"singular_label": "Project Category",
"plural_label": "Project Categories",
"post_types": ["portfolio"],
"hierarchical": true
}
परत करते { "success": true, "slug": "project-category" }
list_taxonomies
agent द्वारे नोंदणीकृत सर्व सानुकूल taxonomies परत करते.
Parameters — काहीही नाही
परत करते
{
"taxonomies": [
{
"slug": "project-category",
"singular_label": "Project Category",
"post_types": ["portfolio"],
"hierarchical": true
}
]
}
delete_taxonomy
agent द्वारे पूर्वी नोंदणीकृत केलेली सानुकूल taxonomy अनोंदणीकृत करते.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
slug | string | Yes | काढून टाकावयाची taxonomy key |
परत करते { "success": true, "slug": "project-category" }
डिझाइन प ्रणाली
डिझाइन प्रणालीच्या क्षमता WordPress site चे दृश्य सादरीकरण बदलतात — सानुकूल CSS पासून block patterns आणि site logo पर्यंत.
inject_custom_css
wp_add_inline_style द्वारे site च्या <head> मध्ये CSS जोडते. CSS gratis_ai_agent_custom_css option मध्ये साठवले जाते आणि क्षमता reset केल्यावर स्वच्छपणे dequeue केले जाते.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
css | string | Yes | inject करण्यासाठी वैध CSS |
label | string | No | या CSS block साठी मानव-वाचनीय label, debug logs मध्ये वापरले जाते. Default "agent-injected" |
replace | boolean | No | true असल्यास, पूर्वी inject केलेले सर्व CSS बदलते. Default 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 pattern library मध्ये पुन्हा वापरता येणारा block pattern नोंदणीकृत करते.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
slug | string | Yes | Pattern identifier, उदा. gratis/hero-dark |
title | string | Yes | editor मध्ये दाखवले जाणारे मानव-वाचनीय pattern नाव |
content | string | Yes | pattern साठी serialised block markup (HTML) |
categories | array | No | Pattern category slugs, उदा. ["featured", "hero"] |
description | string | No | pattern picker मध्ये दाखवले जाणारे छोटे वर्णन |
keywords | array | No | शोध keywords |
परत करते { "success": true, "slug": "gratis/hero-dark" }
list_block_patterns
agent द्वारे नोंदणीकृत सर्व block patterns सूचीबद्ध करते.
Parameters — काहीही नाही
परतावा
{
"patterns": [
{
"slug": "gratis/hero-dark",
"title": "Dark Hero",
"categories": ["hero"]
}
]
}
set_site_logo
दिलेल्या attachment ID किंवा दूरस्थ प्रतिमा URL वर WordPress साइटचा लोगो सेट करते. URL दिल्यास, प्रतिमा डाउनलोड केली जाते आणि Media Library मध्ये आयात केली जाते.
पॅरामीटर्स
| पॅरामीटर | प्रकार | आवश्यक | वर्णन |
|---|---|---|---|
attachment_id | integer | नाही | विद्यमान Media Library attachment चा ID |
url | string | नाही | आयात करून लोगो म्हणून सेट करण्यासाठी दूरस्थ प्रतिमा URL |
attachment_id किंवा url यापैकी एक देणे आवश्यक आहे.
परतावा { "success": true, "attachment_id": 42 }
apply_theme_json_preset
सक्रिय theme च्या theme.json (किंवा global-styles) वर नामांकित रंग/टायपोग्राफी preset लागू करते. Presets हे Gratis AI Agent टीमने देखभाल केलेले निवडक संच आहेत.
पॅरामीटर्स
| पॅरामीटर | प्रकार | आवश्यक | वर्णन |
|---|---|---|---|
preset | string | होय | Preset नाव, उदा. minimal-dark, warm-editorial, corporate-blue |
merge | boolean | नाही | true असल्यास, बदलण्याऐवजी विद्यमान मूल्यांमध्ये विलीन करा. डीफॉल्ट false |
उपलब्ध presets
| Preset | वर्णन |
|---|---|
minimal-dark | जवळपास काळी पार्श्वभूमी, पांढरा मजकूर, एकच उठावदार रंग |
warm-editorial | उबदार ऑफ-व्हाइट पार्श्वभूमी, serif शीर्षके, मातीच्या छटांचे उठावदार रंग |
corporate-blue | व्यावसायिक टायपोग्राफीसह नेव्ही आणि पांढरा रंगसंच |
vibrant-startup | तेजस्वी gradients, गोलाकार कोपरे, आधुनिक sans-serif प्रकार |
classic-blog | तटस्थ करडे रंग, आरामदायक line-height, पारंपरिक layout spacing |
परतावा { "success": true, "preset": "minimal-dark" }
Global Styles
Global Styles क्षमता WordPress Global Styles API द्वारे theme.json मूल्ये वाचतात आणि लिहितात, ज्यामुळे साइटभर सर्व blocks आणि templates प्रभावित होतात.
get_global_styles
सध्याचे global styles configuration परत करते.
पॅरामीटर्स
| पॅरामीटर | प्रकार | आवश्यक | वर्णन |
|---|---|---|---|
path | string | नाही | विशिष्ट मूल्यास ाठी JSON pointer, उदा. /color/palette किंवा /typography/fontSizes. वगळल्यास संपूर्ण object परत करते. |
परतावा पूर्ण global styles object किंवा path वरील मूल्य.
set_global_styles
global styles configuration मधील एक किंवा अधिक मूल्ये अद्ययावत करते.
पॅरामीटर्स
| पॅरामीटर | प्रकार | आवश्यक | वर्णन |
|---|---|---|---|
path | string | होय | सेट करावयाच्या मूल्यासाठी JSON pointer, उदा. /color/palette |
value | any | होय | नवीन मूल्य |
उदाहरण — palette मध्ये रंग जोडा
{
"path": "/color/palette",
"value": [
{ "slug": "primary", "color": "#1a1a2e", "name": "Primary" },
{ "slug": "accent", "color": "#e94560", "name": "Accent" }
]
}
परतावा { "success": true, "path": "/color/palette" }
reset_global_styles
agent-लागू केलेले सर्व global styles बदल reset करते, theme defaults पुनर्स्थापित करते.
पॅरामीटर्स — काहीही नाही
परतावा { "success": true }
Navigation Menus
Navigation Menu क्षमता WordPress nav menus आणि त्यांचे items तयार व व्यवस्थापित करतात.
create_menu
नवीन WordPress navigation menu तयार करते.
पॅरामीटर्स
| पॅरामीटर | प्रकार | आवश्यक | वर्णन |
|---|---|---|---|
name | string | होय | Menu नाव, उदा. Primary Navigation |
location | string | नाही | हा menu नेमण्यासाठी Theme location, उदा. primary |
परतावा { "success": true, "menu_id": 7 }
update_menu
menu चे नाव बदलते किंवा ते theme location ला पुन्हा नेमते.
पॅरामीटर्स
| पॅरामीटर | प्रकार | आवश्यक | वर्णन |
|---|---|---|---|
menu_id | integer | होय | अद्ययावत करावयाच्या menu चा ID |
name | string | नाही | नवीन menu नाव |
location | string | नाही | नेमण्यासाठी किंवा पुन्हा नेमण्यासाठी Theme location |
परतावा { "success": true, "menu_id": 7 }
add_menu_item
विद्यमान navigation menu मध्ये item जोडते.
पॅरामीटर्स
| पॅरामीटर | प्रकार | आवश्यक | वर्णन |
|---|---|---|---|
menu_id | integer | होय | लक्ष्य menu चा ID |
type | string | होय | Item प्रकार: custom, post_type, किंवा taxonomy |
title | string | नाही | menu item साठी लेबल (custom प्रकारासाठी आवश्यक) |
url | string | नाही | custom items साठी URL |
object_id | integer | नाही | post_type/taxonomy items साठी Post ID किंवा term ID |
parent_id | integer | नाही | हा item ज्याखाली nest करायचा त्या Menu item चा ID |
position | integer | नाही | menu मधील शून्य-आधारित स्थान |
परतावा { "success": true, "item_id": 12 }
remove_menu_item
navigation menu मधून item काढते.
पॅरामीटर्स
| पॅरामीटर | प्रकार | आवश्यक | वर्णन |
|---|---|---|---|
item_id | integer | होय | काढण्यासाठी Menu item ID |
परतावा { "success": true, "item_id": 12 }
list_menus
सर्व WordPress navigation menus, त्यांना नेमलेल्या theme locations सह, सूचीबद्ध करते.
पॅरामीटर्स — काहीही नाही
परतावा
{
"menus": [
{
"menu_id": 7,
"name": "Primary Navigation",
"location": "primary",
"item_count": 5
}
]
}
Options Management
Options क्षमता get_option / update_option द्वारे WordPress options वाचतात आणि लिहितात. अंगभूत safety blocklist महत्त्वाच्या settings मध्ये अपघाती बदल होण्यापासून प्रतिबंध करते.
get_option
WordPress option वाचते.
पॅरामीटर्स
| पॅरामीटर | प्रकार | आवश्यक | वर्णन |
|---|---|---|---|
option_name | string | होय | option key, उदा. blogname |
परतावा { "option_name": "blogname", "value": "My Site" }
option_name safety blocklist वर असल्यास error परत करते.
set_option
WordPress option लिहिते.
पॅरामीटर्स
| पॅरामीटर | प्रकार | आवश्यक | वर्णन |
|---|---|---|---|
option_name | string | होय | option key |
value | any | होय | नवीन मूल्य (arrays/objects साठी आपोआप serialised) |
autoload | string | नाही | "yes" किंवा "no". डीफॉल्ट विद्यमान autoload setting जपतो |
option_name safety blocklist वर असल्यास त्रुटी परत करते.
परत करते { "success": true, "option_name": "blogname" }
delete_option
WordPress option हटवते.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
option_name | string | Yes | हटवायची option key |
option_name safety blocklist वर असल्यास त्रुटी परत करते.
परत करते { "success": true, "option_name": "my_custom_option" }
list_options
नमुन्याशी जुळणारे WordPress options सूचीबद्ध करते.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
pattern | string | No | option नावे फिल्टर करण्यासाठी SQL LIKE नमुना, उदा. gratis_%. वगळल्यास सर्व options परत करते (मोठ्या databases वर सावधगिरीने वापरा). |
limit | integer | No | परिणामांची कमाल संख्या. Default 50, कमाल 500 |
परत करते
{
"options": [
{ "option_name": "gratis_ai_agent_version", "autoload": "yes" }
],
"total": 1
}