Dezvoltatori
Referință privind capacitățile Zinn® Cache
Zinn® Cache își înregistrează acțiunile în WordPress Abilities API. Aceleași capacități sunt instrumente MCP pe propriul server al site-ului și rute REST sub /wp-json/wp-abilities/v1. Această pagină este generată din propriul registru al pluginului.
Puncte finale
MCP prin HTTP (streamabil)
https://example.com/wp-json/zinn-cache/v1/mcpMCP prin WP-CLI (intrare și ieșire standard)
wp mcp-adapter serve --server=zinn-cache --user=<login>REST: listați capabilitățile
/wp-json/wp-abilities/v1/abilities?category=zinn-cacheREST: rulează o abilitate
/wp-json/wp-abilities/v1/abilities/<name>/runAutentificare și permisiuni
Cererile HTTP se autentifică cu o parolă de aplicație WordPress (HTTP Basic). Conectarea la serverul MCP necesită capabilitatea afișată mai jos; fiecare abilitate își verifică apoi propria permisiune, per obiect. Abilitățile doar pentru citire rulează cu GET și datele de intrare în șirul de interogare; celelalte cu POST și un corp JSON {„input”: {…}}.
Exemple
# REST: rulează o abilitate
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":{}}}Toate abilitățile
Generat din fișierul abilities.json al pluginului, care la rândul său este generat dintr-un site în execuție; un test eșuează atunci când cele două nu concordă.
| Capacitate | Ce face | Ediție | REST | Permisiune | Parametri |
|---|---|---|---|---|---|
zinn-cache/clean-databasezinn-cache-clean-database | Curăță baza de date (Pro) Elimină în fundal tipurile de elemente inutile activate în setări. Ceea ce este eliminat nu mai poate fi recuperat. | Ediția Pro | POST …/abilities/zinn-cache/clean-database/run | manage_options | niciunul |
zinn-cache/convert-imageszinn-cache-convert-images | Convertește toate imaginile existente (Pro) Începe conversia în fundal a imaginilor din biblioteca media în formatele moderne activate în setări. | Ediția Pro | POST …/abilities/zinn-cache/convert-images/run | manage_options | niciunul |
zinn-cache/detect-cache-layerszinn-cache-detect-cache-layers | Detectează memoriile cache din fața site-ului Solicită pagina principală așa cum ar face-o un vizitator și stochează ce memorii cache au răspuns. Cu sample: true solicită de asemenea paginile cele mai noi de două ori și numără cât de des le-a servit fiecare nivel din memoria sa cache. | Ediție gratuită | 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 | Citește datele analitice din memoria cache (Pro) Returnează rata de succes și traficul din cache-ul de obiecte pentru ultimele ore (ore, până la 720), cele mai lente comenzi ale sale și care module ratează cel mai des cache-ul. | Ediția Pro | GET …/abilities/zinn-cache/get-cache-analytics/run | manage_options | hours: integer |
zinn-cache/get-cache-layerszinn-cache-get-cache-layers | Citește ce stochează site-ul în memoria cache Returnează ce memorie cache servește paginile (LiteSpeed, nginx, Varnish, Apache, Cloudflare sau memoria cache pe disc a modulului), ce a identificat ultima detectare, dimensiunea fiecărui strat acolo unde WordPress o poate citi, coada de golire, reîmprospătarea ritmată și golirile recente. | Ediție gratuită | GET …/abilities/zinn-cache/get-cache-layers/run | manage_options (the REST route's own check) | niciunul |
zinn-cache/get-diagnosticszinn-cache-get-diagnostics | Citește raportul de diagnosticare Returnează raportul de diagnosticare solicitat de asistență: versiunile, limitele serverului, starea memoriei cache și erorile recente. Nu conține parole sau chei. | Ediție gratuită | GET …/abilities/zinn-cache/get-diagnostics/run | manage_options | niciunul |
zinn-cache/get-image-progresszinn-cache-get-image-progress | Citește progresul conversiei imaginii (Pro) Returnează cât de mult a avansat conversia (sau eliminarea) imaginilor. | Ediția Pro | GET …/abilities/zinn-cache/get-image-progress/run | manage_options | niciunul |
zinn-cache/get-pro-settingszinn-cache-get-pro-settings | Citește setările Cache Pro (Pro) Returnează fiecare setare Cache Pro (preîncălzire, imagini, scripturi și stiluri, curățarea bazei de date, golire inteligentă, găsitorul). Informațiile secrete nu sunt returnate niciodată. | Ediția Pro | GET …/abilities/zinn-cache/get-pro-settings/run | manage_options | niciunul |
zinn-cache/get-settingszinn-cache-get-settings | Citește setările de cache Returnează fiecare setare a memoriei cache. Parola Redis și tokenul Cloudflare nu sunt returnate niciodată, ci doar dacă este salvat vreunul. | Ediție gratuită | GET …/abilities/zinn-cache/get-settings/run | manage_options | niciunul |
zinn-cache/get-slow-querieszinn-cache-get-slow-queries | Citește despre instrumentul de găsire a interogărilor lente (Pro) Returnează cele mai lente interogări ale bazei de date și apeluri de ieșire detectate de căutător, împreună cu modulul sau tema care le-a generat. | Ediția Pro | GET …/abilities/zinn-cache/get-slow-queries/run | manage_options | niciunul |
zinn-cache/get-statuszinn-cache-get-status | Citește starea memoriei cache Returnează dacă memoria cache pentru pagini și memoria cache pentru obiecte sunt activate și funcționează, câte pagini sunt stocate în memoria cache, precum și numărul de conexiuni și accesări ale memoriei cache pentru obiecte. | Ediție gratuită | GET …/abilities/zinn-cache/get-status/run | manage_options | niciunul |
zinn-cache/get-warmup-progresszinn-cache-get-warmup-progress | Citește progresul încălzirii (Pro) Returnează dacă preîncălzirea rulează, câte pagini a vizitat și câte au eșuat. | Ediția Pro | GET …/abilities/zinn-cache/get-warmup-progress/run | manage_options | niciunul |
zinn-cache/preview-database-cleanupzinn-cache-preview-database-cleanup | Previzualizează curățarea bazei de date (Pro) Numără ce ar elimina o curățare, în funcție de tip (revizuiri, ciorne, spam, date temporare expirate și altele similare). Nu se elimină nimic. | Ediția Pro | GET …/abilities/zinn-cache/preview-database-cleanup/run | manage_options | niciunul |
zinn-cache/purgezinn-cache-purge | Golește memoria cache Elimină paginile din memoria cache: totul (all: true), unele adrese (urls) sau tot ce este etichetat (tags). Paginile sunt reconstruite pe măsură ce sosesc vizitatorii. | Ediție gratuită | 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 | Golește unele adrese de pe fiecare nivel de cache Elimină aceste adrese (căi precum /about/ sau adrese complete de pe acest site) simultan din memoria cache pe disc, din memoria cache a serverului și din Cloudflare, și indică ce a răspuns fiecare nivel. | Ediție gratuită | POST …/abilities/zinn-cache/purge-urls/run | manage_options (the REST route's own check) | urls: array (obligatoriu) |
zinn-cache/refresh-cachezinn-cache-refresh-cache | Pornește sau oprește reîmprospătarea etapizată action: start reîmprospătează fiecare pagină câte un lot pe minut (ceea ce fac actualizările în loc să golească memoria cache); action: stop oprește o reîmprospătare în curs. | Ediție gratuită | POST …/abilities/zinn-cache/refresh-cache/run | manage_options (the REST route's own check) | action: start|stop (obligatoriu) |
zinn-cache/remove-converted-imageszinn-cache-remove-converted-images | Elimină toate imaginile convertite (Pro) Șterge în fundal fiecare copie convertită a imaginilor; originalele se păstrează. | Ediția Pro | POST …/abilities/zinn-cache/remove-converted-images/run | manage_options | niciunul |
zinn-cache/reset-settingszinn-cache-reset-settings | Readu setările de memorie tampon la valorile implicite Readuce fiecare setare a memoriei cache la valoarea implicită, așa cum face butonul Resetează. Parola Redis salvată este eliminată, de asemenea. | Ediție gratuită | POST …/abilities/zinn-cache/reset-settings/run | manage_options | niciunul |
zinn-cache/reset-slow-querieszinn-cache-reset-slow-queries | Șterge constatările interogărilor lente (Pro) Uită fiecare interogare lentă și apel lent găsit până acum, iar căutătorul pornește din nou. | Ediția Pro | POST …/abilities/zinn-cache/reset-slow-queries/run | manage_options | niciunul |
zinn-cache/update-pro-settingszinn-cache-update-pro-settings | Modifică setările Cache Pro (Pro) Modifică setările Cache Pro pe care le trimiți (setări: cheie la valoare) și le păstrează pe celelalte. Fiecare valoare este verificată exact ca în ecranul Cache Pro; o cheie necunoscută este refuzată. | Ediția Pro | POST …/abilities/zinn-cache/update-pro-settings/run | manage_options | settings: object (obligatoriu) |
zinn-cache/update-settingszinn-cache-update-settings | Schimbă setările pentru cache Modifică setările pe care le trimiți și le păstrează pe restul (memoria cache a paginilor, cât timp rămân paginile în memoria cache, memoria cache a obiectelor și conexiunea sa Redis, regulile de golire și excluderile). Valorile sunt verificate și corectate exact ca în ecranul Cache. | Ediție gratuită | 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 | Preîncălzește memoria cache (Pro) Începe să viziteze fiecare pagină din sitemap-uri în fundal, astfel încât vizitatorii să primească pagini stocate în memoria cache. Progresul său este raportat separat în timp ce rulează. | Ediția Pro | POST …/abilities/zinn-cache/warm-cache/run | manage_options | niciunul |
Comenzi WP-CLI
Rulați-le pe server cu WP-CLI. Fiecare comandă verifică aceleași permisiuni ca ecranele modulului; exemplele sunt luate din propriul text de ajutor al modulului.
| Comandă | Ce face | Ediție |
|---|---|---|
wp zinn-cache purge allwp zinn-cache purge all | Goliți fiecare pagină memorată în cache. | Ediție gratuită |
wp zinn-cache purge post<id>...wp zinn-cache purge post 42 | Goliți paginile unei postări și listele în care apare (pagina principală, arhive, fluxuri). | Ediție gratuită |
wp zinn-cache purge url<url>...wp zinn-cache purge url https://example.com/ /pricing/ | Eliminați paginile stocate în memoria cache de la aceste adrese URL. | Ediție gratuită |
wp zinn-cache refresh<action>wp zinn-cache refresh status | Porniți, opriți sau afișați reîmprospătarea etapizată (ceea ce înlocuiește „golește tot” după o actualizare). | Ediție gratuită |
wp zinn-cache server detectwp zinn-cache server detect | Verificați ce memorii cache răspund în fața site-ului (nginx, Varnish, Apache, LiteSpeed, Cloudflare). | Ediție gratuită |
wp zinn-cache server drainwp zinn-cache server drain | Trimiteți curățările din coadă ale memoriei cache a serverului acum, în loc să așteptați WP-Cron. | Ediție gratuită |
wp zinn-cache status[--format=<format>]wp zinn-cache status --format=json | Raportați starea cache-ului de obiecte. | Ediție gratuită |
Acțiuni și filtre
Fiecare hook pe care îl oferă modulul, împreună cu descrierea din codul său sursă. Filtrele modifică o valoare; acțiunile vă permit să rulați cod la un moment dat; punctele de intrare sunt acțiuni pe care le declanșați pentru a cere modulului să facă ceva.
| Webhook | Tip | Ce face | Parametri | Ediție |
|---|---|---|---|---|
zinn_cache_control_header | Filtrează | Filtrează valoarea cache-control trimisă către LiteSpeed pentru o pagină care poate fi stocată în cache. | string $value, int $ttl | Ediție gratuită |
zinn_cache_fs_loaded | Acțiune | Se declanșează odată ce SDK-ul de licențiere s-a încărcat, înainte de restul de Zinn® Cache. Conectați-vă aici pentru a comunica cu `zinn_cache_fs()`. | niciunul | Ediție gratuită |
zinn_cache_link_scan_post_types | Filtrează | Tipurile de postări acoperite de scanare. | niciunul | Ediție gratuită |
zinn_cache_mcp_abilities | Acțiune | Se activează după ce Zinn® Cache își înregistrează capacitățile: Zinn® Cache Pro le adaugă pe ale sale aici. | niciunul | Ediție gratuită |
zinn_cache_post_change_tags | Filtrează | Filtrează etichetele de cache eliminate când o postare se modifică. | string[] $tags, int $post_id, string $post_type | Ediție gratuită |
zinn_cache_purge_all | Acțiune | Ștergeți totul, din rândul Instrumente. | niciunul | Ediție gratuită |
zinn_cache_purge_hosts | Filtrează | Filtrează numele de gazdă pe care le pot specifica curățările (pentru un site servit pe mai mult de un domeniu). | string[] $hosts | Ediție gratuită |
zinn_cache_purge_on_seo_change | Filtrează | Filtrează dacă o modificare efectuată în Zinn® SEO golește paginile pe care le-a modificat. | bool $on | Ediție gratuită |
zinn_cache_purge_plan | Punct de intrare (îl declanșezi) | Ștergeți exact ce indică un plan: `do_action( 'zinn_cache_purge_plan', array( 'urls' => …, 'tags' => …, 'purge_all' => … ) )`. | niciunul | Ediție gratuită |
zinn_cache_purged | Acțiune | Se execută după ce modulul a inițiat o curățare a cache-ului. | array{purge_all:bool,urls:string[],tags:string[]} $plan | Ediție gratuită |
zinn_cache_purged_all | Acțiune | Se declanșează după ce a fost solicitată o golire completă a memoriei cache a paginii. | string $reason | Ediție gratuită |
zinn_cache_refresh_armed | Acțiune | Se declanșează la începerea unei reîmprospătări ritmate. | string $reason | Ediție gratuită |
zinn_cache_refresh_finished | Acțiune | Se declanșează când o reîmprospătare ritmată a ajuns la sfârșitul site-ului. | int $pages | Ediție gratuită |
zinn_cache_refresh_guard | Filtrează | Filtrează dacă reîmprospătarea ar trebui să se întrerupă în acest minut (propria protecție la încărcare a gazdei). | string $reason | Ediție gratuită |
zinn_cache_refresh_urls | Filtrează | Filtrează adresele pe care le golește un lot de reîmprospătare — adăugați aici, de exemplu, adresele fiecărei pagini în alte limbi. | string[] $urls | Ediție gratuită |
zinn_cache_refreshed_urls | Acțiune | Se declanșează după golirea unui lot de reîmprospătare (Zinn® Cache Pro preîncălzește din nou aceste pagini). | string[] $urls | Ediție gratuită |
zinn_cache_request_cacheable | Filtrează | Filtrează dacă solicitarea actuală de front-end poate fi servită din memoria cache a paginii. | bool $cacheable | Ediție gratuită |
zinn_cache_status_rows | Filtrează | Filtrează rândurile tabelului „Ce memorează în cache acest site” din ecranul de stare. | array<int,array{0:string,1:string}> $rows, array<string,mixed> $report | Ediție gratuită |
zinn_cache_ttl | Filtrează | Filtrează durata de cache pentru pagina curentă, în secunde. | int $ttl | Ediție gratuită |