=== QQ Popup ===
Contributors: qqpopup
Tags: popup, mailto, email, analytics, anti-spam
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.1.21
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect a WordPress site to QQ Popup for protected mailto delivery, message capture, statistics, and API-call billing.

== Description ==

QQ Popup connects a WordPress site to the QQ Popup app at qqpopup.com.

The app owns account registration, connected-site keys, API keys, single-tier API-call billing, subscription status, hosted runtime delivery, message storage, approvals, forwarding, and statistics. The WordPress plugin provides the site admin workflow: first-run registration, connection settings, one site popup, mailto button design settings, runtime status, API-call usage, dashboard metrics, and app deep links.

On public pages, the plugin emits a normal `mailto:` link with a locally hosted email icon font and loads the QQ Popup runtime. The runtime rewrites that link before handoff so the visitor token is embedded in the email recipient address. If Google Analytics events are enabled and the site already has `gtag` loaded, the runtime sends view, click, and email handoff events using the configured event names.

Public WordPress pages use only the public site key and hosted runtime configuration. The private account API key is stored in WordPress options and is not rendered into public HTML.

== Installation ==

1. Upload the plugin zip through Plugins > Add New > Upload Plugin, or install it from WordPress.org when available.
2. Activate QQ Popup.
3. Open QQ Popup in WordPress admin.
4. Create a QQ Popup account or paste an existing app API key.
5. Create or edit the site's popup, choose embed/design settings, and save.

== Frequently Asked Questions ==

= Where are popups and messages managed? =

The WordPress admin screen handles site-level setup, the site's one popup, design settings, Google Analytics event settings, runtime status, API-call usage, summary statistics, recent-message review, sender details, visitor/session context, and basic approval/rejection. Forwarding history, account, and billing work open in the QQ Popup app.

= Does the plugin expose my API key publicly? =

No. Public pages use the app's public connected-site config endpoint. The account API key is used only for authenticated WordPress admin requests.

= What happens on uninstall? =

The plugin removes its saved connection settings and cached runtime-status transients.

== Changelog ==

= 0.1.21 =

* Show auto-reply open totals in QQ Popup dashboard and Stats views.

= 0.1.20 =

* Add a dedicated WordPress admin Stats page for QQ Popup usage metrics.

= 0.1.19 =

* Show a live mailto button preview in the WordPress admin Button tab.

= 0.1.18 =

* Add placement exclusions so QQ Popup can be disabled on listed paths or pages.

= 0.1.17 =

* Organize the WordPress admin settings into tabs.
* Show a red WordPress admin menu count for unread QQ Popup messages.

= 0.1.16 =

* Show recent-message sender, message body, page, visitor context, and delivery details in the WordPress admin dashboard.
* Rename the sender confirmation settings as the auto responder section.

= 0.1.15 =

* Remove the obsolete monthly email limit runtime-status message.

= 0.1.14 =

* Add custom mailto button colors and custom CSS settings.

= 0.1.13 =

* Add mobile mailto button visibility, layout, and bottom-offset settings.

= 0.1.12 =

* Add site popup auto-reply settings for sender confirmation emails.

= 0.1.11 =

* Add inline approve/reject actions for recent messages in the WordPress admin dashboard.

= 0.1.10 =

* Add optional Google Analytics event settings for view, click, and email handoff tracking.

= 0.1.9 =

* Add a locally bundled Google Noto email glyph to the public mailto button.

= 0.1.8 =

* Limit each connected WordPress site to one plugin-managed site popup.

= 0.1.7 =

* Render a protected mailto button on public pages and let the hosted runtime rewrite it with the visitor token.

= 0.1.6 =

* Show API-call usage and single-tier billing status in the WordPress admin dashboard.

= 0.1.5 =

* Add WordPress-side popup create/edit forms backed by QQ Popup integration API endpoints.

= 0.1.4 =

* Pass popup intro text to the hosted runtime widget.

= 0.1.3 =

* Link WordPress dashboard popup and recent-message rows to matching QQ Popup app screens.
* Add plugin repository readme and uninstall cleanup.

= 0.1.2 =

* Add billing deep link and Stripe subscription status display.
* Harden saved API key storage.
* Add runtime status checks.

= 0.1.0 =

* Initial QQ Popup plugin MVP.
