=== WEUX Content Finder ===
Contributors: weuxstudio
Tags: search, content search, block editor, site editor, elementor
Requires at least: 7.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.4.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Find text across WordPress content, templates, patterns, navigation, and supported builder data, then jump to the right editor.

== Description ==

WEUX Content Finder helps you answer a common WordPress editing question: "Where do I edit this text?"

Visit **[contentfinderwp.com](https://contentfinderwp.com)** for more information, documentation, and the Pro version.

WordPress content can live in posts, pages, custom post types, block templates, template parts, synced patterns, navigation menus, theme files, and builder metadata. WEUX Content Finder searches these places from one admin screen and returns direct edit links wherever WordPress provides a safe editor target.

= What the free version searches =

* Posts, pages, and public custom post types
* Block templates (`wp_template`)
* Template parts (`wp_template_part`)
* Synced patterns (`wp_block`)
* Block navigation (`wp_navigation`)
* Classic menu items when the active theme supports classic menus
* Block theme template files and referenced theme patterns
* Elementor page data, with a direct "Edit in Elementor" link when Elementor content is detected

= Block theme support =

For block themes, WEUX Content Finder can search files from the active theme:

* `templates/*.html`
* `parts/*.html`
* referenced `patterns/*.php`

Theme-file results link as precisely as WordPress allows. Template files open the matching Site Editor template, template part files open the matching template part, and theme patterns link to the template or template part where they are used.

= Editing workflow =

1. Open **WEUX Content Finder** in the WordPress admin menu.
2. Enter the exact text you want to find.
3. Filter by content type when needed.
4. Review the result type, match count, snippet, status, and modified date.
5. Click the edit button to open the best available editor target.

= Keyboard access =

When the WordPress Command Palette API is available, WEUX Content Finder registers an "Open WEUX Content Finder" command. You can use the WordPress command palette shortcut and jump to the WEUX Content Finder screen.

= Optional Pro upgrade =

Search is free and unlimited.

WEUX Content Finder Pro is a separate package that adds preview-first Search and Replace, ACF field search and replace, and batch undo. The WordPress.org free package does not include executable Pro mutation endpoints.

== Installation ==

1. Upload the `weux-content-finder` folder to `/wp-content/plugins/`, or install the plugin from the WordPress plugin directory.
2. Activate **WEUX Content Finder** from the **Plugins** screen.
3. Open **WEUX Content Finder** in the WordPress admin menu.
4. Enter a search term and press **Search**.

There are no required settings for search.

== Frequently Asked Questions ==

= Does WEUX Content Finder work with classic themes? =

Yes. WEUX Content Finder searches posts, pages, public custom post types, and classic menu items when the active theme supports classic menus.

Theme-file search and Site Editor deep links are only available for block themes because classic themes do not expose the same editable Site Editor entities.

= Does WEUX Content Finder work with block themes? =

Yes. WEUX Content Finder searches block templates, template parts, navigation, synced patterns, and referenced theme files in block themes.

= Does WEUX Content Finder work with Elementor? =

Yes. WEUX Content Finder searches Elementor page metadata and opens matching Elementor pages with an **Edit in Elementor** link when Elementor data is detected.

= Does WEUX Content Finder replace database search and replace plugins? =

No. WEUX Content Finder is an editor-focused content location tool. It shows where matching text lives and provides edit links. Database migration tools are still better for low-level URL or serialized data migrations.

= Can the free version replace content? =

No. The WordPress.org free version provides search and edit links only. Preview-first Search and Replace, ACF field actions, and batch undo are available in the separate Pro package.

= Does the free version search ACF fields? =

The free version may show a count-only notice when matching ACF fields exist, but it does not expose ACF field values or field-level snippets. Full ACF field search and replace is available in Pro.

= Does the plugin send search queries to an external service? =

No. Search runs inside your WordPress site.

= Does the plugin connect to an external service? =

Only if you open the license screen and submit a Pro license key. License activation, validation, and deactivation requests are sent to Lemon Squeezy for optional Pro licensing. The request includes the license key and the site instance name, which is based on your site URL. Lemon Squeezy terms and privacy information are available at https://www.lemonsqueezy.com/terms and https://www.lemonsqueezy.com/privacy. This is not required for free search.

= What capability is required to search? =

Users need the `edit_posts` capability to use search endpoints and the admin search interface.

== Screenshots ==

1. WEUX Content Finder search results with type badges, match snippets, and direct edit links.
2. WEUX Content Finder results filtered by content type.

== Changelog ==

= 0.4.5 =
* Reworked the Pro replacement preview into a larger review dialog with sticky actions and clearer diffs.

= 0.4.4 =
* Improved Pro replacement preview layout for larger result sets and collapsed recent replace jobs by default.

= 0.4.3 =
* Added selectable Pro replacement preview items with Select all and Clear controls.

= 0.4.2 =
* Fixed Pro Cmd+K overlay behavior when the native WordPress Command Palette is already open.

= 0.4.1 =
* Added Pro global Cmd+K Content Finder overlay with live search, edit links, and Replace navigation.

= 0.4.0 =
* Added Pro ACF field search for supported text-like fields.
* Added Pro ACF field replacement through the preview-first replacement workflow.
* Added replacement diffs, confirmed replacement tokens, replace job history, and batch undo.
* Added count-only ACF match teasers for the free package without exposing ACF field values.

= 0.3.2 =
* Moved admin JavaScript and Command Palette integration to WordPress-enqueued assets.
* Prefixed plugin declarations, stored license data, admin actions, nonces, REST namespace, and script handles.
* Added stricter per-item permission filtering for REST search results.
* Removed Pro mutation route registration from the WordPress.org free package.
* Removed invalid plugin metadata URLs and excluded WordPress.org directory assets from the plugin package.

= 0.3.1 =
* Added more precise Site Editor links for block theme templates, template parts, and referenced theme patterns.
* Added Elementor metadata search with direct Elementor edit links.
* Added clearer result type badges and highlighted search matches.
* Added a local theme compatibility matrix for common WordPress theme stacks.
* Updated packaging for a cleaner WordPress.org free build.

= 0.3.0 =
* Rebuilt the admin interface with type filters, loading states, empty states, and safer output rendering.
* Added preview-first Pro replacement flow in the separate Pro package.
* Hardened REST permissions and per-item edit checks.
* Improved result metadata, post type labels, and match-context snippets.
* Added local wp-env setup and safer packaging.

= 0.2.0 =
* Added Pro licensing infrastructure.
* Added the separate Pro package architecture.

= 0.1.0 =
* Initial release.
* Added text search across posts, pages, custom post types, templates, template parts, navigation, and synced patterns.
* Added the WEUX Content Finder admin page.
* Added REST API search endpoint.

== Upgrade Notice ==

= 0.4.5 =
Adds a larger Pro replacement review dialog.

= 0.4.4 =
Improves the Pro replacement preview layout for larger result sets.

= 0.4.3 =
Adds selectable Pro replacement preview items.

= 0.4.2 =
Fixes Pro Cmd+K overlay behavior with the native WordPress Command Palette.

= 0.4.1 =
Adds the Pro global Cmd+K Content Finder overlay.

= 0.4.0 =
Adds Pro ACF field search and replace, replacement diffs, and batch undo.

= 0.3.0 =
Improves the admin interface, result metadata, and Pro replacement safety.
