Geliştiriciler
Zinn® Cache yetenekleri başvurusu
Zinn® Cache, eylemlerini WordPress Abilities API'ye kaydeder. Aynı yetenekler, sitenin kendi sunucusunda MCP araçları ve /wp-json/wp-abilities/v1 altında REST rotalarıdır. Bu sayfa, eklentinin kendi kayıt defterinden oluşturulmuştur.
Uç Noktalar
HTTP üzerinden MCP (akışlı)
https://example.com/wp-json/zinn-cache/v1/mcpWP-CLI üzerinden MCP (standart girdi ve çıktı)
wp mcp-adapter serve --server=zinn-cache --user=<login>REST: yetenekleri listele
/wp-json/wp-abilities/v1/abilities?category=zinn-cacheREST: bir yeteneği çalıştır
/wp-json/wp-abilities/v1/abilities/<name>/runKimlik doğrulama ve izinler
HTTP istekleri bir WordPress uygulama parolası (HTTP Basic) ile kimlik doğrulaması yapar. MCP sunucusuna bağlanmak aşağıda gösterilen yeteneği gerektirir; her yetki daha sonra her nesne için kendi iznini kontrol eder. Salt okunur yetenekler GET ile ve girdileri sorgu dizesinde çalışır; diğerleri ise POST ve JSON gövdesi {"input": {…}} ile çalışır.
Örnekler
# REST: bir yeteneği çalıştır
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üm yetenekler
Çalışan bir siteden otomatik olarak üretilen eklentinin abilities.json dosyasından oluşturulmuştur; ikisi uyuşmadığında bir test başarısız olur.
| Yetenek | Ne işe yarar | Sürüm | Dinlendir | İzin | Parametreler |
|---|---|---|---|---|---|
zinn-cache/clean-databasezinn-cache-clean-database | Veritabanını temizleyin (Pro) Ayarlarda etkinleştirilen gereksiz öge türlerini arka planda kaldırır. Kaldırılanlar geri getirilemez. | Pro sürüm | POST …/abilities/zinn-cache/clean-database/run | manage_options | hiçbiri |
zinn-cache/convert-imageszinn-cache-convert-images | Mevcut tüm görselleri dönüştürün (Pro) Ortam kitaplığındaki görselleri ayarlarda etkinleştirilen modern biçimlere arka planda dönüştürmeye başlar. | Pro sürüm | POST …/abilities/zinn-cache/convert-images/run | manage_options | hiçbiri |
zinn-cache/detect-cache-layerszinn-cache-detect-cache-layers | Sitenin önündeki önbellekleri tespit edin Ana sayfayı bir ziyaretçi gibi talep eder ve hangi önbelleklerin yanıt verdiğini kaydeder. sample: true ile en yeni sayfaları da iki kez talep eder ve her katmanın bunları kendi önbelleğinden ne sıklıkla sunduğunu sayar. | Ücretsiz sürüm | 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 | Önbellek analizlerini okuyun (Pro) Son saatler (saat cinsinden, 720'ye kadar) için nesne önbelleğinin isabet oranını ve trafiğini, en yavaş komutlarını ve önbelleği en çok hangi eklentilerin kaçırdığını döndürür. | Pro sürüm | GET …/abilities/zinn-cache/get-cache-analytics/run | manage_options | hours: integer |
zinn-cache/get-cache-layerszinn-cache-get-cache-layers | Siteyi neyin önbelleğe aldığını okuyun Hangi önbelleğin sayfaları sunduğunu (LiteSpeed, nginx, Varnish, Apache, Cloudflare veya eklentinin disk önbelleği), son algılamanın ne gördüğünü, WordPress tarafından okunabilen her bir katmanın boyutunu, temizleme kuyruğunu, hız ayarlı yenilemeyi ve son temizlemeleri döndürür. | Ücretsiz sürüm | GET …/abilities/zinn-cache/get-cache-layers/run | manage_options (the REST route's own check) | hiçbiri |
zinn-cache/get-diagnosticszinn-cache-get-diagnostics | Tanılama raporunu okuyun Desteğin talep ettiği tanılama raporunu döndürür: sürümler, sunucu sınırları, önbellek durumu ve son hatalar. Hiçbir parola veya anahtar içermez. | Ücretsiz sürüm | GET …/abilities/zinn-cache/get-diagnostics/run | manage_options | hiçbiri |
zinn-cache/get-image-progresszinn-cache-get-image-progress | Görsel dönüştürme ilerlemesini okuyun (Pro) Görselleri dönüştürme (veya kaldırma) işleminin ne kadar ilerlediğini döndürür. | Pro sürüm | GET …/abilities/zinn-cache/get-image-progress/run | manage_options | hiçbiri |
zinn-cache/get-pro-settingszinn-cache-get-pro-settings | Cache Pro ayarlarını okuyun (Pro) Her Cache Pro ayarını (ön ısıtma, görseller, betikler ve stiller, veritabanı temizliği, akıllı temizleme, bulucu) döndürür. Gizli anahtarlar asla döndürülmez. | Pro sürüm | GET …/abilities/zinn-cache/get-pro-settings/run | manage_options | hiçbiri |
zinn-cache/get-settingszinn-cache-get-settings | Önbellek ayarlarını okuyun Tüm önbellek ayarlarını döndürür. Redis parolası ve Cloudflare belirteci asla döndürülmez, yalnızca birinin kaydedilip kaydedilmediği döndürülür. | Ücretsiz sürüm | GET …/abilities/zinn-cache/get-settings/run | manage_options | hiçbiri |
zinn-cache/get-slow-querieszinn-cache-get-slow-queries | Yavaş sorgu bulucuyu okuyun (Pro) Bulucunun algıladığı en yavaş veritabanı sorgularını ve giden çağrıları, her birini gerçekleştiren eklenti veya tema ile birlikte döndürür. | Pro sürüm | GET …/abilities/zinn-cache/get-slow-queries/run | manage_options | hiçbiri |
zinn-cache/get-statuszinn-cache-get-status | Önbellek durumunu oku Sayfa önbelleğinin ve nesne önbelleğinin açık ve çalışır durumda olup olmadığını, kaç sayfanın önbelleğe alındığını ve nesne önbelleğinin bağlantı ile isabet sayılarını döndürür. | Ücretsiz sürüm | GET …/abilities/zinn-cache/get-status/run | manage_options | hiçbiri |
zinn-cache/get-warmup-progresszinn-cache-get-warmup-progress | Isınma ilerlemesini okuyun (Pro) Isınmanın çalışıp çalışmadığını, kaç sayfayı ziyaret ettiğini ve kaçının başarısız olduğunu döndürür. | Pro sürüm | GET …/abilities/zinn-cache/get-warmup-progress/run | manage_options | hiçbiri |
zinn-cache/preview-database-cleanupzinn-cache-preview-database-cleanup | Veritabanı temizliğini önizleyin (Pro) Bir temizliğin neyi kaldıracağını türe göre sayar (revizyonlar, taslaklar, istenmeyenler, süresi dolmuş geçici veriler ve benzerleri). Hiçbir şey kaldırılmaz. | Pro sürüm | GET …/abilities/zinn-cache/preview-database-cleanup/run | manage_options | hiçbiri |
zinn-cache/purgezinn-cache-purge | Önbelleği temizle Önbelleğe alınmış sayfaları siler: tümü (all: true), bazı adresler (urls) veya etiketlenmiş her şey (tags). Sayfalar, ziyaretçiler geldikçe yeniden oluşturulur. | Ücretsiz sürüm | 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 | Her önbellek katmanındaki bazı adresleri temizleyin Bu adresleri (/about/ gibi yollar veya bu sitedeki tam adresler) disk önbelleğinden, sunucu önbelleğinden ve Cloudflare üzerinden aynı anda kaldırır ve her katmanın ne yanıt verdiğini belirtir. | Ücretsiz sürüm | POST …/abilities/zinn-cache/purge-urls/run | manage_options (the REST route's own check) | urls: array (zorunlu) |
zinn-cache/refresh-cachezinn-cache-refresh-cache | Aşamalı yenilemeyi başlatın veya durdurun action: start her sayfayı dakikada bir grup halinde yeniler (güncellemelerin önbelleği boşaltmak yerine yaptığı işlem); action: stop devam eden yenilemeyi sonlandırır. | Ücretsiz sürüm | POST …/abilities/zinn-cache/refresh-cache/run | manage_options (the REST route's own check) | action: start|stop (zorunlu) |
zinn-cache/remove-converted-imageszinn-cache-remove-converted-images | Dönüştürülen tüm görselleri kaldırın (Pro) Görüntülerin dönüştürülmüş her bir kopyasını arka planda siler; orijinaller kalır. | Pro sürüm | POST …/abilities/zinn-cache/remove-converted-images/run | manage_options | hiçbiri |
zinn-cache/reset-settingszinn-cache-reset-settings | Önbellek ayarlarını varsayılanlarına döndürün Sıfırla düğmesinin yaptığı gibi, her önbellek ayarını varsayılanına geri döndürür. Kaydedilen Redis parolası da kaldırılır. | Ücretsiz sürüm | POST …/abilities/zinn-cache/reset-settings/run | manage_options | hiçbiri |
zinn-cache/reset-slow-querieszinn-cache-reset-slow-queries | Yavaş sorgu bulgularını temizleyin (Pro) Şimdiye kadar bulunan her yavaş sorguyu ve yavaş çağrıyı unutur ve bulucu yeniden başlar. | Pro sürüm | POST …/abilities/zinn-cache/reset-slow-queries/run | manage_options | hiçbiri |
zinn-cache/update-pro-settingszinn-cache-update-pro-settings | Cache Pro ayarlarını değiştirin (Pro) Gönderdiğiniz Cache Pro ayarlarını değiştirir (ayarlar: anahtardan değere) ve geri kalanını korur. Her değer tam olarak Cache Pro ekranındaki gibi denetlenir; bilinmeyen bir anahtar reddedilir. | Pro sürüm | POST …/abilities/zinn-cache/update-pro-settings/run | manage_options | settings: object (zorunlu) |
zinn-cache/update-settingszinn-cache-update-settings | Önbellek ayarlarını değiştirin Gönderdiğiniz ayarları değiştirir ve kalanları korur (sayfa önbelleği, sayfaların ne kadar süre önbellekte kalacağı, nesne önbelleği ve Redis bağlantısı, temizleme kuralları ve hariç tutulanlar). Değerler, tam olarak Önbellek ekranında olduğu gibi kontrol edilir ve düzeltilir. | Ücretsiz sürüm | 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 | Önbelleği ısıtın (Pro) Ziyaretçilerin önbelleğe alınmış sayfaları alabilmesi için arka planda site haritalarındaki her sayfayı ziyaret etmeye başlar. Çalışırken ilerleme durumu ayrı olarak bildirilir. | Pro sürüm | POST …/abilities/zinn-cache/warm-cache/run | manage_options | hiçbiri |
WP-CLI komutları
Bunları sunucuda WP-CLI ile çalıştırın. Her komut, eklentinin ekranlarıyla aynı izinleri kontrol eder; örnekler eklentinin kendi yardım metninden alınmıştır.
| Komut | Ne işe yarar | Sürüm |
|---|---|---|
wp zinn-cache purge allwp zinn-cache purge all | Önbelleğe alınan her sayfayı temizleyin. | Ücretsiz sürüm |
wp zinn-cache purge post<id>...wp zinn-cache purge post 42 | Bir yazının sayfalarını ve göründüğü listeleri (ana sayfa, arşivler, beslemeler) temizleyin. | Ücretsiz sürüm |
wp zinn-cache purge url<url>...wp zinn-cache purge url https://example.com/ /pricing/ | Bu URL'lerdeki önbelleğe alınmış sayfaları temizleyin. | Ücretsiz sürüm |
wp zinn-cache refresh<action>wp zinn-cache refresh status | Aşamalı yenilemeyi başlatın, durdurun veya gösterin (güncelleme sonrasında "her şeyi temizle" seçeneğinin yerini alan özellik). | Ücretsiz sürüm |
wp zinn-cache server detectwp zinn-cache server detect | Sitenin önünde hangi önbelleklerin yanıt verdiğini kontrol edin (nginx, Varnish, Apache, LiteSpeed, Cloudflare). | Ücretsiz sürüm |
wp zinn-cache server drainwp zinn-cache server drain | WP-Cron'u beklemek yerine kuyruktaki sunucu önbelleği temizlemelerini şimdi gönderin. | Ücretsiz sürüm |
wp zinn-cache status[--format=<format>]wp zinn-cache status --format=json | Nesne önbelleğinin durumunu raporla. | Ücretsiz sürüm |
İşlemler ve filtreler
Eklentinin sunduğu her kanca, kaynak kodundaki açıklamasıyla birlikte. Filtreler bir değeri değiştirir; eylemler bir anda kod çalıştırmanızı sağlar; giriş noktaları ise eklentiden bir şey yapmasını istemek için tetiklediğiniz eylemlerdir.
| Kanca | Tür | Ne işe yarar | Parametreler | Sürüm |
|---|---|---|---|---|
zinn_cache_control_header | Filtrele | Önbelleğe alınabilir bir sayfa için LiteSpeed'e gönderilen cache-control değerini filtreler. | string $value, int $ttl | Ücretsiz sürüm |
zinn_cache_fs_loaded | İşlem | Lisanslama SDK'sı yüklendiğinde, Zinn® Cache'in geri kalanından önce tetiklenir. `zinn_cache_fs()` ile iletişim kurmak için burada kanca kullanın. | hiçbiri | Ücretsiz sürüm |
zinn_cache_link_scan_post_types | Filtrele | Taramanın kapsadığı gönderi türleri. | hiçbiri | Ücretsiz sürüm |
zinn_cache_mcp_abilities | İşlem | Zinn® Cache yeteneklerini kaydettikten sonra çalışır: Zinn® Cache Pro buraya kendi özelliklerini ekler. | hiçbiri | Ücretsiz sürüm |
zinn_cache_post_change_tags | Filtrele | Bir gönderi değiştiğinde temizlenen önbellek etiketlerini filtreler. | string[] $tags, int $post_id, string $post_type | Ücretsiz sürüm |
zinn_cache_purge_all | İşlem | Araçlar satırından her şeyi temizleyin. | hiçbiri | Ücretsiz sürüm |
zinn_cache_purge_hosts | Filtrele | Temizlemelerin belirtebileceği ana bilgisayar adlarını filtreler (birden fazla alana sunulan bir site için). | string[] $hosts | Ücretsiz sürüm |
zinn_cache_purge_on_seo_change | Filtrele | Zinn® SEO içinde yapılan bir değişikliğin, değiştirdiği sayfaları temizleyip temizlemeyeceğini filtreler. | bool $on | Ücretsiz sürüm |
zinn_cache_purge_plan | Giriş noktası (tetiklediğiniz) | Bir planın adlandırdığı şeyi tam olarak temizleyin: `do_action( 'zinn_cache_purge_plan', array( 'urls' => …, 'tags' => …, 'purge_all' => … ) )`. | hiçbiri | Ücretsiz sürüm |
zinn_cache_purged | İşlem | Eklenti bir önbellek temizleme işlemi gerçekleştirdikten sonra tetiklenir. | array{purge_all:bool,urls:string[],tags:string[]} $plan | Ücretsiz sürüm |
zinn_cache_purged_all | İşlem | Sayfa önbelleğinin tamamen temizlenmesi istendiğinde tetiklenir. | string $reason | Ücretsiz sürüm |
zinn_cache_refresh_armed | İşlem | Aralıklı bir yenileme başladığında tetiklenir. | string $reason | Ücretsiz sürüm |
zinn_cache_refresh_finished | İşlem | Hızı ayarlanmış bir yenileme sitenin sonuna ulaştığında tetiklenir. | int $pages | Ücretsiz sürüm |
zinn_cache_refresh_guard | Filtrele | Yenilemenin bu dakika duraklatılması gerekip gerekmediğini filtreler (barındırıcının kendi yük koruması). | string $reason | Ücretsiz sürüm |
zinn_cache_refresh_urls | Filtrele | Bir yenileme grubunun temizlediği adresleri filtreler — örneğin, her sayfanın diğer dillerdeki adreslerini buraya ekleyin. | string[] $urls | Ücretsiz sürüm |
zinn_cache_refreshed_urls | İşlem | Yenileme grubu temizlendikten sonra tetiklenir (Zinn® Cache Pro bu sayfaları yeniden ısıtır). | string[] $urls | Ücretsiz sürüm |
zinn_cache_request_cacheable | Filtrele | Geçerli ön uç isteğinin sayfa önbelleğinden sunulup sunulamayacağını filtreler. | bool $cacheable | Ücretsiz sürüm |
zinn_cache_status_rows | Filtrele | Durum ekranının «Bu siteyi ne önbelleğe alıyor» tablosunun satırlarını filtreler. | array<int,array{0:string,1:string}> $rows, array<string,mixed> $report | Ücretsiz sürüm |
zinn_cache_ttl | Filtrele | Geçerli sayfanın kaç saniye boyunca önbelleğe alınacağını filtreler. | int $ttl | Ücretsiz sürüm |