Разработчики
Справочник возможностей 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 плагина, который, в свою очередь, создается на основе работающего сайта; тест завершается с ошибкой, если они не совпадают.
| Возможность | Что делает | Редакция | REST | Разрешение | Параметры |
|---|---|---|---|---|---|
zinn-cache/clean-databasezinn-cache-clean-database | Очистить базу данных (Pro) Удаляет в фоновом режиме виды ненужных данных, включенные в настройках. Удаленное невозможно восстановить. | Версия Pro | POST …/abilities/zinn-cache/clean-database/run | manage_options | Нет |
zinn-cache/convert-imageszinn-cache-convert-images | Преобразовать все существующие изображения (Pro) Запускает в фоновом режиме преобразование изображений медиабиблиотеки в современные форматы, включенные в настройках. | Версия 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), самые медленные команды и плагины, которые чаще всего промахиваются мимо кэша. | Версия Pro | 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) Возвращает степень выполнения преобразования (или удаления) изображений. | Версия 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 (прогрев, изображения, скрипты и стили, очистка базы данных, умная очистка, средство поиска). Секретные данные никогда не возвращаются. | Версия 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) Возвращает самые медленные запросы к базе данных и исходящие вызовы, обнаруженные поисковиком, вместе с плагином или темой, которые их выполнили. | Версия 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) Возвращает информацию о том, выполняется ли прогрев, сколько страниц было посещено и сколько завершилось сбоем. | Версия Pro | GET …/abilities/zinn-cache/get-warmup-progress/run | manage_options | Нет |
zinn-cache/preview-database-cleanupzinn-cache-preview-database-cleanup | Предварительный просмотр очистки базы данных (Pro) Подсчитывает по типам, что было бы удалено при очистке (редакции, черновики, спам, устаревшие временные данные и тому подобное). Ничего не удаляется. | Версия 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) Удаляет в фоновом режиме каждую преобразованную копию изображений; оригиналы сохраняются. | Версия 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) Забывает все найденные до сих пор медленные запросы и медленные вызовы, и поисковик запускается снова. | Версия 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; неизвестный ключ отклоняется. | Версия 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) Начинает посещать каждую страницу в картах сайта в фоновом режиме, чтобы посетители получали кэшированные страницы. Ход выполнения отображается отдельно во время работы. | Версия 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 | Бесплатный тариф |