=== Share with My Agent – AI Visibility & llms.txt ===
Contributors: sharewithmyagent
Tags: llms.txt, ai visibility, ai agents, structured data, sharing
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.3.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Help AI assistants understand your business with llms.txt, page JSON, an AI sitemap, three viewing modes and sharing controls.

== Description ==

Let visitors inspect your published page context and take it to their own AI assistant.

The plugin combines a Normal UI / Agents / Crawlers switch, public JSON and Markdown page mirrors, and current-page sharing controls. llms.txt is one discovery output within that workflow.

Share with My Agent publishes readable, structured information from your WordPress content. Give assistants such as ChatGPT, Claude and Gemini access to your offer, product details and next steps, while keeping your normal website available to visitors.

= Inspect a page, then share it with your own assistant =

* Virtual llms.txt: an index of eligible published content at your site root. An existing physical llms.txt is not overwritten.
* Structured page mirrors: public JSON and Markdown representations of eligible pages and posts.
* A separate agentic-sitemap.xml: links to the published pages and their machine-readable mirrors.
* Normal UI / Agents / Crawlers: visitors can switch between the original page, readable context, and an inspection of metadata and rendered content.
* Sharing controls: offer a dock, bar, badge, button or callout, with a shortcode for manual placement.
* Readability checks: a local score based on the title, summary, text length and headings. These are plugin checks, not feedback from an AI assistant.
* Connected reporting: aggregate endpoint reads by coarse crawler family, sharing activity and installation health.

Assistants decide whether to retrieve, use, cite or recommend your information. The plugin does not guarantee rankings, recommendations, traffic or sales. Reported agent families are inferred from request headers; they are not verified identities or a record of what an assistant said.

= WooCommerce support =

When WooCommerce is active and the store is public, product context includes names, descriptions, SKUs, categories, prices, currency and stock availability. Variable products include a price range and guidance to select product options.

Catalog and category mirrors include eligible products. Checkout guidance links shoppers to your normal cart and checkout; the plugin does not place orders or process payments. Customer records, orders, payment details and private carts are not published. Prices and availability must be confirmed at checkout.

= Free local features and optional service =

Local publishing, WooCommerce context, all three viewing modes and sharing controls are free, with no account requirement, seven-day cutoff or plugin-imposed page quota. Eligible published pages, posts and products are included. Hidden, draft and password-protected content is excluded, as are WooCommerce account, cart and checkout page contents.

A Share with My Agent account is optional for hosted reporting and account services. Paid service plans may provide additional remote reporting; they do not unlock or restrict local publishing code. See https://sharewithmyagent.ai/plugins/wordpress for service information.

Telemetry and footer credit are off by default and can be enabled separately in settings. The optional Powered by link appears once alongside the automatic sharing control in the page footer, on any plan. It is never inserted into llms.txt, JSON, Markdown or manual shortcodes. Existing broad credit settings do not opt users into this new footer-only choice. The automatic sharing widget is also off until enabled; manual shortcodes work without an account.

== Installation ==

1. Download the plugin ZIP. In WordPress, open Plugins > Add New > Upload Plugin.
2. Upload the ZIP, install it, then activate Share with My Agent.
3. Open Share with My Agent in the admin menu and review the local scan.
4. Local publishing is ready without an account. Read the external-service disclosure before optionally connecting an account for reporting.
5. Choose your publishing outputs, sharing placement and theme. Save Changes.
6. Open a published page and test Normal UI, Agents and Crawlers. Check /llms.txt and /agentic-sitemap.xml.

For manual placement, turn automatic sharing display off and insert [share_with_my_agent placement="button"]. Supported placements are button, bar, callout, badge and dock.

This single plugin includes WooCommerce support. A second edition is not required. It also works without WooCommerce installed.

== Frequently Asked Questions ==

= What is llms.txt? =

If another plugin already serves a virtual llms.txt, disable this plugin's llms.txt option and keep one provider. Existing physical files take precedence. The generated index includes only enabled plugin discovery outputs.

It is a proposed plain-text convention for presenting useful website context and links to language-model tools. Support varies. This plugin generates an index from eligible WordPress content; it does not control whether any assistant reads it.

= Does this replace my SEO plugin or theme? =

No. It adds publishing endpoints and optional visible controls. It does not rewrite Yoast or Rank Math metadata, robots.txt, the core WordPress sitemap or WooCommerce templates. Check the generated content with your own theme and page builder: content stored outside ordinary post content may need additional integration.

= Does the dashboard show what ChatGPT said about me? =

No. It shows local readability checks and connected aggregate request/sharing counts. It does not read assistant conversations or provide endorsement reports.

= What happens after seven days? =

Local functionality continues. The directory edition has no time limit and does not require an account to keep publishing or sharing active.

= Where do the scripts run? =

The plugin's JavaScript and CSS are bundled with the plugin and served by your WordPress site. Widgets with telemetry explicitly enabled on connected sites make the event requests described below. The plugin does not download executable JavaScript from the service.

= How do I disconnect? =

Use Disconnect in the plugin dashboard. This clears the local installation credentials and asks the service to revoke the installation connection. Disconnect before uninstalling if you want that revocation request sent. Deleting the plugin removes its settings, scan cache, pending telemetry and rewrite-version option; it does not delete your service account or historical service reports.

== External services ==

This plugin integrates with Share with My Agent at https://sharewithmyagent.ai. The service provides account authorization, installation credentials, plan status, reporting and connected sharing functions.

Before connection, publishing and readability scans run in WordPress. Endpoint counters are recorded only while connected and after telemetry is explicitly enabled. Service requests begin when an administrator opens the connection flow or activates a Pro key; periodic reporting requires a saved installation token.

Data sent to sharewithmyagent.ai:

* Connection: site URL, WordPress admin callback URL and random state in the authorization URL; the one-time authorization code, state and site URL in the exchange request to /api/integrations/wordpress/exchange.
* Pro activation: the activation key and site URL to /api/integrations/wordpress/license/activate.
* Status, reports and disconnection: a revocable installation token in the Authorization header to the WordPress integration API. The service returns access status, expiry, widget key and reporting data. Credentials are stored in WordPress options.
* Telemetry: batch identifier; event day, kind, coarse agent family, post ID, public post URL and count. Health data includes plugin version, WordPress version, whether WooCommerce is active, scanned-page count, average score, healthy/needs-work counts and enabled publishing/widget features. Only with telemetry enabled, batches are sent to /api/integrations/wordpress/telemetry during connected heartbeat or refresh activity. Scheduled activity is hourly and depends on WordPress cron.
* Widget events, only if connected and telemetry is enabled: event kind, current hostname and path, public widget key, placement and theme to /api/events. Events include widget display, open/click, copy, assistant opening and sharing. These requests can occur on display, before a visitor clicks the widget. Query strings and fragments are not included in the event path.

The WordPress telemetry payload does not include visitor IP addresses, cookies, email addresses or raw user-agent strings. However, ordinary network requests expose the sender's IP address and standard HTTP headers to the receiving service. Browser requests originate from the visitor's device. Do not interpret aggregate reporting as anonymous at the network level.

When a visitor chooses an assistant or a social-sharing destination, their browser opens that external service with the selected link/text where supported. Those destinations have their own policies. No assistant or social service is opened until the visitor chooses it.

Service terms: https://sharewithmyagent.ai/terms
Privacy policy: https://sharewithmyagent.ai/privacy

== Screenshots ==

1. Normal UI with the three-view switch on the WordPress test site.
2. Agents view showing readable product context, price and stock availability.
3. Crawlers view for inspecting page metadata and rendered content.
4. The sharing widget with assistant and copy controls.

== Changelog ==

= 2.3.2 =
* Add a bundled logo, plugin website link and compact optional Pro reporting section on the plugin settings page.
* Public output and consent defaults are unchanged.

= 2.3.1 =
* Enqueue separate local admin and widget stylesheets through WordPress.
* Restrict optional credit to one explicit footer opt-in on all plans; remove machine-output credits.
* Make the badge open current-page sharing controls instead of a vendor promotional link.
* Preserve physical llms.txt and percent-encoded URLs; link only to enabled plugin outputs.
* Report clipboard failures honestly and provide selectable manual-copy text.
* Clarify that crawler views and user-agent counts do not prove indexing or assistant recommendations.


= 2.3.0 =
* Combine WordPress and WooCommerce support in one directory edition.
* Keep local publishing and sharing available without an account, quota or time limit.
* Make external telemetry and public branding explicit opt-ins; reset legacy consent defaults on upgrade.
* Correct external-service disclosures, translation placeholders and request sanitization.
* Remove third-party logo artwork and clean up remaining plugin options on uninstall.

= 2.2.0 =
* Add public WooCommerce catalog and category mirrors with pricing and checkout guidance.
* Share the ten-item Free allowance across eligible pages, posts and products.
* Exclude hidden and draft products, private checkout content and Coming soon stores.
* Provide full-page Normal UI, Agents and Crawlers views.
* Bundle the sharing widget and preserve current-page and theme context.
* Require verified server access status before enabling Pro features.

= 2.1.3 =
* Preserve verified access settings and show expiry and renewal status.
* Validate shortcode placement and retain sharing configuration.

= 2.1.2 =
* Add full-page viewing modes, JSON and Markdown discovery, and keyboard navigation.

= 2.1.1 =
* Bound and batch aggregate telemetry uploads.

= 2.1.0 =
* Add aggregate endpoint reporting and installation health.

= 2.0.0 =
* Add local readability checks, JSON mirrors, virtual llms.txt and account connection.

= 1.0.0 =
* Initial release.
