=== Heartbeat Control Manager by Volade ===
Contributors: volade
Tags: heartbeat, heartbeat-api, admin-ajax, performance, woocommerce
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Reduce admin-ajax.php load. Control and manage the Heartbeat API by zone — dashboard, editor, frontend. WooCommerce presets included.

== Description ==

**Heartbeat Control Manager by Volade** reduces automatic `admin-ajax.php` requests caused by WordPress's native Heartbeat API. Ideal for high-traffic sites, multi-author blogs, and **WooCommerce** stores.

A clear introduction in the admin interface explains every option — accessible even without technical knowledge.

**Key features:**

* 5 one-click presets: Blog, WooCommerce, Agency, Maximum performance, Elementor/Builder
* Front-end, dashboard, lists, editor, and admin configurable separately
* 3 front-end modes: disable, default WordPress behavior, or custom interval
* JSON import / export of settings (no account required)
* Multisite: network settings + inheritance per subsite
* Stats: pulses today, total, requests avoided (estimate)
* Preview of effective config on the current admin screen
* Autosave warning if editor interval is too high
* Conflict detection (Heartbeat Control, WP Rocket)
* Late-loaded Heartbeat script handling from other plugins
* Built-in testing guide in the interface
* WP-CLI: `wp hcm status`, `wp hcm export`, `wp hcm preset <slug>`

= No account (free) =

* Presets, import/export, and essential settings — **no account required**
* 3 public site modes: disable, WordPress default, or custom interval
* Disable Heartbeat on the dashboard or content lists
* **60–300 second** intervals per zone: editor, dashboard, rest of admin
* **2 rules per admin screen** (disable or custom interval)
* Pulse counter and requests avoided
* Settings under **Settings → Heartbeat Control**

= Free Volade account (optional) =

* **15–30 second** intervals
* Up to **10 rules per admin screen**
* Rules by content type (CPT) — disable or custom interval
* Automatic slowdown when the admin tab is inactive (×2 to ×8 multiplier)
* Volade ecosystem after sign-in: plugin catalog, missions, XP, referrals

= V+ Premium (optional paid subscription) =

* Rules by user role (up to 20)
* URL rules (regular expressions) — disable or interval
* Log of the last 100 pulses + CSV export
* Ultra-short intervals **5–10 s** if needed
* Billed through [volade.com](https://volade.com) via Stripe (only if you choose to subscribe)

= Volade ecosystem =

The bundled **Volade SDK** is optional for Heartbeat features: **the plugin core works without any Volade account.** Sign in only if you want extended limits, gamification, or V+ Premium.

= Translations =

English (default). Also available: French, Spanish, German, Brazilian Portuguese, and Italian.

== Installation ==

1. Upload the `heartbeat-control-manager-by-volade` folder (with `volade-sdk/` included) to `/wp-content/plugins/`
2. Activate the plugin via the Plugins menu
3. Open **Settings → Heartbeat Control** to configure presets and intervals

== Screenshots ==

1. Quick presets for Blog, WooCommerce, Agency, and page builders
2. Per-zone Heartbeat intervals: front-end, dashboard, editor, and admin
3. Rules per admin screen with free tier and optional Volade upgrades
4. Pulse stats and requests avoided estimate
5. JSON import/export and built-in testing guide

== External services ==

This plugin may connect to **Volade** (`https://volade.com/api`) when you use optional Volade features (account, catalog, subscriptions). No data is sent until you create a Volade account.

**Service:** Volade API (`https://volade.com/api`)

**Data sent (when applicable):**

* Account registration/login: pseudo, email, local user ID (password stored hashed locally only)
* Subscription sync / checkout: user ID, email, selected plan (checkout handled on volade.com / Stripe)
* Referrals: referrer and referred user IDs, referral code
* Reviews: plugin slug, rating, review text
* Health check: none (endpoint ping only)

**When:** Only after you sign in to Volade or subscribe to V+. Optional admin branding (badge, footer) requires explicit opt-in under **Volade → Settings**. No notifications are shown on the public site.

**Disable:** Do not create a Volade account. Heartbeat features remain fully usable.

Developers may override the API URL with the `VOLADE_API_URL` constant in `wp-config.php`.

== Privacy ==

**Local data:** Volade account data (pseudo, email, password hash, XP, badges, activity, subscriptions) is stored in your WordPress database when you use the optional Volade account system. This is separate from WordPress user accounts.

**Export / erasure:** Signed-in users can export their Volade data (JSON) from **Volade → Settings**. Account deletion requests are handled per the [Volade privacy policy](https://volade.com/en/confidentialite).

**Uninstall:** Deleting the plugin removes Heartbeat settings and all Volade SDK tables, options, and scheduled tasks created by this plugin.

**Cookies:** A `volade_token` HTTP-only cookie is set when you sign in to Volade (admin only).

== Frequently Asked Questions ==

= Do I need a Volade account? =

No. Presets, basic settings, import/export, 2 rules per screen, and the testing guide work immediately without an account.

= What config for WooCommerce? =

Apply the **WooCommerce** preset: front-end disabled, product editor at 30 s, dashboard at 60 s. A Volade account enables CPT rules; V+ lets you disable Heartbeat for the Customer role.

= Does disabling Heartbeat break my site? =

Not for front-end display. However, autosave and content locking in the editor depend on Heartbeat — keep **30–60 s minimum** while editing. A warning appears if you exceed 120 s.

= Is Heartbeat Control compatible? =

Avoid running both plugins in parallel. The plugin shows a warning if Heartbeat Control or WP Rocket is detected.

= Multisite? =

Yes. Network settings under **Network Settings → Heartbeat Control**. Each subsite can inherit from the network or use local settings.

= Are front-end Volade notifications shown by default? =

No. Optional admin branding (badge, footer credit) is **disabled by default** and requires explicit opt-in under **Volade → Settings**. No toast notifications are shown on the public site.

== Changelog ==

= 1.0.0 =
* Heartbeat control for front-end, dashboard, editor, and admin (intervals by tier)
* 5 presets, JSON import/export, network multisite, late Heartbeat handling
* 2 free screen rules; CPT, role, URL rules (Volade / V+)
* Requests avoided stats, effective config preview, autosave warning
* Beginner-friendly interface with per-option explanations
* Configurable inactive tab, log + CSV export, WP-CLI, conflict detection
* Volade SDK: ecosystem features (catalog, missions, premium) require sign-in; branding opt-in by default
* Full data cleanup on uninstall
* Translations: French, Spanish, German, Brazilian Portuguese, Italian
