Naibabiji Cache Purger for EdgeOne

توضیحات

A powerful WordPress plugin that automatically purges Tencent Cloud EdgeOne cache when your posts, pages, or custom post types are published, updated, or deleted.

External services

This plugin connects to the Tencent Cloud EdgeOne API (https://teo.tencentcloudapi.com) to provide cache purging and prefetching functionality.

It sends the Following information to Tencent Cloud when a purge or prefetch operation is triggered (e.g., when a post is updated, or when manual purge is used):
* Tencent Cloud API Credentials (SecretId): Used for request authentication and signing.
* EdgeOne Zone ID: Used to identify the specific site/zone in EdgeOne.
* Target URLs or Paths: The specific resources that need to be cleared or prefetched from the CDN nodes.

This service is provided by “Tencent Cloud”: Terms of Service, Privacy Policy.

Features

Automatic Cache Purge

• Automatically purges cache when posts are published, updated, or deleted
• Supports all public post types (posts, pages, and custom post types)
• Smart purge: automatically refreshes post pages, homepage, category archives, tag archives, author archives, and date archives

Comment Integration

• Automatically purges related post cache when new comments are approved

Manual Purge

• Support for manual purge of specific posts or entire site
• Quick purge buttons in admin panel for recent posts

Flexible Configuration

• Choose purge method: delete cache (delete) or mark as expired (invalidate)
• Optional logging of purge operations
• Secure key configuration via wp-config.php constants

Cache Plugin Integration

• Automatically purges EdgeOne cache when popular WordPress cache plugins clear their cache
• Supports WP Super Cache, W3 Total Cache, WP Rocket, and LiteSpeed Cache
• Force mode ensures cache plugin integrations work even when auto purge is disabled
• Proper timing control ensures compatibility with all cache plugin loading sequences

Cache Prefetching

• Optional cache prefetching after purging (disabled by default)
• Only prefetches post URLs, not archive pages to conserve EdgeOne prefetch quota
• Ensures first visitor gets cached content immediately
• Prefetch results are displayed in the purge logs for easy monitoring

Enhanced Logging

• Detailed logging of all purge operations with success/failure status
• Manual log clearing functionality for easier debugging
• Prefetch operation results displayed alongside purge results
• Job IDs and error messages for easy troubleshooting

Advanced Manual Purge

• Optimized host-specific “Purge All” using the purge_host method
• Manual purge operations are not affected by auto purge settings
• Force mode support for cache plugin integrations
• Comprehensive URL coverage for post-related purges

Custom URL Purge

• Purge cache for specific URLs (CSS, JS, images, etc.)
• Support for directory prefix purge using trailing slash (/)
• Batch processing: enter multiple URLs, one per line
• Automatic URL validation and filtering
• Smart type detection: files use purge_url, directories use purge_prefix

Nginx Cache Integration

• Optionally clear Nginx server-side page cache (FastCGI cache or Proxy cache) alongside EdgeOne CDN cache
• Configured separately — most sites using only WordPress cache plugins do not need this
• Nginx cache and EdgeOne cache are cleared independently; either can succeed even if the other fails
• Includes path validation with real-time feedback in the settings page

No SDK Required

• Direct API calls, no need to install Tencent Cloud SDK
• Compatible with all WordPress versions 5.5+

Configuration

Get Tencent Cloud API Keys

1. Visit Tencent Cloud Console
2. Create or get your SecretId and SecretKey

Get EdgeOne Zone ID

1. Visit EdgeOne Console
2. Select your site and find the Zone ID (format: zone-xxxxxx)

Configure Plugin

There are two configuration methods:

Method 1: Using wp-config.php (Recommended)

Add these constants to your WordPress wp-config.php file:

`

define( ‘NB_CACHE_PURGER_SECRET_ID’, ‘your-secret-id’ );
define( ‘NB_CACHE_PURGER_SECRET_KEY’, ‘your-secret-key’ );
`

Then in WordPress admin:
1. Go to “Settings” → “Naibabiji Cache Purger”
2. Fill in the Zone ID (Secret ID and Secret Key will be automatically loaded from constants)
3. Choose other options and save

Method 2: Direct Configuration in Admin

1. Log in to WordPress admin
2. Go to “Settings” → “Naibabiji Cache Purger”
3. Fill in the following information:
   • Secret ID: Tencent Cloud API Secret ID
   • Secret Key: Tencent Cloud API Secret Key
   • Zone ID: EdgeOne Zone ID
4. Choose other options:
   • Enable Auto Purge: Whether to automatically purge cache when posts are updated
   • Purge Method:
     • delete: Directly delete node cache
     • invalidate: Mark as expired, revalidate from origin
   • Enable Logging: Whether to log purge operations

Nginx Cache Integration (Optional)

Only needed if your server uses Nginx FastCGI cache or Proxy cache (configured via fastcgi_cache_path or proxy_cache_path in nginx.conf). Most sites using WordPress cache plugins do not need this.

1. In “Settings” → “Naibabiji Cache Purger” → scroll to the Nginx Cache Integration section at the bottom
2. Check Enable Nginx Cache Purge
3. Enter the absolute filesystem path to your Nginx cache zone directory (e.g. /var/run/nginx-cache)
   • The web server process (e.g. www-data) must have write permission to this directory
   • The settings page will validate the path and show whether it is writable
4. Save settings — Nginx cache will now be cleared automatically every time EdgeOne cache is purged