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

Free face-analysis quiz for any post — "how old do I look" age guesser, attractiveness test, selfie score & symmetry, all in one shortcode.

== 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 **face rating**, 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 — a **"how old do I look" quiz**, an **attractiveness test**, **selfie score**, **face symmetry** check, or **looksmax** analyzer — that lifts time-on-page, shares, and return visits on beauty, grooming, dating, fitness, and self-improvement blogs. Think of it as an **engagement widget** that turns a passive read into a share-worthy result.

**Six 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="age"]` — NEW: "how old do I look?" age guesser (an honest age *range*, never a fake-precise number)
* `[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)

**Why embed it:**

* **More engagement** — an interactive quiz keeps readers on the page instead of bouncing; results are made to share
* **Zero setup** — no API key, no account, no server costs; it's a single shortcode
* **Zero page-speed cost** — loads lazily in a sandboxed iframe, so your Core Web Vitals are unaffected
* **Measurement-based, not a novelty quiz** — the underlying impression model is validated, with published methodology (see below)
* **Privacy-first** — photos are processed in memory and deleted instantly; never stored, never used for training

**Validated accuracy (and its honest limits):**

The Face Score impression model behind these widgets was tested against a 5,500-face academic benchmark of human-rated photos, where its predictions correlate with averaged human ratings at r ≈ 0.8 — strong agreement by social-science standards. The full methodology is published at https://realsmile.online/research-base. That validation applies to the impression score specifically: the geometric measurements are honest rulers (not attractiveness verdicts), and the new age widget is an experimental photo read that always shows a range, never a fake-precise number — the widget itself says so.

**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
* Anti-aging, skincare & wellness content — a "how old do I look?" quiz is the perfect interactive hook
* 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

**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 does this plugin actually do? =

It embeds a free, interactive face-analysis quiz on your site via a shortcode. A visitor uploads a photo and gets an instant, measurement-based result — a face rating, symmetry read, golden-ratio measurement, smile analysis, or a photo ranking — without ever leaving your page.

= 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.

= How do I add the widget to a post? =

Paste the shortcode where you want the widget to appear, for example `[realsmile_widget type="looksmax"]`. Change `type` to `age`, `smile`, `golden-ratio`, `face-score`, or `rank` to embed a different widget. Use `height="640"` to adjust the size.

= How does the "how old do I look" widget work? =

A visitor uploads a photo and gets an estimated age *range* (for example "24–32"). It is deliberately labeled experimental and never shows a fake-precise single number — off-the-shelf age models have an error band of several years, and the widget is honest about that. Low-quality photos (face too small, off-angle) get retake guidance instead of a garbage number.

= Can I put more than one widget on a page? =

Yes. Each shortcode renders independently, so you can place several widgets in the same post if it fits your content.

= 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.

= Is the face rating accurate, or just a random number? =

It's measurement-based. The underlying impression model was tested against a 5,500-face academic benchmark of human-rated photos and correlates with averaged human ratings at r ≈ 0.8, with the methodology published at https://realsmile.online/research-base — it is not a random novelty quiz. The age widget is separate and explicitly experimental: it shows an honest range, not a validated score.

= 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 — a visitor gets their Face Score and top-3 strongest metrics at no cost, with no signup required. Visitors who want the full 17-metric report can choose to buy 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.

= Do I need an API key or account? =

No. There is no API key, no account, and no configuration — install, activate, and drop in the shortcode.

== Screenshots ==

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

== Changelog ==

= 1.1.0 =
* NEW: `[realsmile_widget type="age"]` — a "how old do I look?" age-guesser widget. Shows an honest age range (never a fake-precise number), labels itself experimental, and gives retake guidance instead of a garbage read on low-quality photos.
* Listing: added the published validation details (5,500-face academic benchmark, r ≈ 0.8 impression-model correlation, methodology at realsmile.online/research-base) with an honest note on what is and isn't covered by that validation.
* Clarified exactly what the free tier includes (Face Score + top-3 metrics, no signup).
* Confirmed compatibility with WordPress 7.0 ("Tested up to" refreshed).

= 1.0.1 =
* Refreshed the listing for clearer discovery (face rating / attractiveness test / looksmax) and expanded the FAQ for site owners.
* Added an optional, dismissible admin reminder to leave a review (no incentive, appears only after the widget has been active a while).
* Updated the outbound widget links to a consistent WordPress UTM source.
* Confirmed compatibility with current WordPress ("Tested up to" refreshed).

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