Documentation

Everything you need to install, configure, and use AI Explainer Pro.

1 Quick Start

Install: Download from WordPress.org or upload the ZIP via Plugins > Add New > Upload.

Activate: Click "Activate" in the Plugins list. The plugin creates its menu under AI Explainer Pro.

First scan: Go to AI Explainer Pro > Dashboard and click "Scan All Published Content". The bulk scanner processes posts in batches with a progress bar.

Badges: After scanning, transparency badges appear automatically on your posts (configurable in Settings).

2 Detection Engine

The engine combines 5 local heuristic methods into a weighted ensemble score (0–1):

MethodWhat it measuresWeight
StatisticalSentence length variance (burstiness), word entropy, avg sentence length25%
LinguisticTransition words, formal vocab, hedging, personal pronouns (6 languages)20%
StructuralParagraph uniformity, list/heading patterns, topic sentence formulas20%
VocabularyGuiraud index, hapax legomena ratio, word length distribution20%
RepetitionRepeated bigrams, sentence opening patterns15%

Premium users can add a 6th API-powered method (OpenAI or custom endpoint) for higher accuracy.

3 AI Model Fingerprinting Premium

Once content is flagged as AI-generated, the fingerprinting engine analyzes it against known stylistic signatures of 4 major AI models:

  • ChatGPT / GPT-4 — "delve into", "it's important to note", "landscape", structured headers
  • Claude — "I'd be happy to", "nuanced", cautious phrasing, layered arguments
  • Gemini — "let's explore", "here's the thing", casual connectors
  • Llama — "straightforward", "no-nonsense", concise patterns

The result includes the top model match, confidence score, and matched phrases. Displayed in the Gutenberg sidebar and stored in post meta.

4 Auto AI Disclosure Premium

Automatically appends an EU AI Act Art. 50 transparency notice to posts that exceed your configured AI score threshold.

Configure in Settings > AI Disclosure:

  • Enable/disable the auto disclosure
  • Threshold — AI score above which disclosure appears (default: 60%)
  • Custom text — Use placeholders: {ai_pct}, {human_pct}, {model_info}

5 Content Originality Hash

Each scan generates a SHA-256 hash of the content, stored in _ai_explainer_content_hash post meta. If content is later modified, the hash won't match — proving tampering.

Useful for regulatory audits and establishing content integrity chains.

6 REST API

Full REST API under ai-explainer-pro/v1 namespace. All endpoints require manage_options capability.

MethodEndpointDescription
POST/detectAnalyze arbitrary text
POST/scan-postScan a specific post by ID
POST/bulk-scanBatch scan with offset/limit
GET/statsOverall detection statistics
GET/complianceEU AI Act compliance data
GET/post-status/{id}Detection status for a post

7 EU AI Act Compliance

The compliance dashboard maps your site against Articles 50, 14, 12, and 9 of the EU AI Act (Regulation 2024/1689). It provides:

  • Compliance score (0–100%) across 8 requirements
  • Content inventory — human, AI, mixed breakdown
  • Actionable checklist with article references
  • Downloadable HTML compliance report for audits
Disclaimer: The compliance dashboard provides informational guidance, not legal advice. Consult a qualified legal professional for definitive EU AI Act compliance.

8 Buying Pro & auto-updates

The Pro add-on is sold separately from this website. There is intentionally no license key: once the Pro ZIP is installed, every Pro feature is active.

  1. Click "Buy Pro" in the navigation, pick monthly or yearly, pay through Stripe Checkout.
  2. The success page shows a one-time download link (valid 24h).
  3. In WordPress admin, go to Plugins → Add New → Upload Plugin and select the ZIP. If the free Lite is already installed, the upload replaces it cleanly.
  4. That's it — no key to enter. Open AI Explainer Pro → Subscription any time to manage your billing through the Stripe customer portal.

From there on, new Pro releases appear in the standard WordPress "Update available" notice on the Plugins screen. While your Stripe subscription is active, one-click updates work just like a WordPress.org plugin. If your subscription becomes inactive, the plugin keeps working with the version you have — only future updates stop.