አልሚዎች
Zinn® Cache ችሎታዎች ማጣቀሻ
Zinn® Cache የድርጊት ምዝገባውን ከ WordPress Abilities API ጋር ያከናውናል። እነሁኑ ችሎታዎች በጣቢያው የራስ አገልጋይ ላይ የ MCP መሣሪያዎች እና በ /wp-json/wp-abilities/v1 ስር የ REST መስመሮች ናቸው። ይህ ገጽ የተፈጠረው ከሰኪው የራሱ መዝገብ ነው።
መድረሻዎች
MCP በ HTTP (ሊዥረጭ የሚችል)
https://example.com/wp-json/zinn-cache/v1/mcpMCP በ WP-CLI (መደበኛ ግብዓት እና ውፅዓት)
wp mcp-adapter serve --server=zinn-cache --user=<login>REST፡ ችሎታዎችን ዝርዝር አሳይ
/wp-json/wp-abilities/v1/abilities?category=zinn-cacheREST፡ ክህሎትን ማሄድ
/wp-json/wp-abilities/v1/abilities/<name>/runማረጋገጫ እና ፈቃዶች
HTTP ጥያቄዎች በWordPress መተግበሪያ የይለፍ ቃል (HTTP Basic) ያረጋግጣሉ። ከMCP አገልጋይ ጋር ለመገናኘት ከዚህ በታች የሚታየውን ችሎታ ይፈልጋል፤ ከዚያም እያንዳንዱ ችሎታ በእቃው መሰረት የራሱን ፈቃድ ይፈትሻል። የማንበብ-ብቻ ችሎታዎች በGET እና ግብዓታቸው በጥያቄው ሕብረቁምፊ ውስጥ ይሰሩሉ፤ ሌሎቹ ደግሞ በPOST እና በJSON አካል {"input": {…}} ይሰራሉ።
ምሳሌዎች
# REST፡ ክህሎትን ማሄድ
curl -u your-username:your-application-password \
"https://example.com/wp-json/wp-abilities/v1/abilities/zinn-cache/get-cache-layers/run"# MCP (JSON-RPC over HTTP, after "initialize")
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"zinn-cache-get-cache-layers","arguments":{}}}ሁሉም ችሎታዎች
ከአባሪው abilities.json የተፈጠረ፣ እሱም ራሱ ከሚሰራ ድረ-ገጽ የሚመነጭ ነው፤ ሁለቱ ሲጣሉ ምርመራው ይወድቃል።
| ችሎታ | ምን ይሰራል | እትም | ዕረፍት | ፈቃድ | መለኪያዎች |
|---|---|---|---|---|---|
zinn-cache/clean-databasezinn-cache-clean-database | የውሂብ ጎታውን ያጽዱ (Pro) በቅንብሮች ውስጥ የበሩትን የተዝረከረኩ ነገሮች አይነቶች ከበስተጀርባ ያስወግዳል። የተወገደው ነገር ተመልሶ ሊመጣ አይችልም። | የፕሮ እትም | POST …/abilities/zinn-cache/clean-database/run | manage_options | ምንም |
zinn-cache/convert-imageszinn-cache-convert-images | ሁሉንም ነባር ምስሎች ይለውጡ (Pro) የሚዲያ ቤተ-መጽሐፍትን ምስሎች በቅንብሮች ውስጥ ወደተከፈቱት ዘመናዊ ቅርጸቶች ከበስተጀርባ መቀየር ይጀምራል። | የፕሮ እትም | POST …/abilities/zinn-cache/convert-images/run | manage_options | ምንም |
zinn-cache/detect-cache-layerszinn-cache-detect-cache-layers | ከጣቢያው ፊት ለፊት ያሉትን መሸጎጫዎች ይለዩ ጎብኚ እንደሚጠይቀው የመነሻ ገጹን ይጠይቃል እንዲሁም የትኞቹ መሸጎጫዎች ምላሽ እንደሰጡ ያከማቻል። sample: true ሲሆን፣ አዳዲስ ገጾችንም ሁለት ጊዜ ይጠይቃል እና እያንዳንዱ ንብርብር ምን ያህል ጊዜ ከመሸጎጫው እንዳገለገላቸው ይቆጥራል። | ነጻ እትም | POST …/abilities/zinn-cache/detect-cache-layers/run | manage_options (the REST route's own check) | sample: boolean |
zinn-cache/get-cache-analyticszinn-cache-get-cache-analytics | የመሸጎጫ ትንታኔዎችን ያንብቡ (Pro) የነገር መሸጎጫውን (object cache) ያለፉት ሰዓታት (ሰዓታት፣ እስከ 720) የስኬት ምጣኔና የትራፊክ መጠን፣ በጣም አዝጋሚ ትዕዛዞቹን፣ እና የትኞቹ ፕለጊኖች መሸጎጫውን በብዛት እንደሚያመልጣቸው ይመልሳል። | የፕሮ እትም | GET …/abilities/zinn-cache/get-cache-analytics/run | manage_options | hours: integer |
zinn-cache/get-cache-layerszinn-cache-get-cache-layers | ድህረ ገጹን ምን እያጠራቀመ እንዳለ ያንብቡ የትኛው መሸጎጫ ገጾችን እንደሚያገለግል (LiteSpeed፣ nginx፣ Varnish፣ Apache፣ Cloudflare ወይም የፕለጊኑ የዲስክ መሸጎጫ)፣ የመጨረሻው ፍተሻ ያገኘውን፣ WordPress ማንበብ በሚችልበት ቦታ የእያንዳንዱን ንብርብር መጠን፣ የማጽጃውን ወረፋ፣ በደረጃ የሚደረገውን ማደስ እና የቅርብ ጊዜ ማጽዳቶችን ይመልሳል። | ነጻ እትም | GET …/abilities/zinn-cache/get-cache-layers/run | manage_options (the REST route's own check) | ምንም |
zinn-cache/get-diagnosticszinn-cache-get-diagnostics | የምርመራ ሪፖርቱን ያንብቡ የድጋፍ ቡድኑ የሚጠይቀውን የምርመራ ሪፖርት ይመልሳል፡ ስሪቶች፣ የአገልጋይ ገደቦች፣ የመሸጎጫ ሁኔታ እና የቅርብ ጊዜ ስህተቶች። ምንም የይለፍ ቃላትን ወይም ቁልፎችን አልያዘም። | ነጻ እትም | GET …/abilities/zinn-cache/get-diagnostics/run | manage_options | ምንም |
zinn-cache/get-image-progresszinn-cache-get-image-progress | የምስል ልወጣ ሂደቱን ያንብቡ (Pro) ምስሎችን መለወጥ (ወይም ማስወገድ) ምን ያህል እንደደረሰ ይመልሳል። | የፕሮ እትም | GET …/abilities/zinn-cache/get-image-progress/run | manage_options | ምንም |
zinn-cache/get-pro-settingszinn-cache-get-pro-settings | የCache Pro ቅንብሮችን ያንብቡ (Pro) ሁሉንም የCache Pro ቅንብሮች (ማሞቂያ፣ ምስሎች፣ ስክሪፕቶች እና ቅጦች፣ የመረጃ ቋት ማጽዳት፣ ብልጥ ማጽዳት፣ ፈላጊው) ይመልሳል። ሚስጥሮች ፈጽሞ አይመለሱም። | የፕሮ እትም | GET …/abilities/zinn-cache/get-pro-settings/run | manage_options | ምንም |
zinn-cache/get-settingszinn-cache-get-settings | የመሸጎጫ ቅንብሮችን ያንብቡ ሁሉንም የመሸጎጫ ቅንብሮች ይመልሳል። የ Redis የይለፍ ቃል እና የ Cloudflare ማስመሰያ በጭራሽ አይመለሱም፣ የተቀመጠ መኖሩ ብቻ ነው የሚመለሰው። | ነጻ እትም | GET …/abilities/zinn-cache/get-settings/run | manage_options | ምንም |
zinn-cache/get-slow-querieszinn-cache-get-slow-queries | የዝግታ ጥያቄዎች ፈላጊውን ያንብቡ (Pro) ፈላጊው የተመለከታቸውን በጣም አዝጋሚ የውሂብ ጎታ ጥያቄዎች እና ወጪ ጥሪዎች፣ እያንዳንዳቸውንም ካደረገው ተሰኪ ወይም ገጽታ ጋር ይመልሳል። | የፕሮ እትም | GET …/abilities/zinn-cache/get-slow-queries/run | manage_options | ምንም |
zinn-cache/get-statuszinn-cache-get-status | የመሸጎጫውን ሁኔታ ያንብቡ የገጽ መሸጎጫ እና የነገር መሸጎጫ በርተው እየሠሩ መሆናቸውን፣ ስንት ገጾች እንደተሸጎጡ፣ እና የነገር መሸጎጫው የግንኙነት እና የተመታ ቁጥሮችን ይመልሳል። | ነጻ እትም | GET …/abilities/zinn-cache/get-status/run | manage_options | ምንም |
zinn-cache/get-warmup-progresszinn-cache-get-warmup-progress | የማሞቂያ ሂደቱን ያንብቡ (Pro) ማሞቂያው እየሰራ መሆኑን፣ ምን ያህል ገጾችን እንደጎበኘ እና ምን ያህሉ እንዳልተሳኩ ይመልሳል። | የፕሮ እትም | GET …/abilities/zinn-cache/get-warmup-progress/run | manage_options | ምንም |
zinn-cache/preview-database-cleanupzinn-cache-preview-database-cleanup | የውሂብ ጎታ ማጽዳትን አስቀድመው ይመልከቱ (Pro) ጽዳት ምን እንደሚያስወግድ በዓይነት ይቆጥራል (ክለሳዎች፣ ረቂቆች፣ አይፈለጌ መልዕክት፣ ጊዜ ያለፈባቸው ጊዜያዊ መረጃዎች እና የመሳሰሉት)። ምንም ነገር አይወገድም። | የፕሮ እትም | GET …/abilities/zinn-cache/preview-database-cleanup/run | manage_options | ምንም |
zinn-cache/purgezinn-cache-purge | መሸጎጫውን ያጽዱ የተሸጎጡ ገጾችን ያስወግዳል፦ ሁሉንም (all: true)፣ የተወሰኑ አድራሻዎችን (urls) ወይም መለያ የተሰጣቸውን ሁሉ (tags)። ጎብኚዎች ሲመጡ ገጾች እንደገና ይገነባሉ። | ነጻ እትም | POST …/abilities/zinn-cache/purge/run | manage_options (the REST route's own check) | all: boolean, urls: array, tags: array |
zinn-cache/purge-urlszinn-cache-purge-urls | በእያንዳንዱ የቅሸት ንብርብር ላይ የተወሰኑ አድራሻዎችን ያጽዱ እነዚህን አድራሻዎች (እንደ /about/ ያሉ ዱካዎችን ወይም በዚህ ጣቢያ ላይ ያሉ ሙሉ አድራሻዎችን) በአንድ ጊዜ ከዲስክ መሸጎጫ፣ ከአገልጋይ መሸጎጫ እና ከ Cloudflare ያስወግዳል፣ እንዲሁም እያንዳንዱ ንብርብር ምን ምላሽ እንደሰጠ ይገልጻል። | ነጻ እትም | POST …/abilities/zinn-cache/purge-urls/run | manage_options (the REST route's own check) | urls: array (ያስፈልጋል) |
zinn-cache/refresh-cachezinn-cache-refresh-cache | የተወሰነ የጊዜ ልዩነት ያለውን ማደሻ ይጀምሩ ወይም ያቁሙ action: start በየደቂቃው አንድ ስብስብ እያደረገ እያንዳንዱን ገጽ ያድሳል (ዝማኔዎች መሸጎጫውን ባዶ ከማድረግ ይልቅ የሚያደርጉት ነገር)፤ action: stop ደግሞ በመካሄድ ላይ ያለውን ማደስ ያቆማል። | ነጻ እትም | POST …/abilities/zinn-cache/refresh-cache/run | manage_options (the REST route's own check) | action: start|stop (ያስፈልጋል) |
zinn-cache/remove-converted-imageszinn-cache-remove-converted-images | ሁሉንም የተቀየሩ ምስሎችን አስወግድ (Pro) የምስሎቹን የተቀየሩ ቅጂዎች በሙሉ ከበስተጀርባ ይሰርዛል፤ ዋናዎቹ እንዳሉ ይቆያሉ። | የፕሮ እትም | POST …/abilities/zinn-cache/remove-converted-images/run | manage_options | ምንም |
zinn-cache/reset-settingszinn-cache-reset-settings | የመሸጎጫ ቅንብሮችን ወደ ነባሪዎቻቸው ይመልሱ እንደ «ዳግም አስጀምር» አዝራር ሁሉ እያንዳንዱን የመሸጎጫ ቅንብር ወደ ነባሪ ይመልሳል። የተቀመጠው የRedis የይለፍ ቃልም ይወገዳል። | ነጻ እትም | POST …/abilities/zinn-cache/reset-settings/run | manage_options | ምንም |
zinn-cache/reset-slow-querieszinn-cache-reset-slow-queries | የዘገዩ መጠይቆች ግኝቶችን አጽዳ (Pro) እስከ አሁን የተገኙትን እያንዳንዱን አዝጋሚ መጠይቅ እና አዝጋሚ ጥሪ ይረሳል፣ ፈላጊውም እንደገና ይጀምራል። | የፕሮ እትም | POST …/abilities/zinn-cache/reset-slow-queries/run | manage_options | ምንም |
zinn-cache/update-pro-settingszinn-cache-update-pro-settings | የCache Pro ቅንብሮችን ይቀይሩ (Pro) እርስዎ የሚልኳቸውን የCache Pro ቅንብሮች ይቀይራል (ቅንብሮች፦ ቁልፍ ወደ እሴት) እና የቀሩትን እንዳሉ ያቆያል። እያንዳንዱ እሴት ልክ በCache Pro ማያ ገጽ ላይ እንደሚደረገው በትክክል ይረጋገጣል፤ ያልታወቀ ቁልፍ ተቀባይነት አያገኝም። | የፕሮ እትም | POST …/abilities/zinn-cache/update-pro-settings/run | manage_options | settings: object (ያስፈልጋል) |
zinn-cache/update-settingszinn-cache-update-settings | የመሸጎጫ ቅንብሮችን ይቀይሩ የሚልኳቸውን ቅንብሮች ይለውጣል እንዲሁም የቀሩትን ያስቀምጣል (የገጽ መሸጎጫ፣ ገጾች ተሸጉጠው የሚቆዩበት ጊዜ፣ የእቃ መሸጎጫ እና የ Redis ግንኙነቱ፣ የማጽዳት ደንቦች እና ማግለያዎች)። እሴቶች ልክ በCache ማያ ገጽ ላይ እንዳለው ተረጋግጠው ይስተካከላሉ። | ነጻ እትም | POST …/abilities/zinn-cache/update-settings/run | manage_options | lscache_enabled: boolean, lscache_ttl: integer, object_cache_enabled: boolean, auto_purge_enabled: boolean, purge_on_upgrade: boolean, exclude_uris: array|object|string, exclude_query_keys: array|object|string, exclude_cookies: array|object|string, redis_host: string, redis_port: integer, redis_database: integer, redis_username: string, redis_password: string, redis_key_prefix: string, browser_ttl: integer, cache_logged_out_only: boolean, purge_on_comment: boolean, ttl_overrides: array|object|string, server_cache: string, server_cache_headers: boolean, nginx_purge_method: string, nginx_purge_endpoint: string, nginx_http_verb: string, nginx_purge_address: string, nginx_cache_path: string, nginx_cache_levels: string, nginx_cache_key: string, nginx_key_variants: array|object|string, nginx_spool_dir: string, varnish_host: string, varnish_port: integer, varnish_method: string, apache_cache_root: string, apache_dir_levels: integer, apache_dir_length: integer, cloudflare_enabled: boolean, cloudflare_zone_id: string, cloudflare_api_token: string, cloudflare_purge_everything: boolean, refresh_batch: integer, refresh_load_limit: integer, redis_serializer: string, heartbeat_mode: string, font_display_swap: boolean, preconnect_origins: array|object|string, cdn_url: string, cdn_exclude: array|object|string |
zinn-cache/warm-cachezinn-cache-warm-cache | መሸጎጫውን ያሞቁ (Pro) ጎብኝዎች መሸጎጫ የተደረገባቸውን ገጾች እንዲያገኙ በዳራ ውስጥ በጣቢያ ካርታዎች ውስጥ ያለውን እያንዳንዱን ገጽ መጎብኘት ይጀምራል። ሲሄድም ሂደቱ ለብቻው ሪፖርት ይደረጋል። | የፕሮ እትም | POST …/abilities/zinn-cache/warm-cache/run | manage_options | ምንም |
WP-CLI ትዕዛዞች
እነዚህን በሰርቨሩ ላይ በ WP-CLI ያሂዱ። እያንዳንዱ ትእዛዝ ከፕለግአኑ ማያ ገጾች ጋር አንድ አይነት ፈቃዶችን ይፈትሻል፤ ምሳሌዎቹ የተወሰዱት ከራሱ ከፕለግአኑ የእርዳታ ጽሑፍ ነው።
| ትዕዛዝ | ምን ይሰራል | እትም |
|---|---|---|
wp zinn-cache purge allwp zinn-cache purge all | ሁሉንም የተቀመጡ ገጾች ያጽዱ። | ነጻ እትም |
wp zinn-cache purge post<id>...wp zinn-cache purge post 42 | የአንድን ጽሁፍ ገጾች እና የሚታይባቸውን ዝርዝሮች (መነሻ ገጽ፣ ማህደሮች፣ ምግቦች) ያጽዱ። | ነጻ እትም |
wp zinn-cache purge url<url>...wp zinn-cache purge url https://example.com/ /pricing/ | በእነዚህ ዩአርኤሎች ላይ የተሸጎጡትን ገጾች ያጽዱ። | ነጻ እትም |
wp zinn-cache refresh<action>wp zinn-cache refresh status | የተመጠነ ማደስን ያስጀምሩ፣ ያቁሙ ወይም ይመልከቱ (ከዝማኔ በኋላ «ሁሉንም አጽዳ» የሚለውን የሚተካው)። | ነጻ እትም |
wp zinn-cache server detectwp zinn-cache server detect | ከጣቢያው ፊት ለፊት የትኞቹ መሸጎጫዎች ምላሽ እንደሚሰጡ ያረጋግጡ (nginx፣ Varnish፣ Apache፣ LiteSpeed፣ Cloudflare)። | ነጻ እትም |
wp zinn-cache server drainwp zinn-cache server drain | WP-Cronን ከመጠበቅ ይልቅ የተሰለፉትን የአገልጋይ መሸጎጫ ማጽዳቶች አሁን ይላኩ። | ነጻ እትም |
wp zinn-cache status[--format=<format>]wp zinn-cache status --format=json | የእቃውን መሸጎጫ (object cache) ሁኔታ ሪፖርት አድርግ። | ነጻ እትም |
እርምጃዎች እና ማጣሪያዎች
ፕለጊኑ የሚያቀርባቸው ሁሉም Hook-ዎች፣ ከምንጭ ኮዳቸው የተወሰዱ መግለጫዎች ጋር። Filters እሴትን ይለውጣሉ፤ Actions ደግሞ በሆነ ቅጽበት ኮድ እንዲያንቀሳቅሱ ያስችሉዎታል፤ Entry points ፕለጊኑ አንድን ነገር እንዲያደርግ ለመጠየቅ የሚያስነሷቸው Actions ናቸው።
| ሆክ | ዓይነት | ምን ይሰራል | መለኪያዎች | እትም |
|---|---|---|---|---|
zinn_cache_control_header | አጣራ | ሊተስፒድ (LiteSpeed) ለሚችል መሸጎጫ ገጽ የተላከውን የካሼ-መቆጣጠሪያ (cache-control) እሴት ያጣራል። | string $value, int $ttl | ነጻ እትም |
zinn_cache_fs_loaded | እርምጃ | የፍቃድ አሰጣጥ SDK ጫኝቶ ሲጠናቀቅ ከቀረው የ Zinn® Cache ክፍል በፊት ይነሳል። ከ `zinn_cache_fs()` ጋር ለመገናኘት እዚህ ጋር ያያይዙ። | ምንም | ነጻ እትም |
zinn_cache_link_scan_post_types | አጣራ | ቅኝቱ የሚያካትታቸው የልጥፍ ዓይነቶች። | ምንም | ነጻ እትም |
zinn_cache_mcp_abilities | እርምጃ | Zinn® Cache አቅሙን ከዚህ በኋላ ይመዘግባል፡ Zinn® Cache Pro የራሱን እዚህ ያክላል። | ምንም | ነጻ እትም |
zinn_cache_post_change_tags | አጣራ | ፖስት ሲቀየር የሚጸዳውን መሸጎጫ መለያዎች (cache tags) ያጣራል። | string[] $tags, int $post_id, string $post_type | ነጻ እትም |
zinn_cache_purge_all | እርምጃ | ሁሉንም ከመሳሪያዎች ሰንጠረዥ አጽዳ። | ምንም | ነጻ እትም |
zinn_cache_purge_hosts | አጣራ | ማጽዳቶች ሊጠቅሷቸው የሚችሏቸውን የአስተናጋጅ ስሞች ያጣራል (ከአንድ በላይ በሆነ ጎራ ላይ ለሚስተናገድ ጣቢያ)። | string[] $hosts | ነጻ እትም |
zinn_cache_purge_on_seo_change | አጣራ | በZinn® SEO ውስጥ የተደረገ ለውጥ የቀየራቸውን ገጾች ማጽዳቱን ያጣራል። | bool $on | ነጻ እትም |
zinn_cache_purge_plan | የመግቢያ ነጥብ (እርስዎ ያስጀምሩታል) | የእቅድ ስም የሰጠውን በትክክል ያፅዱ፡ `do_action( 'zinn_cache_purge_plan', array( 'urls' => …, 'tags' => …, 'purge_all' => … ) )`። | ምንም | ነጻ እትም |
zinn_cache_purged | እርምጃ | ፕለጊኑ መሸጎጫ (cache) ማጽዳቱን ካከናወነ በኋላ ይሠራል። | array{purge_all:bool,urls:string[],tags:string[]} $plan | ነጻ እትም |
zinn_cache_purged_all | እርምጃ | የገጽ መሸጎጫ ሙሉ ማጽዳት ከተጠየቀ በኋላ ይከሰታል። | string $reason | ነጻ እትም |
zinn_cache_refresh_armed | እርምጃ | የተወሰነ የጊዜ ክፍተት ያለው ማደስ ሲጀምር ይነሳሳል። | string $reason | ነጻ እትም |
zinn_cache_refresh_finished | እርምጃ | በተወሰነ ፍጥነት የሚከናወን ማደስ የጣቢያው መጨረሻ ላይ ሲደርስ ይነሳሳል። | int $pages | ነጻ እትም |
zinn_cache_refresh_guard | አጣራ | ማደሱ በዚህ ደቂቃ ለአፍታ መቆም እንዳለበት ያጣራል (የአስተናጋጁ የራሱ የጭነት መከላከያ)። | string $reason | ነጻ እትም |
zinn_cache_refresh_urls | አጣራ | የማደሻ ስብስብ የሚያጠራቸውን አድራሻዎች ያጣራል — ለምሳሌ የእያንዳንዱን ገጽ የሌሎች ቋንቋዎች አድራሻዎች እዚህ ያክሉ። | string[] $urls | ነጻ እትም |
zinn_cache_refreshed_urls | እርምጃ | የማደሻ ስብስብ ከተጣራ በኋላ ይነሳል (Zinn® Cache Pro እነዚህን ገጾች እንደገና ያሞቃቸዋል)። | string[] $urls | ነጻ እትም |
zinn_cache_request_cacheable | አጣራ | የአሁኑ የፊት-ለፊት (front-end) ጥያቄ ከገፅ መሸጎጫ (page cache) መቅረብ እንደሚችል እና እንደማይችል ያጣራል:: | bool $cacheable | ነጻ እትም |
zinn_cache_status_rows | አጣራ | የሁኔታ ማሳያውን «ይህን ጣቢያ ምን እያሸጎረው ነው» ሰንጠረዥ ረድፎች ያጣራል። | array<int,array{0:string,1:string}> $rows, array<string,mixed> $report | ነጻ እትም |
zinn_cache_ttl | አጣራ | የአሁን ገጽ በመሸጎሪያ (ካሼ) ውስጥ የሚቆይበትን ጊዜ በሰከንዶች ያጣራል። | int $ttl | ነጻ እትም |