Zum Inhalt

Installation

Via Composer

composer require netthinks/nt-ai

Aktivierung unter Admin Tools → Extensions oder per CLI:

vendor/bin/typo3 extension:setup

Die Extension legt bei der Aktivierung ihre Datenbanktabellen (tx_ntai_audit_report, tx_ntai_page_score, tx_ntai_lighthouse_report, tx_ntai_token_usage) an. Nach einem manuellen composer update folgenden Befehl ausführen:

vendor/bin/typo3 database:updateschema

Manuelle Installation

  1. Das neueste Release von der GitHub-Releases-Seite herunterladen.
  2. Nach typo3conf/ext/nt_ai entpacken.
  3. Unter Admin Tools → Extensions aktivieren.

Nach der Installation

Admin Tools → Settings → Extension Configuration → nt_ai öffnen und mindestens einen KI-Anbieter konfigurieren (siehe Konfiguration).

Note

Solange kein Anbieter konfiguriert ist, laden die Backend-Module zwar, KI-gestützte Funktionen melden jedoch „kein Anbieter konfiguriert".

Barrierefreiheits-Widget & Vorlesefunktion im Frontend aktivieren

Das Frontend-Widget und die Vorlesefunktion werden über ein Site Set bereitgestellt. Auf einem Kundensystem genügt es, das Set als Abhängigkeit einzutragen — entweder direkt in der Site-Konfiguration oder als Dependency des eigenen Sitepackage-Sets:

# config/sites/<identifier>/config.yaml  (oder im eigenen Set)
dependencies:
  - netthinks/nt-ai

Danach erscheinen die Einstellungen automatisch unter Site-Verwaltung → Einstellungen (Kategorien „Barrierefreiheit" und „Vorlesen (TTS)"). Ein manuelles Anlegen von settings.definitions.yaml-Einträgen ist nicht nötig. Das Set liefert Assets, Settings und die Frontend-Konfiguration (data-nt-* am <html>-Tag).

Nur site-spezifisches Theming bleibt im jeweiligen Sitepackage: ein natives Dark-Theme (Markenfarben), optionale Frontend-Tweaks und — falls gewünscht — ein „Vorlesen"-Button im Template (<f:render partial="ReadAloud"/> bzw. [data-nt-tts]).