ڈویلپرز

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

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

صارف گائیڈ: ایک 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-diagnostics/run"

# MCP (JSON-RPC over HTTP, after "initialize")
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"zinn-cache-get-diagnostics","arguments":{}}}

تمام صلاحیتیں

یہ پلگ ان کی abilities.json سے تیار کیا گیا ہے، جو خود ایک فعال سائٹ سے تیار ہوتی ہے؛ جب دونوں میں اختلاف ہوتا ہے تو ٹیسٹ ناكام ہو جاتا ہے۔

صلاحیت	یہ کیا کرتا ہے	ایڈیشن	REST	اجازت	پیرامیٹرز
`zinn-cache/clean-database` `zinn-cache-clean-database`	ڈیٹا بیس صاف کریں (پرو) پس منظر میں، ترتیبات میں فعال کردہ قسم کے کچرے کو ہٹا دیتا ہے۔ جو چیز ہٹا دی جائے اسے واپس نہیں لایا جا سکتا۔	پرو ایڈیشن	`POST …/abilities/zinn-cache/clean-database/run`	manage_options	کوئی نہیں
`zinn-cache/convert-images` `zinn-cache-convert-images`	تمام موجودہ تصاویر کو تبدیل کریں (Pro) ترہتیات میں منتخب کیے گئے جدید فارمیٹس میں میڈیا لائبریری کی تصاویر کو پس منظر میں تبدیل کرنا شروع کرتا ہے۔	پرو ایڈیشن	`POST …/abilities/zinn-cache/convert-images/run`	manage_options	کوئی نہیں
`zinn-cache/get-cache-analytics` `zinn-cache-get-cache-analytics`	کیش کے تجزیات پڑھیں (پرو) پچھلے چند گھنٹوں (گھنٹے، 720 تک) کے لیے آبجیکٹ کیش کی ہٹ ریٹ اور ٹریفک، اس کی سب سے سست کمانڈز، اور کون سے پلگ انز کیش سے سب سے زیادہ محروم رہتے ہیں، واپس کرتا ہے۔	پرو ایڈیشن	`GET …/abilities/zinn-cache/get-cache-analytics/run`	manage_options	hours: integer
`zinn-cache/get-diagnostics` `zinn-cache-get-diagnostics`	تشخیص کی رپورٹ پڑھیں وہ تشخیصی رپورٹ واپس کرتا ہے جس کا سپورٹ عملہ مطالبہ کرتا ہے: ورژنز، سرور کی حدیں، کیش کی حالت اور حالیہ غلطیاں۔ اس میں کوئی پاس ورڈ یا کُنجیاں محفوظ نہیں ہوتیں۔	مفت ایڈیشن	`GET …/abilities/zinn-cache/get-diagnostics/run`	manage_options	کوئی نہیں
`zinn-cache/get-image-progress` `zinn-cache-get-image-progress`	تصویر کی تبدیلی کی پیشرفت پڑھیں (پرو) یہ بتاتا ہے کہ تصویروں کی تبدیلی (یا ہٹانے) کا عمل کہاں تک پہنچ گیا ہے۔	پرو ایڈیشن	`GET …/abilities/zinn-cache/get-image-progress/run`	manage_options	کوئی نہیں
`zinn-cache/get-pro-settings` `zinn-cache-get-pro-settings`	کیش پرو (Cache Pro) کی ترتیبات پڑھیں (پرو) Cache Pro کی تمام ترتیبات (وارم اپ، تصاویر، اسکرپٹس اور اسٹائلز، ڈیٹا بیس کی صفائی، سمارٹ پرجنگ، فائنڈر) واپس کرتا ہے۔ سیکریٹس کبھی واپس نہیں کیے جاتے۔	پرو ایڈیشن	`GET …/abilities/zinn-cache/get-pro-settings/run`	manage_options	کوئی نہیں
`zinn-cache/get-settings` `zinn-cache-get-settings`	کیش کی ترتیبات پڑھیں تمام کیش سیٹنگز واپس کرتا ہے۔ Redis پاس ورڈ کبھی واپس نہیں کیا جاتا، صرف یہ کہ آیا کوئی محفوظ ہے یا نہیں۔	مفت ایڈیشن	`GET …/abilities/zinn-cache/get-settings/run`	manage_options	کوئی نہیں
`zinn-cache/get-slow-queries` `zinn-cache-get-slow-queries`	سست کوئیری فائنڈر (پرو) پڑھیں فائنڈر کو ملنے والی سب سے سست ڈیٹا بیس کیوریز اور آؤٹ گوئنگ کالز واپس کرتا ہے، ساتھ ہی اس پلگ ان یا تھیم کے جن کی وجہ سے وہ ہوئیں۔	پرو ایڈیشن	`GET …/abilities/zinn-cache/get-slow-queries/run`	manage_options	کوئی نہیں
`zinn-cache/get-status` `zinn-cache-get-status`	کیش کی حیثیت پڑھیں یہ بتاتا ہے کہ آیا پیج کیش اور آبجیکٹ کیش آن ہیں اور کام کر رہے ہیں، کتنے صفحات کیش کیے گئے ہیں، اور آبجیکٹ کیش کا کنکشن اور ہٹ نمبر کیا ہیں۔	مفت ایڈیشن	`GET …/abilities/zinn-cache/get-status/run`	manage_options	کوئی نہیں
`zinn-cache/get-warmup-progress` `zinn-cache-get-warmup-progress`	وارم اپ کی پیش رفت پڑھیں (پرو) یہ بتاتا ہے کہ آیا وارم اپ چل رہا ہے، اس نے کتنے صفحات کا دورہ کیا ہے اور کتنے ناکام ہوئے ہیں۔	پرو ایڈیشن	`GET …/abilities/zinn-cache/get-warmup-progress/run`	manage_options	کوئی نہیں
`zinn-cache/preview-database-cleanup` `zinn-cache-preview-database-cleanup`	ڈیٹا بیس کلین اپ کا پیش منظر (پرو) صفائی کے دوران جو کچھ حذف ہو گا اس کی گنتی کرتا ہے، بلحاظ قسم (نظرثانی، مسودات، اسپیم، میعاد ختم ہونے والا عارضی ڈیٹا اور اس طرح کی دوسری چیزیں)۔ کچھ بھی حذف نہیں کیا جاتا۔	پرو ایڈیشن	`GET …/abilities/zinn-cache/preview-database-cleanup/run`	manage_options	کوئی نہیں
`zinn-cache/purge` `zinn-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/remove-converted-images` `zinn-cache-remove-converted-images`	تمام تبدیل شدہ تصاویر ہٹا دیں (پرو) پس منظر میں تصاویر کی ہر تبدیل شدہ نقل کو حذف کر دیتا ہے؛ اصل باقی رہتی ہیں۔	پرو ایڈیشن	`POST …/abilities/zinn-cache/remove-converted-images/run`	manage_options	کوئی نہیں
`zinn-cache/reset-settings` `zinn-cache-reset-settings`	کیش کی ترتیبات کو ان کی پیش فرض حالت پر واپس کر دیں ری سیٹ کے بٹن کی طرح، ہر کیش سیٹنگ کو اس کی ڈیفالٹ حالت پر واپس لے جاتا ہے۔ محفوظ کردہ Redis پاس ورڈ بھی ہٹا دیا جاتا ہے۔	مفت ایڈیشن	`POST …/abilities/zinn-cache/reset-settings/run`	manage_options	کوئی نہیں
`zinn-cache/reset-slow-queries` `zinn-cache-reset-slow-queries`	سلو کوئیری کے نتائج صاف کریں (Pro) اب تک ملنے والی ہر سست کوئری اور سست کال کو بھلا دیتا ہے، اور فائنڈر دوبارہ شروع ہوتا ہے۔	پرو ایڈیشن	`POST …/abilities/zinn-cache/reset-slow-queries/run`	manage_options	کوئی نہیں
`zinn-cache/update-pro-settings` `zinn-cache-update-pro-settings`	Cache Pro کی سیٹنگز تبدیل کریں (Pro) آپ کی بھیجی گئی کیش پرو (Cache Pro) سیٹنگز (سیٹنگ: کلید سے قدر) کو تبدیل کرتا ہے اور باقی کو برقرار رکھتا ہے۔ ہر قدر کی جانچ بالکل کیش پرو اسکرین جیسی ہوتی ہے؛ نامعلوم کلید کو مسترد کر دیا جاتا ہے۔	پرو ایڈیشن	`POST …/abilities/zinn-cache/update-pro-settings/run`	manage_options	settings: object (لازمی)
`zinn-cache/update-settings` `zinn-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
`zinn-cache/warm-cache` `zinn-cache-warm-cache`	کیش گرم کریں (پرو) پس منظر میں سائٹ میپ کے ہر صفحے پر جانا شروع کرتا ہے، تاکہ زائرین کو کیش شدہ صفحات ملیں۔ اس کے بعد zinn-cache/get-warmup-progress استعمال کریں۔	پرو ایڈیشن	`POST …/abilities/zinn-cache/warm-cache/run`	manage_options	کوئی نہیں