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 License Activation

After purchasing a Premium plan, you'll receive an email with your license key.

  1. Go to AI Explainer Pro > License in your WordPress admin
  2. Paste your license key (format: AEP-XXXXXXXX-XXXXXXXX-XXXXXXXX)
  3. Click "Activate License"

The license is verified daily via WP-Cron against our license server. If your subscription expires or payment fails, you'll have a 3-day grace period before reverting to Free.