=== BeraLab GEO Engine - Generative Engine Optimization & Structured Data ===
Contributors: beralabs, kingbera
Plugin URI: https://beralabs.it/beralab-geo-engine/
Author URI: https://beralabs.it
Donate link: https://beralabs.it
Tags: geo, generative-ai, schema, json-ld, structured-data
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Optimize your WordPress site for AI search engines with semantic JSON-LD Knowledge Graphs and dynamic llms.txt endpoints.

== Description ==

**BeraLab GEO Engine** is a WordPress plugin specifically engineered for **Generative Engine Optimization (GEO)** and AI Search Engines (ChatGPT Search, Perplexity AI, Google Gemini, Claude, and Copilot).

While standard SEO focuses strictly on keywords and page rankings for traditional search crawlers, Generative Engine Optimization (GEO) ensures your technical metadata and content structure are recognized, parsed, and cited accurately by Large Language Models (LLMs).

Unlike basic text-file generators, BeraLab GEO Engine bridges **structured semantic data** and **crawler-accessible text indexes** into a cohesive system:

### 1. Semantic JSON-LD Knowledge Graph
* Generates interconnected `@graph` schema entities for `Organization`/`Person`, `WebSite`, `Article`, and `BreadcrumbList`.
* Injects enriched `knowsAbout`, `sameAs` authoritative profiles, `about`, and `mentions` nodes derived from taxonomy relationships to establish topical authority.
* Fully compatible with standard Schema.org specifications and Google Rich Results guidelines.

### 2. Dynamic llms.txt & llms-full.txt Generator
* Exposes standard `/llms.txt` and `/llms-full.txt` endpoints via the WordPress Rewrite API without writing static files to disk.
* Formats clean, structured Markdown summaries optimized for AI context windows and web crawlers.
* Built-in transient caching optimizes performance by storing structured responses in memory.

### Features
* **Lightweight Architecture**: Uses native WordPress Settings API without external option frameworks or heavy dependencies.
* **WordPress.org Compliant**: Adheres to WordPress Coding Standards, strict input sanitization, and late output escaping.
* **Developer Friendly**: Provides filters (`beralab_geo_engine_schema_graph`, `beralab_geo_engine_llms_txt_content`) for full customization.
* **Privacy Focused**: Operates locally with no third-party tracking, external telemetry, or remote calls.
* **Cross-Platform Pedigree**: Part of the BeraLab open source suite, also available for Joomla! as BeraLab GEO Engine for Joomla on the official Joomla! Extensions Directory (JED ID: 17790).

== Installation ==

1. Upload the `geo-schema-forge-generative-engine-optimization-structured-data` folder to your `/wp-content/plugins/` directory, or install the .zip directly via **Plugins > Add New > Upload Plugin**.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Navigate to **Settings > BeraLab GEO Engine** to configure your Entity profile, social links, and AI index settings.
4. Visit `yoursite.com/llms.txt` in your browser to verify your dynamic AI index.

== Frequently Asked Questions ==

= What is Generative Engine Optimization (GEO)? =
GEO is the process of optimizing content and technical metadata so it can be accurately identified, parsed, and cited as an authoritative source by Generative AI engines such as ChatGPT, Perplexity, and Gemini.

= How does this differ from simple llms.txt plugins? =
Most plugins only output a static list of URLs. BeraLab GEO Engine creates a dual-layer optimization system: it outputs deep JSON-LD Knowledge Graphs (linking entities, authors, knowsAbout topics, and semantic taxonomies) and simultaneously exposes dynamically rendered `/llms.txt` and `/llms-full.txt` endpoints matching the entity definitions.

= Does this plugin create physical files on my server? =
No. Both `/llms.txt` and `/llms-full.txt` are rendered dynamically on request using WordPress rewrite rules and cached via WordPress Transients.

= Can I use this alongside other SEO plugins? =
Yes. BeraLab GEO Engine outputs modular JSON-LD schemas and dedicated `/llms.txt` endpoints that complement standard XML sitemaps and on-page SEO meta tags.

= Is there an edition available for Joomla or other CMS platforms? =
Yes. BeraLab provides cross-platform Generative Engine Optimization solutions. For Joomla! websites, our sister extension "BeraLab GEO Engine for Joomla" is officially verified and listed on the Joomla! Extensions Directory (JED ID: 17790, https://extensions.joomla.org/extension/geo-schema-forge-for-joomla/).

= Where can I get support or get in touch? =
For technical assistance, feature requests, or enterprise support, please reach out directly to the BeraLab engineering team at info@beralabs.it or visit https://beralabs.it.

== Changelog ==

= 1.0.1 =
* Compliance bump for WordPress.org Plugin Directory submission.
* Sanitized docblocks, CSS prefixes, and asset loading.
* Soft rewrite rules flush on activation and deactivation.
* Enhanced markdown response headers for AI crawlers.
* Package optimization: excluded repository banner assets and blueprints from production plugin zip.

= 1.0.0 =
* Initial release of BeraLab GEO Engine.
* Semantic JSON-LD Knowledge Graph generation (Organization, WebSite, Article, BreadcrumbList).
* Dynamic `/llms.txt` and `/llms-full.txt` endpoint rendering with transient caching.
* Native WordPress Settings API dashboard.

== Upgrade Notice ==

= 1.0.1 =
Compliance updates and performance refinements for WordPress.org directory.
