डेवलपर्स

Zinn® Cache क्षमता संदर्भ

Zinn® Cache अपने कार्यों को WordPress Abilities API के साथ पंजीकृत करता है। वही क्षमताएं साइट के अपने सर्वर पर MCP टूल और /wp-json/wp-abilities/v1 के अंतर्गत REST रूट हैं। यह पृष्ठ प्लगइन की अपनी रजिस्ट्री से जनरेट किया गया है।

उपयोगकर्ता मार्गदर्शिका: एक AI ऐप कनेक्ट करें

Zinn®, हमारा वाइकिंग, उल्लसित हो रहा है क्योंकि एक एआई सहायक प्लेटफ़ॉर्म के उपकरणों से जुड़ता है।

एंडपॉइंट्स

HTTP पर MCP (स्ट्रीम करने योग्य)

https://example.com/wp-json/zinn-cache/v1/mcp

WP-CLI पर MCP (स्टैंडर्ड इनपुट और आउटपुट)

wp mcp-adapter serve --server=zinn-cache --user=<login>

REST: क्षमताen सूचीबद् करें

/wp-json/wp-abilities/v1/abilities?category=zinn-cache

REST: एक एबिलिटी चलाएँ

/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-database
zinn-cache-clean-database
डेटाबेस साफ़ करें (Pro)
सेटिंग्स में चालू किए गए अव्यवस्था के प्रकारों को पृष्ठभूमि में हटाता है। जो हटा दिया गया है उसे वापस नहीं लाया जा सकता।
प्रो एडिशनPOST …/abilities/zinn-cache/clean-database/runmanage_optionsकोई नहीं
zinn-cache/convert-images
zinn-cache-convert-images
सभी मौजूदा छवियों को रूपांतरित करें (Pro)
मीडिया लाइब्रेरी की छवियों को सेटिंग्स में सक्षम किए गए आधुनिक प्रारूपों में बैकग्राउंड में परिवर्तित करना शुरू करता है।
प्रो एडिशनPOST …/abilities/zinn-cache/convert-images/runmanage_optionsकोई नहीं
zinn-cache/detect-cache-layers
zinn-cache-detect-cache-layers
साइट के आगे मौजूद कैश का पता लगाएं
होम पेज के लिए वैसे ही अनुरोध करता है जैसे कोई विज़िटर करता है और यह सहेजता है कि किन कैश ने उत्तर दिया। sample: true के साथ यह सबसे नए पृष्ठों के लिए भी दो बार अनुरोध करता है और गिनता है कि प्रत्येक लेयर ने उन्हें अपने कैश से कितनी बार प्रस्तुत किया।
फ्री संस्करणPOST …/abilities/zinn-cache/detect-cache-layers/runmanage_options (the REST route's own check)sample: boolean
zinn-cache/get-cache-analytics
zinn-cache-get-cache-analytics
कैश एनालिटिक्स पढ़ें (Pro)
पिछले कुछ घंटों (घंटे, 720 तक) के लिए ऑब्जेक्ट कैश की हिट दर और ट्रैफ़िक, इसके सबसे धीमे कमांड, और कौन से प्लगइन्स कैश को सबसे अधिक मिस करते हैं, यह लौटाता है।
प्रो एडिशनGET …/abilities/zinn-cache/get-cache-analytics/runmanage_optionshours: integer
zinn-cache/get-cache-layers
zinn-cache-get-cache-layers
पढ़ें कि साइट को क्या कैश कर रहा है
यह लौटाता है कि कौन सा कैश पृष्ठ प्रस्तुत करता है (LiteSpeed, nginx, Varnish, Apache, Cloudflare या प्लगइन का डिस्क कैश), अंतिम पहचान में क्या मिला, WordPress जहां इसे पढ़ सकता है वहां प्रत्येक परत का आकार, पर्ज कतार, गतिबद्ध रीफ़्रेश और हाल के पर्ज।
फ्री संस्करणGET …/abilities/zinn-cache/get-cache-layers/runmanage_options (the REST route's own check)कोई नहीं
zinn-cache/get-diagnostics
zinn-cache-get-diagnostics
डायग्नोस्टिक्स रिपोर्ट पढ़ें
सपोर्ट द्वारा अनुरोधित डायग्नोस्टिक्स रिपोर्ट लौटाता है: संस्करण, सर्वर सीमाएं, कैश स्थिति और हालिया त्रुटियां। इसमें कोई पासवर्ड या कुंजी शामिल नहीं होती है।
फ्री संस्करणGET …/abilities/zinn-cache/get-diagnostics/runmanage_optionsकोई नहीं
zinn-cache/get-image-progress
zinn-cache-get-image-progress
छवि रूपांतरण की प्रगति पढ़ें (Pro)
यह लौटाता है कि छवियों को बदलने (या हटाने) की प्रक्रिया कितनी आगे बढ़ी है।
प्रो एडिशनGET …/abilities/zinn-cache/get-image-progress/runmanage_optionsकोई नहीं
zinn-cache/get-pro-settings
zinn-cache-get-pro-settings
Cache Pro सेटिंग्स पढ़ें (Pro)
प्रत्येक Cache Pro सेटिंग (वार्म-अप, चित्र, स्क्रिप्ट और शैलियाँ, डेटाबेस सफाई, स्मार्ट पर्जिंग, खोजकर्ता) लौटाता है। गोपनीय विवरण कभी नहीं लौटाए जाते हैं।
प्रो एडिशनGET …/abilities/zinn-cache/get-pro-settings/runmanage_optionsकोई नहीं
zinn-cache/get-settings
zinn-cache-get-settings
कैश सेटिंग्स पढ़ें
कैश की हर सेटिंग लौटाता है। Redis पासवर्ड और Cloudflare टोकन कभी नहीं लौटाए जाते, केवल यह लौटाया जाता है कि कोई सहेजा गया है या नहीं।
फ्री संस्करणGET …/abilities/zinn-cache/get-settings/runmanage_optionsकोई नहीं
zinn-cache/get-slow-queries
zinn-cache-get-slow-queries
धीमी क्वेरी खोजक पढ़ें (Pro)
खोजक द्वारा देखे गए सबसे धीमे डेटाबेस प्रश्न (क्वेरीज़) और आउटगोइंग कॉल लौटाता है, साथ ही उस प्लगइन या थीम की जानकारी भी देता है जिसने प्रत्येक को निष्पादित किया है।
प्रो एडिशनGET …/abilities/zinn-cache/get-slow-queries/runmanage_optionsकोई नहीं
zinn-cache/get-status
zinn-cache-get-status
कैश स्थिति पढ़ें
यह जानकारी देता है कि पेज कैश और ऑब्जेक्ट कैश चालू हैं और काम कर रहे हैं या नहीं, कितने पेज कैश किए गए हैं, तथा ऑब्जेक्ट कैश के कनेक्शन और हिट की संख्या क्या है।
फ्री संस्करणGET …/abilities/zinn-cache/get-status/runmanage_optionsकोई नहीं
zinn-cache/get-warmup-progress
zinn-cache-get-warmup-progress
वार्म-अप प्रगति पढ़ें (Pro)
यह बताता है कि वॉर्म-अप चल रहा है या नहीं, इसने कितने पृष्ठों का दौरा किया है और कितने विफल रहे हैं।
प्रो एडिशनGET …/abilities/zinn-cache/get-warmup-progress/runmanage_optionsकोई नहीं
zinn-cache/preview-database-cleanup
zinn-cache-preview-database-cleanup
डेटाबेस की सफ़ाई का पूर्वावलोकन करें (Pro)
यह प्रकार के अनुसार गिनता है कि सफ़ाई से क्या हटेगा (संशोधन, ड्राफ्ट, स्पैम, समाप्त हो चुका अस्थायी डेटा और इसी तरह के अन्य)। कुछ भी हटाया नहीं जाता है।
प्रो एडिशनGET …/abilities/zinn-cache/preview-database-cleanup/runmanage_optionsकोई नहीं
zinn-cache/purge
zinn-cache-purge
कैश साफ़ करें
कैश किए गए पृष्ठों को हटाता है: सब कुछ (all: true), कुछ पते (urls) या टैग की गई हर चीज़ (tags)। विज़िटर्स के आने पर पृष्ठ फिर से बनाए जाते हैं।
फ्री संस्करणPOST …/abilities/zinn-cache/purge/runmanage_options (the REST route's own check)all: boolean, urls: array, tags: array
zinn-cache/purge-urls
zinn-cache-purge-urls
प्रत्येक कैश लेयर पर कुछ पते साफ़ करें
इन पतों (जैसे /about/ जैसे पाथ या इस साइट पर पूरे पते) को डिस्क कैश, सर्वर कैश और Cloudflare से एक साथ हटाता है, और बताता है कि प्रत्येक स्तर ने क्या प्रतिक्रिया दी।
फ्री संस्करणPOST …/abilities/zinn-cache/purge-urls/runmanage_options (the REST route's own check)urls: array (आवश्यक)
zinn-cache/refresh-cache
zinn-cache-refresh-cache
नियमित अंतराल वाले रीफ़्रेश को शुरू या बंद करें
action: start हर पेज को प्रति मिनट एक बैच में रीफ्रेश करता है (कैश खाली करने के बजाय अपडेट जो करते हैं); action: stop चल रहे रीफ्रेश को समाप्त करता है।
फ्री संस्करणPOST …/abilities/zinn-cache/refresh-cache/runmanage_options (the REST route's own check)action: start|stop (आवश्यक)
zinn-cache/remove-converted-images
zinn-cache-remove-converted-images
सभी कनवर्ट की गई छवियों को हटाएं (Pro)
पृष्ठभूमि में छवियों की प्रत्येक कनवर्ट की गई प्रति हटा देता है; मूल छवियाँ बनी रहती हैं।
प्रो एडिशनPOST …/abilities/zinn-cache/remove-converted-images/runmanage_optionsकोई नहीं
zinn-cache/reset-settings
zinn-cache-reset-settings
कैश सेटिंग्स को उनके डिफ़ॉल्ट पर वापस लाएं
प्रत्येक कैश सेटिंग को उसके डिफ़ॉल्ट मान पर वापस सेट करता है, जैसा कि रीसेट बटन करता है। सहेजा गया Redis पासवर्ड भी हटा दिया जाता है।
फ्री संस्करणPOST …/abilities/zinn-cache/reset-settings/runmanage_optionsकोई नहीं
zinn-cache/reset-slow-queries
zinn-cache-reset-slow-queries
धीमी क्वेरी के निष्कर्ष साफ़ करें (Pro)
अब तक मिली प्रत्येक धीमी क्वेरी और धीमे कॉल को भूल जाता है, और खोजकर्ता फिर से शुरू होता है।
प्रो एडिशनPOST …/abilities/zinn-cache/reset-slow-queries/runmanage_optionsकोई नहीं
zinn-cache/update-pro-settings
zinn-cache-update-pro-settings
Cache Pro सेटिंग्स बदलें (Pro)
यह आपके द्वारा भेजे गए Cache Pro सेटिंग्स को बदलता है (सेटिंग्स: कुंजी से मान) और बाकी को बनाए रखता है। प्रत्येक मान की ठीक वैसे ही जाँच की जाती है जैसे Cache Pro स्क्रीन पर होती है; अज्ञात कुंजी को अस्वीकार कर दिया जाता है।
प्रो एडिशनPOST …/abilities/zinn-cache/update-pro-settings/runmanage_optionssettings: object (आवश्यक)
zinn-cache/update-settings
zinn-cache-update-settings
कैश सेटिंग्स बदलें
यह आपके द्वारा भेजे गए सेटिंग्स को बदलता है और बाकी को बनाए रखता है (पेज कैश, पेज कितने समय तक कैश रहते हैं, ऑब्जेक्ट कैश और इसका Redis कनेक्शन, पर्ज करने के नियम और बहिष्करण)। मानों की ठीक उसी तरह जाँच और सुधार किया जाता है जैसा Cache स्क्रीन पर होता है।
फ्री संस्करणPOST …/abilities/zinn-cache/update-settings/runmanage_optionslscache_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-cache
zinn-cache-warm-cache
कैश वार्म करें (Pro)
पृष्ठभूमि में साइटमैप के प्रत्येक पृष्ठ पर जाना शुरू करता है, ताकि आगंतुकों को कैश्ड पृष्ठ मिल सकें। इसके चलने के दौरान इसकी प्रगति अलग से रिपोर्ट की जाती है।
प्रो एडिशनPOST …/abilities/zinn-cache/warm-cache/runmanage_optionsकोई नहीं

WP-CLI कमांड्स

WP-CLI के साथ इन्हें सर्वर पर चलाएं। प्रत्येक कमांड प्लगइन की स्क्रीन जैसी ही अनुमतियों की जाँच करती है; उदाहरण प्लगइन के अपने सहायता पाठ से लिए गए हैं।

कमांडयह क्या करता हैसंस्मरण
wp zinn-cache purge all
wp 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 detect
wp zinn-cache server detect
जांचें कि साइट के आगे कौन से कैश उत्तर देते हैं (nginx, Varnish, Apache, LiteSpeed, Cloudflare)।फ्री संस्करण
wp zinn-cache server drain
wp 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फ्री संस्करण