Skip to content

Protokoll

Jump to bottom
Jan Erbert edited this page Sep 9, 2026 · 4 revisions

📋 Protokoll & Fehlersuche

Das KI-Protokoll hilft dabei, KI-Optimierungen nachvollziehbar zu prüfen.

KI-Protokoll

Im Protokoll werden KI-Verarbeitungen gespeichert, unter anderem:

  • Zeitpunkt
  • Nutzer
  • Modell
  • Stilgruppe
  • Originaltitel
  • optimierter Titel
  • Originalinhalt
  • optimierter Inhalt

Die Detailansicht wird als Popup geöffnet und zeigt den optimierten Beitrag als besser lesbare Vorschau. Auf Smartphone-Ansichten wird das Protokoll als Kartenlayout dargestellt.

Einträge können von Nutzern mit administrativer Plugin-Berechtigung gelöscht werden. Vor dem Löschen erscheint ein eigener Hinweis-Dialog.

Die maximale Anzahl gespeicherter Einträge wird in den Einstellungen festgelegt. Standard sind 100 Einträge, möglich sind Werte von 1 bis 500. Wird die Grenze erreicht oder reduziert, entfernt das Plugin zuerst die ältesten Einträge.

Typische Fehlerquellen

API-Key ungültig

Prüfe:

  • Ist ein API-Key gespeichert?
  • Ist OPENAI_API_KEY in der wp-config.php gesetzt?
  • Ist der Key im OpenAI-Dashboard noch gültig?
  • Ist ein Abrechnungskonto eingerichtet?

Modell nicht verfügbar

Wenn ein gespeichertes Modell nicht mehr freigeschaltet oder ungültig ist, nutzt das Plugin automatisch das Standardmodell aus includes/ai/ai-models.php.

In Version 1.2.6 ist gpt-5.6-terra das Standardmodell.

Verbindungstest schlägt fehl

Nach dem Speichern der Einstellungen wird die OpenAI-Verbindung automatisch getestet. Schlägt der Test bei aktivierter KI fehl, bleibt die bisherige Einstellung zunächst erhalten. Ein Administrator entscheidet anschließend im Dialog, ob die KI aktiviert bleiben oder deaktiviert werden soll.

Vorschau kann nicht erstellt werden

Prüfe:

  • Sind Titel und Inhalt ausgefüllt?
  • Ist bei KI-Nutzung eine Stilgruppe gewählt?
  • Ist die API-Verbindung erfolgreich?
  • Gibt die Browser-Konsole JavaScript-Fehler aus?

KI-Antwort ist zu groß

Sehr lange Texte oder alte Hidden-Felder können zu großen Requests führen. Das Plugin entfernt alte Preview-Daten vor neuen Vorschau-Anfragen. Falls der Fehler trotzdem auftritt, sollte der eingegebene Inhalt gekürzt oder in mehrere Beiträge aufgeteilt werden.

WordPress-Debugging

Für technische Fehlersuche kann in der wp-config.php temporär Debug-Logging aktiviert werden:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Fehler landen dann in:

/wp-content/debug.log

Fehler melden

Bitte bei Fehlerberichten angeben:

  • Was wurde eingegeben?
  • War KI aktiv?
  • Welche Stilgruppe wurde genutzt?
  • Gab es eine Vorschau?
  • Welche Fehlermeldung wurde angezeigt?
  • Welche Plugin-Version wird genutzt?

Issue-Tracker: GitHub Issues

➡️ Weiter: Entwicklung & Roadmap

Clone this wiki locally