=== Freedomification Log Inspector ===
Contributors: marasmaras
Donate link: https://freedomification.com/
Tags: logs, debug, viewer, wp-debug, troubleshooting
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.6.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Freedomification Log Inspector is a lightweight, admin-only log viewer for safely reading and searching selected local log files in wp-admin.

== Description ==

Freedomification Log Inspector helps you inspect selected local log files directly in WordPress admin. It is designed for site owners, administrators and developers who need a quick, safe way to review recent log output and troubleshoot issues.

Key principles:
* Admin-only access (capability checks).
* Safe output escaping (no unsafe rendering of log content).
* Audit-friendly implementation with capability checks, nonces and input sanitization.
* Performance-aware loading (tail/limited lines, no full file reads in UI).
* Local operation: log content is not sent to an external service.

= Features =
* Add and organize selected log files.
* Scan common log locations inside `wp-content`.
* Show a limited tail of each file to avoid loading large logs.
* Refresh the visible log content without reloading the whole admin page.
* Optional Live Log Stream visibility control in plugin settings.
* File size badge for quick context before opening or refreshing a log.
* Mini Health Bar for quick counters in the currently loaded log preview.
* Quick Severity Filter: All, Errors, Warnings, Info and Custom.
* Find text with match-case, whole-word and alternate-phrase options.
* Navigate highlighted error lines and copy a line, selection or nearby context.
* Highlight common PHP/WordPress severity formats and custom keywords.
* Manage Custom keywords for user-defined words or phrases.
* Summarize severity and custom matches in the currently loaded lines.
* Filter the currently loaded lines by errors, warnings, info or custom matches.
* Switch between Standard and Comfort log-window heights.
* Show only new content after setting a local baseline.
* Choose between Terminal, Light, Midnight and Solarized log styles.

= Notes about security and paths =
This plugin is intended for administrators. For safety, sensitive filesystem details may be masked in the UI. Log content itself may contain file paths written by other plugins/themes; this plugin does not modify log content.

= Separate PRO plugin =
A separate PRO plugin is available from Freedomification for advanced reporting, alerts, webhooks, maintenance workflows and extended log monitoring.

== Installation ==

1. Upload the plugin folder to the `/wp-content/plugins/` directory, or install via the Plugins screen in WordPress.
2. Activate the plugin through the 'Plugins' screen.
3. Open the dedicated `Freedomification Log Inspector` menu in wp-admin.

== Frequently Asked Questions ==

= Does it read the entire log file? =
No. The viewer is designed to display only the last N lines where possible to avoid loading huge files.

= Can non-admin users access logs? =
No. Access is restricted to users with the required capability (administrator by default).

= Why are some paths masked in the UI? =
To avoid exposing sensitive server paths in wp-admin screenshots and UI. Log content may still include paths produced by PHP/WordPress or other plugins.

= Where are my logs? =
Common locations include `wp-content/debug.log` (if WP_DEBUG_LOG is enabled) or server-specific error logs. Your hosting provider may store them elsewhere.

== Screenshots ==

1. Main viewer for safely reading selected local log files directly in WordPress admin.
2. Add and manage selected local log files for quick access inside the dashboard.
3. Highlight useful phrases such as warnings, cron activity, scheduled tasks or custom debug messages.
4. Search and inspect log content more quickly when looking for specific events, phrases or repeated issues.
5. Useful for reviewing recurring warnings, cron-related activity and custom phrases recorded in local log files.

== Changelog ==

= 1.6.0 =
* Added a compact loaded-lines summary for severity and custom keyword matches.
* Added Mini Health Bar counters and quick client-side severity filtering for the currently loaded lines.
* Added Standard and Comfort log-window height presets.
* Added Custom keywords naming for user-defined words and phrases.
* Added file size context and plugin settings for showing/hiding Live Log Stream and Find.
* Kept all summary and filtering work local to the content already loaded in wp-admin.

= 1.5.0 =
* Improved Add Log validation notices.
* Updated i18n readiness and bundled translations.
* Safer uninstall/data retention behavior.
* Added safer first-run guidance and clarified local log handling.
* Improved structured severity highlighting and publication metadata.
* Settings cleanup and UI/UX polish.

= 1.0.0 =
* Initial public release.

== Upgrade Notice ==

= 1.6.0 =
Adds Mini Health Bar counters, quick severity filtering, Custom keywords naming, file size context and Comfort View for everyday log work.

= 1.5.0 =
Improves first-run guidance, validation notices, severity highlighting, translations, uninstall safety and UI polish.

= 1.0.0 =
Initial release.
