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.

Ghidul utilizatorului: conectarea unei aplicații AI

Zinn®, vikingul nostru, aclamă în timp ce un asistent IA se conectează la instrumentele platformei.

Puncte finale

MCP prin HTTP (streamabil)

https://example.com/wp-json/zinn-cache/v1/mcp

MCP 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-cache

REST: rulează o abilitate

/wp-json/wp-abilities/v1/abilities/<name>/run

Autentificare ș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ă.

CapacitateCe faceEdițieRESTPermisiuneParametri
zinn-cache/clean-database
zinn-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 ProPOST …/abilities/zinn-cache/clean-database/runmanage_optionsniciunul
zinn-cache/convert-images
zinn-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 ProPOST …/abilities/zinn-cache/convert-images/runmanage_optionsniciunul
zinn-cache/detect-cache-layers
zinn-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/runmanage_options (the REST route's own check)sample: boolean
zinn-cache/get-cache-analytics
zinn-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 ProGET …/abilities/zinn-cache/get-cache-analytics/runmanage_optionshours: integer
zinn-cache/get-cache-layers
zinn-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/runmanage_options (the REST route's own check)niciunul
zinn-cache/get-diagnostics
zinn-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/runmanage_optionsniciunul
zinn-cache/get-image-progress
zinn-cache-get-image-progress
Citește progresul conversiei imaginii (Pro)
Returnează cât de mult a avansat conversia (sau eliminarea) imaginilor.
Ediția ProGET …/abilities/zinn-cache/get-image-progress/runmanage_optionsniciunul
zinn-cache/get-pro-settings
zinn-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 ProGET …/abilities/zinn-cache/get-pro-settings/runmanage_optionsniciunul
zinn-cache/get-settings
zinn-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/runmanage_optionsniciunul
zinn-cache/get-slow-queries
zinn-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 ProGET …/abilities/zinn-cache/get-slow-queries/runmanage_optionsniciunul
zinn-cache/get-status
zinn-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/runmanage_optionsniciunul
zinn-cache/get-warmup-progress
zinn-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 ProGET …/abilities/zinn-cache/get-warmup-progress/runmanage_optionsniciunul
zinn-cache/preview-database-cleanup
zinn-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 ProGET …/abilities/zinn-cache/preview-database-cleanup/runmanage_optionsniciunul
zinn-cache/purge
zinn-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/runmanage_options (the REST route's own check)all: boolean, urls: array, tags: array
zinn-cache/purge-urls
zinn-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/runmanage_options (the REST route's own check)urls: array (obligatoriu)
zinn-cache/refresh-cache
zinn-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/runmanage_options (the REST route's own check)action: start|stop (obligatoriu)
zinn-cache/remove-converted-images
zinn-cache-remove-converted-images
Elimină toate imaginile convertite (Pro)
Șterge în fundal fiecare copie convertită a imaginilor; originalele se păstrează.
Ediția ProPOST …/abilities/zinn-cache/remove-converted-images/runmanage_optionsniciunul
zinn-cache/reset-settings
zinn-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/runmanage_optionsniciunul
zinn-cache/reset-slow-queries
zinn-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 ProPOST …/abilities/zinn-cache/reset-slow-queries/runmanage_optionsniciunul
zinn-cache/update-pro-settings
zinn-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 ProPOST …/abilities/zinn-cache/update-pro-settings/runmanage_optionssettings: object (obligatoriu)
zinn-cache/update-settings
zinn-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/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
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 ProPOST …/abilities/zinn-cache/warm-cache/runmanage_optionsniciunul

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 faceEdiție
wp zinn-cache purge all
wp 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 detect
wp 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 drain
wp 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.

WebhookTipCe faceParametriEdiție
zinn_cache_control_headerFiltreazăFiltrează valoarea cache-control trimisă către LiteSpeed pentru o pagină care poate fi stocată în cache.string $value, int $ttlEdiție gratuită
zinn_cache_fs_loadedAcțiuneSe 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()`.niciunulEdiție gratuită
zinn_cache_link_scan_post_typesFiltreazăTipurile de postări acoperite de scanare.niciunulEdiție gratuită
zinn_cache_mcp_abilitiesAcțiuneSe activează după ce Zinn® Cache își înregistrează capacitățile: Zinn® Cache Pro le adaugă pe ale sale aici.niciunulEdiție gratuită
zinn_cache_post_change_tagsFiltreazăFiltrează etichetele de cache eliminate când o postare se modifică.string[] $tags, int $post_id, string $post_typeEdiție gratuită
zinn_cache_purge_allAcțiuneȘtergeți totul, din rândul Instrumente.niciunulEdiție gratuită
zinn_cache_purge_hostsFiltreazăFiltrează numele de gazdă pe care le pot specifica curățările (pentru un site servit pe mai mult de un domeniu).string[] $hostsEdiție gratuită
zinn_cache_purge_on_seo_changeFiltreazăFiltrează dacă o modificare efectuată în Zinn® SEO golește paginile pe care le-a modificat.bool $onEdiție gratuită
zinn_cache_purge_planPunct de intrare (îl declanșezi)Ștergeți exact ce indică un plan: `do_action( 'zinn_cache_purge_plan', array( 'urls' => …, 'tags' => …, 'purge_all' => … ) )`.niciunulEdiție gratuită
zinn_cache_purgedAcțiuneSe execută după ce modulul a inițiat o curățare a cache-ului.array{purge_all:bool,urls:string[],tags:string[]} $planEdiție gratuită
zinn_cache_purged_allAcțiuneSe declanșează după ce a fost solicitată o golire completă a memoriei cache a paginii.string $reasonEdiție gratuită
zinn_cache_refresh_armedAcțiuneSe declanșează la începerea unei reîmprospătări ritmate.string $reasonEdiție gratuită
zinn_cache_refresh_finishedAcțiuneSe declanșează când o reîmprospătare ritmată a ajuns la sfârșitul site-ului.int $pagesEdiție gratuită
zinn_cache_refresh_guardFiltreazăFiltrează dacă reîmprospătarea ar trebui să se întrerupă în acest minut (propria protecție la încărcare a gazdei).string $reasonEdiție gratuită
zinn_cache_refresh_urlsFiltrează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[] $urlsEdiție gratuită
zinn_cache_refreshed_urlsAcțiuneSe declanșează după golirea unui lot de reîmprospătare (Zinn® Cache Pro preîncălzește din nou aceste pagini).string[] $urlsEdiție gratuită
zinn_cache_request_cacheableFiltreazăFiltrează dacă solicitarea actuală de front-end poate fi servită din memoria cache a paginii.bool $cacheableEdiție gratuită
zinn_cache_status_rowsFiltrează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> $reportEdiție gratuită
zinn_cache_ttlFiltreazăFiltrează durata de cache pentru pagina curentă, în secunde.int $ttlEdiție gratuită