Installation

Diese Anleitung führt dich durch die Installation der TYPO3 Extension „News-Navigator Nora“.

Systemvoraussetzungen

TYPO3 Version

  • TYPO3 12.4 LTS oder höher

PHP Version

  • PHP 8.1 oder höher (je nach TYPO3-Version)

Abhängigkeiten

  • TYPO3 Core Extensions (automatisch installiert)
  • News Extension (EXT:news) wird empfohlen
  • Aktive Internetverbindung für API-Zugriffe

API-Accounts

  • OpenAI Account mit API-Zugang (erforderlich)
  • Ideogram Account mit API-Zugang (optional, für Bildgenerierung)

Installationsmethoden

Method 1: Composer Installation

Führe folgenden Befehl im Stammverzeichnis deiner TYPO3-Installation aus:

composer require itmichel/itm-ai-news

Aktiviere anschließend die Extension:

vendor/bin/typo3 extension:activate itm_ai_news

Method 2: Extension Manager

  1. Lade die Extension-Dateien herunter
  2. Gehe im TYPO3 Backend zu Admin Tools → Extensions
  3. Klicke auf Upload Extension
  4. Wähle die Extension-Zip-Datei aus
  5. Klicke auf Upload and Install

Method 3: ZIP-Upload

  1. Entpacke das Extension-Archiv
  2. Kopiere den Ordner itm_ai_news nach typo3conf/ext/
  3. Gehe zu Admin Tools → Extensions
  4. Finde „News-Navigator Nora“ in der Liste
  5. Klicke auf Activate

Post-Installation Setup

1. Cache leeren

Nach der Installation solltest du den Cache leeren:

Admin Tools → Flush TYPO3 and PHP Caches

2. Datenbank-Updates

Falls erforderlich, führe Datenbankupdates durch:

Admin Tools → Upgrade → Database analyser

3. OpenAI API-Schlüssel beschaffen

  1. Registriere dich bei OpenAI
  2. Gehe zu API Keys in deinem Dashboard
  3. Erstelle einen neuen API-Schlüssel
  4. Kopiere den Schlüssel (bewahre ihn sicher auf)

4. Ideogram API-Schlüssel (optional)

Für Bildgenerierung:

  1. Registriere dich bei Ideogram
  2. Navigiere zu den API-Einstellungen
  3. Generiere einen API-Schlüssel
  4. Notiere dir den Schlüssel

Erste Konfiguration

Extension-Konfiguration öffnen

  1. Gehe zu Admin Tools → Settings → Extension Configuration
  2. Suche nach „itm_ai_news“
  3. Klicke auf das Konfigurationssymbol

Minimum-Konfiguration

Für den ersten Test benötigst du mindestens:

[OpenAI API]
apiKeyOpenAi = sk-dein-openai-api-schlüssel-hier
apiModelOpenAi = gpt-4o

[Prompt]
aicompanyName = Dein Firmenname

Test der Installation

  1. Gehe zu Web → AI News (erfordert Admin-Rechte)
  2. Das Modul sollte ohne Fehler laden
  3. Versuche eine Test-News zu erstellen

Mögliche Installationsprobleme

Extension erscheint nicht im Extension Manager

Lösung:

  • Überprüfe die Extension-Key Schreibweise: itm_ai_news
  • Lösche typo3temp/var/cache/ manuell
  • Führe composer dumpautoload aus (bei Composer-Installation)

Modul erscheint nicht im Backend

Lösung:

# Cache leeren
rm -rf typo3temp/var/cache/*

# Bei Composer-Setup
composer dumpautoload

API-Connection Fehler

Häufige Ursachen:

  • Falscher API-Schlüssel
  • Unzureichendes API-Guthaben
  • Netzwerk-/Firewall-Probleme

Debug-Schritte:

  1. Aktiviere Extension-Logging
  2. Prüfe /typo3temp/var/log/ailog.json
  3. Teste API-Schlüssel extern

Berechtigungsprobleme

Wenn Redakteure das Modul nicht sehen:

  1. Gehe zu System → Backend Users → Backend User Groups
  2. Wähle die entsprechende Gruppe
  3. Unter Modules „AI News“ hinzufügen
  4. Speichern

Composer-spezifische Probleme

Autoload-Probleme:

composer dump-autoload
vendor/bin/typo3 extension:setup

Abhängigkeits-Konflikte:

composer update --with-all-dependencies

Deinstallation

Vollständige Deinstallation

Bei Composer-Installation:

composer remove itmichel/itm-ai-news

Manuell:

  1. Extension deaktivieren: Admin Tools → Extensions
  2. Extension löschen (falls gewünscht)
  3. typo3conf/ext/itm_ai_news/ Ordner entfernen

Daten behalten

Die Extension erstellt keine eigenen Datenbanktabellen. Alle generierten News bleiben in der Standard-News-Tabelle erhalten.

Systemrequirements prüfen

PHP Extensions prüfen

Stelle sicher, dass folgende PHP-Extensions aktiv sind:

  • curl (für API-Aufrufe)
  • json (für API-Kommunikation)
  • openssl (für sichere Verbindungen)

Server-Konfiguration

Empfohlene PHP-Settings:

max_execution_time = 300
memory_limit = 256M
post_max_size = 50M
upload_max_filesize = 50M

Bei Installationsproblemen

  1. Systemlogs prüfen: /typo3temp/var/log/
  2. TYPO3 Debug aktivieren: $GLOBALS[‚TYPO3_CONF_VARS‘][‚SYS‘][‚displayErrors‘] = 1
  3. Extension-Logging aktivieren in der Konfiguration