المطورون

مرجع قدرات Zinn® Cache

يسجل الإضافة Zinn® Cache إجراءاته باستخدام واجهة برمجة تطبيقات القدرات في WordPress. القدرات ذاتها هي أدوات MCP على خادم الموقع نفسه ومسارات REST ضمن /wp-json/wp-abilities/v1. يتم إنشاء هذه الصفحة من السجل الخاص بالإضافة.

دليل المستخدم: توصيل تطبيق ذكاء اصطناعي

نقاط النهاية

بروتوكول تحكم متعدد عبر بروتوكول نقل النص الفائق (قابل للبث)

https://example.com/wp-json/zinn-cache/v1/mcp

بروتوكول MCP عبر WP-CLI (الإدخال والإخراج القياسيان)

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 (HTTP Basic). يتطلب الاتصال بخادم 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 الخاص بالإضافة، والذي يتم توليد، بدوره، من موقع قيد التشغيل؛ يفشل الاختبار عندما لا يتطابق الطرفان.

القدرة	ما تفعله	الإصدار	إيقاف مؤقت	إذن	المعاملات
`zinn-cache/clean-database` `zinn-cache-clean-database`	تنظيف قاعدة البيانات (Pro) يزيل، في الخلفية، أنواع الفوضى التي يتم تفعيلها في الإعدادات. لا يمكن استعادة ما يتم إزالته.	إصدار المحترفين	`POST …/abilities/zinn-cache/clean-database/run`	manage_options	لا شيء
`zinn-cache/convert-images` `zinn-cache-convert-images`	تحويل كافة الصور الموجودة (احترافي) يبدأ في تحويل صور مكتبة الوسائط إلى التنسيقات الحديثة المُفعلة في الإعدادات، في الخلفية.	إصدار المحترفين	`POST …/abilities/zinn-cache/convert-images/run`	manage_options	لا شيء
`zinn-cache/get-cache-analytics` `zinn-cache-get-cache-analytics`	قراءة تحليلات ذاكرة التخزين المؤقت (Pro) يعرض معدل الإصابة وحركة المرور لذاكرة التخزين المؤقت للأغراض خلال الساعات الأخيرة (بالساعات، حتى 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`	قراءة تقدم تحويل الصور (Pro) يعيد مدى تقدم تحويل الصور (أو إزالتها).	إصدار المحترفين	`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`	قراءة أداة البحث عن الاستعلامات البطيئة (Pro) تعرض أبطأ استعلامات قاعدة البيانات والاتصالات الصادرة التي رصدها الباحث، مع الملحق أو السمة التي أنشأت كل منها.	إصدار المحترفين	`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`	معاينة تنظيف قاعدة البيانات (Pro) يحسب ما سيزيله إجراء التنظيف، حسب النوع (المراجعات، المسودات، البريد العشوائي، البيانات المؤقتة منتهية الصلاحية وما شابه). لا يتم إزالة أي شيء.	إصدار المحترفين	`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`	إزالة كافة الصور المحولة (Pro) يحذف كل نسخة محولة من الصور في الخلفية؛ وتبقى النسخ الأصلية.	إصدار المحترفين	`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 التي ترسلها (الإعدادات: المفتاح إلى القيمة) ويحتفظ بالبقية. يتم التحقق من كل قيمة تماماً كما هي في شاشة 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`	تفعيل الذاكرة المؤقتة (Pro) يبدأ بزيارة كل صفحة في خرائط الموقع في الخلفية، لكي يحصل الزوار على صفحات مخبأة مؤقتاً. اتبع ذلك بـ zinn-cache/get-warmup-progress.	إصدار المحترفين	`POST …/abilities/zinn-cache/warm-cache/run`	manage_options	لا شيء