=== Site CliniQ — AI Site Health & Error Diagnosis ===
Contributors: bilalmahmooddev
Tags: site health, php errors, SEO audit, broken links, AI diagnosis
Requires at least: 6.3
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Your WordPress site doctor — AI-powered health scanner that explains every PHP error, SEO issue, broken link, and plugin problem in plain English.

== Description ==

**Site CliniQ** is the only WordPress plugin that scans your entire site and explains every issue in plain English — no more staring at cryptic error logs or guessing which plugin is breaking your site.

Run a full scan in one click and get a clear health score, actionable fixes, and a complete picture of what's wrong and why.

**Site Health Dashboard**

See your site's overall health score at a glance — with a visual score ring, system status indicators (WordPress Core, Plugins, Themes, Server), detected issue counts, and live status badges. Everything you need to understand your site's health in one screen.

**Core Features (Free)**

* **AI Error Diagnosis** — Reads your PHP error log and explains each error in plain English with a root cause and step-by-step fix. Requires your own Claude API key (optional — all other features work without it).
* **Site Health Score** — A–F grade calculated from PHP version, memory limit, WordPress version, SSL status, debug mode, and server configuration.
* **Plugin Health Checker** — Flags plugins abandoned for 2+ years or not tested with your current WordPress version before they cause problems.
* **Plugin Bloat Detector** — Ranks every active plugin by its JavaScript and CSS payload so you know exactly which one is slowing your site down.
* **Update Risk Scorer** — AI reads each plugin's changelog and scores the pending update as Safe, Caution, or High Risk before you click Update.
* **Image Size Audit** — Finds every image over 500 KB and shows which posts and pages use it so you know exactly where to optimize.
* **Alt Tag Auditor** — Scans your Media Library and post content for missing alt text. Edit and save alt text directly inside the plugin without leaving the dashboard.
* **SEO Checks** — Site-wide audit for missing meta descriptions, H1 issues, noindex pages, thin content, and duplicate title tags.
* **Broken Link Report** — Crawls up to 100 published URLs and flags every 404, server error, and long redirect chain.
* **Email Health Report** — Send a formatted summary of all issues to your admin email with one click.

**Works Without an API Key**

Every scan feature — health score, plugin audits, image audit, SEO checks, broken links — runs completely without any API key. The Claude API key is optional and only used to add plain-English AI explanations to PHP error entries.

**No Front-End Impact**

Site CliniQ runs exclusively in the WordPress admin. Nothing is loaded on your public-facing site. Your visitors are never affected.

**Your Data Stays Yours**

PHP error messages are sent to the Anthropic Claude API only when you supply your own API key. No data is sent to Site CliniQ servers. No accounts required. No monthly fees for the core scanner.

**External Services**

This plugin connects to the following external services:

* **Anthropic Claude API** (api.anthropic.com) — Used optionally to generate plain-English explanations for PHP errors. Only called when you provide your own API key and run a scan. [Terms of Service](https://www.anthropic.com/legal/consumer-terms) | [Privacy Policy](https://www.anthropic.com/legal/privacy)
* **WordPress.org Plugins API** (api.wordpress.org) — Used to fetch plugin metadata for the Plugin Health Checker and Update Risk Scorer. No API key required. [Privacy Policy](https://wordpress.org/about/privacy/)
* **WordPress.org Core API** (api.wordpress.org) — Used to check the latest WordPress core version. No API key required. [Privacy Policy](https://wordpress.org/about/privacy/)

== Installation ==

1. Upload the `site-cliniq` folder to `/wp-content/plugins/`
2. Activate the plugin via **Plugins → Installed Plugins**
3. Go to **Site CliniQ** in the left admin menu
4. Click **Run Full Scan** on the Dashboard
5. Optionally go to **Settings** and enter your Claude API key to enable AI explanations

== Frequently Asked Questions ==

= Do I need a Claude API key? =
No. All scan features run without any API key. The Claude API key is optional and only unlocks AI-powered plain-English explanations for PHP error log entries. You can get a free API key at console.anthropic.com.

= Does this plugin work on shared hosting? =
Yes. Site CliniQ works on any WordPress host — shared hosting, managed WordPress (WP Engine, Kinsta, Flywheel), VPS, and cloud. No special server configuration is required.

= Will this slow my site down? =
No. The plugin only runs scans when you click "Run Full Scan" from the admin dashboard. Nothing is loaded on the front end and no background scans run without your permission.

= Is my data sent to any server? =
PHP error messages are sent to the Anthropic Claude API only if you provide your own API key and trigger a scan. No data is sent to Site CliniQ servers. No personally identifiable visitor data is ever collected or transmitted.

= What PHP version is required? =
PHP 8.0 or higher. WordPress 6.3 or higher.

= Can I use this on client sites? =
Yes. There are no per-site restrictions on the free version.

== Screenshots ==

1. Site Health Dashboard — score ring, system status, detected issues, and status badges.
2. PHP Error tab — AI-explained errors with root cause and step-by-step fix instructions.
3. Plugins tab — health checker and update risk scorer.
4. SEO tab — site-wide meta, H1, noindex, and thin content audit.
5. Settings — optional Claude API key configuration.

== Changelog ==

= 1.0.2 =
* Added visual Site Health Dashboard with score ring, system status panel, and detected issues summary.
* Improved dashboard layout to match banner design.

= 1.0.0 =
* Initial release — full site scanner, AI error diagnosis, health score, plugin health checker, bloat detector, update risk scorer, image audit, alt tag auditor, SEO checks, broken link report, email report.

== Upgrade Notice ==

= 1.0.2 =
New visual dashboard with health score ring and system status panel.
