Setup

Bedienung für Redakteure

Schritt-für-Schritt Anleitung

1. SEO-Felder in TYPO3 Backend aufrufen

Öffnen Sie eine Seite im TYPO3 Backend
Navigieren Sie zum Reiter „SEO“ oder „Social Media“
Suchen Sie nach den relevanten Metadaten-Feldern

2. AI-Generierung starten

Klicken Sie auf den AI-Button neben dem gewünschten Feld
Die Extension analysiert automatisch Ihre Webseite
Nach wenigen Sekunden erscheinen 2–3 Vorschläge

3. Vorschlag auswählen

Durchlesen: Prüfen Sie alle generierten Vorschläge
Auswählen: Markieren Sie Ihren bevorzugten Text per Radio-Button
Übernehmen: Klicken Sie auf „Übernehmen“ zum Einfügen
Alternativ: Wählen Sie „Abbrechen“ zum Verwerfen

4. Bei Bedarf anpassen

Bearbeiten Sie den übernommenen Text nach Ihren Wünschen
Speichern Sie die Seite wie gewohnt

Erweiterte Funktionen

Benutzerdefinierte Anweisungen

Sie können der KI spezifische Anweisungen geben:

@ Syntax für zusätzliche Hinweise:

Im Eingabe Feld kann ein @ Zeichen geschrieben werden um der KI weitere Informationen mitzugeben.

!@ Syntax für komplett eigene Prompts:

Es kann auch ein !@ geschrieben werden, dann werden die Voreinstellungen des Prompt deaktiviert.

Automatische Keyword-Integration

Die Extension:

Extrahiert automatisch relevante Keywords aus Ihrer Webseite
Integriert diese natürlich in Meta-Titel und -Beschreibungen
Berücksichtigt SEO-Best-Practices für Keyword-Dichte

Responsive Textlängen

Meta-Titel: 50–60 Zeichen (optimal für Google)
Meta-Beschreibung: 150–160 Zeichen (vollständige Anzeige)
Keywords: 3–8 relevante Begriffe
Social Media: Plattform-optimierte Längen

Konfiguration

Grundeinstellungen (für Administratoren)

OpenAI API Konfiguration

- API Key: Ihr OpenAI API-Schlüssel
- Modell: gpt-4o (empfohlen) oder gpt-3.5-turbo
- Temperatur: 0.5–0.7 (Kreativität vs. Präzision)
- Max Tokens: 1000 (ausreichend für alle Felder)

Firmeninformationen

- Firmenname: Vollständiger Unternehmensname
- Firmenbeschreibung: Kurze Beschreibung Ihrer Tätigkeit
- Zielgruppe: Primäre Zielgruppe für maßgeschneiderte Texte

Erweiterte Einstellungen

- Anzahl Vorschläge: 1–3 Optionen pro Generierung
- Webseitenanalyse: Aktiviert für kontextuelle Vorschläge
- Textlänge Analyse: 200 Zeichen vom Seiteninhalt

Custom Extension-Unterstützung

Die AI Metatags Extension kann auch mit benutzerdefinierten Extensions wie News, Events oder anderen Content-Extensions arbeiten:

Extension-URL-Konfiguration (extensionUrl)

Format: UIDSingleSidePage|TabelName|URLBuilder

News Beispiel:

14|tx_news_domain_model_news|['tx_news_pi1'=>['controller' => 'News','action' => 'detail','news' => @id]]

Mehrere Extensions (mit || getrennt)!

Kategorien-Konfiguration (extensionUrlCat)

Format: TabelName|\Vendor\MyExtension\Domain\Repository\MyRepository|TabelFieldNameFromCategory|GetParameterNameFromCategory

Beispiel:
tx_news_domain_model_news|\GeorgRinger\News\Domain\Repository\NewsRepository|categories|category

Benötigte TCA-Override-Dateien

Wichtig: Für jede Custom Extension müssen entsprechende TCA-Override-Dateien erstellt werden:

Für News Extension:

# Configuration/TCA/Overrides/tx_news_domain_model_news.php

<?php
$GLOBALS['TCA']['tx_news_domain_model_news']['columns']['description']['config'] = array_merge_recursive(
    $GLOBALS['TCA']['tx_news_domain_model_news']['columns']['description']['config'],
    [
        'fieldControl' => [
            'importControl' => [
                'renderType' => 'aiMetaTitle'
            ]
        ]
    ]
);

$GLOBALS['TCA']['tx_news_domain_model_news']['columns']['keywords']['config'] = array_merge_recursive(
    $GLOBALS['TCA']['tx_news_domain_model_news']['columns']['keywords']['config'],
    [
        'fieldControl' => [
            'importControl' => [
                'renderType' => 'aiMetaTitle'
            ]
        ]
    ]
);

$GLOBALS['TCA']['tx_news_domain_model_news']['columns']['alternative_title']['config'] = array_merge_recursive(
    $GLOBALS['TCA']['tx_news_domain_model_news']['columns']['alternative_title']['config'],
    [
        'fieldControl' => [
            'importControl' => [
                'renderType' => 'aiMetaTitle'
            ]
        ]
    ]
);

Für eigene Extensions:

# Configuration/TCA/Overrides/tx_myext_domain_model_item.php

<?php
$GLOBALS['TCA']['tx_myext_domain_model_item']['columns']['title']['config'] = array_merge_recursive(
    $GLOBALS['TCA']['tx_myext_domain_model_item']['columns']['title']['config'],
    [
        'fieldControl' => [
            'importControl' => [
                'renderType' => 'aiMetaTitle'
            ]
        ]
    ]
);

$GLOBALS['TCA']['tx_myext_domain_model_item']['columns']['description']['config'] = array_merge_recursive(
    $GLOBALS['TCA']['tx_myext_domain_model_item']['columns']['description']['config'],
    [
        'fieldControl' => [
            'importControl' => [
                'renderType' => 'aiMetaTitle'
            ]
        ]
    ]
);

Einrichtung für Custom Extensions

Schritt 1: TCA-Override erstellen

Erstellen Sie die entsprechende PHP-Datei im Verzeichnis Configuration/TCA/Overrides/
Verwenden Sie die Beispiele oben als Vorlage
Passen Sie Tabellennamen und Feldnamen an Ihre Extension an

Schritt 2: Extension-URL konfigurieren

Öffnen Sie die Extension-Konfiguration im TYPO3 Backend
Tragen Sie die URL-Konfiguration im Feld extensionUrl ein
Format: SeitenUID|Tabellenname|URL-Builder

Schritt 3: Kategorien einrichten (optional)

Falls Ihre Extension Kategorien verwendet, konfigurieren Sie extensionUrlCat
Format: Tabellenname|Repository-Klasse|Kategorien-Feldname|URL-Parameter

Schritt 4: Testen

Cache leeren
News/Content-Item im Backend bearbeiten
AI-Buttons sollten in den konfigurierten Feldern erscheinen

Prompt-Anpassungen (Optional)

Für erweiterte Nutzer können spezifische Prompts für verschiedene Feldtypen definiert werden:

Meta-Titel Prompts:

Erstelle einen SEO-optimierten Titel, der [Firmenname]
und die Hauptkeywords enthält, maximal 60 Zeichen.

Meta-Beschreibung Prompts:

Verfasse eine einladende Beschreibung, die zum Klicken
motiviert und unsere [Zielgruppe] anspricht.

Keyword Prompts:

Identifiziere die 5 wichtigsten Suchbegriffe für diese
Seite, priorisiert nach Suchvolumen.

Best Practices

Empfehlungen

1. Vor der Generierung

Stellen Sie sicher, dass Ihr Seiteninhalt vollständig ist
Überprüfen Sie die Firmendaten in der Konfiguration
Definieren Sie klare Zielgruppen

2. Bei der Auswahl

Lesen Sie alle Vorschläge aufmerksam durch
Wählen Sie den Text, der am besten zu Ihrer Marke passt
Achten Sie auf natürliche Keyword-Integration

3. Nach der Übernahme

Kontrollieren Sie die Zeichenanzahl
Prüfen Sie die Rechtschreibung
Testen Sie die Wirkung verschiedener Varianten

Zu beachten

1. Qualitätskontrolle

KI-generierte Texte sollten immer überprüft werden
Passen Sie Texte an Ihre Markensprache an
Vermeiden Sie identische Texte auf mehreren Seiten

2. SEO-Guidelines

Halten Sie sich an Zeichenlimits
Verwenden Sie relevante Keywords
Schaffen Sie einzigartige Inhalte

3. Rechtliche Aspekte

Prüfen Sie Texte auf rechtliche Unbedenklichkeit
Vermeiden Sie übertriebene Werbeaussagen
Beachten Sie Markenrechte bei der Keyword-Verwendung

Technische Anforderungen

System-Voraussetzungen

TYPO3: Version 13.0.0 – 13.99.99
PHP: Version 8.1 oder höher
OpenAI API: Gültiger API-Schlüssel erforderlich
Internet: Stabile Verbindung für API-Aufrufe

Sicherheit & Datenschutz

Alle Daten werden verschlüsselt an OpenAI übertragen
Keine dauerhafte Speicherung von Inhalten bei OpenAI
API-Schlüssel werden sicher in der TYPO3-Konfiguration gespeichert

Workflow-Optimierung

Effiziente Arbeitsweise

1. Batch-Verarbeitung

Bearbeiten Sie mehrere Seiten nacheinander
Nutzen Sie ähnliche Prompts für verwandte Seiten
Dokumentieren Sie erfolgreiche Prompt-Variationen

2. Qualitätssicherung

Erstellen Sie Checklisten für verschiedene Seitentypen
Definieren Sie Stilrichtlinien für Ihr Team
Führen Sie regelmäßige SEO-Audits durch

3. Performance-Monitoring

Überwachen Sie Click-Through-Rates in Search Console
Testen Sie verschiedene Meta-Beschreibungen
Dokumentieren Sie erfolgreiche Formulierungen

Fehlerbehebung

Häufige Probleme

Problem: Keine Vorschläge werden generiert

Ursache: Fehlender oder ungültiger API-Schlüssel
Lösung: Prüfen Sie die Extension-Konfiguration

Problem: Zu kurze oder zu lange Texte

Ursache: Unpassende OpenAI-Parameter
Lösung: Anpassung der Max-Tokens oder Temperatur

Problem: Irrelevante Vorschläge

Ursache: Unzureichender Seiteninhalt
Lösung: Ergänzen Sie Inhalte oder nutzen Sie @ Syntax