=== 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.6.0 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 Goal Line** — Set a target AI visibility score; the chart shows a reference line so you always know where you stand * **Automatic Weekly Scan** — Schedule a recurring scan so your score history stays fresh without manual effort * **Schema Bulk Operations** — Manage schemas for up to 50 posts at once (generate, delete, activate, deactivate) * **Recommendations Checklist** — Track your content optimization progress with checkboxes and a progress bar * **Schema Templates Library** — Pre-built recipes for Product, Recipe, Event, LocalBusiness, Review, Course schemas * **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 * **Per-Post Score History** — See each page's AI visibility trend over time, right inside the Schema tab * **Weekly Email Digest** — Receive a weekly summary email with score trend, top improvers, and bot activity 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 == = My weekly digest emails are going to spam. How do I fix this? = This is a WordPress email deliverability issue, not a CiteBoost GEO bug. By default, WordPress sends email via PHP `mail()`, which lacks SPF, DKIM, and DMARC — so Gmail, Outlook, and other providers often flag it as spam. The fix is to install an SMTP plugin and configure it with your email provider (SendGrid, Mailgun, Amazon SES, Gmail, etc.): * **WP Mail SMTP** — https://wordpress.org/plugins/wp-mail-smtp/ * **FluentSMTP** — https://wordpress.org/plugins/fluent-smtp/ * **Post SMTP** — https://wordpress.org/plugins/post-smtp/ After setup, test the digest again with the "Send Test Email" button in Settings → Preferences. = 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.6.0 = Weekly email digest (Pro), schema bulk operations, recommendation checklist, templates library. No database changes. = 1.5.1 = Dashboard now shows last scan time and next scheduled auto-scan. No database changes. = 1.5.0 = Adds per-post score history chart (Pro), goal line, and optional automatic weekly scan. No database changes. Backup recommended before any plugin update. = 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.6.0 = * New: Weekly email digest (Pro) — receive a weekly summary email with score trend, top improvers, pages that dropped, and bot activity. Configure day/hour in Settings → Preferences. * New: Schema bulk operations (Free) — select multiple posts on the Schema tab and generate templates, delete, activate, or deactivate schemas in one click. Up to 50 posts per action. * New: Recommendations checklist (Free) — content tips are now trackable checkboxes with a progress bar. Check them off as you apply them; state persists per post. * New: Schema templates library (Free) — browse pre-built schema recipes (Product, Recipe, Event, LocalBusiness, Review, Course). Fill in placeholder values and apply with one click. * New: REST endpoints: POST /cbgeo/v1/digest/test, POST /cbgeo/v1/schemas/bulk, POST /cbgeo/v1/recommendations/{post_id}, GET /cbgeo/v1/templates/library * Database changes: None. No schema changes, no data modifications. New features use existing tables + post meta + options. = 1.5.1 = * New: Dashboard now shows "Last scan" timestamp and "Next auto-scan" time below the Re-Scan button, so you always know when the last analysis ran and when the next automatic one is coming * Database changes: None. = 1.5.0 = * New: Per-post score history chart (Pro) — see how each page's AI visibility changed over time in the Schema tab detail view * New: Score goal line on the Score Trend chart — set your target (default 80) in Settings → Preferences and a green reference line appears on the chart * New: Automatic weekly scan (Free) — enable in Settings → Preferences, pick a day and hour, and CiteBoost GEO will re-scan your site weekly so the chart always has fresh data * New: REST endpoint GET /cbgeo/v1/score-history/{post_id} * New: REST endpoint POST /cbgeo/v1/settings/preferences * Database changes: None. No schema changes, no data modifications. = 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.