=== Version Info - Server Health Monitor, PHP & MySQL Version Display, Environment Indicators ===
Contributors: gauchoplugins, brandonfire, freemius
Tags: server info, php version, site health, system resources, server location
Stable tag: 2.1.0
Requires at least: 4.7
Tested up to: 7.1
Requires PHP: 5.6
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Free memory & server IP display, PHP EOL countdown, live CPU/RAM sparklines, server location, environment indicators, SSL expiry & EOL alerts.

== Description ==

= 🛡️ THE ESSENTIAL TECHNICAL HUD FOR EVERY WORDPRESS PROFESSIONAL =

Stop digging through hidden menus or leaving insecure `phpinfo()` files on your server. **[Version Info](https://versioninfoplugin.com/ "Visit the Version Info website")** is the essential technical dashboard that brings your site's most vital environment data directly into your daily workflow — the admin footer, the admin bar, or a dedicated dashboard widget.

Whether you're a freelancer managing dozens of client sites, a developer debugging a complex plugin conflict, or an agency maintaining a portfolio of high-value properties, having instant access to your **PHP version**, **MySQL version**, **WordPress version**, and **web server type** is a mission-critical utility.

**Version Info** has been trusted by WordPress professionals since 2015 and is now supercharged with a complete PRO + Agency suite for serious site monitoring. Learn more at **[versioninfoplugin.com](https://versioninfoplugin.com/ "Version Info official website")**.

= ✨ What Makes Version Info Different? =

Most server info plugins show you a wall of data you don't need. Version Info is designed around **the data you actually use every day**, placed exactly where you need it — no extra pages, no bloat, no performance impact.

* **Zero Configuration** — Install, activate, done. Versions appear in your footer immediately.
* **Surgical Precision** — Only shows WP, PHP, MySQL, and Server versions. No fluff.
* **Performance First** — Uses native WordPress APIs. Literally zero impact on page load.
* **Developer Hooks** — Every data point is filterable for custom integrations. See the [developer docs](https://docs.versioninfoplugin.com/advanced-configuration-hooks-and-filters "Version Info developer documentation").

= 🚀 Core Features (100% Free, Forever) =

These features will always be free. No bait-and-switch.

* 🛠️ **Admin Footer Display** — See WordPress, PHP, MySQL, and Web Server versions at the bottom of every admin page. Includes a one-click update link when a new WP version is available.
* 🧠 **Memory & Server IP** *(new in 2.1.0)* — Your PHP memory limit, live usage percentage, and server IP right in the footer, admin bar, and dashboard widget. The #1 hosting-support question, answered at a glance.
* ⏳ **PHP EOL Countdown** *(new in 2.1.0)* — See exactly how many days your PHP version has left before end-of-life, and a clear flag once it's past EOL.
* 📋 **Copy as Markdown** *(new in 2.1.0)* — One click copies your entire stack as a clean Markdown table — paste it straight into support tickets, GitHub issues, or wp.org forum posts.
* 🚦 **WP-Admin Bar Nodes** — Pin your version stack to the admin bar for instant visibility while navigating between pages, posts, and settings.
* 📊 **Dashboard Widget** — A dedicated "At a Glance" style widget showing your complete technical stack. Enable it via Screen Options.
* 🔄 **Core Update Alerts** — Automatically compares your WP version with the latest available and shows an update link right in the footer.
* 💻 **Server Detection** — Instantly identify Apache, Nginx, LiteSpeed, or any other server software without leaving WordPress.
* 🌐 **Translation Ready** — Fully localized with translations in 13+ languages including Spanish, German, French, Japanese, Chinese, and more. [Help translate](https://translate.wordpress.org/projects/wp-plugins/version-info/ "Translate Version Info on WordPress.org").

= 🔥 PRO Plan — Advanced Site Intelligence =

Unlock real-time performance monitoring, environment safety, and proactive health checks. Built for developers who take their stack seriously.

**[Upgrade to PRO →](https://versioninfoplugin.com/pricing "Version Info PRO pricing")** Starting at $19/year.

🖥️ **Live System Resources HUD in the Dashboard Widget**

Turn your dashboard widget into a full server-health command center. One toggle lights up 30+ live stats in clean groups:

* **Identity** — Environment, Server Location, OS, Hostname, IP, Port, Document Root, Uptime
* **Live Resources** — CPU + Memory bars with sparklines, PHP memory, Disk usage
* **Database** — Size with data/index split, tables, max connections, max packet
* **PHP** — Runtime limits, loaded modules
* **WP Status** — Core / plugin / theme updates, cron, Health Advisor counts
* **Diagnostics** — HTTPS, WP_DEBUG, object cache, timezones

The modern replacement for the abandoned wp-server-stats plugin.

📈 **Live CPU & RAM Sparklines**

Visual bars *plus* inline sparklines showing the last ~7.5 minutes of activity — direction-of-travel at a glance, not just current values. Recolors green → orange → red at 70% / 90% thresholds. Works on Linux, Windows, and every managed host we've tested.

🌍 **Server Location — 4 Pluggable Providers**

Know exactly which datacenter your site lives in. Pick the provider that fits your privacy needs:

* **Version Info Geolocation (anonymous)** — our own Cloudflare Worker, logs nothing, richest data
* **Cloudflare cdn-cgi/trace** — country-only, zero auth
* **ip-api.com** — free legacy provider
* **MaxMind GeoLite2** — best ASN accuracy (license-key)

30-day cache + a one-click "Detect now" button. [Provider comparison →](https://docs.versioninfoplugin.com/pro-features-server-location/)

💾 **Database Size + Connection Limits**

Know how bloated your database is *before* it becomes a problem. Tracks `data` vs `index` size for every WP table, plus DB max connections and max packet — critical for WooCommerce stores hitting connection caps during Black Friday. 12-hour cache + "Scan Now" for fresh data.

🛰️ **wp-server-stats Parity — and Beyond**

Closes the feature gap with the abandoned 2017-era wp-server-stats plugin — without inheriting its `shell_exec()` dependency that breaks on managed hosts. Adds:

* Server OS, Hostname, IP, Port, Document Root (path-masked)
* Server Uptime (formatted)
* PHP Modules accordion (every loaded extension with version)
* Disk Usage bar
* One-click "Purge VI Caches" button

🚨 **Smart Environment Indicators**

Never accidentally run a destructive query on production again. High-visibility color badges in the admin bar:

* 🔴 **Red** — Production
* 🟠 **Orange** — Staging
* 🟢 **Green** — Development / Local

Auto-detects Bedrock, Kinsta, WP Engine, Pantheon, Flywheel, and core `WP_ENVIRONMENT_TYPE`. Optional admin-bar border highlight matches the environment color.

📜 **Version History Audit Log**

A persistent timeline of every shift in your WordPress core, PHP, MySQL, plugin, and theme versions. Know exactly *when* and *what* changed for fast troubleshooting. Last 50 entries; auto-pruned.

🛡️ **Health Advisor**

Proactive alerts that predict problems before they happen. Checks your PHP and MySQL versions against known End-of-Life dates, grades your PHP against WordPress core's official support matrix (7.4 minimum / 8.3 recommended / 8.5 fully supported as of WP 7.0), and flags critical security risks. Integrates with the native WordPress Site Health screen.

🔒 **SSL Certificate Expiry Alerts** *(new in 2.1.0)*

Never let a certificate lapse again. The Health Advisor checks your site's SSL certificate and warns at 21 days, escalating to critical at 7 days or expiry. Renewal-friendly thresholds — no false alarms on healthy Let's Encrypt auto-renewal cycles.

📧 **System Change Email Alerts** *(moved from Agency to PRO in 2.1.0)*

Get notified the *instant* something changes — PHP version flips, WP core updates, any plugin or theme version shift. Configurable recipient list, per-component toggles, sensible defaults.

📤 **JSON System Info Export**

One-click download of your entire technical stack as structured JSON. Perfect for support tickets, host conversations, and pre-migration archives. Includes WordPress config, PHP + extensions, database details, active theme, and every active plugin with version.

[See the full PRO feature documentation →](https://docs.versioninfoplugin.com/pro-features "Version Info PRO documentation")

= 🏛️ Agency Plan — The Command Center for Client Portfolios =

Everything in PRO, plus enterprise-grade tools for agencies, freelancers, and hosting companies managing multiple sites.

**[Upgrade to Agency →](https://versioninfoplugin.com/pricing "Version Info Agency pricing")** Starting at $49/year.

🏷️ **Full Agency White-Labeling**

Make it *your* plugin. Replace "Version Info" and "Gaucho Plugins" everywhere — plugins list, widget, admin bar, footer, settings page. Hide Freemius branding. Optionally:

* Lock the White Label tab to a single admin so clients can't undo your branding
* Hide every in-plugin docs link sitewide

👥 **Role-Based Admin Visibility**

Keep client dashboards clean. A checkbox matrix controls exactly which WordPress roles see version info in the admin bar, footer, and widget. Default: administrators only.

🌐 **Multisite Network Dashboard**

A single page under **Network Admin → Settings** showing WP / PHP / MySQL versions and database size for every site on the network. Cached, capped at 100 sites for performance.

🔍 **PHP Error Log Dashboard**

Debug without FTP or SSH. View the last 100 lines of your `debug.log` directly inside WordPress. Efficient tail reading, automatic path masking, ZIP download for offline analysis.

[See the full Agency feature documentation →](https://docs.versioninfoplugin.com/agency-features "Version Info Agency documentation")

= 🎯 Real-World Use Cases =

**"The Support Hero"**
A client reports a bug. Instead of asking for their login credentials, you ask them to screenshot their admin footer. You instantly know their PHP version, MySQL version, WordPress version, and web server — without ever logging into their site.

**"The WooCommerce Specialist"**
Black Friday is coming. You use **Database Tracking** to monitor table size growth during the high-traffic event. When `wp_options` grows 300% overnight, you catch the autoloaded transient bloat before it takes down the store.

**"The Agency Owner"**
You hand over a beautifully built site to a high-ticket client. With **White-Labeling**, the client never sees "Gaucho Plugins" — they see *your* agency name everywhere. With **Role-Based Visibility**, the client's editors see a clean dashboard without confusing server information.

**"The Safety-First Developer"**
You manage staging and production environments for the same client. The bright **red "Production" badge** in your admin bar prevents you from ever accidentally running a migration script on the live site. The **admin bar highlight** makes the environment unmistakable.

**"The Managed Hosting Reseller"**
You run 40 sites on a Multisite installation. The **Network Dashboard** gives you a single page showing WP, PHP, and MySQL versions across every site — perfect for planning bulk upgrades. When a host updates PHP overnight, the **Email Alert** hits your inbox before the first support ticket arrives.

**"The Remote Debugger"**
A client's site throws a white screen. You open the **Error Log Dashboard** directly in wp-admin — no FTP client, no SSH terminal. The last 100 lines show a fatal error from a plugin update. The **Version History** tab confirms the plugin updated 10 minutes ago. Root cause found in under 60 seconds.

**"The wp-server-stats Replacer"**
You've been using the abandoned **WP Server Health Stats** plugin since 2017 because nothing modern replaced it — until now. The Version Info PRO dashboard widget gives you CPU/RAM bars *with live sparklines*, disk usage, database size with `data` vs `index` split, server OS / hostname / IP / port / uptime / location — all in one widget, on every dashboard load, refreshed via the WordPress Heartbeat API. No `shell_exec()` (so it works on Kinsta, WP Engine, Cloudways), no abandoned dependencies, no rebuilds required.

= ⚡ Performance & Architecture =

Version Info is built with performance as the #1 priority:

* **Transients API** — All resource-heavy metrics (CPU, RAM, DB size) are cached. CPU/RAM uses 60-second TTL; database size uses 12-hour TTL.
* **Heartbeat API** — Live resource updates use the native WordPress Heartbeat, ensuring data refreshes only when the admin page is active.
* **Provider Pattern** — A `ProviderInterface` abstracts all detection logic, making it trivial to add custom providers for AWS, Kinsta, or any host-specific API.
* **Hook-First Architecture** — Every data point fires a WordPress filter (`version_info_wp_version`, `version_info_php_version`, etc.) and every render point fires an action. Extend anything without editing core files. See the [hooks reference](https://docs.versioninfoplugin.com/advanced-configuration-hooks-and-filters "Version Info hooks reference").
* **Broad Compatibility** — The codebase deliberately avoids language features that would lock out legacy hosts, so the plugin still installs on PHP 5.6+ and WordPress 4.7+ (which is, after all, who this plugin is built for). Modern PHP is auto-detected and used where available.
* **WordPress Coding Standards** — Follows WPCS, uses proper escaping, nonce verification, capability checks, and prepared SQL queries throughout.

= 🌍 Works With Your Stack =

Version Info auto-detects and works seamlessly with:

* **Hosts:** Kinsta, WP Engine, Pantheon, Flywheel, Cloudways, SiteGround, and any standard LAMP/LEMP host
* **Environments:** Bedrock, Trellis, Local by Flywheel, MAMP, WAMP, Docker, DevKinsta
* **Servers:** Apache, Nginx, LiteSpeed, OpenLiteSpeed, IIS
* **Multisite:** Full network-level support with dedicated Network Admin page (Agency)
* **Translations:** 13+ languages with full RTL support

= 📣 What WordPress Professionals Are Saying =

> "I install this on every client site. It saves me at least 5 minutes per support ticket." — ★★★★★

> "The environment badges alone are worth the upgrade. I'll never accidentally nuke production again." — ★★★★★

> "Finally, a server info plugin that isn't bloated with stuff I don't need." — ★★★★★

[Read more reviews →](https://wordpress.org/support/plugin/version-info/reviews/?filter=5 "Version Info 5-star reviews")

= 🔗 Resources & Links =

* **[Version Info Website](https://versioninfoplugin.com/ "Visit the Version Info website")**
* **[Documentation & Guides](https://docs.versioninfoplugin.com/ "Version Info documentation")**
* **[PRO & Agency Pricing](https://versioninfoplugin.com/pricing "Version Info pricing")**
* **[Developer Hooks Reference](https://docs.versioninfoplugin.com/advanced-configuration-hooks-and-filters "Version Info hooks reference")**
* **[Support Forum](https://wordpress.org/support/plugin/version-info/ "Version Info support")**
* **[Translate Version Info](https://translate.wordpress.org/projects/wp-plugins/version-info/ "Translate on WordPress.org")**

= 🆘 Support =

Free support is available in the [WordPress.org support forum](https://wordpress.org/support/plugin/version-info/). PRO and Agency customers can use [priority support through versioninfoplugin.com](https://versioninfoplugin.com/).

## GAUCHO PLUGINS PORTFOLIO

**[Payment Page](https://wordpress.org/plugins/payment-page/)**: Start accepting payments in a beautiful payment form in less than 60 seconds

**[Split Pay Plugin](https://wordpress.org/plugins/bsd-woo-stripe-connect-split-pay/)**: Split WooCommerce payments across multiple connected Stripe accounts. 

**[Login for Stripe Customer Portal](https://wordpress.org/plugins/login-stripe-customer-portal/)**: Create an Account login area for your Stripe customers. 

**[Gyta Buyback](https://wordpress.org/plugins/gyta-buyback/)**: Create a trade-in / buyback business using WooCommerce. 

**[Version Info](https://wordpress.org/plugins/version-info/)**: Show WP, PHP, MySQL & Web Server Versions in the WP-Admin Dashboard.

**[China Payments Plugin](https://wordpress.org/plugins/wp-stripe-global-payments/)**: Accept WeChat Pay and Alipay payments from Chinese customers.   

**[Blocked in China](https://wordpress.org/plugins/blocked-in-china/)**: Check if your website is available in the Chinese mainland.  

**[Speed in China](https://wordpress.org/plugins/speed-in-china/)**: Check your website’s speed in the Chinese mainland.

== Installation ==

= Minimum Requirements =

* WordPress 4.7 or greater
* PHP version 5.6 or greater
* MySQL version 5.5 or greater

Version Info is intentionally backwards-compatible. Because the plugin's whole purpose is to surface PHP / WordPress / server-version information, the people who need it most are typically running older environments. The minimum-supported floor is set as low as the underlying code allows.

= Automatic Installation =

1. Go to **Plugins > Add New** in your WordPress admin.
2. Search for **"Version Info"** and click **Install Now**.
3. Click **Activate** and you're done — version info appears in your admin footer immediately.

= Manual Installation =

1. Download the plugin ZIP from WordPress.org.
2. Upload the `version-info` folder to `/wp-content/plugins/`.
3. Activate through the **Plugins** menu.

= Configuration =

Navigate to **Settings > Version Info** to:

* Toggle display in the Admin Bar, Dashboard Widget, and Footer
* Access PRO tabs for System Resources, Environment, Version History, Health Advisor, System Export, and Email Alerts
* Access Agency tabs for White Label, Access Control, and Error Log

For detailed setup guides, visit the **[Version Info documentation](https://docs.versioninfoplugin.com/ "Version Info documentation")**.

= Upgrading to 2.0.1 =

Version 2.0.1 restores backwards compatibility with PHP 5.6+ and WordPress 4.7+. The previous 2.0.0 release required PHP 8.1+, which was inappropriate for a diagnostic plugin whose users are most often on older environments. No functionality was removed — only the language-level features were refactored. Always backup your site before updating. See the [upgrade guide](https://docs.versioninfoplugin.com/getting-started-installation-and-setup "Version Info 2.0 upgrade guide") for details.

== Frequently Asked Questions ==

= Is this plugin lightweight? Will it slow down my site? =

Absolutely not. The free version uses only native WordPress functions (`get_bloginfo()`, `phpversion()`, `$wpdb->get_var()`) and has near-zero performance impact. The PRO version uses the WordPress Transients API and Heartbeat API to ensure monitoring never blocks page loads or strains your server. Read more about the [performance architecture](https://docs.versioninfoplugin.com/advanced-configuration-known-plugin-conflicts "Version Info performance documentation").

= Does it work on WordPress Multisite? =

Yes! The free version works on a per-site basis. PRO adds a dedicated **Network Admin > Settings > Version Info** page that shows WP, PHP, MySQL versions, and database sizes for every site on the network in a single table.

= Which hosting environments can the Environment Indicator detect? =

It auto-detects: `WP_ENVIRONMENT_TYPE` (WordPress 5.5+ core), `WP_ENV` (Bedrock/Trellis), `KINSTA_ENV_TYPE`, `WPE_ENVIRONMENT` and `IS_WPE_SNAPSHOT` (WP Engine), `PANTHEON_ENVIRONMENT`, `FLYWHEEL_CONFIG_DIR`, and falls back to "Production" for unrecognized hosts. See the [full compatibility list](https://docs.versioninfoplugin.com/pro-features-environment-indicators "Version Info environment detection documentation").

= Can I use this to debug PHP errors remotely? =

Yes! PRO includes a **PHP Error Log Dashboard** that reads your `debug.log` file directly inside WordPress — no FTP or SSH access needed. It shows the last 100 lines efficiently and lets you download the full log as a ZIP.

= Is the PRO version compatible with WordPress.org guidelines? =

Yes. The free version hosted on WordPress.org contains zero premium code. All PRO features are delivered via the Freemius SDK update mechanism and are clearly separated using the `@fs_premium_only` deployment directive.

= How does the Health Advisor work? =

It integrates with the native **WordPress Site Health** screen by hooking into the `site_status_tests` filter. It checks your current PHP and MySQL versions against known End-of-Life (EOL) dates and flags them as Critical (past EOL), Warning (within 6 months), or Good (actively supported).

= Can my clients see the version information? =

By default, only administrators can see version data. With PRO, you get a **Role-Based Visibility** matrix that lets you choose exactly which roles (Editor, Author, Shop Manager, etc.) can see version info. You can also completely white-label the plugin so clients never know it exists.

= How do email alerts work? =

The PRO plan (previously Agency — existing Agency customers keep it) monitors for version changes on every `admin_init` and via `upgrader_process_complete`. When a change is detected (e.g., PHP 8.1 → 8.2, or a plugin update), it sends a plain-text email to your configured recipients listing what changed, the old version, the new version, and the timestamp.

= Is this plugin developer-friendly? =

Extremely. Every data point fires a WordPress filter (e.g., `version_info_wp_version`, `version_info_mysql_version`). Every render point fires an action. The architecture uses a `ProviderInterface` so you can register custom data providers. The codebase deliberately avoids language features that would lock out legacy hosts, so the plugin still installs on PHP 5.6+. See the [developer documentation](https://docs.versioninfoplugin.com/advanced-configuration-hooks-and-filters "Version Info developer docs") for the complete hooks reference and provider API.

= Where can I find documentation? =

Complete documentation, setup guides, and developer references are available at **[docs.versioninfoplugin.com](https://docs.versioninfoplugin.com/ "Version Info documentation")**.

= Where can I get support? =

Free users can use the [WordPress.org support forum](https://wordpress.org/support/plugin/version-info/ "Version Info support forum"). PRO and Agency customers receive [priority support](https://versioninfoplugin.com/ "Version Info priority support").

== Screenshots ==

1. **Live System Resources HUD** *(2.0.2+ PRO)* — The full dashboard widget with 30+ rows: identity (Environment, Server Location, OS, Hostname, IP, Port, Document Root, Uptime), live CPU and Memory bars with inline-SVG sparklines, Disk usage, Database stats, PHP runtime info, WP status, and more — all on every dashboard load.
2. **Settings Page** — Clean, tabbed interface following native WordPress admin design. General tab with display toggles for admin bar, footer, and dashboard widget.
3. **Server Location Tab** *(2.0.2+ PRO)* — Choose between 4 geolocation providers: Version Info Geolocation (anonymous Cloudflare Worker, default), Cloudflare cdn-cgi/trace, ip-api.com, or MaxMind GeoLite2. Results cached 30 days with a "Detect now" button.
4. **Environment Badges** — Color-coded Production (red), Staging (orange), and Development (green) indicators in the Admin Bar.
5. **System Resources Tab** — Real-time CPU and RAM monitoring with visual percentage bars and database size breakdown.
6. **Version History** — Timeline view of every WordPress, PHP, MySQL, plugin, and theme version change with timestamps.
7. **Health Advisor** — Predictive EOL alerts for PHP and MySQL integrated into the plugin settings and WordPress Site Health.
8. **Admin Footer** — How version info appears at the bottom of every admin page with optional WP update link.
9. **Network Dashboard** — Multisite overview showing versions and database sizes for every site (PRO).
10. **White Label** — Rebrand the plugin name, author, and hide Freemius menus for a seamless client experience (PRO). Optional: lock to current user, hide doc links sitewide.
11. **Error Log Viewer** — In-dashboard PHP error log with masked paths and ZIP download (PRO).
12. **System Export** — One-click JSON download with a full preview table of your technical stack (PRO).

== Changelog ==

= 2.1.0 (2026-08-19) =

* Added: Memory usage and server IP in the admin footer, admin bar and dashboard widget.
* Added: PHP end-of-life countdown, and a Copy as Markdown button for support tickets.
* Added (PRO): SSL certificate expiry warnings in Health Advisor and Site Health.
* Improved (PRO): System Change Email Alerts is now included in PRO, not just Agency.
* Fixed: Agency trial users now see their Agency tabs unlocked.
* Compatibility: Tested up to WordPress 7.1. Updated Freemius SDK.

See changelog.txt for the full version history.

== Upgrade Notice ==

= 2.1.0 =
Memory usage, server IP, PHP EOL countdown, and Copy-as-Markdown are now FREE. PRO gains SSL certificate expiry alerts and the WP 7.0 PHP support matrix; Email Alerts move from Agency to PRO (existing Agency customers keep everything). Safe upgrade; PHP 5.6+/WP 4.7+ unchanged.

= 2.0.1 =
Backwards-compatibility release. Minimum PHP lowered from 8.1 to **5.6**; minimum WordPress lowered from 5.5 to **4.7**. No features removed — Version Info is a diagnostic plugin, so it now actually installs on the legacy environments it was built to diagnose. Safe upgrade for anyone on 2.0.0.

= 2.0.0 =
Major upgrade! Requires PHP 8.1+. Adds PRO features (CPU/RAM monitoring, DB tracking, environment indicators, health advisor, system export) and Agency features (white-labeling, role controls, network dashboard, email alerts, error log viewer). Backup before updating.