=== Source Lens – Code Finder ===
Contributors: optimatioseo
Website: https://optimatio.io
Tags: strings locator, code finder, find a code, find code in wp, code finder tool

Requires at least: 5.8
Stable tag: 1.0.2
Tested up to: 6.9
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html


== Short Description ==
Find where code lives in WordPress. Search functions, hooks, shortcodes and strings across themes and plugins.


== Description ==

**Source Lens – Code Finder** is the ultimate code search tool for WordPress. It helps developers and site owners locate where any code lives in their WordPress installation – whether it's in theme files, plugin files, the database, or even dynamically injected by other plugins.

= Two Powerful Search Modes =

**1. Find Code/Strings** – Search for any text, function, hook, shortcode, or code snippet inside files. Perfect for finding where a specific piece of code is used.

**2. Find File by Name** – Search for files by their name (e.g., `header.php`, `functions.php`, `style.css`) and view their full source code instantly.

= Key Features =

* **Search Everywhere** – Search across themes, plugins, WordPress core, and the database
* **View Full Source Code** – Find any file by name and view its complete source code
* **Find Dynamically Injected Code** – Detects code added by other plugins (like Google Tag Manager scripts from code snippet plugins)
* **Multiple Search Types** – Auto-detect, text string, function, hook, shortcode, class, regex, constant, CSS, and HTML
* **Page Builder Support** – Search inside Elementor, Divi, Beaver Builder, and Gutenberg blocks
* **WooCommerce Support** – Search products, orders, settings, and WooCommerce-specific data
* **Code Snippets Detection** – Finds code stored in popular snippet plugins (WPCode, Code Snippets, Insert Headers and Footers, etc.)
* **Safe & Read-Only** – Never modifies any files on your server

== Installation ==

1. Upload the `source-lens-code-finder` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the "Plugins" menu in WordPress.
3. Navigate to **Tools → Source Lens – Code Finder** to start searching.

== How to Use ==

= Finding Code or Text Strings =

1. Go to **Tools → Source Lens – Code Finder**
2. Make sure **"Find Code/Strings"** mode is selected (default)
3. Enter your search query. Examples:
   * `add_action` – Find all uses of the add_action function
   * `wp_enqueue_script` – Find where scripts are enqueued
   * `GTM-XXXXXX` – Find your Google Tag Manager container ID
   * `[contact-form]` – Find where a shortcode is used
   * Any text or code snippet you want to locate
4. Choose a **Search Type** (Auto Detect works for most cases)
5. Choose a **Search Scope** (Everything, specific theme, specific plugin, etc.)
6. Click **Search** to find all matches

= Finding Files by Name =

1. Go to **Tools → Source Lens – Code Finder**
2. Click **"Find File by Name"** mode
3. Enter a file name. Examples:
   * `header.php` – Find all header.php files
   * `functions.php` – Find all functions.php files
   * `style.css` – Find all style.css files
   * `elementor` – Find all files with "elementor" in the name
4. Click **Search** to see matching files
5. Click **"View Source Code"** on any file to see its full contents

= Advanced Options =

* **Case Sensitive** – Match exact letter casing
* **Whole Word** – Only match complete words
* **Regex Mode** – Use regular expressions for complex patterns
* **Search Encoded** – Find base64 encoded content
* **Search Runtime** – Find dynamically injected code from other plugins

== Frequently Asked Questions ==

= Does the plugin modify files? =
No. Source Lens – Code Finder is completely read-only and never changes any files on your server. It only reads and displays code.

= Can I find code added by other plugins? =
Yes! The plugin can detect code injected by other plugins through WordPress hooks. This includes tracking codes (Google Tag Manager, Analytics), code snippet plugins (WPCode, Code Snippets), and more.

= What file types can I search? =
PHP, JavaScript, CSS, HTML, JSON, XML, Markdown, SCSS, LESS, and template files.

= Can I view the full source code of a file? =
Yes! Use the "Find File by Name" mode, search for the file, and click "View Source Code" to see the complete file contents.

= What PHP version do I need? =
The plugin requires PHP 7.4 or later.

= Is it safe to use on a live site? =
Yes, the plugin is completely safe. It only reads files and database content – it never writes or modifies anything.

== Screenshots ==

1. Main search interface with two search modes
2. Code search results with highlighted matches
3. File search results with source code viewer
4. Advanced search options

== Changelog ==

= 1.0.2 =

* Two search modes: Find Code/Strings and Find File by Name
* Search across themes, plugins, WordPress core, and database
* View full source code of any file
* Detect dynamically injected code from other plugins
* Support for page builders (Elementor, Divi, Beaver Builder, Gutenberg)
* WooCommerce integration
* Code snippets plugin detection
* Advanced search options (regex, case sensitive, whole word)
