=== PhoenixForge Reach ===
Contributors: ryanpurvisphoenixforge
Tags: email, subscribe, newsletter, opt-in, GDPR
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Email subscription and list management for WordPress, powered by PhoenixOS.

== Description ==

PhoenixForge Reach adds a fully-featured email subscription system to WordPress without storing any contact data in your database. Subscribers are managed in PhoenixOS and can be emailed via campaigns from there.

**How it works:**
Add the signup block or `[pfrc_signup]` shortcode to any page. When a visitor submits the form, PhoenixOS handles the opt-in flow, stores the contact, and sends the confirmation email. WordPress is just the form.

**Key features:**
* Gutenberg signup block + `[pfrc_signup]` shortcode
* Double opt-in with email confirmation
* RFC 8058 one-click List-Unsubscribe-Post header support
* Subscription preferences virtual page
* Optional GDPR consent checkbox
* Zero contact data stored in WordPress
* Optional first name field

**Pro features:**
* Campaign sending from within PhoenixOS
* Segmentation and tagging
* Automated drip sequences
* A/B subject line testing
* Click and open tracking

**Requirements:**
* PhoenixOS workspace (free to start at os.phoenixforge.io)
* Workspace API key (Settings → API in PhoenixOS)

== Installation ==

1. Upload the plugin to `/wp-content/plugins/phoenixforge-reach/` or install via the WordPress plugin screen.
2. Activate the plugin.
3. Go to **PhoenixForge Reach → Settings** and enter your Workspace API Key and List ID from PhoenixOS.
4. Add the **Reach — Signup Form** Gutenberg block or use `[pfrc_signup]` shortcode on any page.

== Frequently Asked Questions ==

= Where are subscribers stored? =
All contact data lives in PhoenixOS. WordPress stores nothing beyond plugin settings.

= Does it support GDPR? =
Yes — you can enable a consent checkbox in Settings. The text is customisable.

= Can I use different lists on different pages? =
Yes — pass `list_id="your-id"` to the block or shortcode.

= How does double opt-in work? =
When a visitor submits the form, PhoenixOS sends them a confirmation email. Clicking the link calls the /pfrc/confirm virtual page on your site, which verifies the token with PhoenixOS and activates the subscription.

= Does it handle unsubscribes? =
Yes — the /pfrc/unsubscribe virtual page processes unsubscribes, and the RFC 8058 one-click unsubscribe handler is registered automatically so email clients can present a single-click unsubscribe option.

== Screenshots ==

1. Signup form on the front end
2. Subscription preferences page
3. WordPress admin — Reach settings

== Changelog ==

= 1.0.0 =
* Initial release: signup block + `[pfrc_signup]` shortcode, double opt-in, RFC 8058 one-click unsubscribe, subscription preferences virtual page, GDPR consent checkbox.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
