=== Smarketing Cloud - AI Website Builder, SEO & CRO for WordPress ===
Contributors: smarketingcloud
Tags: ai, seo, page builder, gutenberg, elementor, marketing automation, crm, tracking, personalization, aeo, geo
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.4.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn your WordPress site into an autonomous marketing asset with AI-powered website building, SEO autopilot, AI search visibility, and CRM-driven personalization.

== Description ==

**Smarketing Cloud** connects your WordPress site to the Smarketing Cloud marketing automation platform, giving you AI-powered tools to build better websites, rank higher in search, get cited by AI engines, and convert more visitors — all on autopilot.

= 🤖 AI Search Visibility (AEO/GEO) — NEW =
Optimize your site for next-generation AI search engines like ChatGPT, Perplexity, and Google AI Overviews:

* **llms.txt Generator** — Auto-generates a machine-readable site summary for AI crawlers at `/llms.txt`
* **AI Bot Access Manager** — Automatically allows 8 AI search crawlers (ChatGPT, Perplexity, Claude, Gemini, etc.) in robots.txt
* **Content Freshness Tracker** — Color-coded staleness indicators (🟢/🟡/🔴) in your posts list
* **AI Search Readiness Score** — Dashboard widget scoring your site 0-100 across 8 AEO/GEO signals
* **Answer-First Content Audit** — Post editor meta box scoring "AI quotability" (0-100) with 10 criteria and fix suggestions
* **Enhanced Entity Schema** — Auto-generates Person, Product, AboutPage, ContactPage, FAQPage schemas
* **AI Citation Tracker** — Weekly monitoring of whether AI search engines are citing your content, with per-keyword reports

= 🏗️ AI Website Builder =
Generate entire pages and websites using AI directly inside your favourite editor:

* **Gutenberg** — "✨ Build with AI" sidebar panel with a chat-based generation flow
* **Elementor** — AI generation button in the top bar, inserts native Elementor widgets
* Choose from 4 design styles: Modern, Classic, Bold, Minimal
* AI uses your Brand DNA (colours, fonts, voice) from Smarketing Cloud
* Iterative refinement — chat with AI to adjust sections after generation

= 📝 AI Blog Publishing =
Publish AI-generated blog posts remotely from Smarketing Cloud:

* Auto-create WordPress categories and tags
* Featured image upload from URL
* Yoast SEO and RankMath meta injection
* Scheduled and draft post support

= 🔍 SEO Autopilot =
Automatic SEO optimization that runs in the background:

* Auto-generate meta titles and descriptions using AI
* Auto alt text for images on upload
* 10-criteria SEO score per page
* Broken link scanner
* Weekly SEO health reports sent to your Smarketing Cloud dashboard

= 🏷️ Schema Markup (JSON-LD) =
Automatic structured data for rich search results:

* Article schema for blog posts (with SpeakableSpecification)
* Organization schema site-wide
* BreadcrumbList navigation schema
* FAQPage schema (detects Gutenberg Details blocks and Elementor accordions)
* HowTo schema (auto-detects step-by-step patterns)
* LocalBusiness schema (configurable)
* Person schema for author pages (E-E-A-T signals)
* Product schema for WooCommerce (offers, ratings, SKU)
* WebPage subtypes (AboutPage, ContactPage, FAQPage, ProfilePage)

= 🔗 Internal Linking Engine =
Improve site topology and SEO authority distribution:

* Auto-suggest internal links based on title and keyword matching
* Relevance scoring using category/tag overlap
* Orphan page detection
* Link health dashboard widget
* Links count column in posts list

= 📊 Smart Tracking Pixel =
Track visitors and link them to CRM contacts:

* SmcTrackingTag v2 with cross-domain support
* Click ID persistence (gclid, fbclid, msclkid)
* UTM parameter capture
* Scroll depth tracking
* CRM contact identification

= 🎯 CRM Personalization =
Show personalized content based on CRM data:

* Gutenberg block for dynamic CRM tags
* Elementor dynamic tags (Contact, Company, Variable)
* [smc_tag] shortcode for any theme
* Client-side resolution with graceful fallbacks

= 🩺 Diagnostics =
Built-in health monitoring and troubleshooting:

* Structured logging with daily rotation
* Health check REST endpoint
* Hourly heartbeat to Smarketing Cloud
* Module status dashboard

== Installation ==

1. Upload the `smarketing-cloud` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to **Smarketing Cloud → Settings** in your WordPress admin
4. Enter your API key (find it in Smarketing Cloud → Settings → WordPress Plugin)
5. Select your Project ID
6. Enable the modules you want to use
7. Visit Settings → Permalinks and click "Save Changes" to flush rewrite rules (required for /llms.txt)

== Frequently Asked Questions ==

= Do I need a Smarketing Cloud account? =
Yes. The plugin connects to your Smarketing Cloud account to provide AI features, CRM data, and tracking capabilities. Sign up at [smarketingcloud.com](https://smarketingcloud.com).

= What is AI Search Visibility (AEO/GEO)? =
AEO (Answer Engine Optimization) and GEO (Generative Engine Optimization) are strategies to ensure AI-powered search engines — like ChatGPT, Google AI Overviews, and Perplexity — cite your content as a source. This plugin automates the key signals these engines look for.

= What is llms.txt? =
llms.txt is a machine-readable summary of your website, similar to robots.txt but designed for AI crawlers. It helps AI engines understand your site structure and key content.

= Does the Citation Tracker cost extra? =
The Citation Tracker uses the SerpAPI integration in your Smarketing Cloud account. Usage is included with your subscription — no separate API key required.

= Does it work with Gutenberg? =
Yes! The AI Website Builder adds a "Build with AI" panel to the Gutenberg sidebar. The Content Audit meta box also appears in the Gutenberg post editor sidebar.

= Does it work with Elementor? =
Yes! An AI generation button appears in the Elementor top bar. Generated content is inserted as native Elementor widgets.

= Will it conflict with Yoast SEO or RankMath? =
No. The SEO Autopilot module detects which SEO plugin is installed and injects meta data using the appropriate hooks. The Content Audit also reads focus keywords from Yoast and RankMath to power the Citation Tracker.

= Is it GDPR compliant? =
The tracking pixel respects your site's cookie consent settings. You can also exclude logged-in administrators from tracking.

= What AI models does it use? =
The AI features are powered through Smarketing Cloud's AI infrastructure, primarily using Google Gemini with OpenAI as a fallback.

== Screenshots ==

1. WordPress admin settings page with module toggles
2. Gutenberg "Build with AI" sidebar panel
3. Elementor AI generation modal
4. SEO score dashboard widget
5. Internal linking suggestions meta box
6. AI Search Readiness dashboard widget
7. Content Audit meta box (AI Quotability Score)
8. AI Citation Tracker dashboard widget
9. Diagnostics system information page

== Changelog ==

= 1.1.0 =
* **NEW: AI Search Visibility (AEO/GEO)** — comprehensive AI search engine optimization
* llms.txt generator for AI crawlers (cached, auto-invalidated on post save)
* AI Bot Access Manager — allows 8 AI search crawlers in robots.txt
* Content Freshness column with color-coded staleness indicators
* AI Search Readiness dashboard widget (0-100 composite score)
* Answer-First Content Audit meta box with 10-criteria AI quotability scoring
* Enhanced Entity Schema — Person, Product, WebPage subtypes, SpeakableSpecification
* AI Citation Tracker — weekly keyword monitoring via SerpAPI with dashboard widget
* HowTo schema auto-detection for step-by-step content
* SpeakableSpecification for voice search optimization
* Version bump to 1.1.0

= 1.0.0 =
* Initial release
* AI Website Builder (Gutenberg + Elementor)
* AI Blog Publishing engine
* SEO Autopilot (meta, alt text, scoring, reports)
* Schema Markup auto-generation (Article, Organization, Breadcrumb, FAQ, LocalBusiness)
* Internal Linking Engine (suggestions, orphan detection, health dashboard)
* Smart Tracking Pixel (v2)
* CRM Personalization (dynamic tags, shortcodes, Elementor tags)
* Diagnostics and Health Monitoring

== Upgrade Notice ==

= 1.1.0 =
Major update: AI Search Visibility features for Answer Engine Optimization (AEO) and Generative Engine Optimization (GEO). Get cited by ChatGPT, Perplexity, and Google AI Overviews.

= 1.0.0 =
First release of the Smarketing Cloud WordPress plugin.
