=== MV Form Usage Finder for Contact Form 7 ===
Contributors: voramahesh63
Donate link: https://wordpressfoundation.org/donate/
Tags: contact form 7, cf7, search, forms, wpcf7
Requires at least: 5.6
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Search and find which pages, posts, or other content types use a specific Contact Form 7 form, by name or by form ID.

== Description ==

**MV Form Usage Finder for Contact Form 7** solves a common headache for anyone managing a site with many Contact Form 7 forms: knowing exactly *where* a given form is actually embedded.

Instead of manually opening every page and post to check for a `[contact-form-7]` shortcode, this plugin scans your content and reports every location a form is used, complete with direct edit and view links.

= Key Features =

* **Find by form or by ID** — pick a form from a dropdown of all your Contact Form 7 forms, or type in a form ID manually.
* **Page builder aware** — scans every postmeta value on a post, not just post_content, so it detects forms embedded via the classic editor, the block editor (including CF7's own Gutenberg block), and any page builder — Elementor, Beaver Builder, SiteOrigin Page Builder, Bricks, Oxygen, Divi, WPBakery (including its base64-encoded Raw HTML element), and others — without needing a maintained list of builder-specific fields.
* **Works with hash-based shortcode IDs** — resolves and matches the SHA-1 hash identifiers Contact Form 7 5.8+ uses in shortcodes, as well as the classic numeric ID.
* **Flexible content search** — choose exactly which content types to scan: Pages, Posts, Products, Testimonials, Jobs, Forms, Businesses, Events, Books, and Exhibitions.
* **Clear results table** — see the post ID, title, publish status, content type, and quick Edit / View actions for every match.
* **Result count at a glance** — instantly see how many locations a form was found in.
* **Works with custom post types** — searches beyond core Pages and Posts to cover custom content registered by other plugins (WooCommerce Products, Testimonials, Jobs, Businesses, Events, Books, Exhibitions, and more).
* **Fast, targeted scanning** — only searches the content types you select, keeping results relevant and searches quick.
* **Simple, single-screen workflow** — no configuration required; open Contact → Form Finder and start searching.

= Who is this for? =

* Site builders and freelancers auditing client sites with many CF7 forms.
* Agencies maintaining large, multi-post-type WordPress sites.
* Anyone who has ever asked "where is this form actually used?"

== Installation ==

= Automatic installation =

1. Log in to your WordPress admin dashboard.
2. Go to **Plugins → Add New**.
3. Search for **MV Form Usage Finder for Contact Form 7**.
4. Click **Install Now**, then **Activate**.

= Manual installation =

1. Download the plugin ZIP file.
2. Go to **Plugins → Add New → Upload Plugin** in your WordPress admin.
3. Choose the ZIP file and click **Install Now**.
4. Activate the plugin through the **Plugins** menu.
5. Ensure **Contact Form 7** is installed and activated, as this plugin requires it.

= After activation =

1. Go to **Contact → Form Finder** in the WordPress admin menu.
2. Select a form from the dropdown, or enter a form ID manually.
3. Check the content types you want to search under **Search In**.
4. Click **Find Pages** to view the results.

== Frequently Asked Questions ==

= Does this plugin require Contact Form 7 to be installed? =

Yes. This plugin is an add-on for Contact Form 7 and requires it to be installed and active.

= Can I search custom post types? =

Yes. Any registered post type that stores content in the standard WordPress content field can be included in the **Search In** options, including custom post types added by other plugins.

= What happens if a form isn't found anywhere? =

The results panel will show a zero-result message, letting you know the selected form isn't currently embedded in any of the searched content types.

= Does this plugin modify my content? =

No. This plugin is read-only — it scans and reports usage but never edits your pages, posts, or forms.

= Will this slow down my site? =

No. Scanning only runs when you actively use the Form Finder tool in the admin area; it has no effect on your site's front-end performance.

== Screenshots ==

1. The Form Finder screen — select a form or enter an ID, choose which content types to search, and view results with direct Edit/View links.

== Changelog ==

= 1.0.0 =
* Initial release.
* Search by form dropdown or manual form ID.
* Support for searching Pages, Posts, Products, Testimonials, Jobs, Forms, Businesses, Events, Books, and Exhibitions.
* Results table with ID, Title, Status, Type, and Edit/View actions.

== Upgrade Notice ==

= 1.0.0 =
Initial release of MV Form Usage Finder for Contact Form 7.
