Fejlesztők
Zinn® Cache képességreferencia
A Zinn® Cache regisztrálja műveleteit a WordPress Abilities API-val. Ugyanezek a képességek MCP-eszközök a webhely saját szerverén és REST-útvonalak a /wp-json/wp-abilities/v1 alatt. Ez az oldal a bővítmény saját regiszteréből generálódik.
Végpontok
MCP HTTP-n keresztül (streamelhető)
https://example.com/wp-json/zinn-cache/v1/mcpMCP a WP-CLI-n keresztül (szabványos bemenet és kimenet)
wp mcp-adapter serve --server=zinn-cache --user=<login>REST: képességek listázása
/wp-json/wp-abilities/v1/abilities?category=zinn-cacheREST: képesség futtatása
/wp-json/wp-abilities/v1/abilities/<name>/runHitelesítés és jogosultságok
A HTTP-kérések egy WordPress alkalmazásjelszóval (HTTP Basic) hitelesítik magukat. Az MCP-szerverhez való csatlakozáshoz az alábbi jogosultság szükséges; ezután minden egyes képesség objektumunkként ellenőrzi a saját engedélyét. Az írásvédett képességek GET metódussal futnak, bemenetük a lekérdezési sztringben szerepel; a többi POST metódussal és egy JSON törzzsel ({"input": {…}}).
Példák
# REST: képesség futtatása
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":{}}}Minden képesség
A bővítmény abilities.json fájlából generálva, amely maga is egy futó webhelyből készül; egy teszt sikertelen, ha a kettő eltér egymástól.
| Jogosultság | Mire jó | Kiadás | REST | Engedély | Paraméterek |
|---|---|---|---|---|---|
zinn-cache/clean-databasezinn-cache-clean-database | Az adatbázis karbantartása (Pro) A háttérben eltávolítja a beállításokban bekapcsolt felesleges elemeket. Amit eltávolítunk, azt nem lehet visszaállítani. | Pro kiadás | POST …/abilities/zinn-cache/clean-database/run | manage_options | nincs |
zinn-cache/convert-imageszinn-cache-convert-images | Minden meglévő kép konvertálása (Pro) Elindítja a médiatár képeinek a beállításokban bekapcsolt modern formátumokba történő átalakítását a háttérben. | Pro kiadás | POST …/abilities/zinn-cache/convert-images/run | manage_options | nincs |
zinn-cache/detect-cache-layerszinn-cache-detect-cache-layers | A webhely előtti gyorsítótárak észlelése Lekéri a kezdőlapot úgy, mint egy látogató, és eltárolja, mely gyorsítótárak válaszoltak. A sample: true beállítással kétszer lekéri a legújabb oldalakat is, és megszámolja, az egyes rétegek milyen gyakran szolgálták ki azokat a saját gyorsítótárukból. | Ingyenes kiadás | 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 | Gyorsítótár-analitika megtekintése (Pro) Visszaadja az objektum-gyorsítótár találati arányát és forgalmát az elmúlt órákra (óra, legfeljebb 720), a leglassabb parancsait, valamint azt, hogy mely bővítmények tévesztik leginkább a gyorsítótárat. | Pro kiadás | GET …/abilities/zinn-cache/get-cache-analytics/run | manage_options | hours: integer |
zinn-cache/get-cache-layerszinn-cache-get-cache-layers | Tudnivalók arról, hogy mi gyorsítótárazza a webhelyet Visszaadja, hogy melyik gyorsítótár szolgálja ki az oldalakat (LiteSpeed, nginx, Varnish, Apache, Cloudflare vagy a bővítmény lemezes gyorsítótára), mit talált a legutóbbi észlelés, az egyes rétegek méretét ahol a WordPress képes azt olvasni, a kiürítési sort, az ütemezett frissítést és a legutóbbi kiürítéseket. | Ingyenes kiadás | GET …/abilities/zinn-cache/get-cache-layers/run | manage_options (the REST route's own check) | nincs |
zinn-cache/get-diagnosticszinn-cache-get-diagnostics | Diagnosztikai jelentés elolvasása Visszaadja a támogatás által kért diagnosztikai jelentést: verziók, szerverkorlátok, a gyorsítótár állapota és a legutóbbi hibák. Nem tartalmaz jelszavakat vagy kulcsokat. | Ingyenes kiadás | GET …/abilities/zinn-cache/get-diagnostics/run | manage_options | nincs |
zinn-cache/get-image-progresszinn-cache-get-image-progress | A képkonverzió folyamatának megtekintése (Pro) Visszaadja a képek konvertálásának (vagy eltávolításának) előrehaladását. | Pro kiadás | GET …/abilities/zinn-cache/get-image-progress/run | manage_options | nincs |
zinn-cache/get-pro-settingszinn-cache-get-pro-settings | A Cache Pro beállításainak elolvasása (Pro) Visszaadja a Cache Pro minden beállítását (bemelegítés, képek, parancsfájlok és stílusok, adatbázis-tisztítás, intelligens ürítés, a kereső). A titkos adatok soha nem kerülnek visszaadásra. | Pro kiadás | GET …/abilities/zinn-cache/get-pro-settings/run | manage_options | nincs |
zinn-cache/get-settingszinn-cache-get-settings | Gyorsítótár-beállítások olvasása Minden gyorsítótár-beállítást visszaad. A Redis-jelszó és a Cloudflare-token soha nem kerül visszaadásra, csak az, hogy el van-e mentve. | Ingyenes kiadás | GET …/abilities/zinn-cache/get-settings/run | manage_options | nincs |
zinn-cache/get-slow-querieszinn-cache-get-slow-queries | A lassú lekérdezés kereső ismertetője (Pro) Visszaadja a kereső által észlelt leglassabb adatbázis-lekérdezéseket és kimenő hívásokat, megjelölve az azokat végrehajtó bővítményt vagy sablont. | Pro kiadás | GET …/abilities/zinn-cache/get-slow-queries/run | manage_options | nincs |
zinn-cache/get-statuszinn-cache-get-status | Gyorsítótár állapotának olvasása Visszaadja, hogy az oldalgyorsítótár és az objektum-gyorsítótár be van-e kapcsolva és működik-e, hány oldal van gyorsítótárazva, valamint az objektum-gyorsítótár kapcsolati és találati számait. | Ingyenes kiadás | GET …/abilities/zinn-cache/get-status/run | manage_options | nincs |
zinn-cache/get-warmup-progresszinn-cache-get-warmup-progress | A bemelegítés előrehaladásának leolvasása (Pro) Visszaadja, hogy a felmelegítés fut-e, hány oldalt látogatott meg, és hány sikertelen. | Pro kiadás | GET …/abilities/zinn-cache/get-warmup-progress/run | manage_options | nincs |
zinn-cache/preview-database-cleanupzinn-cache-preview-database-cleanup | Adatbázis-tisztítás előnézete (Pro) Megszámolja, mit távolítana el a tisztítás típusonként (revíziók, vázlatok, spam, lejárt ideiglenes adatok és hasonlók). Semmi sem kerül eltávolításra. | Pro kiadás | GET …/abilities/zinn-cache/preview-database-cleanup/run | manage_options | nincs |
zinn-cache/purgezinn-cache-purge | A gyorsítótár kiürítése Elveti a gyorsítótárazott oldalakat: mindent (all: true), bizonyos címeket (urls) vagy az összes címkézett elemet (tags). Az oldalak újra felépülnek a látogatók érkezésekor. | Ingyenes kiadás | 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 | Néhány cím törlése minden gyorsítótár-rétegről Eltávolítja ezeket a címeket (például a /about/ útvonalakat vagy a webhelyen található teljes címeket) egyszerre a lemez gyorsótárából, a szerver gyorsítótárából és a Cloudflare szolgáltatásból, valamint jelzi az egyes rétegek válaszát. | Ingyenes kiadás | POST …/abilities/zinn-cache/purge-urls/run | manage_options (the REST route's own check) | urls: array (kötelező) |
zinn-cache/refresh-cachezinn-cache-refresh-cache | Ütemezett frissítés elindítása vagy leállítása Az action: start percenként egy-egy adagban frissíti az összes oldalt (amit a frissítések tesznek a gyorsítótár ürítése helyett); az action: stop leállítja a folyamatban lévő frissítést. | Ingyenes kiadás | POST …/abilities/zinn-cache/refresh-cache/run | manage_options (the REST route's own check) | action: start|stop (kötelező) |
zinn-cache/remove-converted-imageszinn-cache-remove-converted-images | Összes konvertált kép eltávolítása (Pro) A háttérben törli a képek minden átalakított másolatát; az eredetiek megmaradnak. | Pro kiadás | POST …/abilities/zinn-cache/remove-converted-images/run | manage_options | nincs |
zinn-cache/reset-settingszinn-cache-reset-settings | A gyorsítótár beállításainak visszaállítása az alapértelmezettekre Minden gyorsítótár-beállítást visszaállít az alapértelmezettre, ahogyan a Visszaállítás gomb teszi. A mentett Redis-jelszó is törlésre kerül. | Ingyenes kiadás | POST …/abilities/zinn-cache/reset-settings/run | manage_options | nincs |
zinn-cache/reset-slow-querieszinn-cache-reset-slow-queries | Lassú lekérdezések eredményeinek törlése (Pro) Elfelejti az eddig talált összes lassú lekérdezést és lassú hívást, a kereső pedig újraindul. | Pro kiadás | POST …/abilities/zinn-cache/reset-slow-queries/run | manage_options | nincs |
zinn-cache/update-pro-settingszinn-cache-update-pro-settings | A Cache Pro beállításainak módosítása (Pro) Módosítja az elküldött Cache Pro beállításokat (beállítások: kulcs az értékhez), és megtartja a többit. Minden érték ellenőrzése pontosan úgy történik, mint a Cache Pro képernyőn; az ismeretlen kulcsok elutasításra kerülnek. | Pro kiadás | POST …/abilities/zinn-cache/update-pro-settings/run | manage_options | settings: object (kötelező) |
zinn-cache/update-settingszinn-cache-update-settings | Gyorsítótár-beállítások módosítása Módosítja a beküldött beállításokat, és megtartja a többit (oldal gyorsítótár, az oldalak gyorsítótárazásának időtartama, az objektum gyorsítótár és annak Redis kapcsolata, kiürítési szabályok és kivételek). Az értékek ellenőrzése és javítása pontosan úgy történik, mint a Cache képernyőn. | Ingyenes kiadás | 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 | Gyorsítótár előtöltése (Pro) A háttérben elkezdi felkeresni a webhelytérképek összes oldalát, így a látogatók gyorsítótárazott oldalakat kapnak. A folyamat előrehaladása futás közben külön kerül jelentésre. | Pro kiadás | POST …/abilities/zinn-cache/warm-cache/run | manage_options | nincs |
WP-CLI parancsok
Futtassa ezeket a szerveren WP-CLI használatával. Mindegyik parancs ugyanazokat a jogosultságokat ellenőrzi, mint a bővítmény képernyői; a példák magának a bővítménynek a súgószövegéből származnak.
| Parancs | Mire jó | Kiadás |
|---|---|---|
wp zinn-cache purge allwp zinn-cache purge all | Minden gyorsítótárazott oldal kiürítése. | Ingyenes kiadás |
wp zinn-cache purge post<id>...wp zinn-cache purge post 42 | Egy bejegyzés oldalainak és azon listáinak ürítése, amelyeken megjelenik (kezdőlap, archívumok, hírcsatornák). | Ingyenes kiadás |
wp zinn-cache purge url<url>...wp zinn-cache purge url https://example.com/ /pricing/ | Törölje a gyorsítótárazott oldalakat ezekről az URL-ekről. | Ingyenes kiadás |
wp zinn-cache refresh<action>wp zinn-cache refresh status | Indítsa el, állítsa le vagy jelenítse meg az ütemezett frissítést (amely frissítés után a „minden kiürítése” funkciót helyettesíti). | Ingyenes kiadás |
wp zinn-cache server detectwp zinn-cache server detect | Ellenőrizze, mely gyorsítótárak válaszolnak a webhely előtt (nginx, Varnish, Apache, LiteSpeed, Cloudflare). | Ingyenes kiadás |
wp zinn-cache server drainwp zinn-cache server drain | Küldje el a sorba állított kiszolgálói gyorsítótár-ürítéseket most ahelyett, hogy megvárná a WP-Cron-t. | Ingyenes kiadás |
wp zinn-cache status[--format=<format>]wp zinn-cache status --format=json | Jelentse a objektumgyorsítótár állapotát. | Ingyenes kiadás |
Műveletek és szűrők
A bővítmény által kínált összes hook, a forráskódjukban szereplő leírással. A szűrők módosítanak egy értéket; a műveletek lehetővé teszik, hogy egy adott pillanatban kódot futtasson; a belépési pontok olyan műveletek, amelyeket a bővítmény feladatvégzésre való felszólításához indít el.
| Webhook | Féleség | Mire jó | Paraméterek | Kiadás |
|---|---|---|---|---|
zinn_cache_control_header | Szűrés | Szűri a gyorsítótárazható oldalakhoz a LiteSpeed részére küldött cache-control értéket. | string $value, int $ttl | Ingyenes kiadás |
zinn_cache_fs_loaded | Művelet | Akkor fut le, miután a licencelési SDK betöltődött, a Zinn® Cache többi része előtt. Csatlakozzon ide a `zinn_cache_fs()` függvény meghívásához. | nincs | Ingyenes kiadás |
zinn_cache_link_scan_post_types | Szűrés | A bejegyzéstípusok, amelyekre a vizsgálat kiterjed. | nincs | Ingyenes kiadás |
zinn_cache_mcp_abilities | Művelet | A Zinn® Cache regisztrálja a képességeit: a Zinn® Cache Pro ide adja hozzá a sajátjait. | nincs | Ingyenes kiadás |
zinn_cache_post_change_tags | Szűrés | Szűri a bejegyzés módosításakor törölt gyorsítótár-címkéket. | string[] $tags, int $post_id, string $post_type | Ingyenes kiadás |
zinn_cache_purge_all | Művelet | Töröljön mindent az Eszközök sorból. | nincs | Ingyenes kiadás |
zinn_cache_purge_hosts | Szűrés | Szűri a gazdagépneveket, amelyeket a kiürítések megnevezhetnek (több tartományon kiszolgált webhely esetén). | string[] $hosts | Ingyenes kiadás |
zinn_cache_purge_on_seo_change | Szűrés | Szűri, hogy a Zinn® SEO bővítményben végrehajtott módosítás kiüríti-e a módosított oldalakat. | bool $on | Ingyenes kiadás |
zinn_cache_purge_plan | Belépési pont (ön indítja el) | Pontosan azt ürítse ki, amit a csomag neve mutat: `do_action( 'zinn_cache_purge_plan', array( 'urls' => …, 'tags' => …, 'purge_all' => … ) )`. | nincs | Ingyenes kiadás |
zinn_cache_purged | Művelet | Akkor fut le, amikor a bővítmény elindított egy gyorsítótár-ürítést. | array{purge_all:bool,urls:string[],tags:string[]} $plan | Ingyenes kiadás |
zinn_cache_purged_all | Művelet | Akkor fut le, amikor az oldalgyorsítótár teljes törlését kérték. | string $reason | Ingyenes kiadás |
zinn_cache_refresh_armed | Művelet | Akkor aktiválódik, amikor ütemezett frissítés indul. | string $reason | Ingyenes kiadás |
zinn_cache_refresh_finished | Művelet | Akkor aktiválódik, amikor az ütemezett frissítés eléri a webhely végét. | int $pages | Ingyenes kiadás |
zinn_cache_refresh_guard | Szűrés | Szűri, hogy a frissítésnek szünetelnie kell-e ebben a percben (a tárhely saját terhelésvédelme). | string $reason | Ingyenes kiadás |
zinn_cache_refresh_urls | Szűrés | Szűri a frissítési köteg által törölt címeket — adja hozzá ide például az egyes oldalak más nyelvű címeit. | string[] $urls | Ingyenes kiadás |
zinn_cache_refreshed_urls | Művelet | A frissítési köteg kiürítése után fut le (a Zinn® Cache Pro újra előmelegíti ezeket az oldalakat). | string[] $urls | Ingyenes kiadás |
zinn_cache_request_cacheable | Szűrés | Szűri, hogy az aktuális felületre irányuló kérés kiszolgálható-e az oldalgyorsítótárból. | bool $cacheable | Ingyenes kiadás |
zinn_cache_status_rows | Szűrés | Szűri az állapotképernyő „Mi gyorsítótárazza ezt a webhelyet” táblázatának sorait. | array<int,array{0:string,1:string}> $rows, array<string,mixed> $report | Ingyenes kiadás |
zinn_cache_ttl | Szűrés | Szűri, hogy az aktuális oldal hány másodpercig legyen gyorsítótárazva. | int $ttl | Ingyenes kiadás |