=== 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.2
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, Critical, 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 critical, error, warning, 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.


== 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. Freedomification Log Inspector main screen with selected logs and safe tail preview.
2. Find, filtering and copy controls.
3. Common log location scanner.

== Changelog ==

= 1.6.2 =
* Added a dedicated Critical filter and made severity filters match their own summary counters exactly.
* Improved detection of common bracketed, timestamped and channel-prefixed severity formats.

= 1.6.1 =
* Cleaned up WordPress.org readme and settings copy.

= 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.2 =
Adds a dedicated Critical filter and makes severity filters match their summary counters more exactly.

= 1.6.1 =
Cleans up WordPress.org readme and settings copy.

= 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.
