=== WPFalcons String Finder & Debug Toolkit ===
Contributors: WPFalcons
Tags: debug, error log, string finder, code optimizer, string locator, debug log, code audit
Requires at least: 6.4
Tested up to: 6.9
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Centralized WordPress debugging, string finding, and code optimization. Track errors, search files, and audit plugin code quality from a clean UI.

== Description ==

WPFalcons String Finder & Debug Toolkit is a modern debugging plugin for WordPress developers and site maintainers.

It gives you a centralized dashboard with powerful tools so you can quickly inspect and improve your site:

* **Debug Logs**: Track Core/PHP warnings, JavaScript runtime errors, and REST API error responses in a categorized UI.
* **String Finder**: Search for specific strings across entire plugins, themes, or your whole `wp-content` directory.
* **Code Optimizer**: Audit plugins and themes for common compatibility issues, missing security checks, and leftover debugging statements.

Logs are written to `wp-content/uploads/wpfalcons-toolkit/debug.log` and displayed in a polished React-powered admin UI designed for fast troubleshooting.

### Key Features

* Advanced **String Finder** to recursively search code inside specific themes and plugins
* **Code Optimizer** to automatically scan code for missing `ABSPATH` checks, empty catch blocks, and leftover debug statements
* Debug logging toggle from WordPress admin
* Category tabs for **All**, **Core**, **JS**, and **API** logs
* Search and pagination for large log files
* React-powered admin interface with REST API data flow

### Perfect For

* WordPress plugin and theme development
* Locating hard-coded strings for translation or modification
* Auditing third-party plugin code quality and security
* QA and staging diagnostics
* Faster production issue triage

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`.
2. Activate **WPFalcons String Finder & Debug Toolkit** in **Plugins**.
3. Open **WPFalcons String Finder > Settings**.
4. Enable debugging and the channels you want (PHP, JS, REST).
5. Visit **WPFalcons String Finder > String Finder** to search through files.
6. Visit **WPFalcons String Finder > Logs** to review categorized logs.

== Frequently Asked Questions ==

= Does this require editing wp-config.php? =

No. The plugin is designed to work without manual `wp-config.php` edits for the admin-driven workflow.

= Where are logs stored? =

Logs are stored in the uploads directory: `wp-content/uploads/wpfalcons-toolkit/debug.log`.

= Can I filter logs by source? =

Yes. Use the tabs for **Core**, **JS**, and **API**.

= Is this plugin developer-friendly? =

Yes. It is built for developers and technical teams who need fast diagnostics, efficient string searching, and automated code audits.

= Can I search for a string in all my plugins at once? =

Yes, the String Finder tool allows you to search across the entire `wp-content/plugins` directory or narrow it down to a specific plugin or theme.

= What does the Code Optimizer check for? =

The Code Optimizer checks for missing direct access prevention (ABSPATH), empty catch blocks, unsafe WP_DEBUG usage, instantiating classes without existence checks, and leftover debugging statements like print_r or console.log.

== Screenshots ==

1. Logs dashboard with category tabs
2. String Finder interface for searching code
3. Code Optimizer compatibility scan results
4. Settings screen with debug channel toggles

== Changelog ==

= 1.0.0 =
* Initial release
