Розробники

Довідник можливостей 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 із вхідними даними в рядку запиту; інші — за допомогою 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)
Повертає коефіцієнт влучань та трафік об'єктного кешу за останні години (hours, до 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, правила очищення та винятки). Значення перевіряються та виправляються так само, як і на екрані «Кеш».
Безкоштовна версія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ФільтруватиФільтрує значення 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Безкоштовна версія