=== Provelopers Cache Manager ===
Contributors:      provelopers
Tags:              cache, performance, optimization, godaddy, caching
Requires at least: 5.8
Tested up to:      6.9
Stable tag:        1.0.0
Requires PHP:      7.4
License:           GPL-2.0-or-later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html
Donate link:       https://provelopers.net/donate

Flush WAF, server, and WordPress caches from one dashboard. Supports GoDaddy, Sucuri, WP Rocket, W3TC, and LiteSpeed.

== Description ==

Managing cache on a modern WordPress site means dealing with multiple independent layers — the edge WAF, the server proxy, the WordPress object cache, and whatever caching plugin happens to be active. Most tools only address one of these layers, leaving the rest to be cleared manually.

If your site is hosted on GoDaddy or protected by Sucuri Website Security, you know the pain of logging into a separate dashboard just to flush the WAF cache after every update. Provelopers Cache Manager eliminates that step entirely.

This plugin uses external services only when explicitly configured by the user.

**Provelopers Cache Manager** brings every cache layer under one clean admin interface. One click ensures your visitors always see the most up-to-date content.

= Core Features =

**One-Click Full Flush**
Purge every cache layer simultaneously — WAF, server proxy, and WordPress — with a single click.

**Selective Cache Flushing**
Flush specific layers like WAF or WordPress cache independently without affecting others.

**WAF Cache Integration (Sucuri & GoDaddy)**
Connect your WAF API credentials to purge cache directly via the Sucuri Web Application Firewall API. Fully compatible with GoDaddy Website Security (Sucuri-powered). Includes HTTP fallback if API is unavailable.

**Automatic Cache Clearing**
Automatically purge caches when:
- Posts are published or updated
- Comments are posted
- Theme is switched

**Caching Plugin Support**
Automatically detects and clears cache for:
- WP Rocket
- W3 Total Cache
- WP Super Cache
- LiteSpeed Cache
- Any plugin using native WordPress object cache

**Persistent Audit Log**
Track every cache flush with timestamp, user, and action. Logs are securely stored and manageable from the admin panel.

**Real-Time Debug Panel**
View detailed step-by-step feedback after each manual flush to verify which layers were cleared.

= Why Provelopers Cache Manager? =

Unlike most cache tools that are limited to a single layer or hosting provider, Provelopers Cache Manager works across all cache layers and environments. It is lightweight, admin-only, and has zero impact on front-end performance.

= Privacy =

This plugin does not collect or store personal user data.

If WAF API integration is enabled, the plugin sends API credentials (API Key and Secret) and cache purge requests to the Sucuri WAF service when a cache flush is triggered. No personal user data or visitor browsing data is transmitted.

Logs are stored locally on your server and are not shared externally.

== External services ==

This plugin connects to external services to perform cache purging functionality.

1. Sucuri WAF API (also used by GoDaddy Website Security)

Purpose:
This service is used to remotely clear (purge) the website firewall (WAF) cache.

What data is sent:
- API Key
- API Secret
- Cache purge request (clearcache action)

When data is sent:
- When a user manually triggers a cache flush from the dashboard
- When automatic cache clearing is triggered (if enabled)

This service is provided by Sucuri Inc.

Terms of Service:
https://sucuri.net/terms/

Privacy Policy:
https://sucuri.net/privacy/

== Installation ==

**Install via WordPress Dashboard**

1. Go to **Plugins → Add New**
2. Search for **Provelopers Cache Manager**
3. Click **Install Now** → **Activate**

**Manual Installation**

1. Download the plugin ZIP
2. Upload to `/wp-content/plugins/`
3. Activate from **Plugins menu**

**Initial Setup**

1. Go to **Provelopers Cache → Settings**
2. Enter WAF API Key & Secret (optional)
3. Enable Auto Clear if needed
4. Save settings

**Get WAF API Credentials**

*Sucuri:*
- Login: https://waf.sucuri.net/
- Navigate to **Settings → API**

*GoDaddy:*
- Login: https://account.godaddy.com/
- Go to **Website Security → Manage → Settings → API**

== Frequently Asked Questions ==

= Do I need Sucuri or GoDaddy? =
No. The plugin works without WAF credentials. API is only needed for edge cache purge.

= Which caching plugins are supported? =
WP Rocket, W3TC, WP Super Cache, LiteSpeed, and any using `wp_cache_flush()`.

= Does it work with GoDaddy? =
Yes. GoDaddy WAF uses Sucuri infrastructure, so API integration works seamlessly.

= Are API credentials secure? =
Yes. Stored securely in WordPress options and never exposed.

= Does Auto Clear slow the site? =
No. The impact is minimal and happens within normal WordPress operations.

= Does it affect front-end performance? =
No. The plugin runs only in admin.

= How to view logs? =
Go to **Provelopers Cache → Logs**.

= Multisite support? =
Not officially supported in this version.

= What if API fails? =
Fallback HTTP PURGE and headers will attempt cache clearing.

= Does this plugin send data to third-party services automatically? =
No. External API requests are only made when you configure WAF API credentials and trigger a cache flush manually or via the optional auto-clear feature.

== Screenshots ==

1. Dashboard — Overview and flush controls
2. Settings — API configuration and auto clear
3. Logs — Cache activity tracking

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.