מפתחים

הפניות ליכולות של Zinn® Cache

Zinn® Cache רושם את הפעולות שלו באמצעות ה-WordPress Abilities API. אותן יכולות הן כלי MCP בשרת של האתר עצמו ונתיבי REST תחת /wp-json/wp-abilities/v1. דף זה מופק מתוך הרישום של התוסף עצמו.

מדריך למשתמש: חיבור אפליקציית בינה מלאכותית

⁦Zinn®⁩, הוויקינג שלנו, מריע כאשר עוזר בינה מלאכותית מתחבר לכלי הפלטפורמה.

נקודות קצה

MCP דרך HTTP (ניתן להזרמה)

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 והקלט שלהן במחרוזת השילתא (query string); השאר פועלות עם 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)
מסיר ברקע את סוגי העומס שהופעלו בהגדרות. מה שמוסר אינו ניתן לשחזור.
מהדורת ProPOST …/abilities/zinn-cache/clean-database/runmanage_optionsללא
zinn-cache/convert-images
zinn-cache-convert-images
המרת כל התמונות הקיימות (Pro)
מתחיל בהמרת התמונות בספריית המדיה לתבניות המודרניות שמופעלות בהגדרות, ברקע.
מהדורת ProPOST …/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)
מחזיר את יחס הפגיעות (hit rate) ואת התעבורה של מטמון האובייקטים (object cache) עבור השעות האחרונות (שעות, עד 720), את הפקודות האיטיות ביותר שלו, ואילו תוספים מחטיאים את המטמון במידה הרבה ביותר.
מהדורת ProGET …/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)
מחזיר את מידת ההתקדמות של המרת (או הסרת) התמונות.
מהדורת ProGET …/abilities/zinn-cache/get-image-progress/runmanage_optionsללא
zinn-cache/get-pro-settings
zinn-cache-get-pro-settings
קרא את הגדרות Cache Pro (Pro)
מחזיר כל הגדרה של Cache Pro (חימום, תמונות, סקריפטים וסגנונות, ניקוי מסד נתונים, ניקוי חכם, האיתור). סודות לעולם אינם מוחזרים.
מהדורת ProGET …/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)
מחזיר את שאילתות מסד הנתונים והקריאות היוצאות האיטיות ביותר שהמאתר זיהה, בצירוף התוסף או התבנית שביצעו כל אחת מהן.
מהדורת ProGET …/abilities/zinn-cache/get-slow-queries/runmanage_optionsללא
zinn-cache/get-status
zinn-cache-get-status
קריאת מצב המטמון
מחזיר האם מטמון העמודים ומטמון האובייקטים פועלים ותקינים, כמה עמודים שמורים במטמון, ואת מספרי החיבורים והפגיעות (hits) של מטמון האובייקטים.
מהדורה חינמיתGET …/abilities/zinn-cache/get-status/runmanage_optionsללא
zinn-cache/get-warmup-progress
zinn-cache-get-warmup-progress
קרא את התקדמות החימום (Pro)
מחזיר אם החימום פועל, בכמה עמודים הוא ביקר וכמה נכשלו.
מהדורת ProGET …/abilities/zinn-cache/get-warmup-progress/runmanage_optionsללא
zinn-cache/preview-database-cleanup
zinn-cache-preview-database-cleanup
תצוגה מקדימה של ניקוי מסד הנתונים (Pro)
סופר מה יוסר בניקוי, לפי סוג (גרסאות, טיוטות, זבל, נתונים זמניים שפג תוקפם וכדומה). שום דבר אינו מוסר.
מהדורת ProGET …/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)
מוחק ברקע כל עותק שהומר של התמונות; קובצי המקור נשארים.
מהדורת ProPOST …/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)
שוכח כל שאילתה איטית וקריאה איטית שנמצאו עד כה, והמוצא מתחיל מחדש.
מהדורת ProPOST …/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; מפתח לא מוכר נדחה.
מהדורת ProPOST …/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)
מתחיל לבקר בכל עמוד במפות האתר ברקע, כדי שהמבקרים יקבלו עמודים שמורים במטמון. ההתקדמות מדווחת בנפרד בזמן הפעולה.
מהדורת ProPOST …/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סנןמסנן את ערך ה-cache-control הנשלח אל 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סנןמציג סינון בשאלה האם ניתן להגיש את בקשת ה-front-end הנוכחית מזיכרון המטמון של העמוד (page cache).bool $cacheableמהדורה חינמית
zinn_cache_status_rowsסנןמסנן את שורות הטבלה «מה שומר אתר זה במטמון» במסך המצב.array<int,array{0:string,1:string}> $rows, array<string,mixed> $reportמהדורה חינמית
zinn_cache_ttlסנןמסנן את משך הזמן שבו העמוד הנוכחי נשמר במטמון, בשניות.int $ttlמהדורה חינמית