ڈویلپرز
Zinn® Cache کی صلاحیتوں کا حوالہ
Zinn® Cache اپنے ایکشنز کو WordPress Abilities API کے ساتھ رجسٹر کرتا ہے۔ یہی abilities سائٹ کے اپنے سرور پر MCP ٹولز اور /wp-json/wp-abilities/v1 کے تحت REST روٹس ہیں۔ یہ صفحہ پلگ ان کی اپنی رجسٹری سے تیار کیا گیا ہے۔
اینڈ پوائنٹس
MCP بذریعہ HTTP (اسٹریمیبل)
https://example.com/wp-json/zinn-cache/v1/mcpWP-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 ایپلیکیشن پاس ورڈ (ایچ ٹی ٹی پی بیسک) کے ساتھ توثیق کرتی ہیں۔ ایم سی پی (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 سے تیار کیا گیا ہے، جو خود ایک فعال سائٹ سے تیار ہوتی ہے؛ جب دونوں میں اختلاف ہوتا ہے تو ٹیسٹ ناكام ہو جاتا ہے۔
| صلاحیت | یہ کیا کرتا ہے | ایڈیشن | 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) گزشتہ گھنٹوں (گھنٹے، 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 کنکشن، صاف کرنے کے قواعد اور استثنیات)۔ اقدار بالکل اسی طرح چیک اور درست کی جاتی ہیں جیسا کہ کیش اسکرین پر ہوتا ہے۔ | مفت ایڈیشن | 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/ | ان URLs پر موجود کیش شدہ صفحات کو صاف کریں۔ | مفت ایڈیشن |
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 | آبجیکٹ کیشے کی حالت کی رپورٹ کریں۔ | مفت ایڈیشن |
اعمال اور فلٹرز
پلگ ان پیش کرتا ہے وہ تمام ہکس، اس کے ماؤنٹ کوڈ کی تفصیل کے ساتھ۔ فلٹرز کسی قدر کو تبدیل کرتے ہیں؛ ایکشنز آپ کو کسی لمحے پر کوڈ چلانے کی اجازت دیتے ہیں؛ انٹری پوائنٹس وہ ایکشنز ہیں جنہیں آپ پلگ ان سے کچھ کرنے کا کہنے کے لیے فائر کرتے ہیں۔
| ہک | قسم | یہ کیا کرتا ہے | پیرامیٹرز | ایڈیشن |
|---|---|---|---|---|
zinn_cache_control_header | فلٹر کریں | ایک قابلِ کیش صفحے کے لیے LiteSpeed کو بھیجی جانے والی کیش کنٹرول (cache-control) ویلیو کو فلٹر کرتا ہے۔ | string $value, int $ttl | مفت ایڈیشن |
zinn_cache_fs_loaded | کارروائی | یہ اس وقت متحرک ہوتا ہے جب لائسنسنگ SDK لوڈ ہو جائے، Zinn® Cache کے باقی حصے سے پہلے۔ `zinn_cache_fs()` سے رابطہ کرنے کے لیے یہاں ہک (hook) کریں۔ | کوئی نہیں | مفت ایڈیشن |
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 | کارروائی | جب پلگ ان نے کیش صاف (پرج) کر دیا ہو تو یہ متحرک ہوتا ہے۔ | array{purge_all:bool,urls:string[],tags:string[]} $plan | مفت ایڈیشن |
zinn_cache_purged_all | کارروائی | جب پیج کیشے (page cache) کی مکمل صفائی کی درخواست کی جائے تو یہ فائر ہوتا ہے۔ | 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 | فلٹر کریں | موجودہ صفحہ کتنی دیر کے لیے کیش (cache) کیا گیا ہے، اسے سیکنڈوں میں فلٹر کرتا ہے۔ | int $ttl | مفت ایڈیشن |