=== OutPlug ===
Contributors: lensdigital
Tags: monitor
Requires at least: 6.8
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

OutPlug scans your WordPress site for outdated plugins and alerts you when updates are overdue.  

== Description ==

OutPlug helps WordPress site owners:

* Detect plugins that haven’t been updated in a configurable number of months.
* Highlight outdated plugins in the admin plugin list.
* Display stale plugins in a dashboard widget with a red exclamation mark.
* Optionally send email alerts to the site administrator when stale plugins are detected.

OutPlug is lightweight, safe, and follows WordPress best practices using the Settings API and transients for caching.

== Installation ==

1. Upload the `outplug` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to **Tools > OutPlug** to configure the settings:
   - Set the number of months before a plugin is considered stale.
   - Enable or disable email alerts to the admin.
4. Optionally create `outplug-config.php` in the plugin folder to override defaults.

== Frequently Asked Questions ==

= Does OutPlug update plugins automatically? =

No. OutPlug only monitors plugin updates and alerts the admin. Updating plugins is still a manual or automatic WordPress process.

= Can I change how many months before a plugin is considered stale? =

Yes. Either use the settings page under Tools > OutPlug or create a config file (`outplug-config.php`) with `'stale_months' => X`.

= Does OutPlug send emails? =

It can. Enable the **Send email alerts** option in the settings or via the config file `'send_emails' => true`.

== External services ==

This plugin connects to an API to obtain plugin information via the WordPress Plugin API, it's needed to show the date the plugin was last updated.

It sends the each individual plugin to the API to determine the information either when the page is loaded or when it is refreshed.

More information can be found at https://developer.wordpress.org/rest-api/


== Changelog ==

= 1.0.0 =
* Initial release
* Plugin scanning and highlighting of stale plugins
* Dashboard widget showing stale plugins
* Settings page with months/email options
* Optional debug logging

== Upgrade Notice ==

= 1.0.0 =
Initial release.

== Arbitrary Section ==

Optional configuration file: `outplug-config.php`
- `stale_months` : integer, months before plugin is considered stale
- `send_emails`  : boolean, send email alerts to admin
- `debug`        : boolean, log debug info to PHP error log