CONTENTFLOW FOR TYPO3

Installation und
erste Schritte

Von der Composer-Installation bis zur ersten geprüften Übersetzung oder Bildanalyse.

TYPO3 13.4 LTSPHP ≥ 8.2Composer

SCHRITT 0

Voraussetzungen

Du benötigst eine Composer-basierte TYPO3-13.4-Installation, ein ContentFlow-Konto und ein Projekt im Control Panel. TYPO3 muss https://api.contentflow-ai.de per HTTPS erreichen können.

Einheitliche API-AdresseNutze auch aus DDEV oder Docker immer die öffentliche ContentFlow API. Dadurch funktioniert dieselbe Konfiguration in Entwicklung, Staging und Produktion.

SCHRITT 1

Extension mit Composer installieren

Die ContentFlow-Extension liegt in einem eigenen GitHub-Repository. Registriere das Repository einmal in deinem TYPO3-Projekt und installiere anschließend das Composer-Paket:

composer config repositories.contentflow vcs https://github.com/gadev-g/contentflow-typo3-ai.git
composer require contentflow/typo3-translation:dev-main
vendor/bin/typo3 cache:flush

In einer DDEV-Installation führst du dieselben Schritte im Webcontainer aus:

ddev composer config repositories.contentflow vcs https://github.com/gadev-g/contentflow-typo3-ai.git
ddev composer require contentflow/typo3-translation:dev-main
ddev typo3 cache:flush

Versionierte Installation für ProduktionSobald ein Release verfügbar ist, installierst du eine stabile Versionsreihe statt dev-main, beispielsweise mit composer require contentflow/typo3-translation:^0.1. Dadurch werden Updates kontrolliert über Composer eingespielt.

Lokale Entwicklung der Extension

Nur wenn du selbst an der Extension entwickelst, bindest du einen lokalen Checkout als Path-Repository ein:

git clone git@github.com:gadev-g/contentflow-typo3-ai.git
composer config repositories.contentflow path /absolute/path/to/contentflow-typo3-ai
composer require contentflow/typo3-translation:@dev
vendor/bin/typo3 cache:flush

Erfolgreich installiert?Nach der Anmeldung im TYPO3-Backend erscheint unter Web das Modul ContentFlow AI.

SCHRITT 2

Projekt und API-Key erstellen

1
Control Panel öffnenMelde dich im ContentFlow Control Panel an.
2
Projekt anlegenÖffne „Projects“, erstelle dein TYPO3-Projekt und wähle es aus.
3
API-Key generierenÖffne „API Keys“, erstelle einen Projekt-Key und kopiere ihn sofort. Der vollständige Schlüssel wird nur einmal angezeigt.

API-Key im Control Panel erstellen →

API-Key schützenSpeichere den Schlüssel niemals in Git. Verwende für jede Kundeninstallation einen eigenen Projekt-Key. Verlorene oder veröffentlichte Keys solltest du sofort löschen und ersetzen.

SCHRITT 3

TYPO3 konfigurieren

Öffne im TYPO3-Backend Admin Tools → Settings → Extension Configuration → contentflow_translation und trage folgende Werte ein:

apiUrlÖffentliche URL der ContentFlow APIhttps://api.contentflow-ai.de

apiKeyDer generierte Projekt-API-Keycf_live_••••••••

debugModeBereinigte Request-/Response-Daten anzeigen0

Alternativ kannst du die Konfiguration deploymentsicher in config/system/additional.php setzen und die Werte aus Umgebungsvariablen beziehen:

<?php
$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['contentflow_translation'] = [
    'apiUrl' => getenv('CONTENTFLOW_API_URL') ?: '',
    'apiKey' => getenv('CONTENTFLOW_API_KEY') ?: '',
    'debugMode' => getenv('CONTENTFLOW_DEBUG') ?: '0',
];

CONTENTFLOW_API_URL=https://api.contentflow-ai.de
CONTENTFLOW_API_KEY=cf_live_REPLACE_WITH_PROJECT_KEY
CONTENTFLOW_DEBUG=0

SCHRITT 4

KI-Provider freigeben

Die TYPO3-Extension zeigt ausschließlich Provider an, die für das ausgewählte Projekt im ContentFlow Control Panel aktiviert wurden.

1
Providers öffnenWähle im Control Panel dein TYPO3-Projekt.
2
Zugang konfigurierenHinterlege einen eigenen OpenAI- oder Anthropic-Key – oder verwende einen bereitgestellten Ollama-Dienst.
3
„Available to TYPO3“ aktivierenSpeichere die Änderung. Der Provider erscheint anschließend in den erweiterten Einstellungen der Extension.

Provider konfigurieren →

SCHRITT 5

ContentFlow in TYPO3 benutzen

文

Inhalte übersetzen

Web → ContentFlow AI öffnen
„Translation“ auswählen
Seite oder Content-Element über den Datensatz-Browser wählen
Quell- und Zielsprache prüfen
Übersetzungsvorschau erstellen
Felder vergleichen und freigeben

Die TYPO3-Sprach-ID wird automatisch aus der Site-Konfiguration ermittelt. Erst nach der Freigabe wird der lokalisierte Datensatz angelegt oder aktualisiert.

◎

Bildmetadaten erstellen

Web → ContentFlow AI öffnen
„Asset Intelligence“ auswählen
Bild über den Asset-Browser wählen
Metadatensprache und optional Kontext angeben
Bild analysieren
Alt-Text, Titel und Beschreibung prüfen und übernehmen

Die Originaldatei bleibt unverändert. ContentFlow schreibt ausschließlich die freigegebenen Werte in sys_file_metadata.

HILFE

Fehlersuche

„API key is not configured“+

Prüfe apiKey in der Extension Configuration und leere danach den TYPO3-Cache.

Die ContentFlow API ist nicht erreichbar+

Prüfe, ob https://api.contentflow-ai.de/health vom TYPO3-Server erreichbar ist und als API-Basis-URL verwendet wird.

Kein Provider wird angezeigt+

Aktiviere im Control Panel beim richtigen Projekt mindestens einen konfigurierten Provider mit „Available to TYPO3“.

Anfrage und Antwort untersuchen+

Setze debugMode vorübergehend auf 1. Das Vorschaufenster zeigt bereinigte Payloads ohne API-Key oder vollständige Bilddaten. In Produktion danach wieder deaktivieren.

Installation underste Schritte