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.

Guida utente: collega un'app di IA

Zinn®, il nostro vichingo, esulta mentre un assistente IA si connette agli strumenti della piattaforma.

Endpoint

MCP su HTTP (streamable)

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

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

REST: esegui un'abilità

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

Autenticazione 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.

AbilitazioneCosa faEdizioneRESTAutorizzazioneParametri
zinn-cache/clean-database
zinn-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 ProPOST …/abilities/zinn-cache/clean-database/runmanage_optionsnessuno
zinn-cache/convert-images
zinn-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 ProPOST …/abilities/zinn-cache/convert-images/runmanage_optionsnessuno
zinn-cache/detect-cache-layers
zinn-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 gratuitaPOST …/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
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 ProGET …/abilities/zinn-cache/get-cache-analytics/runmanage_optionshours: integer
zinn-cache/get-cache-layers
zinn-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 gratuitaGET …/abilities/zinn-cache/get-cache-layers/runmanage_options (the REST route's own check)nessuno
zinn-cache/get-diagnostics
zinn-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 gratuitaGET …/abilities/zinn-cache/get-diagnostics/runmanage_optionsnessuno
zinn-cache/get-image-progress
zinn-cache-get-image-progress
Leggi l'avanzamento della conversione dell'immagine (Pro)
Restituisce lo stato di avanzamento della conversione (o rimozione) delle immagini.
Edizione ProGET …/abilities/zinn-cache/get-image-progress/runmanage_optionsnessuno
zinn-cache/get-pro-settings
zinn-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 ProGET …/abilities/zinn-cache/get-pro-settings/runmanage_optionsnessuno
zinn-cache/get-settings
zinn-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 gratuitaGET …/abilities/zinn-cache/get-settings/runmanage_optionsnessuno
zinn-cache/get-slow-queries
zinn-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 ProGET …/abilities/zinn-cache/get-slow-queries/runmanage_optionsnessuno
zinn-cache/get-status
zinn-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 gratuitaGET …/abilities/zinn-cache/get-status/runmanage_optionsnessuno
zinn-cache/get-warmup-progress
zinn-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 ProGET …/abilities/zinn-cache/get-warmup-progress/runmanage_optionsnessuno
zinn-cache/preview-database-cleanup
zinn-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 ProGET …/abilities/zinn-cache/preview-database-cleanup/runmanage_optionsnessuno
zinn-cache/purge
zinn-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 gratuitaPOST …/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
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 gratuitaPOST …/abilities/zinn-cache/purge-urls/runmanage_options (the REST route's own check)urls: array (obbligatorio)
zinn-cache/refresh-cache
zinn-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 gratuitaPOST …/abilities/zinn-cache/refresh-cache/runmanage_options (the REST route's own check)action: start|stop (obbligatorio)
zinn-cache/remove-converted-images
zinn-cache-remove-converted-images
Rimuovi tutte le immagini convertite (Pro)
Elimina in background ogni copia convertita delle immagini; gli originali rimangono.
Edizione ProPOST …/abilities/zinn-cache/remove-converted-images/runmanage_optionsnessuno
zinn-cache/reset-settings
zinn-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 gratuitaPOST …/abilities/zinn-cache/reset-settings/runmanage_optionsnessuno
zinn-cache/reset-slow-queries
zinn-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 ProPOST …/abilities/zinn-cache/reset-slow-queries/runmanage_optionsnessuno
zinn-cache/update-pro-settings
zinn-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 ProPOST …/abilities/zinn-cache/update-pro-settings/runmanage_optionssettings: object (obbligatorio)
zinn-cache/update-settings
zinn-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 gratuitaPOST …/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
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 ProPOST …/abilities/zinn-cache/warm-cache/runmanage_optionsnessuno

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.

ComandoCosa faEdizione
wp zinn-cache purge all
wp 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 detect
wp zinn-cache server detect
Verificate quali cache rispondono a monte del sito (nginx, Varnish, Apache, LiteSpeed, Cloudflare).Edizione gratuita
wp zinn-cache server drain
wp 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.

WebhookGenereCosa faParametriEdizione
zinn_cache_control_headerFiltraFiltra il valore cache-control inviato a LiteSpeed per una pagina memorizzabile nella cache.string $value, int $ttlEdizione gratuita
zinn_cache_fs_loadedAzioneSi attiva una volta caricato l'SDK di licensing, prima del resto di Zinn® Cache. Eseguire l'hook qui per comunicare con `zinn_cache_fs()`.nessunoEdizione gratuita
zinn_cache_link_scan_post_typesFiltraTipi di post coperti dalla scansione.nessunoEdizione gratuita
zinn_cache_mcp_abilitiesAzioneViene attivato dopo che Zinn® Cache registra le sue funzionalità: Zinn® Cache Pro aggiunge qui le proprie.nessunoEdizione gratuita
zinn_cache_post_change_tagsFiltraFiltra i tag della cache eliminati quando un articolo viene modificato.string[] $tags, int $post_id, string $post_typeEdizione gratuita
zinn_cache_purge_allAzioneCancella tutto dalla riga degli Strumenti.nessunoEdizione gratuita
zinn_cache_purge_hostsFiltraFiltra i nomi host che le eliminazioni possono specificare (per un sito servito su più di un dominio).string[] $hostsEdizione gratuita
zinn_cache_purge_on_seo_changeFiltraFiltra se una modifica apportata in Zinn® SEO svuota le pagine che ha modificato.bool $onEdizione gratuita
zinn_cache_purge_planPunto di ingresso (lo attiva Lei)Elimina esattamente ciò che un piano specifica: `do_action( 'zinn_cache_purge_plan', array( 'urls' => …, 'tags' => …, 'purge_all' => … ) )`.nessunoEdizione gratuita
zinn_cache_purgedAzioneSi attiva dopo che il plug-in ha avviato una pulizia della cache.array{purge_all:bool,urls:string[],tags:string[]} $planEdizione gratuita
zinn_cache_purged_allAzioneSi attiva dopo che è stato richiesto uno svuotamento completo della cache della pagina.string $reasonEdizione gratuita
zinn_cache_refresh_armedAzioneSi attiva quando inizia un aggiornamento cadenzato.string $reasonEdizione gratuita
zinn_cache_refresh_finishedAzioneSi attiva quando un aggiornamento cadenzato ha raggiunto la fine del sito.int $pagesEdizione gratuita
zinn_cache_refresh_guardFiltraFiltra se l'aggiornamento debba essere sospeso in questo minuto (la protezione del carico proprietaria dell'host).string $reasonEdizione gratuita
zinn_cache_refresh_urlsFiltraFiltra gli indirizzi eliminati da un batch di aggiornamento: aggiungete qui, ad esempio, gli indirizzi delle altre lingue di ciascuna pagina.string[] $urlsEdizione gratuita
zinn_cache_refreshed_urlsAzioneSi attiva dopo l'eliminazione di un batch di aggiornamento (Zinn® Cache Pro riscalda nuovamente queste pagine).string[] $urlsEdizione gratuita
zinn_cache_request_cacheableFiltraFiltra se la richiesta front-end corrente può essere servita dalla cache di pagina.bool $cacheableEdizione gratuita
zinn_cache_status_rowsFiltraFiltra 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> $reportEdizione gratuita
zinn_cache_ttlFiltraFiltra per quanto tempo la pagina corrente viene memorizzata nella cache, in secondi.int $ttlEdizione gratuita