Installation

Detaillierte Installationsanleitung für die TYPO3 Extension

Systemanforderungen

  • TYPO3 v13.0.0 – 13.99.99
  • PHP 8.1 oder höher
  • OpenAI API-Schlüssel (kostenpflichtig)
  • Internetverbindung für API-Aufrufe

Installationsmethoden

Die Extension kann auf verschiedene Weise installiert werden. Wähle die für deine Umgebung passende Methode.

Methode 1: Composer Installation

Voraussetzungen

  • TYPO3 v13.0.0 oder höher
  • PHP 8.1 oder höher
  • Composer installiert
  • Aktive Internetverbindung

Installation

  1. Terminal öffnen und in dein TYPO3-Projektverzeichnis navigieren: 
    cd /pfad/zu/deinem/typo3-projekt
  2. Extension installieren: 
    composer require itmichel/ai-imagetext
  3. Extension aktivieren:
    • Gehe ins TYPO3 Backend
    • Navigiere zu Admin Tools → Extensions
    • Suche „AI Image Text“
    • Klicke auf den Aktivieren-Button
  4. Cache leeren: 
    # Via Composer
composer typo3:cache:flush

# Oder im Backend: Admin Tools → Maintenance → Flush Caches

Methode 2: Extension Manager

Über das TYPO3 Backend

  1. Extension Manager öffnen:
    • Backend: Admin Tools → Extensions
  2. Extension suchen:
    • Wechsle zum Tab Get Extensions
    • Suche nach „AI Image Text“ oder „itm_ai_imagetext“
  3. Installation:
    • Klicke auf Install and activate
    • Warte bis die Installation abgeschlossen ist
  4. Cache leeren:
    • Admin Tools → Maintenance → Flush Caches

Methode 3: Manuelle Installation

Für Entwicklung oder spezielle Anforderungen

  1. Extension-Code laden: 
    cd typo3conf/ext/
git clone [REPOSITORY-URL] itm_ai_imagetext
# oder ZIP-Datei herunterladen und entpacken
  2. Autoload aktualisieren (falls Composer verwendet): 
    composer dump-autoload
  3. Extension aktivieren:
    • Backend: Admin Tools → Extensions → Installed Extensions
    • „AI Image Text“ suchen und aktivieren
  4. Datenbank-Schema aktualisieren:
    • Admin Tools → Maintenance → Analyze Database Structure
    • Apply selected changes klicken

Post-Installation Setup

1. Datenbankstruktur prüfen

Nach der Installation sollten folgende Datenbanktabellen erstellt worden sein:

tx_aiimagetext_domain_model_ajax

Prüfung:

  1. Admin Tools → Maintenance → Analyze Database Structure
  2. Überprüfe, ob alle Extension-Tabellen vorhanden sind
  3. Falls Unterschiede angezeigt werden, klicke Apply selected changes

2. Backend-Module verfügbar machen

Die Extension fügt automatisch folgende Elemente hinzu:

  • AI-Buttons in der Dateimetadaten-Bearbeitung
  • New TCA-Konfigurationen für sys_file_reference
  • Ajax-Routen für die Backend-Kommunikation

3. JavaScript-Module laden

Die Extension registriert automatisch die erforderlichen JavaScript-Module:

// Automatisch geladen:
- ai-media.js       // Einzelne AI-Funktionen
- ai-media-all.js   // Alle AI-Funktionen zusammen

4. Benutzerrechte konfigurieren

Stelle sicher, dass die relevanten Backend-Benutzer Zugriff haben:

  1. System → Backend Users → Backend User Groups
  2. Bearbeite die relevante Benutzergruppe
  3. Unter Access Lists → Modules:
    • Web > File > Filelist
  4. Unter Access Lists → Tables (modify):
    • sys_file
    • sys_file_reference
    • tx_aiimagetext_domain_model_ajax

Konfiguration

1. Extension Configuration

Minimal-Konfiguration:

  1. Admin Tools → Settings → Extension Configuration
  2. AI Image Text auswählen
  3. API Key OpenAI eingeben (erforderlich)
  4. Andere Einstellungen optional mit Standardwerten belassen

Vollständige Konfiguration:

# OpenAI API
apiKeyOpenAi = sk-proj-xxxxxxxxxxxxxxxxxxxx
apiModelOpenAi = gpt-4o

# AI Settings
aiTemperature = 0.5
aiMaxTokens = 275
aiTopP = 1
aiFrequencyPenalty = 0.8
aiPresencePenalty = 0

# Prompt Context
aicompanyName = Dein Firmenname
aicompanyDescription = Kurze Firmenbeschreibung
aiDomain = 1

# Advanced
configImgName = 0
severalAnswers = 2

2. TypoScript-Konfiguration (Optional)

Falls spezielle Anpassungen nötig sind:

# Falls erforderlich - meist nicht nötig
plugin.tx_aiimagetext {
    settings {
        # Custom settings here
    }
}

Verifikation der Installation

1. Funktionalitätstest

Schritt 1: AI-Buttons sichtbar?

  1. Web → File → Filelist
  2. Bild auswählen → Edit Metadata
  3. Sind AI-Buttons bei Title/Alt/Description sichtbar?

Schritt 2: API-Call funktioniert?

  1. AI-Button klicken
  2. Lädt der Dialog?
  3. Werden Textvorschläge generiert?

Schritt 3: Text übernehmen?

  1. Vorschlag auswählen
  2. Übernehmen klicken
  3. Wird Text ins Feld übertragen?

2. Log-Dateien prüfen

Falls Probleme auftreten, prüfe die TYPO3-Logs:

# TYPO3 v13 Logs
tail -f var/log/typo3_*.log

# Oder im Backend:
# Admin Tools → Log → [aktuelles Datum]

Typische Einträge bei erfolgreicher Installation:

[INFO] Extension itm_ai_imagetext successfully loaded
[INFO] Ajax routes registered for itm_ai_imagetext
[INFO] JavaScript modules registered

Troubleshooting

Installation schlägt fehl

Composer-Probleme:

# Cache löschen und neu versuchen
composer clear-cache
composer require itmichel/ai-imagetext --no-cache

# Falls Abhängigkeitskonflikte:
composer require itmichel/ai-imagetext --ignore-platform-reqs

Speicher-Probleme:

# PHP Memory Limit erhöhen
php -d memory_limit=512M composer require itmichel/ai-imagetext

Permission-Probleme:

# Dateirechte korrigieren
chmod -R 755 typo3conf/ext/itm_ai_imagetext
chown -R webserver:webserver typo3conf/ext/itm_ai_imagetext

Extension nicht sichtbar

  1. Cache vollständig leeren:
    • Backend: Admin Tools → Maintenance → Flush Caches
    • Oder alle Cache-Ordner manuell löschen
  2. Autoload aktualisieren: 
    composer dump-autoload
  3. Extension explizit aktivieren: 
    # Via CLI
vendor/bin/typo3 extension:activate itm_ai_imagetext

Database-Schema Probleme

# Datenbank-Updates via CLI erzwingen
vendor/bin/typo3 database:updateschema

# Mit Validierung
vendor/bin/typo3 database:updateschema "*.add,*.change"

JavaScript-Module laden nicht

  1. Build-Prozess prüfen: 
    # Falls Build-System verwendet wird
npm run build
# oder
yarn build
  2. Browser-Cache leeren:
    • Strg+F5 oder Entwicklertools → Cache löschen
  3. RequireJS-Cache:
    • Backend: Admin Tools → Maintenance → Flush Caches
    • Checkbox „Clear frontend caches“ aktivieren

Deinstallation

Sichere Deinstallation

  1. Daten sichern (falls nötig): 
    -- Export der Extension-Daten
SELECT * FROM tx_aiimagetext_domain_model_ajax;
  2. Extension deaktivieren:
    • Backend: Admin Tools → Extensions → Installed Extensions
    • „AI Image Text“ deaktivieren
  3. Extension entfernen: 
    # Via Composer
composer remove itmichel/ai-imagetext

# Oder manuell
rm -rf typo3conf/ext/itm_ai_imagetext
  4. Datenbank aufräumen: 
    DROP TABLE IF EXISTS tx_aiimagetext_domain_model_ajax;
  5. Cache leeren: 
    composer typo3:cache:flush

Support bei Installationsproblemen

Falls du Probleme bei der Installation hast:

  1. Log-Dateien sammeln: Aktuelle TYPO3-Logs
  2. Systeminfo bereitstellen: PHP/TYPO3-Version, Betriebssystem
  3. Fehlerdetails: Genaue Fehlermeldung und Kontext

Wichtiger Sicherheitshinweis: Bewahre deinen OpenAI API-Schlüssel sicher auf und teile ihn niemals öffentlich. Überwache regelmäßig deine OpenAI-Nutzung und Kosten.