Ontwikkelaars
Referentie van Zinn® Cache-functionaliteiten
Zinn® Cache registreert zijn acties bij de WordPress Abilities API. Dezelfde vaardigheden zijn MCP-tools op de eigen server van de site en REST-routes onder /wp-json/wp-abilities/v1. Deze pagina is gegenereerd vanuit het eigen register van de plugin.
Eindpunten
MCP over HTTP (streamable)
https://example.com/wp-json/zinn-cache/v1/mcpMCP over WP-CLI (standaard invoer en uitvoer)
wp mcp-adapter serve --server=zinn-cache --user=<login>REST: toon de mogelijkheden
/wp-json/wp-abilities/v1/abilities?category=zinn-cacheREST: voer een functie uit
/wp-json/wp-abilities/v1/abilities/<name>/runAuthenticatie en machtigingen
HTTP-verzoeken verifiëren met een WordPress-applicatiewachtwoord (HTTP Basic). Voor het verbinden met de MCP-server is de hieronder getoonde functionaliteit vereist; elke vaardigheid controleert vervolgens haar eigen permissie, per object. Alleen-lezen-vaardigheden worden uitgevoerd met GET en hun invoer in de query-tekenreeks; de overige met POST en een JSON-body {"input": {…}}.
Voorbeelden
# REST: voer een functie uit
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":{}}}Alle bevoegdheden
Gegenereerd op basis van abilities.json van de plug-in, die op zijn beurt is gegenereerd vanuit een actieve site; een test mislukt wanneer deze twee niet met elkaar overeenkomen.
| Mogelijkheid | Wat het doet | Editie | REST | Machtiging | Parameters |
|---|---|---|---|---|---|
zinn-cache/clean-databasezinn-cache-clean-database | Schoon de database op (Pro) Verwijdert op de achtergrond de soorten rommel die zijn ingeschakeld in de instellingen. Wat verwijderd is, kan niet worden teruggehaald. | Pro-editie | POST …/abilities/zinn-cache/clean-database/run | manage_options | geen |
zinn-cache/convert-imageszinn-cache-convert-images | Converteer alle bestaande afbeeldingen (Pro) Begint op de achtergrond met het converteren van de afbeeldingen in de mediabibliotheek naar de moderne formaten die je in de instellingen hebt ingeschakeld. | Pro-editie | POST …/abilities/zinn-cache/convert-images/run | manage_options | geen |
zinn-cache/detect-cache-layerszinn-cache-detect-cache-layers | Detecteer de caches vóór de site Vraagt de startpagina op zoals een bezoeker dat zou doen en slaat op welke caches hebben geantwoord. Met sample: true vraagt het de nieuwste pagina's ook twee keer op en telt het hoe vaak elke laag ze vanuit zijn cache heeft geleverd. | Gratis editie | 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 | Lees de cache-statistieken (Pro) Toont het hitpercentage en verkeer van de objectcache voor de afgelopen uren (uren, tot 720), de traagste commando's en welke plugins de cache het vaakst missen. | Pro-editie | GET …/abilities/zinn-cache/get-cache-analytics/run | manage_options | hours: integer |
zinn-cache/get-cache-layerszinn-cache-get-cache-layers | Lees wat de site buffert Geeft aan welke cache pagina's serveert (LiteSpeed, nginx, Varnish, Apache, Cloudflare of de schijfcache van de plugin), wat er bij de laatste detectie is waargenomen, de grootte van elke laag waar WordPress deze kan lezen, de wachtrij voor legen, het gedoseerd vernieuwen en de recente legingen. | Gratis editie | GET …/abilities/zinn-cache/get-cache-layers/run | manage_options (the REST route's own check) | geen |
zinn-cache/get-diagnosticszinn-cache-get-diagnostics | Lees het diagnoserapport Retourneert het diagnostische rapport waar support om vraagt: versies, serverlimieten, de cachestatus en recente fouten. Het bevat geen wachtwoorden of sleutels. | Gratis editie | GET …/abilities/zinn-cache/get-diagnostics/run | manage_options | geen |
zinn-cache/get-image-progresszinn-cache-get-image-progress | Lees de voortgang van de beeldconversie (Pro) Geeft als resultaat hoe ver de conversie (of verwijdering) van de afbeeldingen is gevorderd. | Pro-editie | GET …/abilities/zinn-cache/get-image-progress/run | manage_options | geen |
zinn-cache/get-pro-settingszinn-cache-get-pro-settings | Lees de Cache Pro-instellingen (Pro) Retourneert elke Cache Pro-instelling (opwarmen, afbeeldingen, scripts en stijlen, database opschonen, slim wissen, de finder). Geheimen worden nooit geretourneerd. | Pro-editie | GET …/abilities/zinn-cache/get-pro-settings/run | manage_options | geen |
zinn-cache/get-settingszinn-cache-get-settings | Lees de cache-instellingen Retourneert elke cache-instelling. Het Redis-wachtwoord en het Cloudflare-token worden nooit geretourneerd, alleen of er een is opgeslagen. | Gratis editie | GET …/abilities/zinn-cache/get-settings/run | manage_options | geen |
zinn-cache/get-slow-querieszinn-cache-get-slow-queries | Lees de zoeker naar trage query's (Pro) Geeft de langzaamste databasequery's en uitgaande aanroepen weer die de zoeker heeft waargenomen, met de plugin of het thema dat ze heeft uitgevoerd. | Pro-editie | GET …/abilities/zinn-cache/get-slow-queries/run | manage_options | geen |
zinn-cache/get-statuszinn-cache-get-status | Lees de cachestatus Geeft terug of de paginacache en de objectcache zijn ingeschakeld en werken, hoeveel pagina's er gecachet zijn en de verbindings- en hit-aantallen van de objectcache. | Gratis editie | GET …/abilities/zinn-cache/get-status/run | manage_options | geen |
zinn-cache/get-warmup-progresszinn-cache-get-warmup-progress | Lees de voortgang van de opwarming (Pro) Retourneert of de opwarming actief is, hoeveel pagina's zijn bezocht en hoeveel er zijn mislukt. | Pro-editie | GET …/abilities/zinn-cache/get-warmup-progress/run | manage_options | geen |
zinn-cache/preview-database-cleanupzinn-cache-preview-database-cleanup | Voorbeeld van de database-opschoning (Pro) Telt wat een opschoonactie zou verwijderen, per soort (revisies, concepten, spam, verlopen tijdelijke gegevens en dergelijke). Er wordt niets verwijderd. | Pro-editie | GET …/abilities/zinn-cache/preview-database-cleanup/run | manage_options | geen |
zinn-cache/purgezinn-cache-purge | Cache legen Verwijdert gecachte pagina's: alles (all: true), bepaalde adressen (urls) of alles met tags (tags). Pagina's worden opnieuw opgebouwd zodra bezoekers binnenkomen. | Gratis editie | 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 | Sommige adressen op elke cachelaag wissen Verwijdert deze adressen (paden zoals /about/ of volledige adressen op deze site) tegelijkertijd uit de schijfcache, de servercache en Cloudflare, en geeft aan wat elke laag heeft geantwoord. | Gratis editie | POST …/abilities/zinn-cache/purge-urls/run | manage_options (the REST route's own check) | urls: array (verplicht) |
zinn-cache/refresh-cachezinn-cache-refresh-cache | Start of stop het gedoseerd vernieuwen actie: start ververst elke pagina batch per minuut (wat updates doen in plaats van de cache te legen); actie: stop beëindigt een actieve vernieuwing. | Gratis editie | POST …/abilities/zinn-cache/refresh-cache/run | manage_options (the REST route's own check) | action: start|stop (verplicht) |
zinn-cache/remove-converted-imageszinn-cache-remove-converted-images | Verwijder alle geconverteerde afbeeldingen (Pro) Verwijdert op de achtergrond elke geconverteerde kopie van de afbeeldingen; de originelen blijven behouden. | Pro-editie | POST …/abilities/zinn-cache/remove-converted-images/run | manage_options | geen |
zinn-cache/reset-settingszinn-cache-reset-settings | Zet de cache-instellingen terug naar de standaardwaarden Zet elke cache-instelling terug naar de standaardwaarde, net zoals de Reset-knop doet. Het opgeslagen Redis-wachtwoord wordt ook verwijderd. | Gratis editie | POST …/abilities/zinn-cache/reset-settings/run | manage_options | geen |
zinn-cache/reset-slow-querieszinn-cache-reset-slow-queries | Wis de bevindingen van trage query's (Pro) Vergeet elke trage query en trage aanroep die tot nu toe is gevonden, en de zoeker begint opnieuw. | Pro-editie | POST …/abilities/zinn-cache/reset-slow-queries/run | manage_options | geen |
zinn-cache/update-pro-settingszinn-cache-update-pro-settings | Wijzig de Cache Pro-instellingen (Pro) Wijzigt de Cache Pro-instellingen die je verzendt (instellingen: sleutel naar waarde) en behoudt de rest. Elke waarde wordt precies zoals op het Cache Pro-scherm gecontroleerd; een onbekende sleutel wordt geweigerd. | Pro-editie | POST …/abilities/zinn-cache/update-pro-settings/run | manage_options | settings: object (verplicht) |
zinn-cache/update-settingszinn-cache-update-settings | Wijzig de cache-instellingen Wijzigt de instellingen die je verzendt en behoudt de rest (paginacache, hoe lang pagina's in de cache blijven, de objectcache en de bijbehorende Redis-verbinding, leegregels en uitsluitingen). Waarden worden precies zoals op het scherm Cache gecontroleerd en gecorrigeerd. | Gratis editie | 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 | Cache voorverwarmen (Pro) Begint op de achtergrond elke pagina in de sitemaps te bezoeken, zodat bezoekers gecachte pagina's te zien krijgen. De voortgang wordt tijdens de uitvoering apart gerapporteerd. | Pro-editie | POST …/abilities/zinn-cache/warm-cache/run | manage_options | geen |
WP-CLI-opdrachten
Voer deze uit op de server met WP-CLI. Elke opdracht controleert dezelfde permissies als de schermen van de plugin; de voorbeelden zijn overgenomen uit de eigen helptekst van de plugin.
| Opdracht | Wat het doet | Editie |
|---|---|---|
wp zinn-cache purge allwp zinn-cache purge all | Elke gecachete pagina wissen. | Gratis editie |
wp zinn-cache purge post<id>...wp zinn-cache purge post 42 | De pagina's van een bericht en de overzichten waarop het verschijnt (homepage, archieven, feeds) opschonen. | Gratis editie |
wp zinn-cache purge url<url>...wp zinn-cache purge url https://example.com/ /pricing/ | Wis de gecachte pagina's op deze URL's. | Gratis editie |
wp zinn-cache refresh<action>wp zinn-cache refresh status | Start, stop of toon het gedoseerd vernieuwen (wat na een update "alles wissen" vervangt). | Gratis editie |
wp zinn-cache server detectwp zinn-cache server detect | Controleer welke caches vóór de site antwoorden (nginx, Varnish, Apache, LiteSpeed, Cloudflare). | Gratis editie |
wp zinn-cache server drainwp zinn-cache server drain | Verzend de servercache-opschoningen in de wachtrij nu in plaats van te wachten op WP-Cron. | Gratis editie |
wp zinn-cache status[--format=<format>]wp zinn-cache status --format=json | Rapporteer de status van de objectcache. | Gratis editie |
Acties en filters
Elke hook die de plugin biedt, met de beschrijving uit de broncode. Filters veranderen een waarde; met acties kunt u op een bepaald moment code uitvoeren; ingangspunten zijn acties die u triggert om de plugin iets te laten doen.
| Webhook | Aard | Wat het doet | Parameters | Editie |
|---|---|---|---|---|
zinn_cache_control_header | Filteren | Filtert de cache-control-waarde die naar LiteSpeed wordt verzonden voor een cachebare pagina. | string $value, int $ttl | Gratis editie |
zinn_cache_fs_loaded | Actie | Wordt uitgevoerd zodra de licentie-SDK is geladen, vóór de rest van Zinn® Cache. Maak hier een hook aan om te communiceren met `zinn_cache_fs()`. | geen | Gratis editie |
zinn_cache_link_scan_post_types | Filteren | Berichttypen die de scan omvat. | geen | Gratis editie |
zinn_cache_mcp_abilities | Actie | Wordt uitgevoerd nadat Zinn® Cache zijn capaciteiten registreert: Zinn® Cache Pro voegt hier zijn eigen capaciteiten toe. | geen | Gratis editie |
zinn_cache_post_change_tags | Filteren | Filtert de cachetags die worden opgeschoond wanneer een bericht wordt gewijzigd. | string[] $tags, int $post_id, string $post_type | Gratis editie |
zinn_cache_purge_all | Actie | Wis alles via de rij Hulpmiddelen. | geen | Gratis editie |
zinn_cache_purge_hosts | Filteren | Filtert de hostnamen die opschoningen mogen noemen (voor een site die op meer dan één domein wordt aangeboden). | string[] $hosts | Gratis editie |
zinn_cache_purge_on_seo_change | Filteren | Filtert of een wijziging die is aangebracht in Zinn® SEO de pagina's die zijn gewijzigd leegmaakt. | bool $on | Gratis editie |
zinn_cache_purge_plan | Invoerpunt (u vuurt dit af) | Verwijder precies wat een pakket aangeeft: `do_action( 'zinn_cache_purge_plan', array( 'urls' => …, 'tags' => …, 'purge_all' => … ) )`. | geen | Gratis editie |
zinn_cache_purged | Actie | Wordt uitgevoerd nadat de plug-in een cache-opschoning heeft verzonden. | array{purge_all:bool,urls:string[],tags:string[]} $plan | Gratis editie |
zinn_cache_purged_all | Actie | Wordt geactiveerd nadat een volledige opschoning van de paginacache is aangevraagd. | string $reason | Gratis editie |
zinn_cache_refresh_armed | Actie | Wordt geactiveerd wanneer een getimed vernieuwen begint. | string $reason | Gratis editie |
zinn_cache_refresh_finished | Actie | Wordt geactiveerd wanneer een gedoseerde vernieuwing het einde van de site heeft bereikt. | int $pages | Gratis editie |
zinn_cache_refresh_guard | Filteren | Filtert of het vernieuwen deze minuut moet worden onderbroken (de eigen belastingbeveiliging van de host). | string $reason | Gratis editie |
zinn_cache_refresh_urls | Filteren | Filtert de adressen die een vernieuwingsbatch opschoont — voeg hier bijvoorbeeld de adressen in andere talen van elke pagina toe. | string[] $urls | Gratis editie |
zinn_cache_refreshed_urls | Actie | Wordt geactiveerd nadat een vernieuwingsbatch is gewist (Zinn® Cache Pro warmt deze pagina's opnieuw op). | string[] $urls | Gratis editie |
zinn_cache_request_cacheable | Filteren | Bepaalt of het huidige front-endverzoek vanuit de paginacache mag worden bediend. | bool $cacheable | Gratis editie |
zinn_cache_status_rows | Filteren | Filtert de rijen van de tabel «Wat buffert deze site» op het statusscherm. | array<int,array{0:string,1:string}> $rows, array<string,mixed> $report | Gratis editie |
zinn_cache_ttl | Filteren | Bepaalt hoe lang de huidige pagina wordt gecached, in seconden. | int $ttl | Gratis editie |