Sviluppatori
Riferimento capacità di Zinn® Cache
Zinn® Cache registra le proprie azioni con WordPress Abilities API. Le stesse capacità sono strumenti MCP sul server del sito e route REST sotto /wp-json/wp-abilities/v1. Questa pagina viene generata dal registro del plugin stesso.
Endpoint
MCP su HTTP (streamable)
https://example.com/wp-json/zinn-cache/v1/mcpMCP su WP-CLI (standard input e output)
wp mcp-adapter serve --server=zinn-cache --user=<login>REST: elenca le capacità
/wp-json/wp-abilities/v1/abilities?category=zinn-cacheREST: esegui un'abilità
/wp-json/wp-abilities/v1/abilities/<name>/runAutenticazione e autorizzazioni
Le richieste HTTP si autenticano con una password applicativa WordPress (HTTP Basic). La connessione al server MCP richiede la funzionalità mostrata di seguito; ogni abilità verifica quindi la propria autorizzazione, per singolo oggetto. Le abilità di sola lettura vengono eseguite con GET e il relativo input nella query string; le altre con POST e un corpo JSON {"input": {…}}.
Esempi
# REST: esegui un'abilità
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":{}}}Tutte le funzionalità
Generato dalle capacità del plugin tramite abilities.json, che a sua volta viene generato da un sito in esecuzione; un test fallisce quando i due non concordano.
| Abilitazione | Cosa fa | Edizione | REST | Autorizzazione | Parametri |
|---|---|---|---|---|---|
zinn-cache/clean-databasezinn-cache-clean-database | Pulisci il database (Pro) Rimuove in background i tipi di elementi superflui attivati nelle impostazioni. Ciò che viene rimosso non può essere recuperato. | Edizione Pro | POST …/abilities/zinn-cache/clean-database/run | manage_options | nessuno |
zinn-cache/convert-imageszinn-cache-convert-images | Converti tutte le immagini esistenti (Pro) Avvia in background la conversione delle immagini della libreria multimediale nei formati moderni attivati nelle impostazioni. | Edizione Pro | POST …/abilities/zinn-cache/convert-images/run | manage_options | nessuno |
zinn-cache/detect-cache-layerszinn-cache-detect-cache-layers | Rileva le cache davanti al sito Richiede la home page come farebbe un visitatore e memorizza quali cache hanno risposto. Con sample: true richiede inoltre le pagine più recenti due volte e conta quante volte ciascun livello le ha servite dalla propria cache. | Edizione gratuita | 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 | Leggi le statistiche della cache (Pro) Restituisce la percentuale di hit della cache degli oggetti e il traffico per le ultime ore (ore, fino a 720), i suoi comandi più lenti e quali plugin mancano maggiormente la cache. | Edizione Pro | GET …/abilities/zinn-cache/get-cache-analytics/run | manage_options | hours: integer |
zinn-cache/get-cache-layerszinn-cache-get-cache-layers | Leggi cosa memorizza nella cache il sito Mostra quale cache gestisce le pagine (LiteSpeed, nginx, Varnish, Apache, Cloudflare o la cache su disco del plugin), che cosa ha rilevato l'ultima scansione, la dimensione di ogni livello dove WordPress è in grado di leggerla, la coda di svuotamento, l'aggiornamento cadenzato e gli svuotamenti recenti. | Edizione gratuita | GET …/abilities/zinn-cache/get-cache-layers/run | manage_options (the REST route's own check) | nessuno |
zinn-cache/get-diagnosticszinn-cache-get-diagnostics | Leggi il rapporto diagnostico Restituisce il report di diagnostica richiesto dall'assistenza: versioni, limiti del server, stato della cache ed errori recenti. Non contiene password o chiavi. | Edizione gratuita | GET …/abilities/zinn-cache/get-diagnostics/run | manage_options | nessuno |
zinn-cache/get-image-progresszinn-cache-get-image-progress | Leggi l'avanzamento della conversione dell'immagine (Pro) Restituisce lo stato di avanzamento della conversione (o rimozione) delle immagini. | Edizione Pro | GET …/abilities/zinn-cache/get-image-progress/run | manage_options | nessuno |
zinn-cache/get-pro-settingszinn-cache-get-pro-settings | Leggi le impostazioni di Cache Pro (Pro) Restituisce tutte le impostazioni di Cache Pro (riscaldamento, immagini, script e stili, pulizia del database, eliminazione intelligente, il finder). I segreti non vengono mai restituiti. | Edizione Pro | GET …/abilities/zinn-cache/get-pro-settings/run | manage_options | nessuno |
zinn-cache/get-settingszinn-cache-get-settings | Leggi le impostazioni della cache Restituisce tutte le impostazioni della cache. La password di Redis e il token di Cloudflare non vengono mai restituiti, ma solo se ne è stato salvato uno. | Edizione gratuita | GET …/abilities/zinn-cache/get-settings/run | manage_options | nessuno |
zinn-cache/get-slow-querieszinn-cache-get-slow-queries | Leggi lo strumento per trovare le query lente (Pro) Restituisce le query del database e le chiamate in uscita più lente rilevate dallo strumento di ricerca, indicando il plugin o il tema che le ha originate. | Edizione Pro | GET …/abilities/zinn-cache/get-slow-queries/run | manage_options | nessuno |
zinn-cache/get-statuszinn-cache-get-status | Leggi lo stato della cache Restituisce se la cache delle pagine e la cache degli oggetti sono attive e funzionanti, quante pagine sono memorizzate nella cache e i numeri di connessione e di hit della cache degli oggetti. | Edizione gratuita | GET …/abilities/zinn-cache/get-status/run | manage_options | nessuno |
zinn-cache/get-warmup-progresszinn-cache-get-warmup-progress | Leggi l'avanzamento del riscaldamento (Pro) Restituisce se il riscaldamento è in esecuzione, quante pagine ha visitato e quante non sono riuscite. | Edizione Pro | GET …/abilities/zinn-cache/get-warmup-progress/run | manage_options | nessuno |
zinn-cache/preview-database-cleanupzinn-cache-preview-database-cleanup | Anteprima della pulizia del database (Pro) Conta cosa rimuoverebbe una pulizia, per tipologia (revisioni, bozze, spam, dati temporanei scaduti e simili). Non viene rimosso nulla. | Edizione Pro | GET …/abilities/zinn-cache/preview-database-cleanup/run | manage_options | nessuno |
zinn-cache/purgezinn-cache-purge | Svuota la cache Elimina le pagine memorizzate nella cache: tutto (all: true), alcuni indirizzi (urls) o tutto ciò che è taggato (tags). Le pagine vengono ricreate all'arrivo dei visitatori. | Edizione gratuita | 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 | Svuota alcuni indirizzi su ogni livello di cache Rimuove contemporaneamente questi indirizzi (percorsi come /about/ o indirizzi completi su questo sito) dalla cache del disco, dalla cache del server e da Cloudflare, e mostra cosa ha risposto ciascun livello. | Edizione gratuita | POST …/abilities/zinn-cache/purge-urls/run | manage_options (the REST route's own check) | urls: array (obbligatorio) |
zinn-cache/refresh-cachezinn-cache-refresh-cache | Avvia o interrompi l'aggiornamento cadenzato action: start aggiorna ogni pagina un batch al minuto (quello che fanno gli aggiornamenti invece di svuotare la cache); action: stop termina un aggiornamento in corso. | Edizione gratuita | POST …/abilities/zinn-cache/refresh-cache/run | manage_options (the REST route's own check) | action: start|stop (obbligatorio) |
zinn-cache/remove-converted-imageszinn-cache-remove-converted-images | Rimuovi tutte le immagini convertite (Pro) Elimina in background ogni copia convertita delle immagini; gli originali rimangono. | Edizione Pro | POST …/abilities/zinn-cache/remove-converted-images/run | manage_options | nessuno |
zinn-cache/reset-settingszinn-cache-reset-settings | Ripristina le impostazioni della cache ai valori predefiniti Ripristina tutte le impostazioni della cache ai valori predefiniti, esattamente come fa il pulsante Reimposta. Anche la password di Redis salvata viene rimossa. | Edizione gratuita | POST …/abilities/zinn-cache/reset-settings/run | manage_options | nessuno |
zinn-cache/reset-slow-querieszinn-cache-reset-slow-queries | Cancella i risultati delle query lente (Pro) Dimentica ogni query lenta e chiamata lenta trovata finora, e lo strumento di ricerca riparte. | Edizione Pro | POST …/abilities/zinn-cache/reset-slow-queries/run | manage_options | nessuno |
zinn-cache/update-pro-settingszinn-cache-update-pro-settings | Modifica le impostazioni di Cache Pro (Pro) Modifica le impostazioni di Cache Pro che invii (impostazioni: da chiave a valore) e mantiene il resto. Ciascun valore viene verificato esattamente come nella schermata di Cache Pro; una chiave sconosciuta viene rifiutata. | Edizione Pro | POST …/abilities/zinn-cache/update-pro-settings/run | manage_options | settings: object (obbligatorio) |
zinn-cache/update-settingszinn-cache-update-settings | Modifica le impostazioni della cache Modifica le impostazioni che invii e mantiene il resto (cache delle pagine, durata di permanenza delle pagine in cache, cache degli oggetti e relativa connessione Redis, regole di svuotamento ed esclusioni). I valori vengono controllati e corretti esattamente come nella schermata Cache. | Edizione gratuita | 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 | Preriscalda la cache (Pro) Inizia a visitare ogni pagina delle sitemap in background, in modo che i visitatori ricevano pagine memorizzate nella cache. L'avanzamento viene segnalato separatamente durante l'esecuzione. | Edizione Pro | POST …/abilities/zinn-cache/warm-cache/run | manage_options | nessuno |
Comandi WP-CLI
Esegui questi comandi sul server con WP-CLI. Ciascun comando verifica gli stessi permessi delle schermate del plugin; gli esempi sono tratti dal testo di aiuto del plugin stesso.
| Comando | Cosa fa | Edizione |
|---|---|---|
wp zinn-cache purge allwp zinn-cache purge all | Svuota ogni pagina memorizzata nella cache. | Edizione gratuita |
wp zinn-cache purge post<id>...wp zinn-cache purge post 42 | Elimina le pagine di un articolo e gli elenchi in cui appare (home page, archivi, feed). | Edizione gratuita |
wp zinn-cache purge url<url>...wp zinn-cache purge url https://example.com/ /pricing/ | Elimina le pagine memorizzate nella cache a questi URL. | Edizione gratuita |
wp zinn-cache refresh<action>wp zinn-cache refresh status | Avviate, arrestate o mostrate l'aggiornamento cadenzato (ciò che sostituisce "svuota tutto" dopo un aggiornamento). | Edizione gratuita |
wp zinn-cache server detectwp zinn-cache server detect | Verificate quali cache rispondono a monte del sito (nginx, Varnish, Apache, LiteSpeed, Cloudflare). | Edizione gratuita |
wp zinn-cache server drainwp zinn-cache server drain | Invia le eliminazioni della cache del server in coda ora invece di attendere WP-Cron. | Edizione gratuita |
wp zinn-cache status[--format=<format>]wp zinn-cache status --format=json | Segnala lo stato della cache degli oggetti. | Edizione gratuita |
Azioni e filtri
Ogni gancio offerto dal plugin, con la descrizione tratta dal suo codice sorgente. I filtri modificano un valore; le azioni consentono di eseguire codice in un determinato momento; i punti di ingresso sono azioni attivate per richiedere al plugin di eseguire un'operazione.
| Webhook | Genere | Cosa fa | Parametri | Edizione |
|---|---|---|---|---|
zinn_cache_control_header | Filtra | Filtra il valore cache-control inviato a LiteSpeed per una pagina memorizzabile nella cache. | string $value, int $ttl | Edizione gratuita |
zinn_cache_fs_loaded | Azione | Si attiva una volta caricato l'SDK di licensing, prima del resto di Zinn® Cache. Eseguire l'hook qui per comunicare con `zinn_cache_fs()`. | nessuno | Edizione gratuita |
zinn_cache_link_scan_post_types | Filtra | Tipi di post coperti dalla scansione. | nessuno | Edizione gratuita |
zinn_cache_mcp_abilities | Azione | Viene attivato dopo che Zinn® Cache registra le sue funzionalità: Zinn® Cache Pro aggiunge qui le proprie. | nessuno | Edizione gratuita |
zinn_cache_post_change_tags | Filtra | Filtra i tag della cache eliminati quando un articolo viene modificato. | string[] $tags, int $post_id, string $post_type | Edizione gratuita |
zinn_cache_purge_all | Azione | Cancella tutto dalla riga degli Strumenti. | nessuno | Edizione gratuita |
zinn_cache_purge_hosts | Filtra | Filtra i nomi host che le eliminazioni possono specificare (per un sito servito su più di un dominio). | string[] $hosts | Edizione gratuita |
zinn_cache_purge_on_seo_change | Filtra | Filtra se una modifica apportata in Zinn® SEO svuota le pagine che ha modificato. | bool $on | Edizione gratuita |
zinn_cache_purge_plan | Punto di ingresso (lo attiva Lei) | Elimina esattamente ciò che un piano specifica: `do_action( 'zinn_cache_purge_plan', array( 'urls' => …, 'tags' => …, 'purge_all' => … ) )`. | nessuno | Edizione gratuita |
zinn_cache_purged | Azione | Si attiva dopo che il plug-in ha avviato una pulizia della cache. | array{purge_all:bool,urls:string[],tags:string[]} $plan | Edizione gratuita |
zinn_cache_purged_all | Azione | Si attiva dopo che è stato richiesto uno svuotamento completo della cache della pagina. | string $reason | Edizione gratuita |
zinn_cache_refresh_armed | Azione | Si attiva quando inizia un aggiornamento cadenzato. | string $reason | Edizione gratuita |
zinn_cache_refresh_finished | Azione | Si attiva quando un aggiornamento cadenzato ha raggiunto la fine del sito. | int $pages | Edizione gratuita |
zinn_cache_refresh_guard | Filtra | Filtra se l'aggiornamento debba essere sospeso in questo minuto (la protezione del carico proprietaria dell'host). | string $reason | Edizione gratuita |
zinn_cache_refresh_urls | Filtra | Filtra gli indirizzi eliminati da un batch di aggiornamento: aggiungete qui, ad esempio, gli indirizzi delle altre lingue di ciascuna pagina. | string[] $urls | Edizione gratuita |
zinn_cache_refreshed_urls | Azione | Si attiva dopo l'eliminazione di un batch di aggiornamento (Zinn® Cache Pro riscalda nuovamente queste pagine). | string[] $urls | Edizione gratuita |
zinn_cache_request_cacheable | Filtra | Filtra se la richiesta front-end corrente può essere servita dalla cache di pagina. | bool $cacheable | Edizione gratuita |
zinn_cache_status_rows | Filtra | Filtra le righe della tabella «Cosa memorizza nella cache questo sito» della schermata di stato. | array<int,array{0:string,1:string}> $rows, array<string,mixed> $report | Edizione gratuita |
zinn_cache_ttl | Filtra | Filtra per quanto tempo la pagina corrente viene memorizzata nella cache, in secondi. | int $ttl | Edizione gratuita |