Mga Developer
Sanggunian ng mga kakayahan ng Zinn® Cache
Ang Zinn® Cache ay nagrerehistro ng mga aksyon nito sa WordPress Abilities API. Ang parehong mga kakayahan ay mga MCP tool sa sariling server ng site at mga REST route sa ilalim ng /wp-json/wp-abilities/v1. Ang pahinang ito ay nabuo mula sa sariling registry ng plugin.
Mga Endpoint
MCP sa ibabaw ng HTTP (naa-stream)
https://example.com/wp-json/zinn-cache/v1/mcpMCP sa pamamagitan ng WP-CLI (karaniwang input at output)
wp mcp-adapter serve --server=zinn-cache --user=<login>REST: ilista ang mga kakayahan
/wp-json/wp-abilities/v1/abilities?category=zinn-cacheREST: magpatakbo ng kakayahan
/wp-json/wp-abilities/v1/abilities/<name>/runPagpapatotoo at mga pahintulot
Ang mga kahilingan sa HTTP ay nag-a-authenticate gamit ang isang WordPress application password (HTTP Basic). Ang pagkonekta sa MCP server ay nangangailangan ng kakayahang ipinapakita sa ibaba; ang bawat kakayahan ay nagsusuri ng sarili nitong pahintulot, sa bawat bagay. Ang mga kakayahang read-only ay tumatakbo gamit ang GET at ang kanilang input sa query string; ang iba naman ay gamit ang POST at isang JSON body na {"input": {…}}.
Mga Halimbawa
# REST: magpatakbo ng kakayahan
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":{}}}Lahat ng kakayahan
Binuo mula sa abilities.json ng plugin, na binubuo naman mula sa tumatakbong site; nabibigo ang pagsubok kapag hindi magkatugma ang dalawa.
| Kakayahan | Ang ginagawa nito | Edisyon | Iba pa | Pahintulot | Mga Parameter |
|---|---|---|---|---|---|
zinn-cache/clean-databasezinn-cache-clean-database | Linisin ang database (Pro) Inaalis sa background ang mga uri ng kalat na naka-on sa mga setting. Ang naalis ay hindi na maibabalik. | Pro edisyon | POST …/abilities/zinn-cache/clean-database/run | manage_options | wala |
zinn-cache/convert-imageszinn-cache-convert-images | I-convert ang lahat ng umiiral na larawan (Pro) Sinisimulan ang pag-convert ng mga larawan ng media library sa mga modernong format na naka-on sa mga setting, sa background. | Pro edisyon | POST …/abilities/zinn-cache/convert-images/run | manage_options | wala |
zinn-cache/detect-cache-layerszinn-cache-detect-cache-layers | Tukuyin ang mga cache sa harap ng site Hinihiling ang home page tulad ng gagawin ng isang bisita at sine-save kung aling mga cache ang sumagot. Kapag may sample: true, hinihiling din nito ang pinakabagong mga page nang dalawang beses at binibilang kung gaano kadalas inihahatid ng bawat layer ang mga ito mula sa cache nito. | Libreng edisyon | 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 | Basahin ang analytics ng cache (Pro) Ibinabalik ang hit rate at trapiko ng object cache para sa mga nakalipas na oras (mga oras, hanggang 720), ang pinakamabagal nitong mga command, at kung aling mga plugin ang may pinakamaraming cache miss. | Pro edisyon | GET …/abilities/zinn-cache/get-cache-analytics/run | manage_options | hours: integer |
zinn-cache/get-cache-layerszinn-cache-get-cache-layers | Basahin kung ano ang nagka-cache ng site Ibinabalik kung aling cache ang nagsisilbi sa mga pahina (LiteSpeed, nginx, Varnish, Apache, Cloudflare o ang disk cache ng plugin), kung ano ang nakita sa huling pagtukoy, ang laki ng bawat layer kung saan mababasa ito ng WordPress, ang pila ng pag-purge, ang may-pagitang pag-refresh at ang mga kamakailang pag-purge. | Libreng edisyon | GET …/abilities/zinn-cache/get-cache-layers/run | manage_options (the REST route's own check) | wala |
zinn-cache/get-diagnosticszinn-cache-get-diagnostics | Basahin ang ulat ng diagnostics Ibinabalik ang ulat ng diagnostics na hinihingi ng suporta: mga bersyon, mga limitasyon ng server, ang estado ng cache, at kamakailang mga error. Wala itong hawak na mga password o key. | Libreng edisyon | GET …/abilities/zinn-cache/get-diagnostics/run | manage_options | wala |
zinn-cache/get-image-progresszinn-cache-get-image-progress | Basahin ang progreso ng conversion ng imahe (Pro) Ibinabalik kung gaano na kalayo ang narating ng pag-convert (o pag-alis) ng mga larawan. | Pro edisyon | GET …/abilities/zinn-cache/get-image-progress/run | manage_options | wala |
zinn-cache/get-pro-settingszinn-cache-get-pro-settings | Basahin ang mga setting ng Cache Pro (Pro) Ibinabalik ang bawat setting ng Cache Pro (warm-up, mga larawan, mga script at estilo, paglilinis ng database, matalinong pag-purge, ang tagahanap). Hindi kailanman ibinabalik ang mga lihim. | Pro edisyon | GET …/abilities/zinn-cache/get-pro-settings/run | manage_options | wala |
zinn-cache/get-settingszinn-cache-get-settings | Basahin ang mga setting ng cache Ibinabalik ang bawat setting ng cache. Ang password ng Redis at ang token ng Cloudflare ay hindi kailanman ibinabalik, kundi kung may naka-save lamang. | Libreng edisyon | GET …/abilities/zinn-cache/get-settings/run | manage_options | wala |
zinn-cache/get-slow-querieszinn-cache-get-slow-queries | Basahin ang tagahanap ng mabagal na query (Pro) Ibinabalik ang pinakamabagal na mga query sa database at mga papalabas na tawag na nakita ng finder, kasama ang plugin o tema na gumawa sa bawat isa. | Pro edisyon | GET …/abilities/zinn-cache/get-slow-queries/run | manage_options | wala |
zinn-cache/get-statuszinn-cache-get-status | Basahin ang status ng cache Ibinabalik kung naka-on at gumagana ang page cache at object cache, kung ilang page ang naka-cache, at ang mga numero ng koneksyon at hit ng object cache. | Libreng edisyon | GET …/abilities/zinn-cache/get-status/run | manage_options | wala |
zinn-cache/get-warmup-progresszinn-cache-get-warmup-progress | Basahin ang progreso ng pagpapainit (Pro) Ibinabalik kung tumatakbo ang warm-up, kung ilang pahina ang nabisita nito at kung ilan ang nabigo. | Pro edisyon | GET …/abilities/zinn-cache/get-warmup-progress/run | manage_options | wala |
zinn-cache/preview-database-cleanupzinn-cache-preview-database-cleanup | I-preview ang paglilinis ng database (Pro) Binibilang kung ano ang aalisin ng isang paglilinis, ayon sa uri (mga rebisyon, draft, spam, nag-expire na pansamantalang data at iba pa). Walang aalisin. | Pro edisyon | GET …/abilities/zinn-cache/preview-database-cleanup/run | manage_options | wala |
zinn-cache/purgezinn-cache-purge | I-purge ang cache Itinatapon ang mga naka-cache na pahina: lahat (all: true), ilang address (urls) o lahat ng naka-tag (tags). Muling bubuuin ang mga pahina habang dumarating ang mga bisita. | Libreng edisyon | 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 | I-purge ang ilang address sa bawat cache layer Inaalis ang mga address na ito (mga path tulad ng /about/ o mga buong address sa site na ito) mula sa disk cache, server cache, at Cloudflare nang sabay-sabay, at sinasabi kung ano ang isinagot ng bawat layer. | Libreng edisyon | POST …/abilities/zinn-cache/purge-urls/run | manage_options (the REST route's own check) | urls: array (kinakailangan) |
zinn-cache/refresh-cachezinn-cache-refresh-cache | Simulan o ihinto ang paced na pag-refresh ina-update ng action: start ang bawat pahina nang pira-piraso bawat minuto (ang ginagawa ng mga update sa halip na i-clear ang cache); wina-wakas ng action: stop ang kasalukuyang pag-update. | Libreng edisyon | POST …/abilities/zinn-cache/refresh-cache/run | manage_options (the REST route's own check) | action: start|stop (kinakailangan) |
zinn-cache/remove-converted-imageszinn-cache-remove-converted-images | Alisin ang lahat ng na-convert na larawan (Pro) Dinedeleto sa background ang bawat na-convert na kopya ng mga larawan; mananatili ang mga orihinal. | Pro edisyon | POST …/abilities/zinn-cache/remove-converted-images/run | manage_options | wala |
zinn-cache/reset-settingszinn-cache-reset-settings | Ibalik ang mga setting ng cache sa kanilang mga default Ibinabalik ang bawat setting ng cache sa default nito, tulad ng ginagawa ng pindutang I-reset. Inaalis din ang naka-save na password ng Redis. | Libreng edisyon | POST …/abilities/zinn-cache/reset-settings/run | manage_options | wala |
zinn-cache/reset-slow-querieszinn-cache-reset-slow-queries | I-clear ang mga natuklasan sa mabagal na query (Pro) Kinakalimutan ang bawat mabagal na query at mabagal na tawag na natagpuan sa ngayon, at magsisimula muli ang tagahanap. | Pro edisyon | POST …/abilities/zinn-cache/reset-slow-queries/run | manage_options | wala |
zinn-cache/update-pro-settingszinn-cache-update-pro-settings | Baguhin ang mga setting ng Cache Pro (Pro) Binabago ang mga setting ng Cache Pro na ipapadala mo (mga setting: key sa value) at pinapanatili ang iba pa. Sinusuri ang bawat value nang eksakto tulad sa screen ng Cache Pro; tinatanggihan ang hindi kilalang key. | Pro edisyon | POST …/abilities/zinn-cache/update-pro-settings/run | manage_options | settings: object (kinakailangan) |
zinn-cache/update-settingszinn-cache-update-settings | Baguhin ang mga setting ng cache Binabago ang mga setting na ipinapadala mo at pinapanatili ang iba pa (page cache, gaano katagal mananatiling naka-cache ang mga page, ang object cache at ang koneksyon nito sa Redis, mga panuntunan sa pag-purge at mga pagbubukod). Ang mga value ay sinusuri at itinatama nang eksakto tulad ng nasa screen ng Cache. | Libreng edisyon | 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 | I-warm ang cache (Pro) Sinisimulang bisitahin ang bawat pahina sa mga sitemap sa background, upang makakuha ang mga bisita ng mga naka-cache na pahina. Iniulat ang progreso nito nang hiwalay habang ito ay tumatakbo. | Pro edisyon | POST …/abilities/zinn-cache/warm-cache/run | manage_options | wala |
Mga utos ng WP-CLI
Patakbuhin ang mga ito sa server gamit ang WP-CLI. Sinusuri ng bawat command ang parehong mga pahintulot gaya ng mga screen ng plugin; ang mga halimbawa ay kinuha mula sa sariling tekstong tulong ng plugin.
| Utos | Ang ginagawa nito | Edisyon |
|---|---|---|
wp zinn-cache purge allwp zinn-cache purge all | I-purge ang bawat naka-cache na pahina. | Libreng edisyon |
wp zinn-cache purge post<id>...wp zinn-cache purge post 42 | I-purge ang mga pahina ng isang post at ang mga listing kung saan ito lumalabas (home page, mga archive, mga feed). | Libreng edisyon |
wp zinn-cache purge url<url>...wp zinn-cache purge url https://example.com/ /pricing/ | I-purge ang mga naka-cache na pahina sa mga URL na ito. | Libreng edisyon |
wp zinn-cache refresh<action>wp zinn-cache refresh status | Simulan, ihinto o ipakita ang paced refresh (ang pumapalit sa "i-purge ang lahat" pagkatapos ng pag-update). | Libreng edisyon |
wp zinn-cache server detectwp zinn-cache server detect | Tingnan kung aling mga cache ang sumasagot sa harap ng site (nginx, Varnish, Apache, LiteSpeed, Cloudflare). | Libreng edisyon |
wp zinn-cache server drainwp zinn-cache server drain | Ipadala ang nakapilang pag-purge ng cache ng server ngayon sa halip na maghintay para sa WP-Cron. | Libreng edisyon |
wp zinn-cache status[--format=<format>]wp zinn-cache status --format=json | Iulat ang estado ng object cache. | Libreng edisyon |
Mga aksyon at filter
Bawat hook na iniaalok ng plugin, kasama ang paglalarawan mula sa source code nito. Binabago ng mga filter ang isang value; pinapahintulutan ka ng mga action na magpatakbo ng code sa isang partikular na sandali; ang mga entry point ay mga action na pinapagana mo para hilingin sa plugin na gumawa ng isang bagay.
| Hook | Uri | Ang ginagawa nito | Mga Parameter | Edisyon |
|---|---|---|---|---|
zinn_cache_control_header | I-filter | Sinasala ang halaga ng cache-control na ipinapadala sa LiteSpeed para sa isang napi-cache na pahina. | string $value, int $ttl | Libreng edisyon |
zinn_cache_fs_loaded | Aksyon | Nag-a-activate sa sandaling ma-load ang licensing SDK, bago ang iba pang bahagi ng Zinn® Cache. Mag-hook dito para makipag-ugnayan sa `zinn_cache_fs()`. | wala | Libreng edisyon |
zinn_cache_link_scan_post_types | I-filter | Mga uri ng post na saklaw ng pagsusuri. | wala | Libreng edisyon |
zinn_cache_mcp_abilities | Aksyon | Nag-a-apoy pagkatapos mairehistro ng Zinn® Cache ang mga kakayahan nito: Idinaragdag ng Zinn® Cache Pro ang sarili nito dito. | wala | Libreng edisyon |
zinn_cache_post_change_tags | I-filter | Sinasala ang mga cache tag na pinarurusahan kapag nagbago ang isang post. | string[] $tags, int $post_id, string $post_type | Libreng edisyon |
zinn_cache_purge_all | Aksyon | I-clear ang lahat, mula sa hilera ng Mga Tool. | wala | Libreng edisyon |
zinn_cache_purge_hosts | I-filter | Sinasala ang mga hostname na maaaring pangalanan ng mga pag-purge (para sa isang site na pinaglilingkuran sa higit sa isang domain). | string[] $hosts | Libreng edisyon |
zinn_cache_purge_on_seo_change | I-filter | Sinasala kung nililinis ng isang pagbabagong ginawa sa Zinn® SEO ang mga pahinang binago nito. | bool $on | Libreng edisyon |
zinn_cache_purge_plan | Punktong pinagmulan (ikaw ang magpapaandar nito) | Linisin nang eksakto kung ano ang tinutukoy ng isang plano: `do_action( 'zinn_cache_purge_plan', array( 'urls' => …, 'tags' => …, 'purge_all' => … ) )`. | wala | Libreng edisyon |
zinn_cache_purged | Aksyon | Nagpapadala pagkatapos ma-dispatch ng plugin ang isang cache purge. | array{purge_all:bool,urls:string[],tags:string[]} $plan | Libreng edisyon |
zinn_cache_purged_all | Aksyon | Na-trigger pagkatapos humiling ng buong paglilinis ng page cache. | string $reason | Libreng edisyon |
zinn_cache_refresh_armed | Aksyon | Tumatakbo kapag nagsimula ang isang may agwat na pag-refresh. | string $reason | Libreng edisyon |
zinn_cache_refresh_finished | Aksyon | Gumagana kapag ang isang may-agwat na pag-refresh ay umabot na sa dulo ng site. | int $pages | Libreng edisyon |
zinn_cache_refresh_guard | I-filter | Sinasala kung dapat bang mag-pause ang pag-refresh sa minutong ito (ang sariling proteksyon sa karga ng host). | string $reason | Libreng edisyon |
zinn_cache_refresh_urls | I-filter | Sinasala ang mga address na nililinis ng isang batch ng pag-refresh — idagdag dito ang mga address ng iba pang wika ng bawat pahina, halimbawa. | string[] $urls | Libreng edisyon |
zinn_cache_refreshed_urls | Aksyon | Gumagana pagkatapos ma-purge ang isang batch ng pag-refresh (muling pinapainit ng Zinn® Cache Pro ang mga pahinang ito). | string[] $urls | Libreng edisyon |
zinn_cache_request_cacheable | I-filter | Sinasala kung ang kasalukuyang kahilingan sa front-end ay maaaring ihain mula sa cache ng pahina. | bool $cacheable | Libreng edisyon |
zinn_cache_status_rows | I-filter | Sinasala ang mga hilera ng talahanayang «Ano ang nagka-cache sa site na ito» sa screen ng katayuan. | array<int,array{0:string,1:string}> $rows, array<string,mixed> $report | Libreng edisyon |
zinn_cache_ttl | I-filter | Sinasala kung gaano katagal naka-cache ang kasalukuyang pahina, sa mga segundo. | int $ttl | Libreng edisyon |