المطورون
مرجع قدرات 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-cacheREST: تشغيل قدرة
/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-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 الخاص بالإضافة، والذي يتم توليد، بدوره، من موقع قيد التشغيل؛ يفشل الاختبار عندما لا يتطابق الطرفان.
| القدرة | ما يفعله | الإصدار | إيقاف مؤقت | الإذن | المعلمات |
|---|---|---|---|---|---|
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 الخاص بها، وقواعد التفريغ والاستثناءات). يتم فحص القيم وتصحيحها تمامًا كما هو الحال في شاشة Cache. | النسخة المجانية | 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 | أبلغ عن حالة تخزين الكائنات المؤقت. | النسخة المجانية |
الإجراءات وعوامل التصفية
كل خطاف يوفره الملحق الإضافي، مع الوصف من الكود المصدري الخاص به. تغير المرشحات قيمة؛ وتتيح لك الإجراءات تشغيل كود في لحظة محددة؛ ونقاط الدخول هي إجراءات تطلقها لتطلب من الملحق الإضافي القيام بشيء ما.
| خطاف | النوع | ما يفعله | المعلمات | الإصدار |
|---|---|---|---|---|
zinn_cache_control_header | تصفية | يصفّي قيمة التحكم في التخزين المؤقت المرسلة إلى LiteSpeed لصفحة قابلة للتخزين المؤقت. | 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 | إجراء | تتم معالجتها بعد أن يقوم الملحق بإرسال عملية مسح ذاكرة التخزين المؤقت. | 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 | النسخة المجانية |