=== CiteBoost GEO === Contributors: zivuch, freemius Tags: ai seo, schema markup, robots.txt, json-ld, ai visibility Requires at least: 6.0 Tested up to: 6.9 Requires PHP: 8.1 Stable tag: 1.4.1 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Optimize your WordPress site for AI search engines like ChatGPT, Claude, Gemini, and Perplexity. == Description == CiteBoost GEO helps your WordPress site get discovered and cited by AI search engines. It analyzes your content for AI readiness, fixes common crawling issues, and adds structured data so AI engines can understand and reference your pages. **Key Features (Free):** * **AI Visibility Score** — Scan all posts and pages to get a 0-100 readiness score for AI search engines * **Score Trend Chart** — Visualize your site-wide AI visibility score over 7, 30, or 90 days with an interactive line chart * **Score History** — Track how your AI visibility improves over time with score trend indicators * **Robots.txt Management** — Detect and fix blocked AI bots with one click (supports both physical and virtual robots.txt) * **Schema Detection** — See which posts have JSON-LD structured data and which types are missing * **Manual JSON-LD Editor** — Paste and validate your own JSON-LD markup * **Schema Backup & Transfer** — Export all saved schemas to a JSON file and import on another site (great for staging → production) * **Content Analysis** — Actionable recommendations for heading structure, word count, and content quality * **Author E-E-A-T Checks** — Verify author signals that AI engines look for * **Bot Crawl Tracking** — See which AI crawlers visit your site * **AI Referral Tracking** — Monitor clicks from ChatGPT, Claude, Perplexity, and other AI sources * **Accessible Dashboard** — WCAG-compliant interface with keyboard navigation **Pro Features:** * **AI Schema Generation** — Generate optimized JSON-LD using Claude, GPT, or Gemini (Article, FAQPage, HowTo, BlogPosting, and more) * **Quick Generate** — Build schema instantly from WordPress post data without API calls * **Citation Monitoring** — Check whether AI engines cite your content in their responses via the Perplexity API * **On-Demand Citation Checks** — Run citation checks any time with the Check Citations Now button * **Configurable AI Model** — Choose which model to use for schema generation * **Encrypted API Key Storage** — All API keys are encrypted at rest using Sodium Tracks 9 AI bots: GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-SearchBot, PerplexityBot, Google-Extended, Amazonbot, and Bytespider. Learn more at [wp-geo-optimizer.com](https://wp-geo-optimizer.com). == Installation == 1. Upload the `citeboost-geo` folder to `/wp-content/plugins/` 2. Activate the plugin through the **Plugins** menu in WordPress 3. Go to **CiteBoost GEO** in the admin sidebar 4. Click **Run Full Scan** to analyze your site 5. Use the **Robots.txt** tab to allow AI bots if any are blocked 6. Add schema markup from the **Schema** tab For Pro features, upgrade via the in-plugin checkout and add your API keys under **Settings**. == Frequently Asked Questions == = Which AI bots does CiteBoost GEO support? = The plugin tracks and manages access for 9 AI bots: GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-SearchBot, PerplexityBot, Google-Extended, Amazonbot, and Bytespider. The robots.txt fixer ensures all of these bots are allowed to crawl your site. = Is CiteBoost GEO free? = Yes. The free version includes AI visibility scanning for all posts and pages, robots.txt fixes, manual JSON-LD editing, content analysis, bot crawl tracking, and AI referral tracking. Pro adds AI-powered schema generation, citation monitoring, and additional dashboard checks. = Do I need API keys to use the plugin? = No. The free version works without any API keys. Pro users need API keys only for AI schema generation (Anthropic, OpenAI, or Google) and citation monitoring (Perplexity). All keys are encrypted at rest using Sodium. = Will CiteBoost GEO slow down my site? = No. The plugin only runs in the admin dashboard. The only frontend output is JSON-LD schema markup injected in the `` tag, which is lightweight and does not affect page load speed. = What schema types can the plugin generate? = Pro users can generate Article, BlogPosting, FAQPage, HowTo, LocalBusiness, Product, BreadcrumbList, and other schema types using AI. Free users can paste any valid JSON-LD markup manually. All schemas are validated before saving. = Does the plugin modify my robots.txt permanently? = If you have a physical robots.txt file, the plugin edits it directly. If WordPress generates robots.txt dynamically, the plugin uses a filter. Both methods can be disabled at any time. A confirmation prompt appears before disabling the fix. == External services == This plugin connects to the following external services when the user explicitly triggers them. No data is sent without user action. = Anthropic API (Claude) = Used for AI-powered JSON-LD schema generation when the user selects Claude as their AI provider and clicks "Generate". Sends: post title, excerpt, content summary, and selected schema type. [Terms of Service](https://www.anthropic.com/terms) | [Privacy Policy](https://www.anthropic.com/privacy) = OpenAI API (GPT) = Used for AI-powered JSON-LD schema generation when the user selects GPT as their AI provider and clicks "Generate". Sends: post title, excerpt, content summary, and selected schema type. [Terms of Service](https://openai.com/terms/) | [Privacy Policy](https://openai.com/privacy/) = Google Gemini API = Used for AI-powered JSON-LD schema generation when the user selects Gemini as their AI provider and clicks "Generate". Sends: post title, excerpt, content summary, and selected schema type. [Terms of Service](https://ai.google.dev/terms) | [Privacy Policy](https://policies.google.com/privacy) = Perplexity API = Used for checking if AI search engines cite your content when the user clicks "Check Citations Now". Sends: tracked search queries configured by the user in Settings. [Terms of Service](https://www.perplexity.ai/hub/terms-of-service) | [Privacy Policy](https://www.perplexity.ai/hub/privacy-policy) = Freemius SDK = Used for license management, in-plugin checkout, automatic updates, and optional usage analytics. Sends: site URL, plugin version, PHP version, and license status. The user is asked for consent during plugin activation opt-in. [Terms of Service](https://freemius.com/terms/) | [Privacy Policy](https://freemius.com/privacy/) == Source Code & Build Process == The JavaScript source code is included in the plugin under `assets/src/`. The compiled files in `assets/build/` are generated using [@wordpress/scripts](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-scripts/) (webpack). To build from source: 1. Install Node.js 18+ 2. Run `npm install` 3. Run `npm run build` — compiles `assets/src/index.js` → `assets/build/` == Screenshots == 1. Dashboard with AI visibility score, schema coverage, bot accessibility, and content readiness metrics 2. Individual check cards with pass/fail/warning status and direct action links 3. Robots.txt tab showing AI bot allow/block status with one-click fix 4. Schema tab with post list, schema type badges, and generation options 5. AI schema generation with type selection and JSON-LD preview 6. Analytics tab showing bot crawl history and citation monitoring 7. Settings panel with API key management and model selection == Upgrade Notice == = 1.4.1 = Packaging fix — removes stray files from the plugin zip. No code changes. = 1.4.0 = Safe upgrade. Adds a database index. No data modified. Backup recommended before any plugin update. == Changelog == = 1.4.1 = * Fix: Removed stray development files (Facebook ad HTML/PNG, plugin icons) that were inadvertently included in the 1.4.0 plugin zip. No code changes — packaging fix only. = 1.4.0 = * New: Score Trend chart on Dashboard — visualize AI visibility score over 7, 30, or 90 days * New: Schema Backup & Transfer — export all saved schemas to a JSON file, import on another site (staging → production workflows) * New: Dashboard now restores previous scan results on load — no need to re-scan every session * New: REST endpoint GET /cbgeo/v1/analyze/cached returns previously-stored scores * New: REST endpoint GET /cbgeo/v1/score-history with server-side 5-minute transient cache * New: REST endpoints GET /cbgeo/v1/schemas/export, POST /cbgeo/v1/schemas/import/preview, POST /cbgeo/v1/schemas/import/confirm * New: Score-history cache auto-invalidates after each scan so the chart updates immediately * New: Chart is WCAG-accessible with role="img" and descriptive aria-label for screen readers * New: CBGEO_FORCE_PRO wp-config constant for local Pro-feature testing * Improvement: Added analyzed_at index on cbgeo_scores table for faster score-history queries (DB v1.2.0) * Improvement: Post titles now stripped of HTML tags in schema panel and posts list * Improvement: Lazy-loaded Recharts library — main admin bundle reduced from 397KB to 51KB (87% smaller). Chart loads on demand when Dashboard tab is opened. * Improvement: Automatic one-time cleanup of orphaned schema rows during DB migration (schemas whose post was deleted). Manual cleanup button also added to Settings → Schema Backup. * Database changes: ADD KEY analyzed_at on wp_cbgeo_scores table. DELETE from wp_cbgeo_schemas where parent post is deleted/unpublished (one-time cleanup of orphaned rows only). No other data is modified. = 1.3.3 = * Fixed: schema type badge now updates immediately in post list after generating a schema * Fixed: dashboard schema coverage now refreshes automatically when switching tabs * Fixed: third-party plugin fatal errors no longer display raw HTML in the dashboard = 1.3.2 = * Fixed: third-party plugin fatal errors no longer display raw HTML in the dashboard * Improved error handling sanitization across all panels = 1.3.1 = * Quick Generate (template-based schema from post data) is now free for all users * Source code included in plugin package for WordPress.org compliance = 1.3.0 = * Renamed plugin to CiteBoost GEO * Migrated licensing from LemonSqueezy to Freemius SDK * In-plugin checkout — upgrade without leaving WordPress admin * Automatic plugin updates for Pro users * Documented all external service connections * Updated all internal prefixes for WordPress.org compliance = 1.2.3 = * Added multilingual support: Hebrew, Spanish, Arabic, German, Russian, Chinese, Japanese * Full RTL support for Hebrew and Arabic locales * JavaScript translations via wp_set_script_translations() * Plugin Check compliance: zero errors, zero warnings = 1.2.2 = * Improved batch scanning stability for sites with many posts * Better error messages in the dashboard * Minor UI polish and accessibility improvements = 1.2.1 = * Fixed schema validation edge case for nested JSON-LD arrays * Improved robots.txt detection for non-standard server configurations * Updated bot list with latest user agent strings = 1.2.0 = * Added Quick Generate for instant schema creation from post data (Pro) * Added support for OpenAI and Google Gemini models for schema generation * Added Check Citations Now button for on-demand citation checks (Pro) * Added citations pagination with Load More * Added score history with trend indicators * Added cancel button for batch scanning * Improved mobile responsive layout * Tab state now persists across page loads = 1.1.0 = * Added BlogPosting schema type support * Added rate limiting for schema generation (10 requests/min) * Added OAI-SearchBot and Amazonbot to tracked bot list * Improved database reliability with atomic write operations * Added WCAG accessible tab navigation with keyboard support * Added confirmation prompt before disabling robots.txt fix * Internationalization improvements for score descriptions = 1.0.0 = * Initial release == Upgrade Notice == = 1.3.0 = Plugin renamed to CiteBoost GEO. Licensing migrated to Freemius. In-plugin checkout and automatic updates.