=== Judaval Form Roster for Contact Form 7 ===
Contributors: shanerati
Tags: form audit, unused forms, contact form 7, website maintenance, form inventory
Requires at least: 6.4
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 0.3.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Find Contact Form 7 forms, see where each appears, track review dates, and export a site audit.

== Description ==

Judaval Form Roster gives WordPress administrators a single local roster of Contact Form 7 forms, where each form appears, and when it was last manually reviewed.

Use Judaval Form Roster for site audits, maintenance reviews, client handoffs, and finding registered forms that no longer appear on published content.

Judaval Form Roster can:

* Find registered Contact Form 7 forms.
* Show published pages and posts where each form was found.
* Flag registered forms not found on published content.
* Track the latest manual review date and highlight reviews older than 30 days.
* Export a CSV audit record for handoffs and maintenance documentation.

Current verified integration:

* Contact Form 7

Judaval Form Roster works locally inside WordPress. It does not submit forms, verify email delivery, or guarantee that every dynamically injected or unsupported placement has been discovered.

== Installation ==

1. Upload the `judaval-form-roster` folder to `/wp-content/plugins/`, or upload the ZIP in Plugins > Add New > Upload Plugin.
2. Activate “Judaval Form Roster for Contact Form 7.”
3. Open Judaval Form Roster in the WordPress administration menu.
4. Click “Scan site.”
5. Review discovered forms and record manual review dates where useful.

== Frequently Asked Questions ==

= Does Judaval Form Roster submit forms automatically? =

No. FormRoster maps supported forms and published placements. It does not submit forms or verify email delivery.

= Does the plugin read or store form submissions? =

No. It stores only discovered form metadata, placement URLs, scan timestamps, and manual review timestamps in the site's own WordPress database.

= Why might Judaval Form Roster miss a form? =

A theme or plugin may inject a form dynamically, store it in an unsupported page builder, or use a form platform not currently supported. Treat the roster as an audit aid, not a completeness guarantee.

= Is an unplaced form broken? =

Not necessarily. It may be an old form, a draft, or a form embedded dynamically. “Unplaced” means Judaval Form Roster found the registered form but did not find it on published WordPress content.

= Does Judaval Form Roster send site data to an external service? =

No. The current plugin works locally and makes no automatic external requests.

== Screenshots ==

1. See a site-wide summary and review forms that need attention first.
2. See where Contact Form 7 forms appear and identify registered forms not found on published content.
3. Track manual review dates and export a CSV audit record.

== Privacy ==

FormRoster runs locally inside WordPress.

It stores discovered form metadata, placement URLs, scan timestamps, and manual review timestamps in the site's own WordPress database.

FormRoster does not:

* Collect or store form submissions.
* Read lead messages or email contents.
* Send site data to an external service.
* Set tracking cookies.

CSV exports are generated locally when an administrator requests them. Uninstalling Judaval Form Roster removes the WordPress options created by the plugin.

== Changelog ==

= 0.3.3 =

* Renamed the plugin to Judaval Form Roster for Contact Form 7.
* Changed the plugin slug and text domain to `judaval-form-roster`.
* Preserved existing local inventory and review data from the FormRoster build.
* Uses the concise “Form Roster” label inside wp-admin with a small “by Judaval” attribution.

= 0.3.2 =

* Removed the pre-release agency-research promotion from the administrator screen.
* Limited public integration claims to the verified Contact Form 7 workflow.
* Updated plugin and readme metadata for WordPress.org submission.

= 0.3.1 =

* Changed administrator actions to fresh POST forms with explicit nonce fields.
* Rebuilds placement links from post IDs when possible so migrated or saved Playground sites do not retain obsolete URLs.
* Improved action-link reliability after restoring a saved WordPress Playground.

= 0.3.0 =

* Renamed the plugin to FormRoster.
* Reframed the product around site audits, handoffs, and manual review tracking.
* Added migration from the earlier LeadGuard and Form Census prototype options.
* Updated directory copy.

= 0.2.0 =

* Reframed manual verification as manual review to avoid implying functional testing.
* Added a 30-day review interval and clearer product-scope language.
* Added CSV formula-injection protection.
* Added privacy documentation.

= 0.1.4 =

* Sorted the roster so forms needing review appear first, followed by reviewed and unplaced forms.
* Simplified the scope explanation.

= 0.1.0 =

* Added initial form discovery adapters.
* Added manual review tracking and CSV export.
