=== RealSmile Face Analysis Widget — Free Quiz & Interactive Content ===
Contributors: realsmileonline
Tags: face analysis, selfie, quiz, interactive content, embed
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a free, interactive face-analysis quiz to any post: smile analyzer, golden ratio, face score, photo ranker. One shortcode, no API key.

== Description ==

Give your readers something to *do*. RealSmile drops a free, interactive face-analysis quiz straight into any post or page — visitors upload a photo and get an instant, measurement-based result, and they stay on **your** site the whole time. No API key, no account, no server costs. Just one shortcode.

It's the kind of interactive content that lifts time-on-page, shares, and return visits on beauty, grooming, dating, fitness, and self-improvement blogs.

**Five widgets, one shortcode:**

* `[realsmile_widget type="looksmax"]` — looksmaxxing test: 17-metric face analysis (symmetry, canthal tilt, jawline angle, golden ratio and more)
* `[realsmile_widget type="smile"]` — smile analyzer (Duchenne / genuine-smile detection)
* `[realsmile_widget type="golden-ratio"]` — golden ratio face measurement
* `[realsmile_widget type="face-score"]` — quick 0–100 face score
* `[realsmile_widget type="rank"]` — photo ranker (compare 2–6 photos, pick the best)

**Perfect for:**

* Beauty, skincare & makeup blogs — a "rate my features" quiz readers love to share
* Men's grooming & looksmaxxing sites — the full looksmaxxing test, on your own domain
* Dating & relationship blogs — a photo ranker for "which profile picture wins?"
* Fitness, glow-up & self-improvement content — an interactive before/after hook
* Any publisher who wants quiz-style interactive content without building one

**Why bloggers use it:**

* No API key, no account, no server costs — it's a single shortcode
* Loads lazily in a sandboxed iframe: zero impact on your Core Web Vitals / page speed
* Measurement-based results with published methodology (not a novelty quiz)
* Privacy-first: photos are processed in memory and deleted instantly — never stored, never used for training

**Options:**

* `height` — iframe height in pixels (default 720): `[realsmile_widget type="smile" height="640"]`
* `badge` — a small visible "Free face analysis by RealSmile" credit renders under the widget by default; set `badge="no"` to hide it

== External Service Disclosure ==

This plugin embeds an iframe served by **realsmile.online** (the RealSmile face-analysis service). The iframe loads only on pages where you place the shortcode. When one of your visitors chooses to upload a photo inside the widget, that photo is sent to RealSmile for analysis, processed in memory, and deleted immediately after the facial landmarks are measured — it is never written to disk, never stored, and never used to train anything. No data is collected by the plugin itself, and nothing is sent anywhere until a visitor actively uses the widget.

* Service: https://realsmile.online
* Privacy details and methodology: https://realsmile.online/about
* Terms: https://realsmile.online/terms

== Installation ==

1. Install and activate the plugin.
2. Add the shortcode to any post, page, or shortcode block: `[realsmile_widget type="looksmax"]`
3. That's it — no API key, no configuration.

== Frequently Asked Questions ==

= What kind of site is this best for? =

Any blog where readers care about faces, photos, or appearance: beauty and skincare, men's grooming and looksmaxxing, dating and relationships, fitness and glow-up, and self-improvement. It's an easy way to add quiz-style interactive content that keeps visitors engaged on your page.

= Does it slow my site down? =

No. The widget is a lazily-loaded iframe — it doesn't load until it's near the viewport, and analysis models load only when a visitor interacts with it. Your Core Web Vitals are unaffected.

= Are my visitors' photos stored? =

No. Photos are processed in memory and deleted instantly after measurement — never stored, never used for training. See the external-service disclosure above.

= Is it really free? =

Yes. The embedded tools are RealSmile's free tier. Visitors who want RealSmile's full paid report can choose to get one on realsmile.online — your page just hosts the free widget.

= Can I remove the credit line? =

Yes: `[realsmile_widget badge="no"]`. The credit is a small visible text link, on by default.

== Screenshots ==

1. The looksmaxxing-test widget embedded in a post
2. The smile analyzer widget
3. The shortcode in the block editor

== Changelog ==

= 1.0.0 =
* Initial release: five embeddable widgets via one shortcode, lazy iframe, optional credit badge.
