ڈویلپرز

Zinn® Cache کی صلاحیتوں کا حوالہ

Zinn® Cache اپنے ایکشنز کو WordPress Abilities API کے ساتھ رجسٹر کرتا ہے۔ یہی abilities سائٹ کے اپنے سرور پر MCP ٹولز اور /wp-json/wp-abilities/v1 کے تحت REST روٹس ہیں۔ یہ صفحہ پلگ ان کی اپنی رجسٹری سے تیار کیا گیا ہے۔

صارف گائیڈ: ایک AI ایپ مربوط کریں

⁦Zinn®⁩، ہمارا وائکنگ، نعرہ لگا رہا ہے جب کہ ایک AI اسسٹنٹ پلیٹ فارم کے ٹولز سے منسلک ہوتا ہے۔

اینڈ پوائنٹس

MCP بذریعہ HTTP (اسٹریمیبل)

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-cache

REST: ایک قابلیت چلائیں

/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-database
zinn-cache-clean-database
ڈیٹا بیس صاف کریں (Pro)
سیٹنگز میں آن کی گئی غیر ضروری عناصر کی اقسام کو پس منظر میں ہٹا دیتا ہے۔ جو ہٹا دیا جائے اسے واپس نہیں لایا جا سکتا۔
پرو ایڈیشنPOST …/abilities/zinn-cache/clean-database/runmanage_optionsکوئی نہیں
zinn-cache/convert-images
zinn-cache-convert-images
تمام موجود تصاویر تبدیل کریں (Pro)
میڈیا لائبریری کی تصاویر کو ترتیبات میں فعال کردہ جدید فارمیٹس میں پس منظر میں تبدیل کرنا شروع کرتا ہے۔
پرو ایڈیشنPOST …/abilities/zinn-cache/convert-images/runmanage_optionsکوئی نہیں
zinn-cache/detect-cache-layers
zinn-cache-detect-cache-layers
سائٹ کے سامنے موجود کیشز کا پتہ لگائیں
ہوم پیج کی بالکل اسی طرح درخواست کرتا ہے جیسے کوئی دیکھنے والا کرے گا اور محفوظ کرتا ہے کہ کن کیشز نے جواب دیا۔ sample: true کے ساتھ یہ جدید ترین صفحات کی بھی دو بار درخواست کرتا ہے اور شمار کرتا ہے کہ ہر تہہ نے کتنی بار انہیں اپنے کیشے سے پیش کیا۔
مفت ایڈیشنPOST …/abilities/zinn-cache/detect-cache-layers/runmanage_options (the REST route's own check)sample: boolean
zinn-cache/get-cache-analytics
zinn-cache-get-cache-analytics
کیشے کے تجزیات پڑھیں (Pro)
گزشتہ گھنٹوں (گھنٹے، 720 تک) کے لیے آبجیکٹ کیشے کی ہٹ کی شرح اور ٹریفک، اس کے سست ترین کمانڈز، اور کون سے پلگ انز کیشے کو سب سے زیادہ مس کرتے ہیں، واپس کرتا ہے۔
پرو ایڈیشنGET …/abilities/zinn-cache/get-cache-analytics/runmanage_optionshours: integer
zinn-cache/get-cache-layers
zinn-cache-get-cache-layers
پڑھیں کہ سائٹ کو کیا چیز کیش کر رہی ہے
یہ بتاتا ہے کہ کون سا کیش صفحات فراہم کرتا ہے (LiteSpeed، nginx، Varnish، Apache، Cloudflare یا پلگ ان کا ڈسک کیش)، آخری بار پتہ لگانے پر کیا پایا گیا، ہر پرت کا سائز جہاں WordPress اسے پڑھ سکتا ہے، پرج کی قطار، رفتار کے ساتھ کی جانے والی تجدید اور حالیہ پرجز۔
مفت ایڈیشنGET …/abilities/zinn-cache/get-cache-layers/runmanage_options (the REST route's own check)کوئی نہیں
zinn-cache/get-diagnostics
zinn-cache-get-diagnostics
تشخیصی رپورٹ پڑھیں
تشخیصی رپورٹ واپس کرتا ہے جو سپورٹ طلب کرتی ہے: ورژنز، سرور کی حدود، کیشے کی حالت اور حالیہ غلطیاں۔ اس میں کوئی پاس ورڈ یا کیز نہیں ہیں۔
مفت ایڈیشنGET …/abilities/zinn-cache/get-diagnostics/runmanage_optionsکوئی نہیں
zinn-cache/get-image-progress
zinn-cache-get-image-progress
تصویر کی تبدیلی کی پیش رفت پڑھیں (Pro)
یہ واپس کرتا ہے کہ تصاویر کو تبدیل کرنے (یا ہٹانے) کا عمل کہاں تک پہنچا ہے۔
پرو ایڈیشنGET …/abilities/zinn-cache/get-image-progress/runmanage_optionsکوئی نہیں
zinn-cache/get-pro-settings
zinn-cache-get-pro-settings
Cache Pro کی ترتیبات پڑھیں (Pro)
ہر Cache Pro ترتیب (وارم اپ، تصاویر، اسکرپٹس اور اسٹائلز، ڈیٹا بیس کی صفائی، سمارٹ پرجنگ، فائنڈر) واپس کرتا ہے۔ خفیہ معلومات کبھی واپس نہیں کی جاتیں۔
پرو ایڈیشنGET …/abilities/zinn-cache/get-pro-settings/runmanage_optionsکوئی نہیں
zinn-cache/get-settings
zinn-cache-get-settings
کیش کی ترتیبات پڑھیں
کیشے کی ہر ترتیب واپس کرتا ہے۔ Redis پاس ورڈ اور Cloudflare ٹوکن کبھی واپس نہیں کیے جاتے، صرف یہ بتایا جاتا ہے کہ آیا کوئی محفوظ ہے یا نہیں۔
مفت ایڈیشنGET …/abilities/zinn-cache/get-settings/runmanage_optionsکوئی نہیں
zinn-cache/get-slow-queries
zinn-cache-get-slow-queries
سست استفسارات تلاش کنندہ پڑھیں (Pro)
تلاش کنندہ کے مشاہدے میں آنے والے سست ترین ڈیٹابیس کے استفسارات اور آؤٹ گوئنگ کالز کو اس پلگ ان یا تھیم کے ساتھ واپس کرتا ہے جس نے ہر ایک کو انجام دیا ہے۔
پرو ایڈیشنGET …/abilities/zinn-cache/get-slow-queries/runmanage_optionsکوئی نہیں
zinn-cache/get-status
zinn-cache-get-status
کیشے کی حالت پڑھیں
یہ بتاتا ہے کہ آیا صفحہ کیشے اور آبجیکٹ کیشے آن ہیں اور کام کر رہے ہیں، کتنے صفحات کیشے کیے گئے ہیں، اور آبجیکٹ کیشے کے کنکشن اور ہٹ کی تعداد کیا ہے۔
مفت ایڈیشنGET …/abilities/zinn-cache/get-status/runmanage_optionsکوئی نہیں
zinn-cache/get-warmup-progress
zinn-cache-get-warmup-progress
وارم اپ کی پیشرفت پڑھیں (Pro)
واپس کرتا ہے کہ آیا وارم اپ چل رہا ہے، اس نے کتنے صفحات کا دورہ کیا ہے اور کتنے ناکام ہوئے۔
پرو ایڈیشنGET …/abilities/zinn-cache/get-warmup-progress/runmanage_optionsکوئی نہیں
zinn-cache/preview-database-cleanup
zinn-cache-preview-database-cleanup
ڈیٹابیس کی صفائی کا پیش منظر دیکھیں (Pro)
گنتا ہے کہ صفائی کے دوران قسم کے لحاظ سے کیا ہٹایا جائے گا (نظرثانی، مسودات، سپیم، زائد المیعاد عارضی ڈیٹا اور اس طرح کی دیگر چیزیں)۔ کچھ بھی نہیں ہٹایا جاتا۔
پرو ایڈیشنGET …/abilities/zinn-cache/preview-database-cleanup/runmanage_optionsکوئی نہیں
zinn-cache/purge
zinn-cache-purge
کیشے صاف کریں
کیش شدہ صفحات کو خارج کرتا ہے: سب کچھ (all: true)، کچھ پتے (urls) یا وہ تمام جن پر ٹیگ لگا ہے (tags)۔ جیسے جیسے زائرین آتے ہیں، صفحات دوبارہ بنتے جاتے ہیں۔
مفت ایڈیشنPOST …/abilities/zinn-cache/purge/runmanage_options (the REST route's own check)all: boolean, urls: array, tags: array
zinn-cache/purge-urls
zinn-cache-purge-urls
ہر کیشے پرت پر کچھ پتوں کو صاف کریں
ان پتوں کو (راستے جیسے /about/ یا اس سائٹ کے مکمل پتے) ڈسک کیش، سرور کیش اور Cloudflare سے ایک ساتھ ہٹاتا ہے، اور بتاتا ہے کہ ہر تہہ نے کیا جواب دیا۔
مفت ایڈیشنPOST …/abilities/zinn-cache/purge-urls/runmanage_options (the REST route's own check)urls: array (لازمی)
zinn-cache/refresh-cache
zinn-cache-refresh-cache
رفتار کے مطابق ریفریش شروع یا بند کریں
action: start ہر صفحے کو فی منٹ ایک بیچ کے حساب سے ریفریش کرتا ہے (جو اپ ڈیٹس کیشے کو خالی کرنے کے بجائے کرتی ہیں)؛ action: stop جاری ریفریش کو ختم کرتا ہے۔
مفت ایڈیشنPOST …/abilities/zinn-cache/refresh-cache/runmanage_options (the REST route's own check)action: start|stop (لازمی)
zinn-cache/remove-converted-images
zinn-cache-remove-converted-images
تمام تبدیل شدہ تصاویر ہٹائیں (Pro)
پس منظر میں تصاویر کی ہر تبدیل شدہ کاپی کو حذف کرتا ہے؛ اصل تصاویر برقرار رہتی ہیں۔
پرو ایڈیشنPOST …/abilities/zinn-cache/remove-converted-images/runmanage_optionsکوئی نہیں
zinn-cache/reset-settings
zinn-cache-reset-settings
کیش کی ترتیبات کو ان کے پہلے سے طے شدہ پر واپس لائیں
کیشے کی ہر ترتیب کو اس کے پہلے سے طے شدہ پر واپس لاتا ہے، جیسا کہ ری سیٹ کا بٹن کرتا ہے۔ محفوظ کردہ Redis پاس ورڈ بھی ہٹا دیا جاتا ہے۔
مفت ایڈیشنPOST …/abilities/zinn-cache/reset-settings/runmanage_optionsکوئی نہیں
zinn-cache/reset-slow-queries
zinn-cache-reset-slow-queries
سست استفسارات کے نتائج صاف کریں (Pro)
اب تک پائے جانے والے ہر سست استفسار اور سست کال کو بھول جاتا ہے، اور تلاش کنندہ دوبارہ شروع ہوتا ہے۔
پرو ایڈیشنPOST …/abilities/zinn-cache/reset-slow-queries/runmanage_optionsکوئی نہیں
zinn-cache/update-pro-settings
zinn-cache-update-pro-settings
Cache Pro کی ترتیبات تبدیل کریں (Pro)
آپ کی بھیجی گئی Cache Pro ترتیبات کو تبدیل کرتا ہے (ترتیبات: کلید سے قدر) اور باقی کو برقرار رکھتا ہے۔ ہر قدر کی بالکل اسی طرح جانچ پڑتال کی جاتی ہے جیسے Cache Pro اسکرین پر ہوتی ہے؛ نامعلوم کلید مسترد کر دی جاتی ہے۔
پرو ایڈیشنPOST …/abilities/zinn-cache/update-pro-settings/runmanage_optionssettings: object (لازمی)
zinn-cache/update-settings
zinn-cache-update-settings
کیش کی ترتیبات تبدیل کریں
آپ کی بھیجی گئی ترتیبات کو تبدیل کرتا ہے اور باقی کو برقرار رکھتا ہے (صفحہ کیش، صفحات کتنی دیر تک کیش رہتے ہیں، آبجیکٹ کیش اور اس کا Redis کنکشن، صاف کرنے کے قواعد اور استثنیات)۔ اقدار بالکل اسی طرح چیک اور درست کی جاتی ہیں جیسا کہ کیش اسکرین پر ہوتا ہے۔
مفت ایڈیشنPOST …/abilities/zinn-cache/update-settings/runmanage_optionslscache_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-cache
zinn-cache-warm-cache
کیشے کو گرم کریں (Pro)
پس منظر میں سائٹ میپس کے ہر صفحے پر جانا شروع کرتا ہے، تاکہ دیکھنے والوں کو کیش شدہ صفحات مل سکیں۔ چلنے کے دوران اس کی پیش رفت کی الگ سے اطلاع دی جاتی ہے۔
پرو ایڈیشنPOST …/abilities/zinn-cache/warm-cache/runmanage_optionsکوئی نہیں

WP-CLI کمانڈز

انہیں سرور پر WP-CLI کے ساتھ چلائیں۔ ہر کمانڈ پلگ ان کی اسکرینوں جیسی ہی اجازتوں کی جانچ کرتی ہے؛ مثالیں پلگ ان کے اپنے مددگار متن سے لی گئی ہیں۔

کمانڈیہ کیا کرتا ہےایڈیشن
wp zinn-cache purge all
wp 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 detect
wp zinn-cache server detect
چیک کریں کہ سائٹ کے سامنے کون سے کیشز جواب دیتے ہیں (nginx، Varnish، Apache، LiteSpeed، Cloudflare)۔مفت ایڈیشن
wp zinn-cache server drain
wp 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مفت ایڈیشن