=== Georix – GEO & AI Citation ===
Contributors: ankit087087
Tags: geo, llms.txt, schema, ai, local business
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Get cited by ChatGPT, Perplexity & Google AI. llms.txt, FAQ/HowTo schema, LocalBusiness wizard, and GEO audit — no API keys.

== Description ==

**Stop being invisible to AI.** While everyone focuses on Google rankings, AI engines like ChatGPT, Perplexity, and Google AI Overviews are answering your customers' questions — and citing your competitors instead of you.

**Georix** fixes that from inside WordPress, with no coding and no API keys required.

= How it works =

The plugin automatically creates two live URLs on your site:

* **yoursite.com/llms.txt** — a structured plain-text summary: who you are, your key pages, topics, services, and authors
* **yoursite.com/llms-full.txt** — an extended version with full content excerpts, dates, and attribution

These files are served **automatically by WordPress** — no manual file creation, no FTP, no file permissions to worry about. The moment you activate the plugin and save your settings, the URLs are live. AI crawlers (GPTBot, ClaudeBot, PerplexityBot, and others) read these files to understand your site before deciding whether to cite you in their answers.

Traditional SEO gets you into Google blue links. **GEO (Generative Engine Optimisation)** gets you cited inside AI-generated answers. They are different disciplines — this plugin handles both from a single settings page.

= Who is it for =

* **Local service businesses** — dental clinics, law firms, accountants, restaurants, salons, gyms, medical practices
* **Bloggers and content publishers** who want AI engines to summarise and cite their articles
* **SaaS and product sites** that want to appear in AI-generated comparisons and recommendations
* **Agencies** managing multiple client sites — one plugin, consistent GEO setup across all sites

= Core Features =

**Automatic File Generation (No files to create manually)**

* Auto-generates `/llms.txt`, `/llm.txt` (alias), `/llms-full.txt`, and optional `/ai.txt` served live from your WordPress site
* Works entirely through WordPress URL rewriting — no disk writes, no file permissions, no FTP
* `<head>` discoverability links, robots.txt AI crawler rules, and discovery-file comment block
* llms.txt Health Panel, physical file conflict detection, and robots.txt conflict alerts
* Crawler visit logging with 40+ bot registry (90-day history, CSV export)
* Intelligent content filtering — skips cart, checkout, login, privacy, and other non-content pages automatically
* Configurable minimum word count to exclude thin or placeholder pages
* Quality-scored post ordering — posts with excerpts, schema, and recent updates rank higher in the output
* WPML and Polylang support — discovery files grouped by language with correct per-locale URLs and content

**Schema & Structured Data (Helps both AI and Google)**

* **LocalBusiness Schema Wizard** — 100+ schema.org business types (Dentist, Solicitor, Restaurant, Accountant, and many more including India-specific types like Ayurvedic Clinic, CA Firm, Tiffin Service), opening hours, price range, address, phone number, and social profiles — output as JSON-LD on every page automatically
* **FAQ Gutenberg Block** — add Q&A items that output FAQPage JSON-LD schema, making your FAQs eligible for Google rich results and AI citation
* **HowTo Gutenberg Block** — step-by-step guides with HowTo JSON-LD schema for processes, tutorials, and guides
* Organization, Article, BreadcrumbList, and speakable schema output site-wide

**GEO Content Tools (Unique to this plugin)**

* **GEO Content Audit sidebar** — live per-post checklist in the block editor scoring your content across 9 GEO checks: H2 headings, word count, FAQ block, HowTo block, manual excerpt, freshness, definition paragraph, statistics, and quotable sentence. Updates in real time as you edit — no save required.
* **FAQ Question Suggester** — detects your page's niche (dental, legal, medical, accounting, restaurant, or generic) from the title, categories, tags, and content. Returns 8 ready-to-use question/answer pairs. Inserts directly as a FAQ block at the bottom of your post with one click. No API call — works completely offline.
* **EEAT & AEO Readiness Score** — 0–100 score across 5 pillars: Clarity, Authority, Comprehensiveness, Recency, and Structure. Shows exactly what is passing and what needs attention.

**Technical Controls**

* **AI Crawler Manager** — per-bot Allow/Disallow toggles for GPTBot, ClaudeBot, PerplexityBot, Google-Extended, Applebot-Extended, Bytespider, cohere-ai, and FacebookBot written to robots.txt
* **Custom Sections builder** — add your own sections with headings and links directly to llms.txt from the admin UI (no code)
* **Check File Status** — live HTTP test confirms your llms.txt and llms-full.txt are serving correctly
* **Flush Rewrite Rules** — one-click fix if the URLs ever return a 404 after a theme or plugin change

= No API Keys. No Coding. No File Uploads. =

Everything works out of the box after activation. Fill in your organisation name and description, save, and your llms.txt is live within 30 seconds.

= Privacy =

This plugin does not collect, store, or transmit personal data to the plugin author's servers. Crawler visit logs (bot name, user agent, IP address, timestamp) are stored only in your WordPress database when logging is enabled. All other processing happens on your own site.

== External services ==

This plugin does **not** send site content or personal data to the plugin author's servers or to third-party APIs.

**Site health checks (your own site only)**

When you click "Check File Status" or when the Health panel runs validation, the plugin makes HTTP requests from your WordPress install to your own site's public URLs (for example `/llms.txt` and `/robots.txt`). These self-requests confirm that discovery files are reachable. No data is sent to external servers.

**WPML / Polylang (optional, if installed)**

If WPML or Polylang is active, the plugin reads language configuration from those plugins locally to group llms.txt output by locale. The plugin does not make additional outbound requests to WPML or Polylang services beyond what those plugins already do on your site.

**Bot documentation links (admin reference only)**

The AI Crawlers admin tab lists known crawlers with links to each provider's public documentation (for example [OpenAI GPTBot](https://platform.openai.com/docs/gptbot), [Google crawlers](https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers), [Anthropic](https://www.anthropic.com), [Amazonbot](https://developer.amazon.com/amazonbot)). These are display-only reference URLs in the WordPress admin. The plugin does not connect to those services or transmit your site data to them.

== Installation ==

= Install and activate =

1. In your WordPress admin, go to **Plugins → Add New**.
2. Search for **Georix**, then click **Install Now** and **Activate**.
   *(Or upload the plugin ZIP via **Plugins → Add New → Upload Plugin**.)*

= Quick start (5 minutes) =

3. Go to **Settings → Georix**.
4. Enter your **Organisation Name** and **Site Description** — 1–2 sentences about what you do and who you serve. This is the most important field; AI engines read it first.
5. Under **Post Types to Include**, tick at least **Posts** and **Pages**.
6. Click **Save Changes**.
7. Visit `yoursite.com/llms.txt` in your browser — the file is live immediately.
8. On the settings page, click **Check File Status** to confirm the URL returns HTTP 200.

= Recommended setup (optional but high impact) =

9. Open the **Local Business** tab if you run a local or service business. Choose your business type, enter address, phone, opening hours, and price range. JSON-LD schema is output site-wide automatically — no shortcode or template change needed.
10. Open the **Custom Sections** tab to add links WordPress does not expose automatically — services, team pages, case studies, pricing, or resources.
11. Edit your homepage and top service pages in the block editor. Add a **FAQ Block** (search for "FAQ" in the block inserter) with 3–5 real questions and answers. This is the single highest-impact step for AI citation.
12. While editing a post or page, open the **GEO Content Audit** sidebar (right panel). Use the live checklist to improve headings, word count, excerpts, and structure. Click **Suggest FAQ Questions** to insert ready-made Q&A pairs for your niche.
13. Open the **AI Crawlers** tab and set Allow/Disallow for each bot (GPTBot, ClaudeBot, PerplexityBot, and others). Rules are written to your `robots.txt` automatically.
14. Open the **EEAT & AEO Score** tab for a site-wide readiness score and a checklist of what still needs attention.

= If /llms.txt returns a 404 =

Go to **Settings → Permalinks** and click **Save Changes** (this re-registers WordPress URL rules). Or use the **Flush Rewrite Rules** button on the plugin settings page. This only needs to be done once.

**Note:** The plugin requires a permalink structure other than **Plain**. Use **Post name** or any custom structure. Plain permalinks are not supported because `/llms.txt` is served via WordPress rewrite rules.

== Frequently Asked Questions ==

= Do I need to create the llms.txt file manually? =

No. The plugin creates the URLs automatically through WordPress. There is no file to upload, no FTP access needed, and no file permissions to configure. Visit `yoursite.com/llms.txt` immediately after saving your settings and it is live.

= My /llms.txt returns a 404 — how do I fix it? =

Go to **Settings > Permalinks** and click Save Changes. This flushes WordPress rewrite rules. If the 404 persists, use the **Flush Rewrite Rules** button on the plugin settings page. Note: the plugin does not work if your permalink structure is set to Plain (default WordPress install). Change it to Post name or any other option.

= Does this plugin require any API keys? =

No. Every feature works with zero configuration and zero API keys. Fill in your name and description and you are done.

= Will this slow my site down? =

No. The llms.txt content is generated and cached for 6 hours. Regular visitor page loads are completely unaffected — the plugin only runs when `/llms.txt` or `/llms-full.txt` is specifically requested, not on every page load.

= Does it work with Elementor, Divi, or other page builders? =

Yes. The file generation, schema output, AI Crawlers tab, and GEO Content Audit all work with any page builder. The FAQ and HowTo Gutenberg blocks require the WordPress block editor. The FAQ Question Suggester works on Elementor pages — it shows suggested questions in a copy box so you can paste them into your page builder's FAQ widget.

= Does it work with the Classic Editor? =

The FAQ and HowTo blocks and FAQ Question Suggester require the block editor. All other features — file generation, schema output, AI Crawlers, LocalBusiness wizard — work with any editor.

= How long until AI engines start citing my site? =

Typically 4–12 weeks after your llms.txt is live and your key pages have FAQ blocks. Adding FAQ blocks to your homepage and top service pages has the biggest impact. AI crawlers recrawl sites regularly — once your content is indexed by them, citations follow.

= Does this affect my regular Google SEO? =

The llms.txt and llms-full.txt files are ignored by Google's main search crawler. The JSON-LD schema (FAQ, HowTo, LocalBusiness) the plugin outputs is standard structured data that Google reads and can reward with rich results in search.

= Is the FAQ Question Suggester free? =

Yes, completely free. It works offline with no API call — all niche-specific question and answer templates are stored locally inside the plugin.

= Does it work with WPML or Polylang? =

Yes. When WPML or Polylang is active with two or more languages, Georix automatically groups `/llms.txt` and `/llms-full.txt` by language. Each section includes that language's homepage, key pages, posts, categories, and correct permalinks. Per-language taglines are used when available. You can toggle this under **Settings → Georix**.

= Does it work on multisite? =

Not yet. Multisite support is planned for a future release.

= Can I control which AI bots can access my content? =

Yes. The AI Crawlers tab lets you individually allow or block GPTBot (ChatGPT), ClaudeBot, PerplexityBot, Google-Extended, Applebot-Extended, Bytespider, cohere-ai, and FacebookBot. Changes are written directly to your robots.txt.

== Screenshots ==

1. Settings overview — organisation name, description, post types, discovery files, and word count threshold
2. LocalBusiness Schema Wizard — 100+ business types, opening hours, address, phone, and price range
3. Health tab — discovery file status, validation checks, HTTP 200 test, and conflict alerts
4. Crawler Analytics — visit counts, unique bots, and CSV export of AI crawler traffic
5. AI Crawlers tab — per-bot Allow/Disallow toggles with full bot registry and robots.txt conflict detection
6. Preview llms-full.txt — live preview of the extended discovery file with full content excerpts
7. Preview llms.txt — live preview of the primary AI discovery file, generated straight from the admin
8. EEAT & AEO Score tab — 5-pillar 0–100 readiness score with per-check breakdown
9. Documentation tab — built-in step-by-step setup guide
10. GEO Content Audit sidebar — live per-post score updating in real time as you edit
11. FAQ Question Suggester — niche detection with ready-to-insert question/answer pairs

== Changelog ==

= 1.0.0 =
* Initial public release
* Auto-generates /llms.txt and /llms-full.txt served live via WordPress URL rewriting — no file uploads needed
* `/ai.txt` AI usage permissions file with admin toggle and policy settings
* `/llm.txt` compatibility alias (same content as llms.txt)
* `<link rel="alternate">` discoverability tags in site `<head>`
* LocalBusiness Schema Wizard with 100+ schema.org types including India-specific business categories
* AI Crawler Manager — per-bot Allow/Disallow for 8 AI crawlers written to robots.txt, with 40+ bot registry, robots.txt conflict detection, and expanded directives
* Custom Sections builder — add your own sections and links to llms.txt from the admin UI
* FAQ Gutenberg block with FAQPage JSON-LD schema
* HowTo Gutenberg block with HowTo JSON-LD schema
* FAQ Question Suggester with niche detection — dental, legal, medical, accounting, restaurant, generic
* GEO Content Audit sidebar — live 9-check score updating in real time in the block editor, with Elementor-aware word count and heading detection
* Organization, Article, BreadcrumbList, and speakable schema output site-wide
* EEAT and AEO Readiness Score — 5-pillar 0–100 score
* WPML and Polylang support — llms.txt and llms-full.txt grouped by language with per-language URLs, taglines, key pages, and content
* Crawler visit logging (database table, daily cleanup cron, Crawler Analytics tab)
* llms.txt Health Panel with HTTP status, cache, permalink, and conflict checks
* Physical file conflict detection and admin warnings
* SEO plugin noindex filtering (Yoast, Rank Math, SEOPress, AIOSEO)
* Per-post include/exclude controls and content selection modes (translation-aware)
* Intelligent content filtering with configurable minimum word count
* Quality-scored post ordering for better llms.txt output
* Check File Status tests all active discovery URLs
* Documentation tab with step-by-step guidance built into the plugin
* All features fully unlocked — no license keys, no Pro tier, no usage limits

== Upgrade Notice ==

= 1.0.0 =
First public release. Install and activate — your /llms.txt will be live within 30 seconds.
