=== ThemeSync Subscribe ===
Contributors: globeboss
Donate link: https://globeboss.com
Tags: subscribe, newsletter, email, popup, opt-in
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Themed email subscriptions. Pick a design and the popup, forms, confirmation and notification emails all adopt it end to end.

== Description ==

ThemeSync Subscribe is a themed email subscription plugin for WordPress. It ships with **5 pre-designed themes** (Minimal, Editorial, Boutique, Studio, Noir) that style every piece of the subscription experience — the slide-in popup, inline shortcode form, sidebar widget, confirmation email, post-notification email, and broadcasts — from one click, so the look stays consistent end to end.

You can also set an optional accent color (hex) to match your brand without touching CSS, and the plugin automatically picks accessible text contrast for buttons.

= Core features (free) =

*   **5 designed themes** — Minimal, Editorial, Boutique, Studio, Noir
*   **Accent color override** per theme — match your exact brand color
*   **Slide-in popup** with per-page targeting, delay, and dismiss memory
*   **Shortcode** `[themesync_subscribe]` (full and compact styles)
*   **Sidebar/footer widget**
*   **Double opt-in** confirmation flow with themed email
*   **Post-publish notifications** — subscribers get a themed email when you publish a new post
*   **Broadcasts** — compose and send one-off emails (promotions, announcements) with hero image, promo code, CTA button
*   **Rate-limited AJAX endpoint** (10 attempts per IP per 5 minutes) + honeypot
*   **Test email delivery** diagnostic — see the exact SMTP error if emails fail
*   **Cache-safe** confirm/unsubscribe URLs route through `admin-ajax.php` — never cached by caching plugins
*   **List-Unsubscribe headers** for Gmail/Yahoo deliverability
*   **GDPR-friendly** double opt-in, IP logging only after validation, honeypot anti-spam
*   **Owner notifications** on each new subscribe / unsubscribe
*   **Global toggles** to pause subscriber notifications or FS Poster auto-sharing

= Pro features (coming in v1.1) =

*   20+ premium themes
*   A/B testing between themes
*   Exit-intent popup trigger
*   Mailchimp / ConvertKit / Brevo / SendFox sync
*   Scheduled broadcasts
*   Open-rate and click-rate analytics
*   Multiple lists and tag-based segmentation

== Installation ==

1.  Upload the plugin files to `/wp-content/plugins/themesync-subscribe/`, or install through the Plugins screen directly.
2.  Activate the plugin through the 'Plugins' screen.
3.  Go to **Subscribers** in the admin menu.
4.  Pick a **Design theme** at the top of the page.
5.  Set your "From" email and save.
6.  Add the form anywhere with the shortcode `[themesync_subscribe]`, or drag the **ThemeSync Subscribe** widget into a sidebar/footer.
7.  Enable the popup in the "Slide-in popup settings" section if you want it.

== Frequently Asked Questions ==

= Does it work with my caching plugin? =

Yes. Confirm and unsubscribe links route through `admin-ajax.php`, which is never cached by WP Rocket, LiteSpeed, FastPixel, W3TC, or any other caching plugin.

= Does it send emails? =

Yes, through WordPress's built-in `wp_mail()`. For reliable delivery, install an SMTP plugin like WP Mail SMTP or FluentSMTP and configure a transactional mail service (Mailgun, SendGrid, Amazon SES, etc.). The plugin includes a **test email** button so you can diagnose delivery issues.

= Can I change the colors? =

Pick a theme that fits your brand, then optionally set an accent color override (6-digit hex) to match your exact brand color. The plugin automatically calculates text contrast on buttons for accessibility.

= Does it work in the block editor / Gutenberg? =

Yes. The shortcode works in a Shortcode block, and the widget works in any block-based sidebar.

= Will I lose my subscribers if I switch themes? =

No. Themes only affect visual appearance. Your subscriber list is stored separately and is unaffected.

= Does it work with FS Poster or similar auto-share plugins? =

Yes. There's a global toggle on the Subscribers page to skip FS Poster auto-sharing for all new posts if you prefer manual control.

== Screenshots ==

1.  Theme picker on the Subscribers settings page.
2.  Slide-in popup on the frontend (Editorial theme shown).
3.  Confirmation email (Boutique theme shown).
4.  Broadcasts composer with hero image, promo code, and CTA.
5.  Subscriber list with status, source, and timestamps.

== Changelog ==

= 1.0.0 =
*   Initial release.
*   5 themes: Minimal, Editorial, Boutique, Studio, Noir
*   Theme-aware popup, inline form, widget, confirmation email, post-notification email, broadcasts
*   Rate limiting, honeypot, double opt-in, List-Unsubscribe headers
*   Cache-safe confirm/unsubscribe through admin-ajax
*   Test email delivery diagnostic
*   Global post-distribution toggles (skip subscriber email, skip FS Poster share)

== Upgrade Notice ==

= 1.0.0 =
Initial release.
