개발자
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: 기능 목록 보기
/wp-json/wp-abilities/v1/abilities?category=zinn-cacheREST: 능력 실행
/wp-json/wp-abilities/v1/abilities/<name>/run인증 및 권한
HTTP 요청은 WordPress 애플리케이션 비밀번호(HTTP 기본 인증)를 사용하여 인증됩니다. 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 파일에서 생성되었으며, 두 파일의 내용이 일치하지 않을 경우 테스트가 실패합니다.
| 권한 | 기능 | 에디션 | 나머지 | 권한 | 매개변수 |
|---|---|---|---|---|---|
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 | 작업 | Zinn® Cache의 나머지 부분이 로드되기 전에, 라이선싱 SDK가 로드된 직후에 실행됩니다. `zinn_cache_fs()`와 통신하려면 여기에 훅을 걸어두세요. | 없음 | 무료 버전 |
zinn_cache_link_scan_post_types | 필터 | 검색이 포함하는 게시물 유형입니다. | 없음 | 무료 버전 |
zinn_cache_mcp_abilities | 작업 | Zinn® 캐시가 기능을 등록한 후에 실행됩니다: 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 | 무료 버전 |