Разработчики

Справочник возможностей 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 плагина, который, в свою очередь, создается на основе работающего сайта; тест завершается с ошибкой, если они не совпадают.

ВозможностьЧто делаетРедакцияRESTРазрешениеПараметры
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)
Возвращает процент попаданий в объектный кэш и трафик за последние часы (hours, до 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
Прочитать статус кэша
Возвращает информацию о том, включены ли и работают кэш страниц и кэш объектов, сколько страниц кэшировано, а также количество подключений и попаданий кэша объектов.
Бесплатный тариф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, правила очистки и исключения). Значения проверяются и корректируются точно так же, как на экране «Кэш».
Бесплатный тариф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ФильтроватьОпределяет, может ли текущий фронтенд-запрос обслуживаться из кэша страниц.bool $cacheableБесплатный тариф
zinn_cache_status_rowsФильтроватьФильтрует строки таблицы «Что кэширует этот сайт» на экране состояния.array<int,array{0:string,1:string}> $rows, array<string,mixed> $reportБесплатный тариф
zinn_cache_ttlФильтроватьФильтрует время кеширования текущей страницы в секундах.int $ttlБесплатный тариф