پرمخبیوونکي
د Zinn® Cache وړتیاوې حواله
Zinn® Cache خپل کړنې د WordPress Abilities API سره ثبتوي. ورته وړتیاوې د سایټ په خپل سرور کې د MCP وسیلې او د /wp-json/wp-abilities/v1 لاندې د REST لارې دي. دا پاڼه د پلگ ان د خپل راجستر څخه جوړه شوې ده.
پای ټکي
د HTTP له لارې MCP (د سیند وړ)
https://example.com/wp-json/zinn-cache/v1/mcpد WP-CLI له لارې MCP (معیاري ان پټ او آوټ پټ)
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 او د هغو ورودی په پوښتنې پټه (query string) کې چلیږي؛ نورې د 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 څخه تولید شوی، چېخپل پخپله له یوه فعال سایټ څخه تولید شوی؛ کله چې دواړه سره یو شان نه وي، ازموینه ناکامیږي.
| قابلیت | دا څه کوي | نسخه | REST | اجازه | پارامترونه |
|---|---|---|---|---|---|
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) د تېرو ساعتونو لپاره د ابجکټ کيش د هټ کچه (hit rate) او ټرافیک (تر ۷۲۰ ساعتونو پورې)، د هغې تر ټولو ورو کمانډونه، او دا چې کوم پلګینونه تر ټولو زیات کيش له لاسه ورکوي بېرته راګرځوي. | پرو نسخه | 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 اړیکه، د پاکولو اصول او استثناوې). ارزښتونه کټ مټ لکه د کیش په سکرین کې کتل کیږي او سم کیږي. | وړیا نسخه | 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/ | په دې URL پتو کې زیرمه شوې پاڼې پاکې کړئ. | وړیا نسخه |
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) حالت راپور کړئ. | وړیا نسخه |
کړنې او فلترونه
plugin د سرچینې کوډ د توضیحاتو سره، هر هغه هک وړاندې کوي چې پلگ ان يې لري. فلټرونه یو ارزق بدلوي؛ عملونه تاسو ته اجازه درکوي چې په یو وخت کې کوډ اجرا کړئ؛ د داخلېدو نقطې هغه عملونه دي چې تاسو يې د یو شي د ترسره کولو لپاره په پلگ ان غوښتنه کوئ.
| هوک | ډول | دا څه کوي | پارامترونه | نسخه |
|---|---|---|---|---|
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 | فلټر | د هغو کیش ټاګونو فلټرونه چې د پوسټ بدلېدو پر مهال پاکېږي. | 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 purge) پروسه پيل کړي، دا فعالېږي. | 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 | فلټر | فلتر کوي چې ایا د مخکینۍ برخې اوسنۍ غوښتنه د پاڼې کیچ څخه پوره کیدی شي که نه. | bool $cacheable | وړیا نسخه |
zinn_cache_status_rows | فلټر | د وضعیت سکرین د «څه شی دا سایټ کیش کوي» جدول قطارونه فلټر کوي. | array<int,array{0:string,1:string}> $rows, array<string,mixed> $report | وړیا نسخه |
zinn_cache_ttl | فلټر | دا فلتر کوي چې اوسنی پاڼه د څومره وخت لپاره، په ثانیو کې، کیش شي. | int $ttl | وړیا نسخه |