=== Web Plura Diagnostics ===
Contributors: wplura
Tags: diagnostics, site health, performance, email, hosting
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.2.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Business-first diagnostics and prioritized actions for site admins.

== Description ==

Web Plura Diagnostics is a free admin-only plugin that helps site owners understand:

* What is the problem?
* Why it matters
* Business impact
* What may be causing it
* Who can fix it
* What to fix first

What it includes:

* Overall advisor score and module scores
* Universal check format with problem, impact, causes, actions, ownership, and urgency
* Why This Matters and Business Impact sections for warning/critical findings
* Priority queue (`Fix First`, `Fix Soon`, `Optional Improvements`)
* Dashboard action center (`Recommended Actions`)
* WordPress Site Health-style grouped advisor view for critical issues, recommended improvements, checks needing review, and passed tests
* Beginner vs Advanced Explain Mode (stored in WordPress option)
* Beginner-friendly `What is this?` explanations
* Hosting Quality Advisor with score, strengths, weaknesses, improvements, and copyable host-support message
* Update Safety Advisor (`Safe To Update`, `Backup Recommended Before Updating`, `High Impact Updates`)
* Recovery Readiness indicator score
* Lightweight historical change tracking (`Recently Changed`)
* Settings page for retention policy, visible history count, and scheduled diagnostics scan interval
* Downloadable diagnostics exports (JSON and CSV)
* Optional scheduled diagnostics scans via WP-Cron
* WP-CLI command support for scan/export/cleanup workflows
* Multisite network dashboard surface for cross-site scan visibility
* Site health, email, performance, plugin impact, hosting, and update-risk modules
* Expanded local server checks for database version, PHP limits, timezone, URL alignment, cache signals, and key file permissions
* Plugin/theme diagnostics for inactive plugins, theme update backlog, commerce plugins, builders, and cache plugins
* Passive manual email test readiness check based on the last admin-triggered test email result
* Lead Capture Health module for local form plugin, contact page, SMTP, privacy, and form-plugin update signals
* WordPress privacy tooling compatibility for test-email metadata

Principles:

* No cloud requirement
* No tracking
* No aggressive popups
* No frontend impact
* Admin-only behavior

The admin dashboard includes a non-blocking WPlura Cloud benefits notice for automated monitoring and alerts. Free local checks remain available without cloud connection or a paid plan.

Product page: https://wplura.com/products/web-plura-diagnostics
Terms: https://wplura.com/terms
Privacy: https://wplura.com/privacy

Admin menu counters may show locally cached actionable findings or jobs. Counters are local-only and do not trigger scans, cloud calls, tracking, or paid gating during menu rendering.

Automatic update checks use WordPress.org by default for public packages. Direct/private WPlura builds may use signed WPlura release manifests; those checks send only the plugin slug, current version, and release channel.

== Installation ==

1. Upload the `web-plura-diagnostics` folder to `/wp-content/plugins/`.
2. Activate the plugin through the `Plugins` menu in WordPress.
3. Go to `Web Plura Diagnostics` in the admin sidebar.
4. Click `Run Diagnostics`.

== Frequently Asked Questions ==

= Does this plugin require a cloud account? =
No. It works locally inside WordPress.

= Does it send emails automatically? =
No. It only sends a manual test email when an admin explicitly clicks the button.

= Does it perform updates automatically? =
No. It only provides update-safety guidance.

= Does it collect telemetry? =
No. It stores local diagnostics cache and limited local metadata only.

== Screenshots ==

1. Advisor dashboard with priority queues
2. Site Health-style advisor checks with expandable problem, impact, and action details
3. Email advisor with test email action
4. Lead Capture Health advisor
5. Hosting advisor and provider message generator
6. Update safety advisor

== Changelog ==

= 0.2.6 =
* Improved Diagnostics check presentation so healthy results, findings, review-needed items, and active problems use clearer status-aware labels.
* Refined Lead Capture Health update-status copy so current form plugins are presented as a professional maintenance result, not as a problem.
* Added contextual WordPress Help Tabs and shared WPlura admin wrapper support across Diagnostics admin and network views.
* Added native WordPress heading and header-divider markup to Diagnostics admin views, including the network dashboard.
* Added WordPress-native postbox foundations to dashboard, settings, export, hosting, updates, and Lead Capture Health panels while preserving existing Diagnostics styling and local-only behavior.

= 0.2.5 =
* Updated the Site Health Advisor page with a WordPress-native grouped presentation for critical issues, recommended improvements, checks needing review, and passed tests.
* Added accessible expandable check details so admins can scan the summary first and open only the problem, impact, and action guidance they need.
* Kept the Diagnostics Health Advisor local-only with no cloud sync, tracking, paid gating, or scan work during page rendering.
* Hardened the WordPress.org-ready package so public builds rely on native WordPress.org updates and helper acceleration uses the configured local socket path only.

= 0.2.4 =
* Added local core/server diagnostics for database version, upload/post limits, max execution time, key file permissions, URL alignment, timezone, object cache, and page cache signals.
* Added passive manual email test readiness reporting based on the last admin-triggered test email result; diagnostics scans do not send email automatically.
* Added plugin/theme diagnostics for inactive plugin inventory, theme update backlog, commerce plugin detection, major builder detection, and cache plugin detection.
* Refreshed diagnostics result cache version so expanded local checks appear after upgrade.

= 0.2.3 =
* Added local-only Lead Capture Health diagnostics for form plugin detection, likely contact/lead pages, SMTP readiness, privacy policy setup, and form plugin update signals.
* Added a Lead Capture Health admin page and dashboard module score card.
* Added a basic local lead capture risk score without submitting forms, collecting leads, calling cloud APIs, or sending telemetry.
* Refreshed diagnostics result cache version so the new module appears after upgrade.

= 0.2.2 =
* Simplified dashboard microcopy and action labels for faster operator understanding (`Run Scan`, `Save View`).
* Added a recommendation-driven “What To Do Next” priority callout on the main diagnostics surface.
* Improved dashboard presentation hierarchy with a critical-issues-first summary panel and cleaner module cards.
* Refined table readability with improved spacing, sticky headers, and zebra row scanning.
* Added AJAX-based report export downloads (JSON/CSV) for smoother in-page workflow, while preserving secure nonce/cookie admin-post handling.
* Restored Web Plura Diagnostics admin colors to WordPress-default-oriented behavior and removed plugin-forced dark-mode palette overrides.
* Kept plugin styles scoped to `.web-plura-diagnostics-wrap` so WordPress admin/global color scheme behavior remains primary.
* Added forced-colors compatibility handling while preserving `prefers-reduced-motion` behavior.
* Improved network dashboard status labels and number rendering for translation and locale safety.
* Added subtle, scoped admin CSS animations across cards, notices, tables, buttons, and score counters for clearer UI feedback.
* Added `prefers-reduced-motion` safeguards so motion is automatically reduced for users who prefer minimal animation.
* Added Settings API-based admin settings page for retention, history visibility, and scheduled scan control.
* Added scheduled diagnostics scan cron workflow with configurable interval.
* Added diagnostics export actions (JSON and CSV) from WP admin.
* Added multisite network dashboard for site-level diagnostics status visibility.
* Added WP-CLI command surface: `wp web-plura-diagnostics scan`, `wp web-plura-diagnostics export`, `wp web-plura-diagnostics cleanup`.
* Added richer test-email failure details capture from `wp_mail_failed` for troubleshooting.

= 0.2.1 =
* Replaced guidance-only email DNS checks with real local SPF/DKIM/DMARC DNS verification attempts.
* Replaced legacy plugin abandonment guidance with local plugin maintenance backlog signals.
* Expanded compatibility baseline to broader supported WordPress and PHP versions.

= 0.2.0 =
* Repositioned plugin as WordPress Problem Advisor.
* Added universal advisor check format (severity, impact, causes, actions, ownership, urgency).
* Added Why This Matters and Business Impact sections for warning/critical findings.
* Added priority queues and action center recommendations.
* Added Explain Mode (Beginner/Advanced) persisted in WordPress options.
* Added hosting advisor score/strengths/weaknesses/recommendations and copyable provider message.
* Added update safety categories and recovery readiness score.
* Added lightweight historical diagnostics change tracking.
* Added dark-mode-aware admin styling via `prefers-color-scheme`.

= 0.1.0 =
* Initial release.
* Added diagnostics runner with transient caching.
* Added health, email, performance, plugin impact, hosting, and update-risk modules.
* Added recommendations page and secure admin actions.

== External Services ==

This plugin does not require external services for core functionality.

The manual test email feature uses WordPress mail transport (`wp_mail`) configured by your environment.

== Privacy ==

Web Plura Diagnostics stores local diagnostic cache, explain-mode preference, and local action metadata in WordPress options/transients.

No user tracking or telemetry is sent by default.
