=== Form Orah – Contact Form Builder & Lead Intelligence ===
Contributors: kevin10676, formorah
Tags: contact form, form builder, contact, email, lead generation
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Contact form builder with AI lead scoring, e-signatures, and multi-step flows. Embed beautiful contact forms on any WordPress page — no coding needed.

== Description ==

**Form Orah** is a powerful contact form builder that goes far beyond basic contact forms. Connect your WordPress site to your Form Orah account and embed smart, conversion-optimized contact forms anywhere — in seconds.

Every contact form submission is automatically **AI-scored (HOT / WARM / COLD)**, followed up with a personalized email, and tracked in a full lead intelligence dashboard.

=== What Form Orah does ===

Form Orah turns your contact forms into a lead engine:

* **AI lead scoring** — every contact form submission is scored and qualified automatically
* **E-signatures** — let contacts sign documents directly inside your contact form
* **Multi-step contact forms** — break long forms into conversational steps that convert better
* **Conditional logic** — show or hide fields based on previous answers
* **Real-time analytics** — see which contact forms convert and why
* **Automated follow-up emails** — personalized emails sent the moment a form is submitted
* **Gutenberg block** — visual contact form picker with live preview in the editor
* **Shortcode support** — works with Elementor, Divi, and any page builder

=== What is Form Orah? ===

Form Orah is an AI-powered contact form and lead capture platform. Build any type of contact form — simple inquiry forms, multi-step lead gen forms, quote request forms, appointment booking forms, and more — then embed them on your WordPress site in one click.

[Sign up free at formorah.com](https://formorah.com) — the free plan includes unlimited contact forms and submissions.

=== Features in this plugin ===

* **Gutenberg block** — add a Form Orah contact form to any page with a visual picker
* **[forc_form] shortcode** — paste your contact form into any editor, widget, or page builder
* **Dashboard widget** — see your 10 most recent contact form leads with AI scores, without leaving WordPress
* **Settings page** — enter your API key, test the connection, and manage your contact form configuration

=== Usage ===

1. Install and activate the plugin
2. Go to **Form Orah → Settings** and paste your API key (get it from [app.formorah.com/settings/developer](https://app.formorah.com/settings/developer))
3. Click **Test Connection** to verify, then **Save**
4. Edit any page or post, add the **Form Orah** block, and pick your contact form

Or use the shortcode anywhere:

`[forc_form id="your-form-id"]`

You can find your form ID in the Form Orah builder URL.

== Installation ==

1. Upload the `form-orah-connect` folder to `/wp-content/plugins/`
2. Activate the plugin through the **Plugins** menu in WordPress
3. Go to **Form Orah → Settings** to enter your API key

Or install directly from the WordPress Plugin Directory: Plugins → Add New → search **"Form Orah contact form"**.

== Frequently Asked Questions ==

= Do I need a Form Orah account to use this contact form plugin? =

Yes. [Sign up free at formorah.com](https://formorah.com) — the free plan includes unlimited contact forms and submissions with no time limit.

= Where do I find my API key? =

Log in to [app.formorah.com](https://app.formorah.com), go to **Settings → Developer**, and create a new API key. Copy it and paste it into the plugin settings.

= What does Form Orah add to a contact form? =

Form Orah scores every submission with AI (HOT / WARM / COLD), sends personalized follow-up emails automatically, and gives you a full lead intelligence dashboard.

= Does the plugin work with the classic editor? =

Yes — use the `[forc_form id="your-form-id"]` shortcode in any editor, widget, or page builder.

= Does this contact form plugin work with Elementor, Divi, or other page builders? =

Yes — use the shortcode widget in any page builder that supports shortcodes, including Elementor, Divi, Beaver Builder, WPBakery, and Bricks.

= Can I add multiple contact forms to one page? =

Yes — add as many `[forc_form id="..."]` shortcodes or blocks as you need. Each one loads independently.

= Will this slow down my WordPress site? =

No. Contact form data is fetched via the Form Orah API and cached for 5 minutes. The embedded contact form loads asynchronously and never blocks your page render.

= Can my contact forms collect e-signatures? =

Yes — Form Orah supports e-signature steps inside contact forms. Signers receive a signed PDF with a certificate and audit trail.

== External Services ==

This plugin connects to the **Form Orah API** (https://app.formorah.com) to:

* Retrieve the list of forms associated with your account
* Retrieve recent form submissions for the WordPress dashboard widget
* Test your API key connection

Data sent to the Form Orah API includes your API key (transmitted as a Bearer token in the Authorization header). No visitor data is collected or transmitted by this plugin — the embedded form runs inside an iframe served directly by Form Orah.

The Form Orah service is operated by Pure Grace AI, LLC.

* [Privacy Policy](https://formorah.com/privacy-policy/)
* [Terms of Service](https://formorah.com/terms/)

This plugin only contacts the Form Orah API when an administrator has entered a valid API key in the plugin settings.

== Screenshots ==

1. Settings page — enter your API key and test the connection
2. Gutenberg block — pick your contact form from a visual dropdown
3. WordPress dashboard widget — see your latest contact form leads with AI scores
4. Contact form example — multi-step form with conditional logic

== Changelog ==

= 1.0.1 =
* Renamed the embed shortcode to [forc_form] so it uses the plugin's unique prefix
* Updated the plugin text domain to match the plugin slug

= 1.0.0 =
* Initial release
* Gutenberg block with contact form picker
* [forc_form] shortcode support
* Dashboard widget with recent contact form leads + AI scores
* Settings page with connection test

== Upgrade Notice ==

= 1.0.1 =
The embed shortcode is now [forc_form] (previously [formorah]). Update any existing shortcodes after upgrading.

= 1.0.0 =
Initial release.
