Zhvilluesit
Referenca e aftësive për Zinn® Cache
Zinn® Cache regjistron veprimet e veta te WordPress Abilities API. Të njëjtat aftësi janë mjete MCP në serverin e vet të faqes dhe rrugë REST nën /wp-json/wp-abilities/v1. Kjo faqe gjenerohet nga regjistri i vetë shtojcës.
Pikat fundore
MCP mbi HTTP (që transmetohet)
https://example.com/wp-json/zinn-cache/v1/mcpMCP përmes WP-CLI (hyrja dhe dalja standarde)
wp mcp-adapter serve --server=zinn-cache --user=<login>REST: listoni aftësitë
/wp-json/wp-abilities/v1/abilities?category=zinn-cacheREST: ekzekuto një aftësi
/wp-json/wp-abilities/v1/abilities/<name>/runAutentifikimi dhe lejet
Kërkesat HTTP autentikohen me një fjalëkalim aplikacioni WordPress (HTTP Basic). Lidhja me serverin MCP kërkon aftësinë e treguar më poshtë; çdo aftësi më pas kontrollon lejen e saj, për çdo objekt. Aftësitë vetëm për lexim ekzekutohen me GET dhe hyrjen e lor në vargun e pyetjes (query string); të tjerat me POST dhe një trup JSON {"input": {…}}.
Shembuj
# REST: ekzekuto një aftësi
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":{}}}Të gjitha aftësitë
Gjeneruar nga abilities.json i shtojcës, i cili nga ana e tij gjenerohet nga një sajt në ekzekutim; një test dështon kur të dyja nuk pajtohen.
| Aftësia | Çfarë bën | Edicioni | REST | Leje | Parametrat |
|---|---|---|---|---|---|
zinn-cache/clean-databasezinn-cache-clean-database | Pastrojeni bazën e të dhënave (Pro) Heq në prapaskenë llojet e rrëmujës të aktivizuara te cilësimet. Çfarë hiqet nuk mund të rikthehet. | Edicioni Pro | POST …/abilities/zinn-cache/clean-database/run | manage_options | asnjë |
zinn-cache/convert-imageszinn-cache-convert-images | Konvertoni të gjitha imazhet ekzistuese (Pro) Nis konvertimin në sfond të imazheve të bibliotekës së medias në formatet moderne të aktivizuara te cilësimet. | Edicioni Pro | POST …/abilities/zinn-cache/convert-images/run | manage_options | asnjë |
zinn-cache/detect-cache-layerszinn-cache-detect-cache-layers | Zbuloni memorjet e përkohshme para faqes Kërkon faqen kryesore ashtu siç do të bënte një vizitor dhe ruan se cilat fshehtina u përgjigjën. Me sample: true, ajo gjithashtu kërkon dy herë faqet më të reja dhe numëron se sa shpesh secila shtresë i ka shërbyer ato nga fshehtina e saj. | Edicioni falas | 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 | Lexoni analitikën e fshehtinës (Pro) Kthen shkallën e goditjeve dhe trafikun e fshehtinës së objekteve për orët e fundit (orë, deri në 720), komandat e saj më të ngadalta, dhe cilat shtojca e humbasin më shumë fshehtinën. | Edicioni Pro | GET …/abilities/zinn-cache/get-cache-analytics/run | manage_options | hours: integer |
zinn-cache/get-cache-layerszinn-cache-get-cache-layers | Lexoni se çfarë po e ruan në fshehtinë faqen Kthen se cili fshehtinë shërben faqet (LiteSpeed, nginx, Varnish, Apache, Cloudflare ose fshehtina në disk e shtojcës), çfarë pa zbulimi i fundit, madhësinë e çdo shtrese ku WordPress mund ta lexojë, radhën e spastrimit, rifreskimin e kontrolluar dhe spastrimet e fundit. | Edicioni falas | GET …/abilities/zinn-cache/get-cache-layers/run | manage_options (the REST route's own check) | asnjë |
zinn-cache/get-diagnosticszinn-cache-get-diagnostics | Lexoni raportin e diagnostikimit Kthen raportin e diagnostikimit që kërkon mbështetja: versionet, kufijtë e serverit, gjendjen e fshehtinës dhe gabimet e fundit. Nuk mban fjalëkalime apo çelësa. | Edicioni falas | GET …/abilities/zinn-cache/get-diagnostics/run | manage_options | asnjë |
zinn-cache/get-image-progresszinn-cache-get-image-progress | Lexoni ecurinë e konvertimit të figurës (Pro) Kthen se sa ka përparuar konvertimi (ose heqja) e figurave. | Edicioni Pro | GET …/abilities/zinn-cache/get-image-progress/run | manage_options | asnjë |
zinn-cache/get-pro-settingszinn-cache-get-pro-settings | Lexoni rregullimet e Cache Pro-së (Pro) Kthen çdo cilësim të Cache Pro (ngrohjen, figurat, skriptet dhe stilet, pastrimin e bazës së të dhënave, spastrimin inteligjent, gjetësin). Sekretet nuk kthehen kurrë. | Edicioni Pro | GET …/abilities/zinn-cache/get-pro-settings/run | manage_options | asnjë |
zinn-cache/get-settingszinn-cache-get-settings | Lexoni rregullimet e fshehtinës Kthen çdo cilësim të fshehtinës. Fjalëkalimi i Redis dhe tokeni i Cloudflare nuk kthehen kurrë, kthehet vetëm nëse është ruajtur ndonjëri prej tyre. | Edicioni falas | GET …/abilities/zinn-cache/get-settings/run | manage_options | asnjë |
zinn-cache/get-slow-querieszinn-cache-get-slow-queries | Lexoni gjetësin e kërkesave të ngadalta (Pro) Kthen pyetësorët më të ngadaltë të bazës së të dhënave dhe thirrjet dalëse që gjetësi ka hasur, së bashku me shtojcën ose temën që ka kryer secilën prej tyre. | Edicioni Pro | GET …/abilities/zinn-cache/get-slow-queries/run | manage_options | asnjë |
zinn-cache/get-statuszinn-cache-get-status | Lexoni gjendjen e fshehtinës Kthen nëse fshehtina e faqeve dhe fshehtina e objekteve janë të aktivizuara dhe po funksionojnë, sa faqe janë ruajtur në fshehtinë, si dhe numrin e lidhjeve dhe goditjeve të fshehtinës së objekteve. | Edicioni falas | GET …/abilities/zinn-cache/get-status/run | manage_options | asnjë |
zinn-cache/get-warmup-progresszinn-cache-get-warmup-progress | Lexoni ecurinë e ngrohjes (Pro) Kthen nëse nxehja po funksionon, sa faqe ka vizituar dhe sa kanë dështuar. | Edicioni Pro | GET …/abilities/zinn-cache/get-warmup-progress/run | manage_options | asnjë |
zinn-cache/preview-database-cleanupzinn-cache-preview-database-cleanup | Parapamje e pastrimit të bazës së të dhënave (Pro) Numëron se çfarë do të hiqte një pastrim, sipas llojit (rishikime, draft-e, spam, të dhëna të përkohshme të skaduara e të ngjashme). Asgjë nuk hiqet. | Edicioni Pro | GET …/abilities/zinn-cache/preview-database-cleanup/run | manage_options | asnjë |
zinn-cache/purgezinn-cache-purge | Pastroje fshehtinën Hedh poshtë faqet e ruajtura në fshehtinë: gjithçka (all: true), disa adresa (urls) ose gjithçka me etiketa (tags). Faqet rindërtohen me mbërritjen e vizitorëve. | Edicioni falas | 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 | Pastro disa adresa në çdo shtresë fshehtine I heq këto adresa (shtigje të tilla si /about/ ose adresa të plota në këtë faqe) njëkohësisht nga fshehtina e diskut, fshehtina e serverit dhe Cloudflare, dhe tregon se çfarë u përgjigj secila shtresë. | Edicioni falas | POST …/abilities/zinn-cache/purge-urls/run | manage_options (the REST route's own check) | urls: array (kërkuar) |
zinn-cache/refresh-cachezinn-cache-refresh-cache | Nisni ose ndaloni rifreskimin e shkallëzuar action: start rifreskon çdo faqe me një grup për minutë (çfarë bëjnë përditësimet në vend që të boshatisin memorien e përkohshme); action: stop ndërpret një rifreskim në proces. | Edicioni falas | POST …/abilities/zinn-cache/refresh-cache/run | manage_options (the REST route's own check) | action: start|stop (kërkuar) |
zinn-cache/remove-converted-imageszinn-cache-remove-converted-images | Hiqni të gjitha imazhet e konvertuara (Pro) Fshin në prapaskenë çdo kopje të konvertuar të imazheve; origjinalet mbeten. | Edicioni Pro | POST …/abilities/zinn-cache/remove-converted-images/run | manage_options | asnjë |
zinn-cache/reset-settingszinn-cache-reset-settings | Rikthejini rregullimet e fshehtinës te parazgjedhjet e tyre Kthen çdo cilësim të fshehtinës në vlerën e paracaktuar, ashtu siç bën butoni Rivendos. Fjalëkalimi i ruajtur i Redis hiqet gjithashtu. | Edicioni falas | POST …/abilities/zinn-cache/reset-settings/run | manage_options | asnjë |
zinn-cache/reset-slow-querieszinn-cache-reset-slow-queries | Pastro gjetjet e kërkesave të ngadalta (Pro) Harron çdo kërkesë të ngadaltë dhe thirrje të ngadaltë të gjetur deri tani, dhe gjetësi riniset. | Edicioni Pro | POST …/abilities/zinn-cache/reset-slow-queries/run | manage_options | asnjë |
zinn-cache/update-pro-settingszinn-cache-update-pro-settings | Ndryshoni rregullimet e Cache Pro-së (Pro) Ndryshon cilësimet e Cache Pro që dërgoni (cilësimet: çelësi te vlera) dhe ruan pjesën tjetër. Çdo vlerë kontrollohet saktësisht si në ekranin e Cache Pro; një çelës i panjohur refuzohet. | Edicioni Pro | POST …/abilities/zinn-cache/update-pro-settings/run | manage_options | settings: object (kërkuar) |
zinn-cache/update-settingszinn-cache-update-settings | Ndryshoni rregullimet e fshehtinës Ndryshon cilësimet që dërgoni dhe ruan pjesën tjetër (parapamjen e faqeve, sa gjatë qëndrojnë faqet në memorien e përkohshme, parapamjen e objekteve dhe lidhjen e saj me Redis, rregullat e spastrimit dhe përjashtimet). Vlerat kontrollohen dhe korrigjohen saktësisht si në ekranin e Parapamjes. | Edicioni falas | 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 | Ngrohni memorien e fshehtë (Pro) Fillon të vizitojë çdo faqe në hartat e faqeve në sfond, në mënyrë që vizitorët të marrin faqe të ruajtura në fshehtinë. Ecuria e saj raportohet veçmas gjatë kohës që ekzekutohet. | Edicioni Pro | POST …/abilities/zinn-cache/warm-cache/run | manage_options | asnjë |
Komandat WP-CLI
Ekzekutoni këto në server me WP-CLI. Çdo komandë kontrollon të njëjtat leje si ekranet e shtojcës; shembujt janë marrë nga vetë teksti i ndihmës i shtojcës.
| Komandë | Çfarë bën | Edicioni |
|---|---|---|
wp zinn-cache purge allwp zinn-cache purge all | Pastro çdo faqe të ruajtur në memorien e përkohshme. | Edicioni falas |
wp zinn-cache purge post<id>...wp zinn-cache purge post 42 | Pastro faqet e një postimi dhe listimet ku ai shfaqet (faqja kryesore, arkivat, furnizimet). | Edicioni falas |
wp zinn-cache purge url<url>...wp zinn-cache purge url https://example.com/ /pricing/ | Pastro faqet e ruajtura në kujtesën e përkohshme në këto URL. | Edicioni falas |
wp zinn-cache refresh<action>wp zinn-cache refresh status | Nisni, ndaloni ose shfaqni rifreskimin e shkallëzuar (ajo që zëvendëson opsionin "pastro gjithçka" pas një përditësimi). | Edicioni falas |
wp zinn-cache server detectwp zinn-cache server detect | Kontrolloni se cilat fshehtina përgjigjen përpara faqes (nginx, Varnish, Apache, LiteSpeed, Cloudflare). | Edicioni falas |
wp zinn-cache server drainwp zinn-cache server drain | Dërgoni pastrimet e radhës të memories së fshehtë të serverit tani në vend që të prisni për WP-Cron. | Edicioni falas |
wp zinn-cache status[--format=<format>]wp zinn-cache status --format=json | Raportoni gjendjen e skedarit të cache të objektit. | Edicioni falas |
Veprimet dhe filtrat
Çdo "hook" që ofron shtojca, me përshkrimin nga kodi i saj burimor. Filtrat ndryshojnë një vlerë; veprimet ju lejojnë të ekzekutoni kod në një moment të caktuar; pikat e hyrjes janë veprime që i ekzekutoni për t'i kërkuar shtojcës të bëjë diçka.
| Çengel | Lloj | Çfarë bën | Parametrat | Edicioni |
|---|---|---|---|---|
zinn_cache_control_header | Filtro | Filtron vlerën cache-control të dërguar te LiteSpeed për një faqe që mund të ruhet në cache. | string $value, int $ttl | Edicioni falas |
zinn_cache_fs_loaded | Veprim | Aktivizohet sapo të jetë ngarkuar SDK-ja e licencimit, para pjesës tjetër të Zinn® Cache. Lidhuni këtu për të komunikuar me `zinn_cache_fs()`. | asnjë | Edicioni falas |
zinn_cache_link_scan_post_types | Filtro | Llojet e postimeve që përfshin skanimi. | asnjë | Edicioni falas |
zinn_cache_mcp_abilities | Veprim | Aktivizohet pasi Zinn® Cache regjistron aftësitë e veta: Zinn® Cache Pro shton të vetat këtu. | asnjë | Edicioni falas |
zinn_cache_post_change_tags | Filtro | Filtron etiketat e cache-it që pastrohen kur një postim ndryshon. | string[] $tags, int $post_id, string $post_type | Edicioni falas |
zinn_cache_purge_all | Veprim | Pastro gjithçka, nga rreshti i Mjeteve. | asnjë | Edicioni falas |
zinn_cache_purge_hosts | Filtro | Filtorn emrat e host-eve që mund të përcaktojnë pastrimet (për një faqe që shërbehet në më shumë se një domen). | string[] $hosts | Edicioni falas |
zinn_cache_purge_on_seo_change | Filtro | Filtorn nëse një ndryshim i bërë në Zinn® SEO i pastron faqet që ka ndryshuar. | bool $on | Edicioni falas |
zinn_cache_purge_plan | Pika e hyrjes (ju e nisni atë) | Pastro saktësisht atë që emërton një plan: `do_action( 'zinn_cache_purge_plan', array( 'urls' => …, 'tags' => …, 'purge_all' => … ) )`. | asnjë | Edicioni falas |
zinn_cache_purged | Veprim | Aktivizohet pasi shtojca ka nisur pastrimin e cache-it. | array{purge_all:bool,urls:string[],tags:string[]} $plan | Edicioni falas |
zinn_cache_purged_all | Veprim | Aktivizohet pasi është kërkuar një pastrim i plotë i fshehtëzës së faqes. | string $reason | Edicioni falas |
zinn_cache_refresh_armed | Veprim | Aktivizohet kur fillon një rifreskim me ritëm të kontrolluar. | string $reason | Edicioni falas |
zinn_cache_refresh_finished | Veprim | Aktivizohet kur një rifreskim i ritmuar ka arritur në fund të faqes. | int $pages | Edicioni falas |
zinn_cache_refresh_guard | Filtro | Filtorn nëse rifreskimi duhet të ndalojë për këtë minutë (mbrojtja e vetë ngarkesës së hostit). | string $reason | Edicioni falas |
zinn_cache_refresh_urls | Filtro | Filtorn adresat që pastron një grup rifreskimi — shtoni këtu, për shembull, adresat e gjuhëve të tjera të çdo faqeje. | string[] $urls | Edicioni falas |
zinn_cache_refreshed_urls | Veprim | Aktivizohet pasi pastrohet një grup rifreskimi (Zinn® Cache Pro i ringroh këto faqe). | string[] $urls | Edicioni falas |
zinn_cache_request_cacheable | Filtro | Filtri nëse kërkesa aktuale e front-end-it mund të shërbehet nga memorja e fshehtë e faqes. | bool $cacheable | Edicioni falas |
zinn_cache_status_rows | Filtro | Filtra rreshtat e tabelës «Çfarë po e ruan në memorien e fshehtë këtë faqe» të ekranit të statusit. | array<int,array{0:string,1:string}> $rows, array<string,mixed> $report | Edicioni falas |
zinn_cache_ttl | Filtro | Filtron kohëzgjatjen e ruajtjes në memorienCache të faqes aktuale, në sekonda. | int $ttl | Edicioni falas |