=== NR Brief Builder ===
Contributors: nicognito23
Donate link: https://nicolasraux.fr
Tags: brief, form, client onboarding, freelance, agency
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Smart client brief builder for freelancers and agencies. Drop a multi-step brief form anywhere with one shortcode.

== Description ==

NR Brief Builder turns the classic "contact me" form into a guided, multi-step client brief. Visitors pick their project type, answer a handful of chip-based questions, and get a live recap before sending — you get a clean, structured brief in your inbox and in your WordPress dashboard.

**Free version features**

* `[nr_brief]` shortcode, usable in any page, post or widget
* Up to 5 configurable question steps + a fixed final contact/recap step
* Chips (single or multiple choice) and free-text fields
* Dynamic recap panel built as the visitor answers
* Structured notification email to you, automatic confirmation email to the prospect
* 3 ready-made templates: Web, Graphisme, Coaching
* Native WordPress security: nonces, sanitization, output escaping
* Zero external dependencies — vanilla CSS/JS only

**Usage**

`[nr_brief template="web"]`

Available templates: `web`, `graphisme`, `coaching`.

**Premium (roadmap)**

Unlimited steps, submission pipeline (New/In progress/Quoted/Won/Lost), PDF export, automatic budget scoring, follow-up reminders, custom branding, CSV export, WPML/Polylang, webhooks (Zapier, Make, CRM).

== Installation ==

1. Upload the `nr-brief-builder` folder to `/wp-content/plugins/`, or install the zip via *Plugins → Add New*.
2. Activate the plugin.
3. Add `[nr_brief]` to any page, or `[nr_brief template="graphisme"]` / `[nr_brief template="coaching"]` for another preset.
4. Set your notification email under *NR Brief Builder → Settings*.

== Frequently Asked Questions ==

= Where do submissions go? =

Every submission is stored privately under *NR Brief Builder → Submissions* in wp-admin, and two emails are sent: a structured notification to you, and an automatic confirmation to the prospect.

= Can I use it more than once on the same page? =

Yes, each `[nr_brief]` instance is independent.

= Does it work with any theme? =

Yes. The form ships with its own self-contained styling and does not depend on the active theme beyond typography.

== Third Party Services / Privacy Policy ==

NR Brief Builder uses the [Freemius](https://freemius.com/) SDK to manage installations and (in a future version) license checks for the optional Pro upgrade.

On activation, Freemius shows a one-time opt-in screen asking whether you want to share some basic, non-sensitive usage and installation data (e.g. your site's URL, WordPress and PHP versions, and this plugin's version) to help us improve compatibility and support, and to receive relevant update notifications. **This is opt-in, not automatic**: nothing is sent unless you click "Allow & Continue," and clicking "Skip" declines it — the plugin works exactly the same either way.

No personal data — such as the content of your clients' brief submissions — is ever sent to Freemius. That data stays in your own WordPress database, as described above.

Freemius's full privacy policy is available at [https://freemius.com/privacy/](https://freemius.com/privacy/).

== Screenshots ==

1. The NR Brief Builder dashboard — recent submissions, a getting-started checklist, and your shortcode, all in one place.
2. The settings page — pick a template, preview it live, and copy your shortcode in one click.
3. Multi-step brief form on the front end — a chip-based question step (Goals & audience), with the progress stepper.
4. The final Contact step, with the live recap panel showing every answer before the prospect sends their brief.
5. A submitted brief in your WordPress admin, fully structured and readable.

== Changelog ==

= 1.0.3 =
* Fixed: a site could crash with a fatal error if a Pro license was already active but the Pro files weren't installed yet (e.g. right after upgrading, before the Premium package is in place). The plugin now degrades cleanly to the free experience in that case instead of crashing.

= 1.0.2 =
* Fixed: template dropdown text became unreadable on hover/focus in Settings (both the shortcode generator and the default template field).
* Uninstall cleanup now runs through Freemius's own uninstall hook instead of a plugin-root uninstall.php file.
* Added the licensing infrastructure and extension points used by the upcoming Pro upgrade — no visible change for existing installs.

= 1.0.1 =
* Added Freemius SDK integration for future Pro upgrade support.

= 1.0.0 =
* Initial release: shortcode, 3 templates, stepper form, email notifications, basic admin dashboard.

== Upgrade Notice ==

= 1.0.3 =
Fixes a fatal-error crash that could happen right after activating a Pro license before the Premium files are installed. Recommended for everyone on 1.0.2.

= 1.0.0 =
Initial release.
