المطورون

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

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

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

⁦Zinn®⁩، محارب الفايكنج الخاص بنا، يهتف بينما يتصل مساعد الذكاء الاصطناعي بأدوات المنصة.

نقاط النهاية

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

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-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-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 الخاص بها، وقواعد التفريغ والاستثناءات). يتم فحص القيم وتصحيحها تمامًا كما هو الحال في شاشة Cache.
النسخة المجانية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/
تطهير الصفحات المخزنة مؤقتًا في عناوين URL هذه.النسخة المجانية
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 لصفحة قابلة للتخزين المؤقت.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النسخة المجانية