Pengembang
Referensi kemampuan Zinn® Cache
Zinn® Cache mendaftarkan aksinya ke WordPress Abilities API. Kemampuan yang sama adalah alat MCP pada server situs itu sendiri dan rute REST di bawah /wp-json/wp-abilities/v1. Halaman ini dihasilkan dari registri plugin itu sendiri.
Titik Akhir
MCP melalui HTTP (dapat dialirkan)
https://example.com/wp-json/zinn-cache/v1/mcpMCP melalui WP-CLI (masukan dan keluaran standar)
wp mcp-adapter serve --server=zinn-cache --user=<login>REST: daftar kemampuan
/wp-json/wp-abilities/v1/abilities?category=zinn-cacheJALANKAN: jalankan kemampuan
/wp-json/wp-abilities/v1/abilities/<name>/runOtentikasi dan izin
Permintaan HTTP diautentikasi dengan kata sandi aplikasi WordPress (HTTP Basic). Menghubungkan ke server MCP memerlukan kemampuan yang ditunjukkan di bawah ini; setiap kemampuan kemudian memeriksa izinnya sendiri, per objek. Kemampuan hanya-baca berjalan dengan GET dan inputnya di string kueri; kemampuan lainnya dengan POST dan isi JSON {"input": {…}}.
Contoh
# JALANKAN: jalankan kemampuan
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":{}}}Semua kemampuan
Dibuat dari abilities.json milik plugin, yang sendiri dibuat dari situs yang sedang berjalan; pengujian gagal ketika keduanya tidak cocok.
| Kemampuan | Fungsinya | Edisi | REST | Izin | Parameter |
|---|---|---|---|---|---|
zinn-cache/clean-databasezinn-cache-clean-database | Bersihkan basis data (Pro) Menghapus jenis kekacauan yang diaktifkan di pengaturan di latar belakang. Apa yang dihapus tidak dapat dikembalikan. | Edisi Pro | POST …/abilities/zinn-cache/clean-database/run | manage_options | tidak ada |
zinn-cache/convert-imageszinn-cache-convert-images | Konversikan semua gambar yang ada (Pro) Mulai mengonversi gambar pustaka media ke format modern yang diaktifkan di pengaturan, di latar belakang. | Edisi Pro | POST …/abilities/zinn-cache/convert-images/run | manage_options | tidak ada |
zinn-cache/detect-cache-layerszinn-cache-detect-cache-layers | Deteksi cache di depan situs Meminta halaman beranda sebagaimana yang dilakukan pengunjung dan menyimpan cache mana yang merespons. Dengan sample: true, ini juga meminta halaman-halaman terbaru sebanyak dua kali dan menghitung seberapa sering setiap lapisan menyajikannya dari cache-nya. | Edisi gratis | 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 | Baca analitik cache (Pro) Mengembalikan hit rate dan lalu lintas tembolok objek selama beberapa jam terakhir (jam, hingga 720), perintah terlambatnya, serta plugin mana yang paling sering mengalami cache miss. | Edisi Pro | GET …/abilities/zinn-cache/get-cache-analytics/run | manage_options | hours: integer |
zinn-cache/get-cache-layerszinn-cache-get-cache-layers | Baca apa yang menyimpan cache situs Mengembalikan cache mana yang menyajikan halaman (LiteSpeed, nginx, Varnish, Apache, Cloudflare, atau cache disk plugin), apa yang ditemukan pada deteksi terakhir, ukuran setiap lapisan jika WordPress dapat membacanya, antrean pembersihan, penyegaran bertahap, dan pembersihan terkini. | Edisi gratis | GET …/abilities/zinn-cache/get-cache-layers/run | manage_options (the REST route's own check) | tidak ada |
zinn-cache/get-diagnosticszinn-cache-get-diagnostics | Baca laporan diagnostik Mengembalikan laporan diagnostik yang diminta dukungan: versi, batas server, status cache, dan kesalahan terkini. Laporan ini tidak memuat kata sandi atau kunci apa pun. | Edisi gratis | GET …/abilities/zinn-cache/get-diagnostics/run | manage_options | tidak ada |
zinn-cache/get-image-progresszinn-cache-get-image-progress | Baca progres konversi gambar (Pro) Mengembalikan sejauh mana proses pengonversian (atau penghapusan) gambar telah berjalan. | Edisi Pro | GET …/abilities/zinn-cache/get-image-progress/run | manage_options | tidak ada |
zinn-cache/get-pro-settingszinn-cache-get-pro-settings | Baca pengaturan Cache Pro (Pro) Mengembalikan setiap pengaturan Cache Pro (pemanasan, gambar, skrip dan gaya, pembersihan basis data, pembersihan cerdas, pencari). Rahasia tidak pernah dikembalikan. | Edisi Pro | GET …/abilities/zinn-cache/get-pro-settings/run | manage_options | tidak ada |
zinn-cache/get-settingszinn-cache-get-settings | Baca pengaturan cache Mengembalikan setiap pengaturan singgahan. Kata sandi Redis dan token Cloudflare tidak pernah dikembalikan, hanya informasi apakah ada yang tersimpan. | Edisi gratis | GET …/abilities/zinn-cache/get-settings/run | manage_options | tidak ada |
zinn-cache/get-slow-querieszinn-cache-get-slow-queries | Baca pencari kueri lambat (Pro) Mengembalikan kueri basis data dan panggilan keluar paling lambat yang ditemukan oleh pencari, beserta plugin atau tema yang memicunya. | Edisi Pro | GET …/abilities/zinn-cache/get-slow-queries/run | manage_options | tidak ada |
zinn-cache/get-statuszinn-cache-get-status | Baca status cache Mengembalikan informasi apakah cache halaman dan cache objek aktif dan berfungsi, berapa banyak halaman yang di-cache, serta jumlah koneksi dan hit cache objek. | Edisi gratis | GET …/abilities/zinn-cache/get-status/run | manage_options | tidak ada |
zinn-cache/get-warmup-progresszinn-cache-get-warmup-progress | Baca progres pemanasan (Pro) Mengembalikan informasi apakah pemanasan sedang berjalan, berapa banyak halaman yang telah dikunjungi, dan berapa banyak yang gagal. | Edisi Pro | GET …/abilities/zinn-cache/get-warmup-progress/run | manage_options | tidak ada |
zinn-cache/preview-database-cleanupzinn-cache-preview-database-cleanup | Pratinjau pembersihan basis data (Pro) Menghitung apa saja yang akan dihapus oleh pembersihan, berdasarkan jenis (revisi, draf, spam, data sementara yang kedaluwarsa, dan sejenisnya). Tidak ada yang dihapus. | Edisi Pro | GET …/abilities/zinn-cache/preview-database-cleanup/run | manage_options | tidak ada |
zinn-cache/purgezinn-cache-purge | Bersihkan singgahan Membuang halaman yang di-cache: semua (all: true), beberapa alamat (urls), atau semua yang diberi tag (tags). Halaman dibuat ulang saat pengunjung tiba. | Edisi gratis | 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 | Bersihkan beberapa alamat di setiap lapisan cache Menghapus alamat-alamat ini (jalur seperti /about/ atau alamat lengkap di situs ini) sekaligus dari cache disk, cache server, dan Cloudflare, serta memberi tahu apa yang dijawab oleh setiap lapisan. | Edisi gratis | POST …/abilities/zinn-cache/purge-urls/run | manage_options (the REST route's own check) | urls: array (wajib) |
zinn-cache/refresh-cachezinn-cache-refresh-cache | Mulai atau hentikan penyegaran bertahap action: start memperbarui setiap halaman satu kelompok per menit (apa yang dilakukan pembaruan alih-alih mengosongkan cache); action: stop menghentikan pembaruan yang sedang berjalan. | Edisi gratis | POST …/abilities/zinn-cache/refresh-cache/run | manage_options (the REST route's own check) | action: start|stop (wajib) |
zinn-cache/remove-converted-imageszinn-cache-remove-converted-images | Hapus semua gambar yang dikonversi (Pro) Menghapus setiap salinan gambar yang dikonversi di latar belakang; gambar asli tetap ada. | Edisi Pro | POST …/abilities/zinn-cache/remove-converted-images/run | manage_options | tidak ada |
zinn-cache/reset-settingszinn-cache-reset-settings | Kembalikan pengaturan cache ke default-nya Mengembalikan setiap pengaturan singgahan ke bawaannya, seperti yang dilakukan tombol Atur Ulang. Kata sandi Redis yang tersimpan juga dihapus. | Edisi gratis | POST …/abilities/zinn-cache/reset-settings/run | manage_options | tidak ada |
zinn-cache/reset-slow-querieszinn-cache-reset-slow-queries | Hapus temuan kueri lambat (Pro) Melupakan setiap kueri lambat dan panggilan lambat yang ditemukan sejauh ini, dan pencari dimulai kembali. | Edisi Pro | POST …/abilities/zinn-cache/reset-slow-queries/run | manage_options | tidak ada |
zinn-cache/update-pro-settingszinn-cache-update-pro-settings | Ubah pengaturan Cache Pro (Pro) Mengubah pengaturan Cache Pro yang Anda kirimkan (pengaturan: kunci ke nilai) dan mempertahankan sisanya. Setiap nilai diperiksa persis seperti pada layar Cache Pro; kunci yang tidak dikenal akan ditolak. | Edisi Pro | POST …/abilities/zinn-cache/update-pro-settings/run | manage_options | settings: object (wajib) |
zinn-cache/update-settingszinn-cache-update-settings | Ubah pengaturan cache Mengubah pengaturan yang Anda kirimkan dan mempertahankan sisanya (cache halaman, berapa lama halaman tetap di-cache, cache objek dan koneksi Redis-nya, aturan pembersihan, dan pengecualian). Nilai diperiksa dan diperbaiki persis seperti pada layar Cache. | Edisi gratis | 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 | Hangatkan cache (Pro) Mulai mengunjungi setiap halaman di peta situs di latar belakang, sehingga pengunjung mendapatkan halaman yang di-cache. Kemajuannya dilaporkan secara terpisah saat dijalankan. | Edisi Pro | POST …/abilities/zinn-cache/warm-cache/run | manage_options | tidak ada |
Perintah WP-CLI
Jalankan perintah ini di server menggunakan WP-CLI. Setiap perintah memeriksa izin yang sama dengan layar plugin; contohnya diambil dari teks bantuan plugin itu sendiri.
| Perintah | Fungsinya | Edisi |
|---|---|---|
wp zinn-cache purge allwp zinn-cache purge all | Bersihkan setiap halaman yang di-cache. | Edisi gratis |
wp zinn-cache purge post<id>...wp zinn-cache purge post 42 | Bersihkan halaman pos dan daftar tempat ia muncul (halaman beranda, arsip, umpan). | Edisi gratis |
wp zinn-cache purge url<url>...wp zinn-cache purge url https://example.com/ /pricing/ | Bersihkan halaman yang di-cache di URL ini. | Edisi gratis |
wp zinn-cache refresh<action>wp zinn-cache refresh status | Mulai, hentikan, atau tampilkan penyegaran bertahap (yang menggantikan "bersihkan semua" setelah pembaruan). | Edisi gratis |
wp zinn-cache server detectwp zinn-cache server detect | Periksa cache mana yang merespons di depan situs (nginx, Varnish, Apache, LiteSpeed, Cloudflare). | Edisi gratis |
wp zinn-cache server drainwp zinn-cache server drain | Kirim pembersihan cache server yang diantrekan sekarang alih-alih menunggu WP-Cron. | Edisi gratis |
wp zinn-cache status[--format=<format>]wp zinn-cache status --format=json | Laporkan status singgahan objek. | Edisi gratis |
Tindakan dan filter
Setiap hook yang disediakan oleh plugin, beserta deskripsi dari kode sumbernya. Filter mengubah suatu nilai; aksi memungkinkan Anda menjalankan kode pada suatu momen tertentu; titik masuk adalah aksi yang Anda jalankan untuk meminta plugin melakukan sesuatu.
| Hook | Jenis | Fungsinya | Parameter | Edisi |
|---|---|---|---|---|
zinn_cache_control_header | Filter | Menyaring nilai cache-control yang dikirim ke LiteSpeed untuk halaman yang dapat di-cache. | string $value, int $ttl | Edisi gratis |
zinn_cache_fs_loaded | Tindakan | Dipicu setelah SDK perizinan dimuat, sebelum bagian lain dari Zinn® Cache. Kaitkan di sini untuk berinteraksi dengan `zinn_cache_fs()`. | tidak ada | Edisi gratis |
zinn_cache_link_scan_post_types | Filter | Jenis postingan yang dicakup oleh pemindaian. | tidak ada | Edisi gratis |
zinn_cache_mcp_abilities | Tindakan | Dipicu setelah Zinn® Cache mendaftarkan kemampuannya: Zinn® Cache Pro menambahkan kemampuannya sendiri di sini. | tidak ada | Edisi gratis |
zinn_cache_post_change_tags | Filter | Menyaring tag singgahan yang dihapus saat sebuah pos berubah. | string[] $tags, int $post_id, string $post_type | Edisi gratis |
zinn_cache_purge_all | Tindakan | Bersihkan semuanya, dari baris Alat. | tidak ada | Edisi gratis |
zinn_cache_purge_hosts | Filter | Memfilter nama host yang mungkin disebutkan oleh pembersihan (untuk situs yang disajikan di lebih dari satu domain). | string[] $hosts | Edisi gratis |
zinn_cache_purge_on_seo_change | Filter | Memfilter apakah perubahan yang dibuat di Zinn® SEO membersihkan halaman yang diubahnya. | bool $on | Edisi gratis |
zinn_cache_purge_plan | Titik masuk (Anda yang memicunya) | Bersihkan persis seperti yang dinamai paket: `do_action( 'zinn_cache_purge_plan', array( 'urls' => …, 'tags' => …, 'purge_all' => … ) )`. | tidak ada | Edisi gratis |
zinn_cache_purged | Tindakan | Dicuci setelah plugin mengirimkan pembersihan cache. | array{purge_all:bool,urls:string[],tags:string[]} $plan | Edisi gratis |
zinn_cache_purged_all | Tindakan | Berjalan setelah pembersihan penuh tembolok halaman diminta. | string $reason | Edisi gratis |
zinn_cache_refresh_armed | Tindakan | Dipicu saat pembaruan berkala dimulai. | string $reason | Edisi gratis |
zinn_cache_refresh_finished | Tindakan | Dipicu ketika penyegaran bertahap telah mencapai akhir situs. | int $pages | Edisi gratis |
zinn_cache_refresh_guard | Filter | Memfilter apakah pembaruan harus dijeda menit ini (pelindung beban milik host). | string $reason | Edisi gratis |
zinn_cache_refresh_urls | Filter | Memfilter alamat yang dibersihkan oleh batch penyegaran — tambahkan alamat bahasa lain untuk setiap halaman di sini, misalnya. | string[] $urls | Edisi gratis |
zinn_cache_refreshed_urls | Tindakan | Dijalankan setelah tumpukan penyegaran dibersihkan (Zinn® Cache Pro memanaskan kembali halaman-halaman ini). | string[] $urls | Edisi gratis |
zinn_cache_request_cacheable | Filter | Menyaring apakah permintaan front-end saat ini dapat dilayani dari tembolok halaman. | bool $cacheable | Edisi gratis |
zinn_cache_status_rows | Filter | Memfilter baris pada tabel «Apa yang meng-cache situs ini» di layar status. | array<int,array{0:string,1:string}> $rows, array<string,mixed> $report | Edisi gratis |
zinn_cache_ttl | Filter | Menyaring berapa lama halaman saat ini dicache, dalam detik. | int $ttl | Edisi gratis |