დეველოპერები
Zinn® Cache-ის შესაძლებლობების ცნობარი
Zinn® Cache აფიქსირებს თავის მოქმედებებს WordPress Abilities API-ის გამოყენებით. ესვე შესაძლებლობები წარმოადგენს MCP ინსტრუმენტებს საიტის საკუთარ სერვერზე და REST მარშრუტებს /wp-json/wp-abilities/v1 მისამართზე. ეს გვერდი გენერირებულია თავად მოდულის რეესტრიდან.
საბოლოო წერტილები
MCP over HTTP (სტრიმინგადი)
https://example.com/wp-json/zinn-cache/v1/mcpMCP WP-CLI-ის მეშვეობით (სტანდარტული შეყვანა და გამოყვანა)
wp mcp-adapter serve --server=zinn-cache --user=<login>REST: შესაძლებლობების სია
/wp-json/wp-abilities/v1/abilities?category=zinn-cacheREST: უნარის გაშვება
/wp-json/wp-abilities/v1/abilities/<name>/runავტორიზაცია და ნებართვები
HTTP მოთხოვნები ავთენტიფიცირდება WordPress აპლიკაციის პაროლით (HTTP Basic). MCP სვერთან დასაკავშირებლად საჭიროა ქვემოთ მოცემული შესაძლებლობა; თითოეული შესაძლებლობა შემდეგ ამოწმებს საკუთარ უფლებას, თითოეული ობიექტის მიხედვით. მხოლოდ წაკითხვადი შესაძლებლობები ეშვება 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 ფაილიდან, რომელიც თავის მხრივ გენერირებულია მუშა საიტიდან; ტესტი ვერ გადის, როდესაც ეს ორი ერთმანეთს არ ემთხვევა.
| შესაძლებლობა | რას აკეთებს | გამოცემა | REST | ნებართვა | პარამეტრები |
|---|---|---|---|---|---|
zinn-cache/clean-databasezinn-cache-clean-database | მონაცემთა ბაზის გასუფთავება (Pro) ფონურ რეჟიმში შლის პარამეტრებში ჩართული ზედმეტი ელემენტების ტიპებს. წაშლილის დაბრუნება შეუძლებელია. | Pro გამოცემა | POST …/abilities/zinn-cache/clean-database/run | manage_options | არცერთი |
zinn-cache/convert-imageszinn-cache-convert-images | ყველა არსებული სურათის გარდაქმნა (Pro) ფონურ რეჟიმში იწყებს მედიაბიბლიოთეკის სურათების კონვერტაციას პარამეტრებში ჩართულ თანამედროვე ფორმატებში. | 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-მდე), მის ყველაზე ნელ ბრძანებებს და იმას, თუ რომელი მოდულები აცდენენ ქეშს ყველაზე ხშირად. | Pro გამოცემა | 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) აბრუნებს სურათების გარდაქმნის (ან წაშლის) პროგრესს. | 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-ს ყველა პარამეტრს (გახურება, სურათები, სკრიპტები და სტილები, მონაცემთა ბაზის გასუფთავება, ჭკვიანი გასუფთავება, მაძიებელი). საიდუმლოებები არასოდეს ბრუნდება. | 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) აბრუნებს მონაცემთა ბაზის ყველაზე ნელ მოთხოვნებსა და გამავალ გამოძახებებს, რომლებიც მპოვნელმა დააფიქსირა, თითოეულის შემსრულებელ პლაგინთან ან თემასთან ერთად. | Pro გამოცემა | GET …/abilities/zinn-cache/get-slow-queries/run | manage_options | არცერთი |
zinn-cache/get-statuszinn-cache-get-status | ქეშის სტატუსის წაკითხვა აბრუნებს ინფორმაციას იმის შესახებ, ჩართულია თუ არა და მუშაობს გვერდის ქეში და ობიექტის ქეში, რამდენი გვერდია დაქეშილი, ასევე ობიექტის ქეშის კავშირებისა და წარმატებული მიმართვების (hit) რაოდენობას. | უფლებანი გამოვიდა | GET …/abilities/zinn-cache/get-status/run | manage_options | არცერთი |
zinn-cache/get-warmup-progresszinn-cache-get-warmup-progress | წაიკითხეთ გახურების პროგრესი (Pro) აბრუნებს ინფორმაციას იმის შესახებ, მუშაობს თუ არა გახურება, რამდენი გვერდი მოინახულა და რამდენი ჩაიშალა. | Pro გამოცემა | GET …/abilities/zinn-cache/get-warmup-progress/run | manage_options | არცერთი |
zinn-cache/preview-database-cleanupzinn-cache-preview-database-cleanup | მონაცემთა ბაზის გასუფთავების წინასწარი ნახვა (Pro) ითვლის, რას წაშლის გასუფთავება, ტიპების მიხედვით (რევიზიები, მონახაზები, სპამი, ვადაგასული დროებითი მონაცემები და მსგავსი). არაფერი იშლება. | 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) ფონურ რეჟიმში შლის სურათების თითოეულ გარდაქმნილ ასლს; ორიგინალები რჩება. | 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) ივიწყებს აქამდე ნაპოვნ ყველა ნელ მოთხოვნასა და ნელ გამოძახებას, და მძებნელი თავიდან იწყებს. | 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-ს ეკრანზე; უცნობი გასაღები უარყოფილია. | 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) ფონურ რეჟიმში იწყებს საიტის რუკებში არსებული თითოეული გვერდის მონახულებას, რათა ვიზიტორებმა მიიღონ დაქეშირებული გვერდები. მისი პროგრესი ცალკე მოხსენდება მისი მუშაობის დროს. | Pro გამოცემა | POST …/abilities/zinn-cache/warm-cache/run | manage_options | არცერთი |
WP-CLI ბრძანებები
გaurთ ესენი სერვერზე 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 | მოქმედება | მუშაობს პლაგინის მიერ ქეშის გასუფთავების გაგზავნის შემდეგ. | array{purge_all:bool,urls:string[],tags:string[]} $plan | უფლებანი გამოვიდა |
zinn_cache_purged_all | მოქმედება | ამოქმედდება გვერდის ქეშის სრული გაწმენდის მოთხოვნის შემდეგ. | 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 | უფლებანი გამოვიდა |