Vývojáři
Referat schopností pluginu Zinn® Cache
Zinn® Cache registruje své akce pomocí WordPress Abilities API. Stejné schopnosti jsou nástroji MCP na vlastním serveru webu a cestami REST pod /wp-json/wp-abilities/v1. Tato stránka je generována z vlastního registru pluginu.
Uživatelská příručka: připojení aplikace s umělou inteligencí
Koncové body
MCP přes HTTP (streamovatelné)
https://example.com/wp-json/zinn-cache/v1/mcpMCP přes WP-CLI (standardní vstup a výstup)
wp mcp-adapter serve --server=zinn-cache --user=<login>REST: vypsat funkce
/wp-json/wp-abilities/v1/abilities?category=zinn-cacheREST: spustit schopnost
/wp-json/wp-abilities/v1/abilities/<name>/runAutentizace a oprávnění
HTTP požadavky se ověřují pomocí aplikačního hesla WordPress (HTTP Basic). Připojení k serveru MCP vyžaduje níže zobrazenou oprávněnost; každá schopnost pak kontroluje své vlastní oprávnění pro každý objekt. Schopnosti pouze pro čtení běží s metodou GET a vstupem v řetězci dotazu; ostatní s metodou POST a tělem JSON {„input“: {…}}.
Příklady
# REST: spustit schopnost
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":{}}}Všechny oprávnění
Vygenerováno ze souboru abilities.json v pluginu, který se sám generuje z běžícího webu; test selže, pokud se tyto dva zdroje neshodují.
| Oprávnění | Co to dělá | Edice | REST | Oprávnění | Parametry |
|---|---|---|---|---|---|
zinn-cache/clean-databasezinn-cache-clean-database | Vyčistit databázi (Pro) Na pozadí odstraňuje druhy nepořádku zapnuté v nastavení. Co je odstraněno, nelze vrátit zpět. | Edice Pro | POST …/abilities/zinn-cache/clean-database/run | manage_options | žádné |
zinn-cache/convert-imageszinn-cache-convert-images | Převést všechny existující obrázky (Pro) Spustí na pozadí převod obrázků v knihovně médií do moderních formátů povolených v nastavení. | Edice Pro | POST …/abilities/zinn-cache/convert-images/run | manage_options | žádné |
zinn-cache/detect-cache-layerszinn-cache-detect-cache-layers | Zjistit mezipaměti před webem Vyžádá domovskou stránku stejně jako návštěvník a zaznamená, které mezipaměti odpověděly. S parametrem sample: true také dvakrát vyžádá nejnovější stránky a spočítá, jak často je každá vrstva obsloužila ze své mezipaměti. | Bezplatná edice | 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 | Přečtěte si analytiku mezipaměti (Pro) Vrací míru úspěšnosti a provoz objektové mezipaměti za poslední hodiny (hodiny, až 720), její nejpomalejší příkazy a pluginy, které mezipaměť míjejí nejčastěji. | Edice Pro | GET …/abilities/zinn-cache/get-cache-analytics/run | manage_options | hours: integer |
zinn-cache/get-cache-layerszinn-cache-get-cache-layers | Přečtěte si, co web ukládá do mezipaměti Vrací informaci o tom, která mezipaměť obsluhuje stránky (LiteSpeed, nginx, Varnish, Apache, Cloudflare nebo disková mezipaměť pluginu), co zjistila poslední detekce, velikost jednotlivých vrstev tam, kde je WordPress dokáže přečíst, frontu promazávání, postupné obnovování a nedávná promazání. | Bezplatná edice | GET …/abilities/zinn-cache/get-cache-layers/run | manage_options (the REST route's own check) | žádné |
zinn-cache/get-diagnosticszinn-cache-get-diagnostics | Přečtěte si diagnostickou zprávu Vrací diagnostickou zprávu, kterou podpora vyžaduje: verze, limity serveru, stav mezipaměti a nedávné chyby. Neobsahuje žádná hesla ani klíče. | Bezplatná edice | GET …/abilities/zinn-cache/get-diagnostics/run | manage_options | žádné |
zinn-cache/get-image-progresszinn-cache-get-image-progress | Přečtěte si průběh převodu obrázku (Pro) Vrací, jak daleko pokročil převod (nebo odstranění) obrázků. | Edice Pro | GET …/abilities/zinn-cache/get-image-progress/run | manage_options | žádné |
zinn-cache/get-pro-settingszinn-cache-get-pro-settings | Přečtěte si nastavení Cache Pro (Pro) Vrací každé nastavení Cache Pro (zahřátí, obrázky, skripty a styly, vyčištění databáze, chytré promazávání, vyhledávač). Tajné klíče se nikdy nevrací. | Edice Pro | GET …/abilities/zinn-cache/get-pro-settings/run | manage_options | žádné |
zinn-cache/get-settingszinn-cache-get-settings | Přečtěte si nastavení mezipaměti Vrací všechna nastavení mezipaměti. Heslo pro Redis a token pro Cloudflare se nikdy nevrací, pouze informace o tom, zda jsou uloženy. | Bezplatná edice | GET …/abilities/zinn-cache/get-settings/run | manage_options | žádné |
zinn-cache/get-slow-querieszinn-cache-get-slow-queries | Přečtěte si o vyhledávači pomalých dotazů (Pro) Vrací nejpomalejší databázové dotazy a odchozí volání, které vyhledávač zaznamenal, spolu s pluginem nebo šablonou, které je provedly. | Edice Pro | GET …/abilities/zinn-cache/get-slow-queries/run | manage_options | žádné |
zinn-cache/get-statuszinn-cache-get-status | Přečíst stav mezipaměti Vrací, zda je mezipaměť stránek a mezipaměť objektů zapnutá a funguje, kolik stránek je v mezipaměti uloženo a počty připojení a zásahů mezipaměti objektů. | Bezplatná edice | GET …/abilities/zinn-cache/get-status/run | manage_options | žádné |
zinn-cache/get-warmup-progresszinn-cache-get-warmup-progress | Přečtěte si postup zahřívání (Pro) Vrací informaci, zda zahřívání běží, kolik stránek navštívilo a kolik jich selhalo. | Edice Pro | GET …/abilities/zinn-cache/get-warmup-progress/run | manage_options | žádné |
zinn-cache/preview-database-cleanupzinn-cache-preview-database-cleanup | Náhled vyčištění databáze (Pro) Spočítá, co by vyčištění odstranilo, podle jednotlivých druhů (revize, koncepty, spam, expirovaná dočasná data a podobně). Nic se neodstraňuje. | Edice Pro | GET …/abilities/zinn-cache/preview-database-cleanup/run | manage_options | žádné |
zinn-cache/purgezinn-cache-purge | Vyprázdnit mezipaměť Odstraní stránky z mezipaměti: vše (all: true), některé adresy (urls) nebo vše s daným štítkem (tags). Stránky se znovu vytvoří při příchodu návštěvníků. | Bezplatná edice | 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 | Vyprázdnit některé adresy na každé vrstvě mezipaměti Odebere tyto adresy (cesty jako /about/ nebo celé adresy na tomto webu) současně z diskové mezipaměti, mezipaměti serveru a ze služby Cloudflare a uvede, co jednotlivé vrstvy odpověděly. | Bezplatná edice | POST …/abilities/zinn-cache/purge-urls/run | manage_options (the REST route's own check) | urls: array (povinné) |
zinn-cache/refresh-cachezinn-cache-refresh-cache | Spusťte nebo zastavte postupné obnovování action: start obnovuje každou stránku po dávkách za minutu (což provádějí aktualizace namísto vyprázdnění mezipaměti); action: stop ukončí probíhající obnovu. | Bezplatná edice | POST …/abilities/zinn-cache/refresh-cache/run | manage_options (the REST route's own check) | action: start|stop (povinné) |
zinn-cache/remove-converted-imageszinn-cache-remove-converted-images | Odebrat všechny převedené obrázky (Pro) Na pozadí smaže každou převedenou kopii obrázků; originály zůstanou zachovány. | Edice Pro | POST …/abilities/zinn-cache/remove-converted-images/run | manage_options | žádné |
zinn-cache/reset-settingszinn-cache-reset-settings | Obnovte výchozí nastavení mezipaměti Vrátí každé nastavení mezipaměti zpět na výchozí hodnotu, stejně jako tlačítko Obnovit. Uložené heslo pro Redis bude také odstraněno. | Bezplatná edice | POST …/abilities/zinn-cache/reset-settings/run | manage_options | žádné |
zinn-cache/reset-slow-querieszinn-cache-reset-slow-queries | Vymazat nálezy pomalých dotazů (Pro) Zapomene každý dosud nalezený pomalý dotaz a pomalé volání a vyhledávač se spustí znovu. | Edice Pro | POST …/abilities/zinn-cache/reset-slow-queries/run | manage_options | žádné |
zinn-cache/update-pro-settingszinn-cache-update-pro-settings | Změnit nastavení Cache Pro (Pro) Změní nastavení Cache Pro, která odešlete (nastavení: klíč k hodnotě), a zbytek ponechá. Každá hodnota je zkontrolována přesně jako na obrazovce Cache Pro; neznámý klíč je odmítnut. | Edice Pro | POST …/abilities/zinn-cache/update-pro-settings/run | manage_options | settings: object (povinné) |
zinn-cache/update-settingszinn-cache-update-settings | Změnit nastavení mezipaměti Změní nastavení, která odešlete, a zbytek zachová (mezipaměť stránek, jak dlouho zůstanou stránky v mezipaměti, mezipaměť objektů a její připojení k Redis, pravidla promazávání a výjimky). Hodnoty jsou zkontrolovány a opraveny přesně jako na obrazovce Cache. | Bezplatná edice | 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 | Zahřát mezipaměť (Pro) Začne na pozadí navštěvovat každou stránku v souborech sitemap, aby návštěvníci získávali stránky z mezipaměti. Průběh je během běhu hlášen samostatně. | Edice Pro | POST …/abilities/zinn-cache/warm-cache/run | manage_options | žádné |
Příkazy WP-CLI
Spusťte tyto příkazy na serveru pomocí WP-CLI. Každý příkaz kontroluje stejná oprávnění jako obrazovky pluginu; příklady jsou převzaty z nápovědy samotného pluginu.
| Příkaz | Co to dělá | Edice |
|---|---|---|
wp zinn-cache purge allwp zinn-cache purge all | Vyprázdnit všechny stránky v mezipaměti. | Bezplatná edice |
wp zinn-cache purge post<id>...wp zinn-cache purge post 42 | Vyprázdnit stránky příspěvku a výpisy, na kterých se zobrazuje (domovská stránka, archivy, kanály). | Bezplatná edice |
wp zinn-cache purge url<url>...wp zinn-cache purge url https://example.com/ /pricing/ | Vymažte stránky v mezipaměti na těchto adresách URL. | Bezplatná edice |
wp zinn-cache refresh<action>wp zinn-cache refresh status | Spusťte, zastavte nebo zobrazte postupné obnovení (to, co po aktualizaci nahrazuje možnost „vymazat vše“). | Bezplatná edice |
wp zinn-cache server detectwp zinn-cache server detect | Zkontrolujte, které mezipaměti odpovídají před webem (nginx, Varnish, Apache, LiteSpeed, Cloudflare). | Bezplatná edice |
wp zinn-cache server drainwp zinn-cache server drain | Odešlete zařazená promazání mezipaměti serveru nyní namísto čekání na WP-Cron. | Bezplatná edice |
wp zinn-cache status[--format=<format>]wp zinn-cache status --format=json | Nahlaste stav objektové mezipaměti. | Bezplatná edice |
Akce a filtry
Každý háček, který plugin nabízí, včetně popisu z jeho zdrojového kódu. Filtry mění hodnotu; akce vám umožňují spustit kód v daném okamžiku; vstupní body jsou akce, které spouštíte, abyste plugin požádali o provedení nějaké akce.
| Webhook | Druh | Co to dělá | Parametry | Edice |
|---|---|---|---|---|
zinn_cache_control_header | Filtrovat | Filtruje hodnotu cache-control odeslanou do LiteSpeed pro stránku, kterou lze ukládat do mezipaměti. | string $value, int $ttl | Bezplatná edice |
zinn_cache_fs_loaded | Akce | Spustí se po načtení SDK licenčního klíče, před zbytkem mezipaměti Zinn® Cache. Zde se můžete napojit na komunikaci s `zinn_cache_fs()`. | žádné | Bezplatná edice |
zinn_cache_link_scan_post_types | Filtrovat | Typy příspěvků, které kontrola zahrnuje. | žádné | Bezplatná edice |
zinn_cache_mcp_abilities | Akce | Spustí se poté, co Zinn® Cache zaregistruje své schopnosti: Zinn® Cache Pro zde přidá své vlastní. | žádné | Bezplatná edice |
zinn_cache_post_change_tags | Filtrovat | Filtruje značky mezipaměti, které se vymažou při změně příspěvku. | string[] $tags, int $post_id, string $post_type | Bezplatná edice |
zinn_cache_purge_all | Akce | Vymažte vše z řádku Nástroje. | žádné | Bezplatná edice |
zinn_cache_purge_hosts | Filtrovat | Filtruje názvy hostitelů, které mohou pročištění uvádět (pro web provozovaný na více doménách). | string[] $hosts | Bezplatná edice |
zinn_cache_purge_on_seo_change | Filtrovat | Filtruje, zda změna provedená v Zinn® SEO promaže stránky, které změnila. | bool $on | Bezplatná edice |
zinn_cache_purge_plan | Vstupní bod (spustíte ho) | Vymažte přesně to, co plán uvádí: `do_action( 'zinn_cache_purge_plan', array( 'urls' => …, 'tags' => …, 'purge_all' => … ) )`. | žádné | Bezplatná edice |
zinn_cache_purged | Akce | Spustí se poté, co plugin vyvolá vymazání vyrovnávací paměti. | array{purge_all:bool,urls:string[],tags:string[]} $plan | Bezplatná edice |
zinn_cache_purged_all | Akce | Spustí se po vyžádání úplného vymazání mezipaměti stránky. | string $reason | Bezplatná edice |
zinn_cache_refresh_armed | Akce | Spouští se při zahájení dávkového obnovení. | string $reason | Bezplatná edice |
zinn_cache_refresh_finished | Akce | Spustí se, když postupné obnovení dosáhne konce webu. | int $pages | Bezplatná edice |
zinn_cache_refresh_guard | Filtrovat | Filtruje, zda by se mělo obnovení v této minutě pozastavit (vlastní ochrana zátěže hostitele). | string $reason | Bezplatná edice |
zinn_cache_refresh_urls | Filtrovat | Filtruje adresy, které dávka obnovení vymaže — přidejte sem například adresy jednotlivých stránek v jiných jazycích. | string[] $urls | Bezplatná edice |
zinn_cache_refreshed_urls | Akce | Spouští se po vyčištění dávky obnovení (Zinn® Cache Pro tyto stránky znovu zahřeje). | string[] $urls | Bezplatná edice |
zinn_cache_request_cacheable | Filtrovat | Filtruje, zda aktuální požadavek front-endu může být obsloužen z vyrovnávací paměti stránky. | bool $cacheable | Bezplatná edice |
zinn_cache_status_rows | Filtrovat | Filtruje řádky tabulky „Co ukládá tento web do mezipaměti“ na stavové obrazovce. | array<int,array{0:string,1:string}> $rows, array<string,mixed> $report | Bezplatná edice |
zinn_cache_ttl | Filtrovat | Filtruje dobu ukládání aktuální stránky do mezipaměti v sekundách. | int $ttl | Bezplatná edice |