=== Consortia Quick Find & Replace ===
Contributors: tommyhansen21
Tags: find, replace, search, text replacement, editor
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 2.1.33
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Find, highlight, and replace text in the current post, page, docs entry, or WooCommerce product without leaving the editor.

== Description ==

Consortia Quick Find & Replace adds a compact find and replace tool to the editor so you can clean up content without switching screens or editing HTML by hand.

This free version is built for fast, safe editing in the current document only. It is ideal for the kind of cleanup work editors do every day:

* fix repeated words or phrases
* update outdated wording in a long article
* clean up product descriptions
* replace text in the title and content while reviewing a draft

You can search for text, move between matches, replace the current match, replace all matches in the open document, and undo the last replacement before saving normally in WordPress.

Matches are highlighted in supported editor views, with a stronger highlight for the active match when using Previous or Next.

= What you get in the free version =

* Find text in the current post, page, docs entry, or product
* Highlight matches while searching
* Move through matches with Previous and Next
* Replace the current match or replace all matches in the open document
* Undo the last replacement in the current editor session
* Optionally include the title in replacements
* Use case-sensitive or case-insensitive matching
* Work in the block editor, classic editor, and text editor

= Why editors like it =

* Works where you are already writing
* Safer than running a site-wide or database-wide replace
* Fast for one article, one page, or one product at a time
* Easy to review before you save the document
* Useful even if you only need it occasionally

= Important =

This plugin does not run site-wide or database-wide replacements.

It only changes the content that is currently open in the editor. WordPress does not save those changes until you click Update, Publish, or Save Draft.

= Available in Pro =

If you later need a faster editing workflow, Quick Find & Replace Pro is designed to add more convenience tools for repeated content work.

Depending on the package and release stage, Pro-oriented workflow features may include:

* saved presets for common find and replace pairs
* replacement history
* undo all changes in the current session
* remembered values and workflow preferences
* a draggable floating panel
* extra WooCommerce field support, including short descriptions

== Features ==

* Fast editor-side find and replace for the current document
* Visible match highlighting with a stronger active match state
* Previous and Next navigation between matches
* Replace one match or replace all matches in the open document
* Undo the last replacement before saving
* Optional title replacement
* Match case toggle
* WooCommerce product main content support
* No site-wide database changes

== How It Works ==

1. Open a supported editor screen.
2. Enter a word or phrase in the Find field.
3. Review the highlighted matches.
4. Use Previous or Next to move between matches.
5. Open Replace when you want to change text.
6. Choose Replace for one match or Replace all for the current document.
7. Use Undo last change if the replacement was not what you wanted.
8. Save, update, publish, or discard the document through WordPress as usual.

The plugin changes the open editor content only. WordPress does not save those changes until you save the document.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/consortia-quick-find-replace/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Open or create a post, page, docs entry, or product
4. Use the "Quick Find & Replace" meta box in the editor sidebar
5. Save or update the document normally after making changes

== Frequently Asked Questions ==

= Where does the tool appear? =

Quick Find & Replace appears inside supported editor screens for posts, pages, docs entries, and WooCommerce products.

= Does this change content across the whole site? =

No. The current free version works on the document you are editing. It does not run database-wide replacements.

= Why is that important? =

That makes the plugin easier to review before saving. You can see the changes in the current editor, confirm they look right, and then save the document normally in WordPress.

= Do I need to save after replacing text? =

Yes. The plugin changes the open editor content, then WordPress saves the document when you click Update, Publish, or Save Draft.

= Why do the highlights refresh after a replacement? =

After a replacement, the editor content changes and the match list is recalculated. Use Previous or Next to focus the remaining matches again.

= Can I undo a replacement? =

Yes. Undo last change restores the most recent replacement made during the current editor session. It does not restore changes after the editor page has been reloaded.

= Can I replace in specific post types only? =

The free version currently appears on posts, pages, docs entries, and products.

= What about case sensitivity? =

The plugin offers both case-sensitive and case-insensitive search options for flexibility.

= Does it support WooCommerce products? =

Yes. The free version supports the main product content editor. More product-specific fields, such as short description and other advanced product-editing helpers, are better suited to Pro.

= Does it support custom fields? =

Not yet. The free version focuses on the open editor content and optional title replacement.

= What does Pro add? =

Pro is aimed at heavier editing workflows. Depending on the package and release stage, it may include features such as saved presets, replacement history, undo all changes in the current session, remembered values, a floating panel, and extra WooCommerce field support.

= Is the free version still useful on its own? =

Yes. The WordPress.org version is intended to remain a complete and useful editor tool for single-document find and replace work.

== Screenshots ==

1. Find and highlight repeated words or phrases directly inside the editor.
2. Enter replacement text, make a change, and undo the last replacement before saving.
3. Use Quick Find & Replace while editing WooCommerce product content.

== Changelog ==

= 2.1.33 =
* Remembered the Replace section open/closed state between editor loads.
* Improved keyboard flow so Tab from Find can open Replace and move focus directly into the field.

= 2.1.32 =
* Refined the Quick Find & Replace panel UI with cleaner clear buttons and a more compact match-navigation row.
* Improved Pro floating-panel behavior so docked or floating mode is remembered across refreshes.
* Improved single-replace flow and editor highlighting so navigation and visual feedback stay more consistent across title, WooCommerce, and code-editor workflows.

= 2.1.31 =
* Improved Pro floating-panel behavior so it can be closed back into the sidebar and reopened without refreshing the editor.
* Added better HTML/code editor handling for search, replace, and highlight updates.
* Added stronger WooCommerce product-description and short-description highlighting, including better Next/Previous navigation in TinyMCE fields.

= 2.1.30 =
* Fixed Replace all so title replacements stay stable when "Also replace in title" is enabled.
* Improved keyboard flow so Tab moves from Find directly into Replace when the Replace field is open.
* Refreshed the WordPress.org readme and screenshot planning materials.

= 2.1.29 =
* Built a true-free WordPress.org package that replaces locked local Pro features with dedicated free override files.
* Kept the full-featured Freemius package unchanged for Pro distribution.
* Refreshed the review build for a clean WordPress.org resubmission.

= 2.1.28 =
* Added a one-time welcome notice after activation with a quick link to the Tools page.
* Added a clearer "How it works" explanation on the plugin info page.
* Moved the plugin info page under Tools for a more natural workflow location.

= 2.1.27 =
* Internal test build for activation onboarding and Tools-page polish.

= 2.1.26 =
* Simplified the free settings screen to keep Pro visible with a lighter, review-friendly upgrade notice.
* Replaced direct AJAX `$_POST` reads with helper methods for more consistent request handling.
* Refreshed the WordPress.org free package for approval testing.

= 2.1.25 =
* Rebuilt fresh Freemius and WordPress.org packages after the review fixes and slug alignment.

= 2.1.24 =
* Aligned the plugin folder, bootstrap file, text domain, and Freemius slug with the assigned WordPress.org slug.
* Updated contributor and naming details for the WordPress.org review process.

= 2.1.23 =
* Added Pro saved presets for reusable Find and Replace pairs.
* Added a collapsible Pro tools section that remembers its open or closed state.
* Refined the Pro tools layout and preset select width.

= 2.1.22 =
* Added Pro highlight color settings with reset to default colors.
* Improved floating panel controls and remembered search refresh behavior.
* Polished editor and settings controls.

= 2.1.21 =
* Refreshed the editor widget controls with toggle switches and button icons.
* Made the floating editor panel draggable and remembered its position.

= 2.1.20 =
* Kept the active match position more stable after replacing a single match.
* Added a clear search button to reset the current search and highlights.

= 2.1.19 =
* Renamed the editor meta box for consistent plugin branding.
* Added a Pro tool to swap Find and Replace values.

= 2.1.18 =
* Added Pro support for optional WooCommerce product short description replacements.

= 2.1.17 =
* Added tabbed settings navigation for General and Pro settings.

= 2.1.16 =
* Added settings architecture for editor workflow preferences.
* Added Pro settings for opening Replace by default, remembering editor values, and using a floating editor panel.

= 2.1.15 =
* Added Pro-only architecture for advanced editor tools.
* Added Pro-only undo all changes and replacement history foundations.

= 2.1.14 =
* Added WordPress.org release packaging support.
* Documented match highlight refresh behavior after replacements.

= 2.1.13 =
* Updated the plugin display name for WordPress.org naming guidelines.

= 2.1.12 =
* Added Freemius basename handling for free/pro activation compatibility.

= 2.1.11 =
* Updated Freemius bootstrap for the new paid Pro plan.

= 2.1.10 =
* Added guarded Freemius bootstrap support.

= 2.1.9 =
* Refactored the plugin bootstrap into a Pro-ready architecture.

= 2.1.8 =
* Added Undo last change for the current editor session.

= 2.1.7 =
* Added a broader iframe fallback for WooCommerce product editor highlighting.

= 2.1.6 =
* Fixed search input focus so typing a search term does not jump into the editor content.

= 2.1.5 =
* Added highlight support for iframe-based block editor canvases.

= 2.1.4 =
* Added Gutenberg visual highlighting using browser-native CSS highlights where available.
* Added block editor title support when "Also replace in title" is enabled.

= 2.1.3 =
* Added soft yellow match highlighting with a stronger active match color for title and plain text editor searches.

= 2.1.2 =
* Moved admin JavaScript into `assets/js/admin.js`.
* Moved admin CSS into `assets/css/admin.css`.
* Aligned the readme with the current document-level editor workflow.
* Fixed asset loading for product edit screens.

= 2.1.1 =
* Initial release
* Basic current-document find and replace functionality

== Support ==

For help with the free version, please use the WordPress.org support forum for this plugin.
