डेवलपर्स
Zinn® Cache क्षमता संदर्भ
Zinn® Cache अपने कार्यों को WordPress Abilities API के साथ पंजीकृत करता है। वही क्षमताएं साइट के अपने सर्वर पर MCP टूल और /wp-json/wp-abilities/v1 के अंतर्गत REST रूट हैं। यह पृष्ठ प्लगइन की अपनी रजिस्ट्री से जनरेट किया गया है।
एंडपॉइंट्स
HTTP पर MCP (स्ट्रीम करने योग्य)
https://example.com/wp-json/zinn-cache/v1/mcpWP-CLI पर MCP (स्टैंडर्ड इनपुट और आउटपुट)
wp mcp-adapter serve --server=zinn-cache --user=<login>REST: क्षमताen सूचीबद् करें
/wp-json/wp-abilities/v1/abilities?category=zinn-cacheREST: एक एबिलिटी चलाएँ
/wp-json/wp-abilities/v1/abilities/<name>/runप्रमाणन और अनुमतियाँ
HTTP अनुरोध एक WordPress एप्लिकेशन पासवर्ड (HTTP Basic) के साथ प्रमाणित होते हैं। MCP सर्वर से कनेक्ट करने के लिए नीचे दिखाई गई क्षमता की आवश्यकता होती है; फिर प्रत्येक क्षमता प्रति ऑब्जेक्ट अपनी स्वयं की अनुमति की जाँच करती है। केवल-पढ़ने वाली क्षमताएँ (Read-only) GET के साथ और उनका इनपुट क्वेरी स्ट्रिंग में चलता है; अन्य POST और JSON बॉडी {"input": {…}} के साथ चलती हैं।
उदाहरण
# REST: एक एबिलिटी चलाएँ
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":{}}}सभी क्षमताएँ
प्लगइन की abilities.json से जेनरेट किया गया, जो खुद एक रनिंग साइट से जेनरेट होती है; दोनों के मेल न खाने पर एक टेस्ट असफल हो जाता है।
| क्षमता | यह क्या करता है | संस्मरण | शेष | अनुमति | पैरामीटर |
|---|---|---|---|---|---|
zinn-cache/clean-databasezinn-cache-clean-database | डेटाबेस साफ़ करें (Pro) सेटिंग्स में चालू किए गए अव्यवस्था के प्रकारों को पृष्ठभूमि में हटाता है। जो हटा दिया गया है उसे वापस नहीं लाया जा सकता। | प्रो एडिशन | POST …/abilities/zinn-cache/clean-database/run | manage_options | कोई नहीं |
zinn-cache/convert-imageszinn-cache-convert-images | सभी मौजूदा छवियों को रूपांतरित करें (Pro) मीडिया लाइब्रेरी की छवियों को सेटिंग्स में सक्षम किए गए आधुनिक प्रारूपों में बैकग्राउंड में परिवर्तित करना शुरू करता है। | प्रो एडिशन | POST …/abilities/zinn-cache/convert-images/run | manage_options | कोई नहीं |
zinn-cache/detect-cache-layerszinn-cache-detect-cache-layers | साइट के आगे मौजूद कैश का पता लगाएं होम पेज के लिए वैसे ही अनुरोध करता है जैसे कोई विज़िटर करता है और यह सहेजता है कि किन कैश ने उत्तर दिया। sample: true के साथ यह सबसे नए पृष्ठों के लिए भी दो बार अनुरोध करता है और गिनता है कि प्रत्येक लेयर ने उन्हें अपने कैश से कितनी बार प्रस्तुत किया। | फ्री संस्करण | 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 | कैश एनालिटिक्स पढ़ें (Pro) पिछले कुछ घंटों (घंटे, 720 तक) के लिए ऑब्जेक्ट कैश की हिट दर और ट्रैफ़िक, इसके सबसे धीमे कमांड, और कौन से प्लगइन्स कैश को सबसे अधिक मिस करते हैं, यह लौटाता है। | प्रो एडिशन | GET …/abilities/zinn-cache/get-cache-analytics/run | manage_options | hours: integer |
zinn-cache/get-cache-layerszinn-cache-get-cache-layers | पढ़ें कि साइट को क्या कैश कर रहा है यह लौटाता है कि कौन सा कैश पृष्ठ प्रस्तुत करता है (LiteSpeed, nginx, Varnish, Apache, Cloudflare या प्लगइन का डिस्क कैश), अंतिम पहचान में क्या मिला, WordPress जहां इसे पढ़ सकता है वहां प्रत्येक परत का आकार, पर्ज कतार, गतिबद्ध रीफ़्रेश और हाल के पर्ज। | फ्री संस्करण | GET …/abilities/zinn-cache/get-cache-layers/run | manage_options (the REST route's own check) | कोई नहीं |
zinn-cache/get-diagnosticszinn-cache-get-diagnostics | डायग्नोस्टिक्स रिपोर्ट पढ़ें सपोर्ट द्वारा अनुरोधित डायग्नोस्टिक्स रिपोर्ट लौटाता है: संस्करण, सर्वर सीमाएं, कैश स्थिति और हालिया त्रुटियां। इसमें कोई पासवर्ड या कुंजी शामिल नहीं होती है। | फ्री संस्करण | GET …/abilities/zinn-cache/get-diagnostics/run | manage_options | कोई नहीं |
zinn-cache/get-image-progresszinn-cache-get-image-progress | छवि रूपांतरण की प्रगति पढ़ें (Pro) यह लौटाता है कि छवियों को बदलने (या हटाने) की प्रक्रिया कितनी आगे बढ़ी है। | प्रो एडिशन | GET …/abilities/zinn-cache/get-image-progress/run | manage_options | कोई नहीं |
zinn-cache/get-pro-settingszinn-cache-get-pro-settings | Cache Pro सेटिंग्स पढ़ें (Pro) प्रत्येक Cache Pro सेटिंग (वार्म-अप, चित्र, स्क्रिप्ट और शैलियाँ, डेटाबेस सफाई, स्मार्ट पर्जिंग, खोजकर्ता) लौटाता है। गोपनीय विवरण कभी नहीं लौटाए जाते हैं। | प्रो एडिशन | GET …/abilities/zinn-cache/get-pro-settings/run | manage_options | कोई नहीं |
zinn-cache/get-settingszinn-cache-get-settings | कैश सेटिंग्स पढ़ें कैश की हर सेटिंग लौटाता है। Redis पासवर्ड और Cloudflare टोकन कभी नहीं लौटाए जाते, केवल यह लौटाया जाता है कि कोई सहेजा गया है या नहीं। | फ्री संस्करण | GET …/abilities/zinn-cache/get-settings/run | manage_options | कोई नहीं |
zinn-cache/get-slow-querieszinn-cache-get-slow-queries | धीमी क्वेरी खोजक पढ़ें (Pro) खोजक द्वारा देखे गए सबसे धीमे डेटाबेस प्रश्न (क्वेरीज़) और आउटगोइंग कॉल लौटाता है, साथ ही उस प्लगइन या थीम की जानकारी भी देता है जिसने प्रत्येक को निष्पादित किया है। | प्रो एडिशन | GET …/abilities/zinn-cache/get-slow-queries/run | manage_options | कोई नहीं |
zinn-cache/get-statuszinn-cache-get-status | कैश स्थिति पढ़ें यह जानकारी देता है कि पेज कैश और ऑब्जेक्ट कैश चालू हैं और काम कर रहे हैं या नहीं, कितने पेज कैश किए गए हैं, तथा ऑब्जेक्ट कैश के कनेक्शन और हिट की संख्या क्या है। | फ्री संस्करण | GET …/abilities/zinn-cache/get-status/run | manage_options | कोई नहीं |
zinn-cache/get-warmup-progresszinn-cache-get-warmup-progress | वार्म-अप प्रगति पढ़ें (Pro) यह बताता है कि वॉर्म-अप चल रहा है या नहीं, इसने कितने पृष्ठों का दौरा किया है और कितने विफल रहे हैं। | प्रो एडिशन | GET …/abilities/zinn-cache/get-warmup-progress/run | manage_options | कोई नहीं |
zinn-cache/preview-database-cleanupzinn-cache-preview-database-cleanup | डेटाबेस की सफ़ाई का पूर्वावलोकन करें (Pro) यह प्रकार के अनुसार गिनता है कि सफ़ाई से क्या हटेगा (संशोधन, ड्राफ्ट, स्पैम, समाप्त हो चुका अस्थायी डेटा और इसी तरह के अन्य)। कुछ भी हटाया नहीं जाता है। | प्रो एडिशन | GET …/abilities/zinn-cache/preview-database-cleanup/run | manage_options | कोई नहीं |
zinn-cache/purgezinn-cache-purge | कैश साफ़ करें कैश किए गए पृष्ठों को हटाता है: सब कुछ (all: true), कुछ पते (urls) या टैग की गई हर चीज़ (tags)। विज़िटर्स के आने पर पृष्ठ फिर से बनाए जाते हैं। | फ्री संस्करण | 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 | प्रत्येक कैश लेयर पर कुछ पते साफ़ करें इन पतों (जैसे /about/ जैसे पाथ या इस साइट पर पूरे पते) को डिस्क कैश, सर्वर कैश और Cloudflare से एक साथ हटाता है, और बताता है कि प्रत्येक स्तर ने क्या प्रतिक्रिया दी। | फ्री संस्करण | POST …/abilities/zinn-cache/purge-urls/run | manage_options (the REST route's own check) | urls: array (आवश्यक) |
zinn-cache/refresh-cachezinn-cache-refresh-cache | नियमित अंतराल वाले रीफ़्रेश को शुरू या बंद करें action: start हर पेज को प्रति मिनट एक बैच में रीफ्रेश करता है (कैश खाली करने के बजाय अपडेट जो करते हैं); action: stop चल रहे रीफ्रेश को समाप्त करता है। | फ्री संस्करण | POST …/abilities/zinn-cache/refresh-cache/run | manage_options (the REST route's own check) | action: start|stop (आवश्यक) |
zinn-cache/remove-converted-imageszinn-cache-remove-converted-images | सभी कनवर्ट की गई छवियों को हटाएं (Pro) पृष्ठभूमि में छवियों की प्रत्येक कनवर्ट की गई प्रति हटा देता है; मूल छवियाँ बनी रहती हैं। | प्रो एडिशन | POST …/abilities/zinn-cache/remove-converted-images/run | manage_options | कोई नहीं |
zinn-cache/reset-settingszinn-cache-reset-settings | कैश सेटिंग्स को उनके डिफ़ॉल्ट पर वापस लाएं प्रत्येक कैश सेटिंग को उसके डिफ़ॉल्ट मान पर वापस सेट करता है, जैसा कि रीसेट बटन करता है। सहेजा गया Redis पासवर्ड भी हटा दिया जाता है। | फ्री संस्करण | POST …/abilities/zinn-cache/reset-settings/run | manage_options | कोई नहीं |
zinn-cache/reset-slow-querieszinn-cache-reset-slow-queries | धीमी क्वेरी के निष्कर्ष साफ़ करें (Pro) अब तक मिली प्रत्येक धीमी क्वेरी और धीमे कॉल को भूल जाता है, और खोजकर्ता फिर से शुरू होता है। | प्रो एडिशन | POST …/abilities/zinn-cache/reset-slow-queries/run | manage_options | कोई नहीं |
zinn-cache/update-pro-settingszinn-cache-update-pro-settings | Cache Pro सेटिंग्स बदलें (Pro) यह आपके द्वारा भेजे गए Cache Pro सेटिंग्स को बदलता है (सेटिंग्स: कुंजी से मान) और बाकी को बनाए रखता है। प्रत्येक मान की ठीक वैसे ही जाँच की जाती है जैसे Cache Pro स्क्रीन पर होती है; अज्ञात कुंजी को अस्वीकार कर दिया जाता है। | प्रो एडिशन | POST …/abilities/zinn-cache/update-pro-settings/run | manage_options | settings: object (आवश्यक) |
zinn-cache/update-settingszinn-cache-update-settings | कैश सेटिंग्स बदलें यह आपके द्वारा भेजे गए सेटिंग्स को बदलता है और बाकी को बनाए रखता है (पेज कैश, पेज कितने समय तक कैश रहते हैं, ऑब्जेक्ट कैश और इसका Redis कनेक्शन, पर्ज करने के नियम और बहिष्करण)। मानों की ठीक उसी तरह जाँच और सुधार किया जाता है जैसा Cache स्क्रीन पर होता है। | फ्री संस्करण | 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 | कैश वार्म करें (Pro) पृष्ठभूमि में साइटमैप के प्रत्येक पृष्ठ पर जाना शुरू करता है, ताकि आगंतुकों को कैश्ड पृष्ठ मिल सकें। इसके चलने के दौरान इसकी प्रगति अलग से रिपोर्ट की जाती है। | प्रो एडिशन | POST …/abilities/zinn-cache/warm-cache/run | manage_options | कोई नहीं |
WP-CLI कमांड्स
WP-CLI के साथ इन्हें सर्वर पर चलाएं। प्रत्येक कमांड प्लगइन की स्क्रीन जैसी ही अनुमतियों की जाँच करती है; उदाहरण प्लगइन के अपने सहायता पाठ से लिए गए हैं।
| कमांड | यह क्या करता है | संस्मरण |
|---|---|---|
wp zinn-cache purge allwp zinn-cache purge all | प्रत्येक कैश्ड पृष्ठ को साफ़ करें। | फ्री संस्करण |
wp zinn-cache purge post<id>...wp zinn-cache purge post 42 | किसी पोस्ट के पृष्ठों और उन सूचियों को साफ़ करें जिनमें वह दिखाई देती है (होम पेज, संग्रह, फ़ीड)। | फ्री संस्करण |
wp zinn-cache purge url<url>...wp zinn-cache purge url https://example.com/ /pricing/ | इन URL पर कैश्ड पेजों को साफ़ करें। | फ्री संस्करण |
wp zinn-cache refresh<action>wp zinn-cache refresh status | गति-नियंत्रित रीफ़्रेश शुरू करें, रोकें या देखें (जो अपडेट के बाद "सब कुछ साफ़ करें" की जगह लेता है)। | फ्री संस्करण |
wp zinn-cache server detectwp zinn-cache server detect | जांचें कि साइट के आगे कौन से कैश उत्तर देते हैं (nginx, Varnish, Apache, LiteSpeed, Cloudflare)। | फ्री संस्करण |
wp zinn-cache server drainwp zinn-cache server drain | WP-Cron की प्रतीक्षा करने के बजाय कतारबद्ध सर्वर कैश पर्ज अभी भेजें। | फ्री संस्करण |
wp zinn-cache status[--format=<format>]wp zinn-cache status --format=json | ऑब्जेक्ट कैश की स्थिति की रिपोर्ट करें। | फ्री संस्करण |
क्रियाएँ और फ़िल्टर
प्लगइन द्वारा प्रदान किए जाने वाले प्रत्येक हुक का विवरण इसके सोर्स कोड से दिया गया है। फ़िल्टर किसी मान को बदलते हैं; एक्शन आपको किसी क्षण पर कोड चलाने की अनुमति देते हैं; प्रविष्टि बिंदु वे एक्शन हैं जिन्हें आप प्लगइन से कुछ करने के लिए कहते हैं।
| हुक | प्रकार | यह क्या करता है | पैरामीटर | संस्मरण |
|---|---|---|---|---|
zinn_cache_control_header | फ़िल्टर करें | कैश करने योग्य पृष्ठ के लिए LiteSpeed को भेजे गए cache-control मान को फ़िल्टर करता है। | string $value, int $ttl | फ्री संस्करण |
zinn_cache_fs_loaded | कार्रवाई | यह तब ट्रिगर होता है जब लाइसेंसिंग SDK लोड हो जाता है, Zinn® Cache के बाकी हिस्सों से पहले। `zinn_cache_fs()` से बात करने के लिए यहाँ हुक करें। | कोई नहीं | फ्री संस्करण |
zinn_cache_link_scan_post_types | फ़िल्टर करें | स्कैन जिन पोस्ट प्रकारों को कवर करता है। | कोई नहीं | फ्री संस्करण |
zinn_cache_mcp_abilities | कार्रवाई | Zinn® Cache अपनी क्षमताएं दर्ज करने के बाद ट्रिगर होता है: Zinn® Cache Pro यहाँ अपनी क्षमताएं जोड़ता है। | कोई नहीं | फ्री संस्करण |
zinn_cache_post_change_tags | फ़िल्टर करें | जब कोई पोस्ट बदलती है, तो कैशे टैग को फ़िल्टर करता है जिन्हें साफ़ किया जाता है। | string[] $tags, int $post_id, string $post_type | फ्री संस्करण |
zinn_cache_purge_all | कार्रवाई | टूल पंक्ति से सब कुछ साफ़ करें। | कोई नहीं | फ्री संस्करण |
zinn_cache_purge_hosts | फ़िल्टर करें | उन होस्टनामों को फ़िल्टर करता है जिन्हें निष्कासन निर्दिष्ट कर सकते हैं (एक से अधिक डोमेन पर परोसी जाने वाली साइट के लिए)। | string[] $hosts | फ्री संस्करण |
zinn_cache_purge_on_seo_change | फ़िल्टर करें | फ़िल्टर करता है कि Zinn® SEO में किया गया कोई बदलाव उसके द्वारा बदले गए पेजों को पर्ज करता है या नहीं। | bool $on | फ्री संस्करण |
zinn_cache_purge_plan | प्रवेश बिंदु (आप इसे ट्रिगर करते हैं) | वही साफ़ करें जो प्लान का नाम है: `do_action( 'zinn_cache_purge_plan', array( 'urls' => …, 'tags' => …, 'purge_all' => … ) )`। | कोई नहीं | फ्री संस्करण |
zinn_cache_purged | कार्रवाई | प्लगइन द्वारा कैश पर्ज (cache purge) डिपाच (dispatch) करने के बाद ट्रिगर होता है। | array{purge_all:bool,urls:string[],tags:string[]} $plan | फ्री संस्करण |
zinn_cache_purged_all | कार्रवाई | पेज कैशे के पूर्ण पर्ज (purge) का अनुरोध किए जाने के बाद यह ट्रिगर होता है। | string $reason | फ्री संस्करण |
zinn_cache_refresh_armed | कार्रवाई | गति-नियंत्रित रीफ़्रेश शुरू होने पर सक्रिय होता है। | string $reason | फ्री संस्करण |
zinn_cache_refresh_finished | कार्रवाई | तब ट्रिगर होता है जब गति-नियंत्रित रीफ़्रेश साइट के अंत तक पहुँच जाता है। | int $pages | फ्री संस्करण |
zinn_cache_refresh_guard | फ़िल्टर करें | फ़िल्टर करता है कि क्या रीफ़्रेश को इस मिनट रुकना चाहिए (होस्ट का अपना लोड गार्ड)। | string $reason | फ्री संस्करण |
zinn_cache_refresh_urls | फ़िल्टर करें | उन पतों को फ़िल्टर करता है जिन्हें रीफ़्रेश बैच साफ़ करता है — उदाहरण के लिए, प्रत्येक पृष्ठ के अन्य भाषा पते यहाँ जोड़ें। | string[] $urls | फ्री संस्करण |
zinn_cache_refreshed_urls | कार्रवाई | रिफ्रेश बैच साफ़ होने के बाद सक्रिय होता है (Zinn® Cache Pro इन पृष्ठों को फिर से वार्म करता है)। | string[] $urls | फ्री संस्करण |
zinn_cache_request_cacheable | फ़िल्टर करें | फ़िल्टर करता है कि वर्तमान फ़्रंट-एंड अनुरोध को पृष्ठ कैश से पूर्ण किया जा सकता है या नहीं। | bool $cacheable | फ्री संस्करण |
zinn_cache_status_rows | फ़िल्टर करें | स्थिति स्क्रीन की «इस साइट को क्या कैश कर रहा है» तालिका की पंक्तियों को फ़िल्टर करता है। | array<int,array{0:string,1:string}> $rows, array<string,mixed> $report | फ्री संस्करण |
zinn_cache_ttl | फ़िल्टर करें | वर्तमान पृष्ठ को कितने सेकंड के लिए कैश किया जाता है, इसके आधार पर फ़िल्टर करता है। | int $ttl | फ्री संस्करण |