Разработчици
Справка за възможностите на 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 и входните им данни в заявката (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 на плъгина, който от своя страна се генерира от работещ сайт; тестът се проваля, когато двете не съвпадат.
| Възможност | Какво прави | Издание | REST | Разрешение | Параметри |
|---|---|---|---|---|---|
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, правила за изчистване и изключения). Стойностите се проверяват и коригират точно както на екрана Cache. | Безплатно издание | 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 | Безплатно издание |