Розробники
Довідник можливостей Zinn® Cache
Zinn® Cache реєструє свої дії в WordPress Abilities API. Ці самі здібності є MCP-інструментами на власному сервері сайту та маршрутами REST у /wp-json/wp-abilities/v1. Цю сторінку згенеровано з власного реєстру плагіна.
Кінцеві точки
MCP через HTTP (з підтримкою потокової передачі)
https://example.com/wp-json/zinn-cache/v1/mcpMCP через 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) Повертає коефіцієнт влучань та трафік об'єктного кешу за останні години (hours, до 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, правила очищення та винятки). Значення перевіряються та виправляються так само, як і на екрані «Кеш». | Безкоштовна версія | 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 | Фільтрувати | Фільтрує значення 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 | Фільтрувати | Фільтрує, чи можна обслуговувати поточний запит інтерфейсу з кешу сторінок. | bool $cacheable | Безкоштовна версія |
zinn_cache_status_rows | Фільтрувати | Фільтрує рядки таблиці «Що кешує цей сайт» на екрані стану. | array<int,array{0:string,1:string}> $rows, array<string,mixed> $report | Безкоштовна версія |
zinn_cache_ttl | Фільтрувати | Фільтрує тривалість кешування поточної сторінки в секундах. | int $ttl | Безкоштовна версія |