=== Search & Social Appearance Audit ===
Contributors: plugupp, freemius
Tags: open graph, meta tags, social preview, seo audit, twitter card
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

See exactly how your WordPress content appears in search engines and on social media - all from one simple dashboard.

== Description ==

Search & Social Appearance Audit shows how your WordPress pages actually appear in search engines and on social platforms by auditing the final rendered output - regardless of theme, SEO plugin, page builder or custom code.

It is not an SEO plugin and does not manage your metadata. Whatever produces your titles, descriptions and social images, this plugin tells you the truth about what actually ships on each page, and flags issues with evidence.

It renders each of your pages the way a visitor's browser would, reads the metadata that actually ships, and reports the problems. Discovery is a simple list of your own content - it never crawls, spiders or follows links.

What you get on the free plan:

* Search Appearance preview - a Google-style mobile result (breadcrumb, title, description, thumbnail) for every page
* Social Appearance preview - a Facebook and LinkedIn style share card (image, title, description) plus the X (Twitter) card type
* Click any preview image to see the exact area each platform keeps and what it crops off
* Issue detection with evidence - missing, duplicate or conflicting metadata, broken OG image URLs, over-long or very short descriptions, noindex pages, canonical problems, and pages set to hide their search thumbnail
* Indexable / noindex and canonical shown as compact flags, with the full details a click away
* Exclude pages from the audit individually or in bulk - including bulk actions on the standard Posts and Pages screens, which combine with any list filter
* Ignore individual issues, and file-based logging with a viewer

Paid plans add scheduled scans with email reports, custom post type and WooCommerce auditing, pre-publish auditing of drafts, filtering and CSV export, Enhanced scan (fallback-image prediction and weak social-image detection), author flagging, and multi-site licensing.

Private and password-protected content is excluded automatically - search engines and social platforms can never see it, so there is nothing to audit.

== External services ==

This plugin connects to the following external services.

= Freemius =

The plugin uses the Freemius platform for licence activation, plan changes, plugin updates (for paid plans), and as the Merchant of Record for purchases.

* When data is sent: on first plugin activation as part of the user-consented opt-in flow, on licence activation or deactivation, on plugin update checks (paid plans), and on uninstall (for optional feedback). Sending the initial opt-in data is the user's choice - declining the opt-in still lets the plugin work in full. Scanning is fully local and never requires the connection.
* What data is sent: standard Freemius opt-in data including site URL, administrator email address, WordPress version, PHP version, plugin version, and active theme name.
* Terms of service: https://freemius.com/terms/
* Privacy policy: https://freemius.com/privacy/

= Image URLs declared on your pages =

When checking whether an Open Graph image actually loads, the plugin requests the image URL that the page itself declares (for example a file in your Media Library or on your CDN).

* When data is sent: during a scan, for pages that declare an OG image.
* What data is sent: nothing beyond the HTTP request to the image URL - it is made only to confirm the image resolves. Only URLs published on your own pages are contacted.

The plugin also renders your own pages by requesting them on your own server (a self-request); that is your site contacting itself, not a third-party service.

== Installation ==

1. Install from the WordPress.org plugin directory (Plugins > Add New), or upload the plugin ZIP (Plugins > Add New > Upload).
2. Activate the plugin.
3. Open the Appearance Audit screen and click "Scan now" to audit your pages and posts. You can leave the page; the scan continues in the background.
4. Review the Search Appearance, Social Appearance and Issues tabs.

== Frequently Asked Questions ==

= Does this replace my SEO plugin? =

No. The plugin audits what your site actually outputs - whichever SEO plugin, theme or page builder produces it. It does not manage or change your metadata.

= Does it crawl my site? =

No. It audits only your known WordPress content. It never follows links or discovers URLs like a crawler.

= Are private or password-protected pages audited? =

No. Private and password-protected content is excluded automatically. Search engines and social platforms can never see it - a crawler or a social share preview only ever reaches a login screen, a password form, or a not-found response. Auditing how such pages appear would be meaningless, so they are left out of every scan, count and report. Make a page public (or remove its password) and it is picked up on the next scan.

== Screenshots ==

1. Search Appearance - every page shown as a Google-style mobile result (breadcrumb, title, description and thumbnail), with the Issues, Canonical and Robots flags alongside and a scan summary across the top.
2. Social Appearance - every page shown as a Facebook and LinkedIn style share card with the image, title and description, plus the X (Twitter) card type.
3. Click-to-enlarge preview - opens the image full size with the area each platform keeps highlighted and the cropped edges dimmed, so you see exactly what shows and what is trimmed.
4. The Issues tab - every problem found, grouped by area with a one-line summary for fast triage.
5. Issue details - the problem, the exact evidence taken from the rendered page, and quick actions (view, edit, re-scan).
6. Settings - choose which content types are audited and set the search and social description preview lengths; a built-in log viewer is on the Logs tab.

== Changelog ==

= 1.0.7 =
* New check: flags a meta description that is longer than your preview length (so search engines will truncate it) or very short.
* New check: flags pages set to max-image-preview:none, where Google will not show a thumbnail in search results.

= 1.0.6 =
* Updated the bundled Freemius framework to version 2.13.2.

= 1.0.5 =
* Clicking a preview image now opens it full size with the platform's crop area highlighted, so you can see exactly what Facebook or Google keeps and what gets trimmed.

= 1.0.4 =
* The Social preview thumbnail is now larger (matching the Search preview height) and uses the true 1.91:1 share-card proportions.

= 1.0.3 =
* The Search and Social preview cards now name the specific field that is missing (for example "Missing meta description" or "Missing OG title") instead of a generic "Missing" label.

= 1.0.2 =
* Updates made in response to the WordPress.org plugin review.

= 1.0.1 =
* Improved: when a page fails to render during a scan, the log now records a short snippet of what the page returned - including the underlying PHP error when the page fatals - so render errors are diagnosable from the Logs tab without server access.

= 1.0.0 =
* Initial public release.

== Upgrade Notice ==

= 1.0.7 =
New search checks (over-long or short descriptions, pages that hide their search thumbnail) and a click-to-enlarge preview showing exactly what each platform crops.
