=== AMG Labs Cron Inspector ===
Contributors: amglabs
Tags: cron, scheduled tasks, debugging, admin tools, developer
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A lightweight admin tool to inspect, monitor, and manually trigger WordPress cron events.

== Description ==

AMG Labs Cron Inspector provides a simple, secure way to view and manage WordPress scheduled events (WP-Cron) directly from your admin dashboard.

**Features:**

* **Cron Event Listing** - View all scheduled cron events in a clean, sortable table
* **Event Details** - See hook names, next run times, recurrence schedules, and instance counts
* **Visual Status Indicators** - Quickly identify healthy, irregular, or overdue cron events
* **Manual Execution** - Safely trigger any cron hook with a single click
* **Health Checks** - Automatic detection of common WP-Cron issues

**Security First:**

* Read-only inspection (no modification or deletion of cron jobs)
* Nonce verification on all actions
* Capability checks requiring 'manage_options'
* No external requests or telemetry
* No file system writes

**Perfect For:**

* Developers debugging cron-related issues
* Site administrators monitoring scheduled tasks
* Troubleshooting plugins that rely on WP-Cron

== Installation ==

1. Upload the `amglabs-cron-inspector` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Navigate to Tools > Cron Inspector to view your scheduled events

== Frequently Asked Questions ==

= Is this plugin safe to use on production sites? =

Yes. AMG Labs Cron Inspector is read-only by design. It cannot modify or delete cron events. The only action it performs is manually triggering existing hooks, which requires admin capability and nonce verification.

= What does "overdue" mean? =

A cron event is marked as overdue when its scheduled run time has passed but the event hasn't been executed yet. This can happen when:

* `DISABLE_WP_CRON` is set to true
* No site traffic has occurred to trigger WP-Cron
* A cron event is taking too long to execute

= What does DISABLE_WP_CRON mean? =

When `DISABLE_WP_CRON` is set to `true` in your wp-config.php, WordPress will not automatically run scheduled events on page loads. This is typically done when using a server-side cron job (recommended for high-traffic sites).

= Can I delete cron events with this plugin? =

No. AMG Labs Cron Inspector is intentionally read-only to prevent accidental data loss. To delete cron events, use the WordPress function `wp_unschedule_event()` or a plugin designed for cron management.

= Does this plugin work with Multisite? =

Yes, but it only shows cron events for the current site. Network admins can view cron events on each site individually.

== Changelog ==

= 1.0.0 =
* Initial release
* Cron event listing with sorting
* Visual status indicators (healthy, irregular, overdue)
* Manual execution with nonce protection
* WP-Cron health check notifications

== Upgrade Notice ==

= 1.0.0 =
Initial release of AMG Labs Cron Inspector.
