=== AgizoAI Agentic Browsing Optimizer ===
Contributors: nr23
Tags: llms.txt, webmcp, ai, accessibility, woocommerce
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Prepare WordPress for AI agents with an agentic readiness dashboard, llms.txt, WebMCP-style form metadata, read-only discovery tools, accessibility checks, layout stability checks, WooCommerce readiness and SEO metadata integration.

== Description ==

AgizoAI Agentic Browsing Optimizer helps site owners make public WordPress content easier for AI agents, browser assistants and LLM crawlers to understand safely. It is intentionally broader than a basic llms.txt generator: the plugin combines LLM discovery files with WebMCP-style form metadata, safe public read-only REST discovery tools, accessibility-for-agents checks, layout-stability analysis, WooCommerce public product readiness and SEO metadata integration.

Plugin page and documentation: https://www.agizoai.com/agizoai-agentic-browsing-optimizer

The plugin creates dynamic agent-facing files, optional public read-only REST discovery tools, form metadata for supported public forms, accessibility-for-agents checks, layout-stability checks, WooCommerce public product readiness and SEO metadata integrations.

This plugin keeps the grouped mobile-friendly navigation, directory-ready green branding and every feature free.


= What makes this different =

This plugin is not submitted as another standalone llms.txt generator. Its main purpose is agentic browsing optimisation for WordPress: a combined workflow for LLM discoverability, safe read-only public tool discovery, form clarity, accessibility for agents, layout stability, WooCommerce public product readiness and SEO metadata alignment.

The plugin is designed for site owners and agencies who need a practical readiness dashboard and exportable reports, not only a text file.

= Core features =

* Dynamic `/llms.txt` endpoint.
* Dynamic `/llms-full.txt` endpoint.
* Setup wizard for safe defaults.
* Agentic Score dashboard.
* Grouped modern admin navigation.
* HTML, Markdown and JSON report exports.
* Public post type and taxonomy selection.
* Noindex-aware filtering for common SEO metadata.
* Private, draft and password-protected content excluded by default.
* Optional robots.txt reference.
* Safe read-only mode.
* WebMCP-style form metadata foundation.
* Native WordPress search form enhancement.
* Public content form enhancement for rendered form HTML.
* Contact Form 7 rendered-form enhancement.
* Detection for Contact Form 7, WPForms, Gravity Forms, Ninja Forms, Formidable Forms and raw HTML forms.
* Public read-only REST tool registry.
* Public site information endpoint.
* Public content search endpoint.
* Public content summary endpoint.
* Recent public content endpoint.
* Public navigation menus endpoint.
* Public taxonomy sections endpoint.
* Accessibility-for-agents scanner.
* Missing image alt text detection.
* Empty and vague link text detection.
* Button accessible-name checks.
* Form field name and label checks.
* Heading hierarchy checks.
* Layout Stability admin tab.
* Missing image and iframe dimension checks.
* Ad-slot reserved-space checks.
* Optional frontend helper CSS for common ad slots.
* Sticky header offset helper.
* WooCommerce Agentic Readiness scanner.
* Public read-only product search endpoint.
* Public read-only product detail endpoint.
* Public read-only product categories endpoint.
* Product summary, image alt and category checks.
* SEO metadata integrations for Real SEO Master-style fields, Yoast SEO, Rank Math, All in One SEO, SEOPress and WordPress core fallback.
* Optional SEO descriptions in `llms.txt` summaries.
* Optional SEO metadata fields in public read-only content tools.
* No Pro locks.

= Public read-only endpoints =

When enabled by an administrator, the plugin can expose public read-only endpoints such as:

* `/wp-json/agizoai-agentic/v1/tools`
* `/wp-json/agizoai-agentic/v1/site`
* `/wp-json/agizoai-agentic/v1/search`
* `/wp-json/agizoai-agentic/v1/content/{id}`
* `/wp-json/agizoai-agentic/v1/recent`
* `/wp-json/agizoai-agentic/v1/menus`
* `/wp-json/agizoai-agentic/v1/taxonomies`
* `/wp-json/agizoai-agentic/v1/products`
* `/wp-json/agizoai-agentic/v1/product/{id}`
* `/wp-json/agizoai-agentic/v1/product-categories`

These endpoints are intentionally read-only and only return selected public information.

== Installation ==

1. Upload the plugin ZIP through Plugins > Add New > Upload Plugin.
2. Activate the plugin.
3. Open AgizoAI Agentic in the WordPress admin menu.
4. Complete the Setup Wizard.
5. Visit https://www.agizoai.com/agizoai-agentic-browsing-optimizer for the plugin showcase page and usage notes.
6. Review llms.txt, Forms & WebMCP, Agent Tools, Accessibility, Layout Stability, WooCommerce, Integrations and Reports.
7. Export an HTML, Markdown or JSON report if needed.

== Frequently Asked Questions ==

= Does this expose private content? =

No. Private, draft and password-protected content are excluded by default. Private content inclusion is disabled unless an administrator manually enables it.

= Do the agent tools change my site? =

No. The included tools are public read-only only. They do not submit forms, create content, update posts, update settings, process payments, change carts or modify orders.

= Are the REST endpoints public? =

Yes, if enabled. They are designed for public discovery and only return published public content selected in the plugin settings.

= Does this submit forms automatically? =

No. It only adds metadata attributes to supported public forms. Your existing form plugin still controls validation, spam protection, CAPTCHA, nonces and submissions.

= Does this add checkout or payment automation? =

No. The WooCommerce module adds read-only product discovery only. It does not add cart, checkout, coupon, customer, order, account or payment automation.

= Does the layout helper change my frontend? =

Only if you enable both frontend helper CSS and ad-slot reservation in the Layout Stability tab. The helper is optional and disabled by default.

= Does it replace SEO plugins? =

No. It complements SEO plugins by using their public metadata as a clearer agent-facing summary layer.

= Is every option free? =

Yes. The plugin has no Pro locks.

== Screenshots ==

1. Agentic Score dashboard with grouped checks.
2. Setup Wizard for site type, purpose and safe public defaults.
3. llms.txt preview and generation settings.
4. Forms & WebMCP metadata settings.
5. Agent Tools registry preview.
6. Accessibility and Layout Stability scanner sections.
7. WooCommerce and SEO metadata integration sections.
8. Exportable report screen.

== Privacy ==

This plugin does not collect analytics, does not call external services, does not send site data to AgizoAI and does not add remote scripts.

If public read-only REST tools are enabled, the site may expose selected published public content through the listed REST endpoints. Administrators control which modules are enabled. Private, draft and password-protected content are excluded by default.

== Changelog ==
= 1.0.4 =
* Addressed WordPress.org pre-review feedback.
* Removed generated report style tags from plugin output.
* Replaced public REST permission callbacks with explicit public read-only permission methods.
* Removed the translation loader call that is not needed for WordPress.org-hosted plugins.
* Updated the readme contributor username and clarified the plugin's distinct agentic browsing scope.

= 1.0.3 =
* Added the official AgizoAI plugin showcase page to the plugin header and readme.
* Updated the Plugin URI to https://www.agizoai.com/agizoai-agentic-browsing-optimizer.
* Kept the review-ready build clean, free and without the extra planning admin section.

= 1.0.2 =
* Removed the extra planning section from the admin interface for a cleaner WordPress.org review build.
* Refreshed the admin colour direction with green AgizoAI accents.
* Updated WordPress.org-ready assets to avoid version-specific artwork.
* Kept all public agent tools read-only and every option free.

= 1.0.1 =
* Fixed admin page access by restoring the stable admin menu slug used by earlier versions.
* Fixed internal dashboard, tab, report and cache-regeneration links after the WordPress.org text-domain cleanup.
* Kept grouped mobile-friendly admin navigation and all v1.0.0 features.

= 1.0.0 =
* Stable WordPress.org-ready release.
* Updated plugin headers and readme stable tag to 1.0.0.
* Improved grouped admin navigation for easier management.
* Added mobile-friendly jump selector for plugin sections.
* Improved navigation accessibility with clearer labels and aria-current support.
* Updated text domain to match the plugin slug.
* Added WordPress.org directory-ready readme structure.
* Kept all features free with no Pro locks.

= 0.7.0 =
* Added SEO Metadata Integrations admin tab.
* Added Real SEO Master-style metadata detection and extraction.
* Added Yoast SEO metadata extraction.
* Added Rank Math metadata extraction.
* Added All in One SEO metadata extraction.
* Added SEOPress metadata extraction.
* Added WordPress core fallback source.
* Added preferred metadata source selector with auto mode.
* Added SEO metadata coverage scanner and score group.
* Added optional SEO descriptions in llms.txt summaries.
* Added optional SEO metadata fields in public read-only content tools.
* Added SEO metadata section to HTML, Markdown and JSON reports.

= 0.6.0 =
* Added modern mobile-ready pill tab navigation.
* Added WooCommerce Agentic Readiness admin tab.
* Added WooCommerce product-readiness scanner.
* Added safe public read-only product search endpoint.
* Added safe public read-only single product endpoint.
* Added safe public read-only product categories endpoint.
* Added WooCommerce product tools to the public tool registry when WooCommerce is active and tools are enabled.

= 0.5.0 =
* Added Layout Stability admin tab.
* Added public content layout-shift scanner.
* Added missing image width/height checks.
* Added iframe/embed reserved-space checks.
* Added likely ad-slot reserved-space checks.
* Added optional frontend CSS helper for common ad slots.
* Hardened third-party WordPress admin notice contrast and hero button visibility.

= 0.4.0 =
* Added Accessibility admin tab.
* Added lightweight accessibility-for-agents public content scanner.
* Added image alt text checks.
* Added empty and vague link text checks.
* Added button accessible-name checks.
* Added form field name and label checks.
* Added heading hierarchy checks.
* Fixed Registry Preview contrast/readability.

= 0.3.0 =
* Added Agent Tools admin tab.
* Added safe public read-only REST tool registry.
* Added public site info, content search, content summary, recent content, menus and taxonomy endpoints.
* Added per-tool enable/disable controls.
* Added tool registry preview and copy action.

= 0.2.0 =
* Added Forms & WebMCP admin tab.
* Added WebMCP support switch.
* Added declarative form metadata switch.
* Added native WordPress search form enhancement.
* Added Contact Form 7 rendered-form enhancement.
* Added supported-form detection and metadata scanner warnings.

= 0.1.2 =
* Fixed admin success notice contrast and visibility.
* Added clearer custom dismissible notices.

= 0.1.1 =
* Added first-run setup wizard.
* Added richer Agentic Score dashboard.
* Added report exports.
* Improved admin UX and copy buttons.

= 0.1.0 =
* Initial foundation build.
* Added /llms.txt and /llms-full.txt endpoints.
* Added dashboard, readiness score and safe settings.

== Upgrade Notice ==

= 1.0.0 =
Stable free release with improved navigation and WordPress.org-ready metadata. Existing 0.x settings are preserved.
