=== AskLoop Widget ===
Contributors: askloop
Tags: qa, questions, answers, widget, block
Requires at least: 5.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.16
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed your AskLoop anonymous Q&A profile on WordPress. Requires an AskLoop account at askloop.net.

== Description ==

AskLoop Widget embeds your AskLoop Q&A profile on any WordPress page so visitors can ask you questions.

**Important:** This plugin requires a free or paid [AskLoop](https://askloop.net) account. It connects to AskLoop servers to load questions/answers and submit new questions.

**How to use**

1. Create an account at [askloop.net](https://askloop.net/register) and note your handle.
2. In WordPress: edit a page → Add block → search **AskLoop**.
3. Enter your handle in the Connect box (or set a site default under Tools → AskLoop Widget).
4. Publish the page.

**Also supports shortcode:** `[askloop handle="your-handle" theme="dark" layout="full" color="#2ea44f" style="minimal" per_page="10"]`

**Features:**

* Clear Connect placeholder in the block editor
* Theme (light / dark / auto), accent color, layout (full / form / Q&A), and minimal style
* Show/hide avatar, bio, and social links
* Custom placeholder, submit label, and success message
* Questions per page (1–20)
* Admin “Test connection” for the default handle
* Site-wide default handle
* Gutenberg block + shortcode
* Loads public Q&A for your AskLoop handle
* Visitors can submit questions through your site
* Optional analytics (disabled by default)
* Mobile-responsive layout

**Privacy**

By default the plugin does not send analytics events. Site admins can enable anonymous usage analytics under Tools → AskLoop Widget. When enabled, interaction events may be sent to AskLoop. See [AskLoop Privacy Policy](https://askloop.net/privacy).

**Terms**

Use of AskLoop is subject to the [AskLoop Terms](https://askloop.net/terms).

**Development**

Human-readable JavaScript source is included in the plugin under `src/` (`src/index.js` for the block editor, `src/frontend.js` for the public widget). Minified files in `build/` are generated with [@wordpress/scripts](https://www.npmjs.com/package/@wordpress/scripts).

To rebuild assets from source:

1. Install [Node.js](https://nodejs.org/) (LTS recommended).
2. In the plugin directory: `npm install`
3. Run: `npm run build`

This updates `build/index.js` and `build/frontend.js`. Plugin page: https://askloop.net/wordpress-plugin

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/askloop-widget`, or install through Plugins → Add New.
2. Activate the plugin.
3. Open **Tools → AskLoop Widget** and follow Getting Started (optional: set a default handle).
4. Create an AskLoop account at https://askloop.net and note your handle.
5. Edit a page, add the **AskLoop Widget** block, enter your handle, and publish.

== Frequently Asked Questions ==

= Do I need an AskLoop account? =

Yes. Create one at [askloop.net](https://askloop.net). The plugin will not work without a valid handle.

= Where do I enter my handle? =

In the block editor, the AskLoop block shows a Connect box. You can also set a site default under Tools → AskLoop Widget, or use the shortcode `[askloop handle="your-handle"]`.

= Is analytics required? =

No. Analytics are off by default and can be enabled in Tools → AskLoop Widget.

= Can I remove AskLoop branding? =

Branding controls depend on your AskLoop plan. Configure branding in your AskLoop dashboard.

== Changelog ==

= 1.0.16 =
* WordPress.org review: remove Tested up to from main plugin file (readme only)
* Enqueue admin Test connection script instead of inline JavaScript
* Include `src/` source and document build steps in readme
* Plugin URI landing page at askloop.net/wordpress-plugin

= 1.0.15 =
* Minimal style now respects the light/dark theme for text, links, and borders
* Minimal keeps transparent surfaces so it blends with your site background
* Dark Minimal is previewed on a dark backdrop in the block editor

= 1.0.14 =
* Fix Minimal style not applying (renamed reserved Gutenberg `style` attribute to `appearance`)
* Make Minimal visually distinct: no card chrome, accent header rule, left-rail answers

= 1.0.13 =
* Fix Plugin Check warning on per_page sanitization
* Honor questions-per-page even when the API uses a fixed page size
* Make Minimal style clearly distinct (borderless, accent answers, underline input)

= 1.0.12 =
* Show/hide avatar, bio, and social links in the block
* Minimal style variant
* Custom question placeholder, submit label, and success message
* Questions per page control (1–20) for block and shortcode
* Admin Tools “Test connection” for the default handle

= 1.0.11 =
* Block controls: theme (light/dark/auto), accent color, layout (full/form/Q&A)
* Shortcode supports theme, layout, and color attributes
* Shared CSS accent variable for buttons and links

= 1.0.10 =
* Fix editor preview styling (shared CSS in iframe; correct askloop-* classes)
* Clearer closed-for-questions state; Q&A hierarchy in preview
* Clear remaining Plugin Check warnings on settings/activation notice

= 1.0.9 =
* Getting Started admin guide, activation notice, and Settings plugin link
* Block Connect placeholder with inline handle entry
* Site-wide default handle + `[askloop]` / `[askloop_widget]` shortcodes
* Clearer empty-state messaging for editors

= 1.0.8 =
* Clear remaining Plugin Check warnings (nonce-scoped request reads, prefixed uninstall vars)

= 1.0.7 =
* Raise block apiVersion to 3 for WordPress 7.0+ editor compatibility
* Update Tested up to 7.1; exclude hidden files from org zip
* Use WP_Filesystem only for log rotation (no direct rename)
* Sanitize and unslash all AJAX request input for Plugin Check

= 1.0.6 =
* Load real AskLoop profile and branding from the public API (no mock profile)
* Escape profile fields in the frontend widget
* Use paginated /api/questions?handle= for editor and frontend

= 1.0.5 =
* Fix question submit field mapping to AskLoop API
* Fix block editor preview (POST + nonce)
* Analytics opt-in (default off); remove direct phone-home fallback
* Harden nonces, handle sanitization, and remove curl_resolve hack
* Escape Q&A content in the frontend widget
* Honest SaaS/privacy disclosure in readme

= 1.0.4 =
* Initial public release
* Basic Q&A widget functionality
* WordPress block editor integration
* AJAX-powered frontend
* Built-in logging system

== Upgrade Notice ==

= 1.0.16 =
WordPress.org compliance update; no functional changes to the public widget.

= 1.0.15 =
Minimal style now follows the light/dark theme instead of ignoring it.

= 1.0.14 =
Fixes Minimal style not applying due to a reserved Gutenberg attribute name.

= 1.0.13 =
Fixes Plugin Check per_page warning, questions-per-page behavior, and Minimal style visibility.

= 1.0.12 =
Adds profile display toggles, minimal style, custom copy, questions-per-page, and admin handle test.

= 1.0.11 =
Adds theme, accent color, and layout controls in the block and shortcode.

= 1.0.10 =
Fixes editor preview formatting and remaining Plugin Check warnings.

= 1.0.9 =
Much clearer setup: Connect placeholder, Getting Started, default handle, and shortcode.

= 1.0.8 =
Plugin Check warning cleanup for WordPress.org submission.

= 1.0.7 =
Plugin Check fixes for WordPress 7.0+ (apiVersion 3, Tested up to 7.1).

= 1.0.6 =
Uses live AskLoop profile and branding settings from your account.

= 1.0.5 =
Security and privacy improvements. Review Tools → AskLoop Widget analytics setting after update.

== Privacy Policy ==

This plugin connects to askloop.net to provide Q&A features. Optional analytics may send anonymous event data when explicitly enabled by an administrator. See https://askloop.net/privacy.
