=== Share with My Agent ===
Contributors: livefutureinc
Tags: ai, ai agents, share, seo, geo
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Scan how AI agents read WordPress, then publish llms.txt, JSON mirrors, an agentic sitemap and a visible agent-view switch.

== Description ==

Your next customer doesn't browse alone — they ask an AI assistant. Share with
My Agent gives every page a short link (a swma.link) that any assistant can
read: your offer, prices, limits and next steps, declared by you.

Version 2 adds an agentic-visibility dashboard to WordPress:

* Scan published pages and score agentic readability page by page.
* Serve a virtual llms.txt without replacing a physical file.
* Publish JSON mirrors and a separate agentic-sitemap.xml.
* Let visitors switch to the exact structured view agents receive.
* Add the Share with My Agent control as a dock, bar, badge or shortcode.
* Send privacy-bounded aggregate endpoint counters and fetch AI-read, health,
  per-endpoint and share reporting from your account.
* Enrich WooCommerce products with price, stock, cart, checkout and coupon facts.

The free plugin creates up to 10 page mirrors. Connect a free Share with My
Agent account within seven days so the generated endpoints and reporting stay
active. The $12.90/month WordPress plan removes the page limit and unlocks all
customization. The plugin loads the official widget and reporting API from
sharewithmyagent.ai only after you authorize the connection.

== Installation ==

1. Upload the plugin ZIP under Plugins → Add New → Upload Plugin, and activate.
2. Open Share with My Agent in the WordPress admin menu. The first scan is
   already waiting for you.
3. Click Connect ShareWithAgent account, sign in and authorize this site.
4. Review your page scores and enable the generated endpoints and placement.

The plugin is additive. It does not overwrite Yoast, Rank Math, a physical
llms.txt, the WordPress core sitemap, robots.txt or WooCommerce templates.

Prefer manual placement? Put `[share_with_my_agent]` in any page or post,
optionally with `placement="button|bar|callout|badge|dock"`.

== Frequently Asked Questions ==

= Do I need an account? =

Yes — a free one. Your account publishes the agent-readable context that the
assistants read, and shows you the adoption stats.

= Does it slow my site down? =

The widget is a small deferred script served from our edge. Generated machine
endpoints are rendered by WordPress only when requested.

= What happens after seven days? =

Connect a free account to keep generated mirrors, llms.txt, the agentic sitemap
and reporting active. Your human pages and existing SEO configuration are never
changed or disabled.

= Does this work with WooCommerce? =

Yes. Product mirrors include SKU, price, currency, stock, cart, checkout and
coupon support when WooCommerce is active. Payment remains in your normal
WooCommerce checkout.

== External services ==

When you authorize a connection, this plugin calls sharewithmyagent.ai to
exchange a five-minute one-time code, refresh the plan entitlement and fetch
aggregated reporting. Each hourly heartbeat sends aggregate counts for llms.txt,
agentic-sitemap, JSON-mirror and agent-view requests, grouped by day, page ID and
coarse agent family, plus enabled-feature and score health. It does not send IP
addresses, cookies, emails or raw user-agent strings. It stores the resulting
revocable installation token in WordPress options. It may load the widget script
and record anonymous widget usage events. See https://sharewithmyagent.ai/privacy.

== Changelog ==

= 2.2.0 =
* Free WordPress and WooCommerce download editions share one plugin and settings.
* Public product catalog, category mirrors, pricing and checkout guidance.
* Ten shared eligible page/product mirrors on Free; hidden and draft products do not consume the allowance.
* Respect WooCommerce Coming soon mode and exclude account, cart and checkout page content.
* Normal UI / Agents / Crawlers switch uses full-page views.


= 2.2.0 =
* Bundle the sharing widget and preserve link/theme context in dock and bar.
* Withhold Pro until the server provides a verified access status.
* Free sharing remains available while Pro verification or renewal is pending.

= 2.1.3 =
* Preserve server-verified activation state through the Settings API.
* Render sharing widgets with the current page URL and selected placement/theme.
* Show truthful connection, Pro access and renewal status; enforce supplied expiry.
* Distinguish failed activation from success and validate shortcode placements.

= 2.1.2 =
* Full-page Normal UI, Agents and Crawlers views match the product site.
* Compact Markdown and JSON discovery for published pages and the homepage.
* Crawler metadata, structured data and cleaned semantic content inspection.
* Restore normal page scroll; support keyboard navigation and mobile views.
* Hide the switch when mirrors are disabled; decode text entities in context.

= 2.1.1 =
* Bounded 450-row idempotent telemetry batches for unlimited large sites.
* Up to four queued batches drain on each hourly heartbeat without losing counts.

= 2.1.0 =
* Idempotent hourly aggregate telemetry for generated endpoint and agent-view use.
* Server-backed agent-read, endpoint, health and paid per-page reporting.
* No visitor identity, IP, cookie or raw user-agent is sent by plugin telemetry.

= 2.0.0 =
* On-activation dashboard scan and per-page readability score.
* Free 10-page JSON mirror tier, virtual llms.txt and agentic sitemap.
* Secure account authorization with a one-time server exchange.
* Agent-view front-end switch and Share with My Agent placements.
* Aggregated remote reporting and daily entitlement heartbeat.
* WooCommerce product, stock, cart, checkout and coupon support.
* Additive compatibility: no writes over Yoast, Rank Math or core SEO output.

= 1.1.0 =
* Activation is now your pasted swma.link (validated against the allowed
  Share with My Agent hosts); the widget key is optional, for stats.
* Free plan shares the master link; paid multi-URL plans can enable
  per-page links resolved automatically from your account.
* Paid extras: serve llms.txt when the site has none (with your agent link
  and sitemap), BreadcrumbList JSON-LD on posts and pages.
* Redesigned settings page with placement previews.

= 1.0.0 =
* First release: settings page, auto placement (bar/dock/badge), shortcode
  placements, theme control, per-placement manifest override.
