Introduction 

What is AI Writer? 

AI Writer (ok_ai_writer) is a TYPO3 extension that brings AI-powered text generation directly into CKEditor. Editors can generate, preview, and iteratively refine SEO-optimized HTML content using Azure OpenAI or OpenAI (ChatGPT) — all without leaving the rich text editor.

The extension provides three CKEditor 5 plugins:

AI Text Generator

Opens a chat-style dialog where editors describe the content they need. The AI generates well-structured HTML that can be refined through follow-up prompts before inserting it into the editor.

AI Translate

Translates the entire editor content into a selected target language while preserving all HTML structure and formatting. Supports 7 languages.

Lorem Ipsum

Opens a dialog to select the number of paragraphs (1–20) and inserts Lorem Ipsum placeholder text — useful during development and layout prototyping.

Features 

• Conversational AI dialog — Chat-style interface with full conversation history for iterative content refinement.
• SEO-optimized output — The AI generates well-structured HTML with semantic headings (<h2> – <h4>) and paragraphs.
• Dual provider support — Works with both Azure OpenAI and OpenAI (ChatGPT) APIs. Switch between providers via extension configuration.
• Per-site configuration — Dedicated backend module (Web > AI Writer) allows administrators to configure different API credentials per TYPO3 site, with automatic fallback to global extension configuration.
• Encrypted credential storage — Per-site API keys are encrypted at rest using Sodium encryption derived from TYPO3's encryptionKey.
• Centralized or per-user credentials — API credentials can be configured server-side by an administrator (displayed blinded to editors) or per-user in the browser's localStorage when developer mode is enabled.
• Token usage tracking — Displays cumulative input/output token counts per session so editors stay aware of API consumption.
• AI translation — Translate entire editor content into 7 languages (Deutsch, English US/UK, Español, Français, Italiano, Türkçe) while preserving HTML structure.
• Dark mode support — All dialogs automatically adapt to the TYPO3 backend's dark mode setting, detecting the data-color-scheme attribute with prefers-color-scheme media query fallback.
• Localized UI — Ships with English and German translations.
• Lorem Ipsum helper — Additional CKEditor plugin for quick placeholder text insertion (1–20 paragraphs) during development.
• Backend proxy — API requests are routed through the TYPO3 backend, avoiding browser CORS restrictions.

Requirements