=== Host Gauge ===
Contributors: reivanstudios
Tags: storage, files, disk usage, hosting, site health
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.38
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Measure storage and file counts locally with a clean WordPress dashboard, scheduled scans, and read-only reporting.

== Description ==

Host Gauge is a lightweight meter for WordPress sites that need a clear view of local storage and file usage.

It scans the current WordPress installation, stores the latest reading, and shows the result in a focused admin screen, dashboard widget, and admin bar indicator. The plugin is designed to stay calm and read-only: it measures what is already on the site without blocking uploads, changing content, or enforcing quotas.

= What Host Gauge shows =

* Storage used by the WordPress installation.
* Total files found during the local scan.
* Last scan time and measured status.
* A manual scan action for fresh readings.
* Scheduled background scans for daily visibility.
* Lightweight smart updates after uploads, plugin changes, and theme changes.

= Built for hosting visibility =

Host Gauge is useful for site owners, freelancers, and hosting teams who want to understand capacity before storage or file-count limits become a problem. The dashboard keeps the numbers simple enough for daily work while still giving developers hooks for deeper workflows.

= Optional Hub workflow =

Host Gauge works on its own. If your team also uses Hosting Quota Control Hub, a separate companion plugin can connect sites to your Hub account for managed licenses, capacity reporting, and multi-site operations. A 30-day Hub trial is available from the service website.

== Privacy ==

Host Gauge runs locally inside WordPress. By itself, it does not require an external account and does not send scan results to a remote service.

The plugin stores its latest measurement in WordPress options so administrators can see the current reading. If you install and connect a separate companion plugin, that companion workflow may send site data according to its own configuration and privacy terms.

== Installation ==

1. In WordPress, go to Plugins > Add New.
2. Search for "Host Gauge", or upload the `hostgauge.zip` file.
3. Install and activate Host Gauge.
4. Open Host Gauge from the WordPress admin menu.
5. Run a scan to measure current storage and file usage.

== Frequently Asked Questions ==

= Does Host Gauge require an external account? =

No. Host Gauge runs locally and does not require an external account.

= Does Host Gauge block uploads or enforce quotas? =

No. Host Gauge is a read-only local meter. It shows current usage, but it does not block uploads, delete files, or restrict WordPress behavior.

= Does Host Gauge contact external servers? =

No. Host Gauge does not make external HTTP requests by itself.

= What does the file count mean? =

The file count is the number of files detected inside the scanned WordPress installation. Hosting providers often use similar counts when discussing inode or file limits.

= Can I force a new scan? =

Yes. Open the Host Gauge admin screen and use the Force scan action to refresh the measurement.

= Can developers extend Host Gauge? =

Yes. Host Gauge exposes helper functions and hooks for companion plugins and custom workflows:

* `hostgauge_get_usage()`
* `hostgauge_update_usage()`
* `hostgauge_scan_usage()`
* `hostgauge_after_scan`
* `hostgauge_usage_data`

== Screenshots ==

1. Host Gauge admin screen with storage, file usage, current reading, and system summary panels.
2. Storage and files cards after a completed local scan.
3. Dashboard widget and admin bar indicator for quick daily visibility.
4. Optional Hosting Quota Control Hub callout for teams managing several WordPress sites.

== Changelog ==

= 1.0.38 =
* Restored bundled Spanish translations for local testing and added standard plugin textdomain loading.

= 1.0.37 =
* Removed direct active plugin option normalization for WordPress.org review compatibility.
* Removed the manual inline CSS fallback and kept admin assets loaded through WordPress enqueue APIs.
* Refined the optional Hub messaging while preserving the companion Hub sign-in panel and extension filter.

= 1.0.36 =
* Removed the manual translation loader for WordPress.org compatibility checks and cleaned the language index file encoding.

= 1.0.35 =
* Restored the legacy activation-path loader inside the package while keeping a single real plugin header.

= 1.0.34 =
* Standardized source strings in English and added Spanish translation files for localized installs.

= 1.0.32 =
* Prevented buttons from visually sticking in hover/focus states by removing hover movement and clearing mouse focus after pointer leave.

= 1.0.31 =
* Improved metric card hover reliability by pairing CSS hover with pointerenter/pointerleave state handling and clearing hover state when focus leaves.

= 1.0.30 =
* Normalized Host Gauge line endings and documented nonce-protected admin notice query reads for cleaner Plugin Check results.

= 1.0.29 =
* Added safe smart tracking every six hours for uploads, plugins, and themes with strict time/file limits, plus plugin/theme update hooks that schedule a lightweight resync without slowing normal page loads.

= 1.0.28 =
* Prevented metric card hover from appearing stuck by removing card movement on hover while keeping border, shadow, and accent-bar feedback.

= 1.0.27 =
* Removed transform-based entrance motion from interactive containers so hover and press states respond immediately on first page load.

= 1.0.26 =
* Optimized admin motion by removing competing continuous decorative animations, moving meter sheen to transform-based animation, and giving the manual scan action stronger visual priority.

= 1.0.25 =
* Polished the restored Host Gauge UI with richer cards, stronger Hub presentation, faster hover/press states, staggered panel entrances, and preserved animated meter bars.

= 1.0.24 =
* Restored the polished Host Gauge admin UI from the earlier split-plugin version while keeping lightweight activation, legacy activation path compatibility, cache-busted assets, and inline CSS fallback.

= 1.0.13 =
* Returned the package to a single main plugin file for maximum WordPress ZIP installer compatibility.

= 1.0.12 =
* Added compatibility loader files for common legacy basenames to help WordPress recover from stale plugin-file references.

= 1.0.11 =
* Restored the free meter activation path to a minimal local-only flow with no active-plugin reference cleanup.

= 1.0.10 =
* Added cleanup for stale Hosting Quota Control active-plugin references left by older packages, preventing WordPress activation errors when installing the companion Hub.

= 1.0.9 =
* Added dynamic companion Hub messaging so the admin panel can link to the installed Hub plugin when available.

= 1.0.8 =
* Refined the companion Hub messaging in the admin panel.

= 1.0.7 =
* Updated the readme to standard English for WordPress.org submission.
* Removed the manual textdomain loader and invalid Domain Path header.
* Added nonce verification to admin notice query parameters.

= 1.0.6 =
* Refined the admin panel language to present Host Gauge as a read-only local meter.

= 1.0.5 =
* Updated the visible product name to Host Gauge.

= 1.0.4 =
* Replaced emoji markers with WordPress admin icons and refined the meter bar animation.

= 1.0.3 =
* Reworked the admin screen into a read-only current usage gauge.

= 1.0.2 =
* Reworked the admin screen into a meter-first dashboard.

= 1.0.1 =
* Refined the admin dashboard layout and labels.

= 1.0.0 =
* Initial Host Gauge release.

== Upgrade Notice ==

= 1.0.38 =
Spanish translation files restored for local installs.

= 1.0.37 =
WordPress.org compatibility cleanup with clearer optional Hub messaging.

= 1.0.9 =
Dynamic Hub companion messaging refresh.

= 1.0.8 =
Admin panel Hub messaging refresh.

= 1.0.7 =
WordPress.org readme and Plugin Check cleanup.

= 1.0.6 =
Refined local meter language.

= 1.0.5 =
Visible product name updated to Host Gauge.

= 1.0.4 =
WordPress admin icon refresh and smoother meter animation.

= 1.0.3 =
Read-only current usage gauge refresh.

= 1.0.2 =
Meter-first admin dashboard refresh.

= 1.0.1 =
Refined admin dashboard layout and labels.

= 1.0.0 =
Initial release.
