🧠 AI Beitragseinreichung WP Registry grade A. No security issues foundWP RegistryNo security issues foundOpen the reportA

AI Beitragseinreichung ist ein WordPress-Plugin, mit dem berechtigte Nutzer im Backend Beiträge vorbereiten und zur Prüfung einreichen können. Standardmäßig werden Beiträge zur Prüfung im Status in Verarbeitung gespeichert. Alternativ kann direktes Veröffentlichen eingestellt werden, wenn der Nutzer das WordPress-Recht publish_posts besitzt. Das Speichern als Entwurf bleibt möglich.

Das Plugin unterstützt Titel, Inhalt, Kategorie, Schlagwörter, Beitragsbild, Zusatzbilder, Vorschau, Benachrichtigungen und optional eine KI-gestützte Überarbeitung über die OpenAI API.

Funktionen

• Beiträge im WordPress-Backend einreichen
• Beiträge vor dem Speichern als Vorschau prüfen
• Titel, Inhalt, Kategorie, Schlagwörter, Beitragsbild und Zusatzbilder erfassen
• Schlagwörter als Kacheln eingeben
• doppelte Schlagwörter automatisch vermeiden
• aktuelles Jahr optional als Schlagwort vorschlagen
• Beiträge optional per KI stilistisch überarbeiten
• Textauszug manuell oder automatisch per KI erstellen
• KI-Schlagwörter optional automatisch vorschlagen lassen
• Stilgruppen für unterschiedliche Beitragsarten pflegen
• Zusatzbilder sauber als Einzelbild oder Galerie-Slider einfügen
• Benachrichtigungsmails an ausgewählte Nutzer senden
• KI-Optimierungen im Protokoll nachvollziehen
• eigene WordPress-Capabilities für Rollen und Rechte nutzen

Typischer Ablauf

1. Nutzer öffnet im Backend AI Beitragseinreichung.
2. Titel, Inhalt, Kategorie und Schlagwörter werden eingetragen.
3. Optional werden Beitragsbild und Zusatzbilder ausgewählt.
4. Optional wird Texte automatisch verbessern aktiviert.
5. Der Beitrag wird über Vorschau erstellen geprüft.
6. Bei Bedarf wird ein Änderungswunsch an die KI gesendet.
7. Der Beitrag wird final eingereicht.
8. Je nach Abschlussmodus wird der Beitrag zur Prüfung gespeichert oder veröffentlicht. Ein Entwurf bleibt als Alternative möglich.

Die Vorschau wird empfohlen, weil sie Titel, Text, Schlagwörter und Bilder vor dem Speichern sichtbar macht.

KI-Funktionen

Die KI ist optional und wird nur genutzt, wenn sie in den Einstellungen aktiviert ist und der Nutzer sie im Formular auswählt.

Unterstützt werden:

• stilistische Überarbeitung von Titel und Beitragstext
• automatische Erstellung eines Textauszugs
• automatische Vorschläge für Schlagwörter
• erneute Überarbeitung über einen konkreten Änderungswunsch in der Vorschau
• zentrale Modellverwaltung über includes/ai/ai-models.php

Die OpenAI-Aufrufe nutzen strukturierte Antworten, damit Titel, Inhalt, Textauszug und Schlagwörter zuverlässig getrennt verarbeitet werden können.

Als Standard wird gpt-5.6-terra verwendet. Freigeschaltet sind derzeit:

• gpt-5.6-luna
• gpt-5.6-terra
• gpt-5.6-sol
• gpt-5.4-nano
• gpt-5.4-mini
• gpt-5.4
• gpt-5.5

Weitere Modelle können zentral vorbereitet werden, ohne sie sofort im Dropdown anzubieten. Ungültige oder nicht mehr freigeschaltete gespeicherte Modellwerte werden automatisch durch das Standardmodell ersetzt.

Wichtig: Die KI verbessert Stil und Struktur, ersetzt aber keine fachliche Prüfung.

Stilgruppen

Stilgruppen geben der KI eine klare sprachliche Richtung. Beispiele:

• Einladung
• Rückblick
• Vereinsmeldung
• Ergebnisbericht
• kurzer Hinweis

Eine gute Stilgruppe beschreibt nicht nur „mach schöner“, sondern gibt konkret vor, wie der Beitrag klingen soll.

Beispiel:

Freundlich und einladend schreiben. Der Beitrag soll Lust auf Teilnahme machen. Datum, Uhrzeit, Ort und Anmeldung deutlich nennen. Titel kurz halten. Keine Inhalte erfinden.

Stilgruppen können in den Einstellungen als versionierte JSON-Datei exportiert und wieder importiert werden. Einzelne Importe werden zuerst im Bearbeiten-Popup geöffnet, damit sie geprüft und erst danach gespeichert werden. Mehrere Stilgruppen können über eine gemeinsame JSON-Datei importiert werden.

Schlagwörter

Schlagwörter werden im Formular als Kacheln gepflegt. Sie helfen dabei, Beiträge später besser zu verbinden und auffindbar zu machen.

Das Plugin unterstützt:

• manuelle Schlagwort-Kacheln
• automatische Duplikatvermeidung
• optionales Jahres-Schlagwort
• KI-generierte Schlagwortvorschläge
• häufig verwendete WordPress-Schlagwörter als Orientierung für die KI
• eine bearbeitbare Liste bevorzugter Schreibweisen

Bilder

Das Plugin unterstützt:

• ein Beitragsbild
• zusätzliche Bilder
• Galerie- bzw. Slider-Ausgabe bei mehreren Zusatzbildern

Ein Beitragsbild wird empfohlen, weil es je nach Theme in Übersichten, Teasern oder Social-Vorschauen verwendet werden kann.

Formatierung

Der Beitragstext kann mit einer bewusst begrenzten Markdown-Auswahl strukturiert werden. Beim Speichern wandelt das Plugin diese Formatierungen in passende Gutenberg-Blöcke oder sicheres HTML um:

• Überschriften von # bis ######
• Aufzählungen und nummerierte Listen
• Zitate und horizontale Trennlinien
• einfache Tabellen
• Links und Inline-Code
• Fett- und Kursivschrift

Markdown-Bilder, Codeblöcke und freie HTML-Ausgabe sind nicht vorgesehen. Titel werden grundsätzlich von Markdown und HTML bereinigt.

Benachrichtigungen

Bei neuen Einreichungen können ausgewählte Nutzer per E-Mail informiert werden. Optional kann auch der einreichende Autor eine Benachrichtigung erhalten.

Die Mail enthält eine strukturierte Vorschau mit:

• Titel
• Autor
• Kategorie
• Schlagwörtern
• Textauszug
• Inhalt
• Bildinformationen

KI-Protokoll

Das KI-Protokoll zeigt durchgeführte KI-Überarbeitungen mit:

• Zeitpunkt
• Nutzer
• Modell
• Stilgruppe
• Originaltitel
• optimiertem Titel
• Originalinhalt
• optimiertem Inhalt
• Textauszug

Details werden als Popup angezeigt. Auf kleinen Bildschirmen ist die Ansicht mobil nutzbar.

In den Einstellungen kann festgelegt werden, wie viele Einträge aufbewahrt werden. Standard sind 100, maximal sind 500 möglich. Beim Erreichen der Grenze werden die ältesten Einträge automatisch entfernt.

Rechte und Rollen

Das Plugin nutzt eigene Capabilities:

Die Rechte können z. B. mit dem WordPress-Plugin Members verwaltet werden.

Zuverlässige Speicherung und Mailversand

Vorschauen werden benutzergebunden für 30 Minuten auf dem Server gespeichert. Abgelaufene Vorschauen müssen neu erstellt werden; versteckte Formularfelder ersetzen sie nicht. Ein Formular ist zwölf Stunden gültig. Einmaltokens, atomare Sperren und eine 24 Stunden gespeicherte Quittung verhindern wiederholte Beitragserstellung durch denselben Speichervorgang. Nach einem Speicherfehler bleibt die Vorschau erhalten.

Unter Einstellungen → Abschluss der Einreichung wird genau eine Hauptaktion gewählt: Prüfung oder direkte Veröffentlichung. Ohne publish_posts wird im Veröffentlichungsmodus nur ein Entwurf angeboten. Die optionale Beitragsbild-Pflicht gilt beim Veröffentlichen über dieses Formular; sie ersetzt keine seitenweite Veröffentlichungsregel im normalen WordPress-Editor. Entwürfe lösen keine Benachrichtigung aus und können ohne neue KI-Verarbeitung gespeichert werden.

Benachrichtigungen speichern Inhalt und Empfänger als festen Mailstand am Beitrag. Unter Beitragseinreichung: Mailversand im Beitragseditor stehen die Versandstände je Adresse. Nur eindeutig fehlgeschlagene Übergaben werden über WP-Cron nach fünf Minuten erneut versucht, insgesamt höchstens dreimal. Bereits erfolgreiche oder unklare, abgebrochene Versuche werden nicht wiederholt. „An Maildienst übergeben“ bestätigt keine Zustellung. Für bereits vor Version 1.3.0 gespeicherte Beiträge werden keine Benachrichtigungen nachträglich erzeugt.

KI-Grenzen

Die Vorgaben sind 30 Wörter Mindestlänge, 40.000 Zeichen Maximallänge und 20 KI-Anfragen pro Benutzer innerhalb einer Stunde ab der ersten Anfrage. Die Werte sind einstellbar; auch erneute KI-Überarbeitungen zählen. Lange Zusatzhinweise werden ebenfalls begrenzt. Eine manuelle Vorschau benötigt keine KI-Anfrage.

Optionaler lokaler Symbolpool

Die Funktion ist standardmäßig aus. Zwei neutrale Symbole (Information und Veranstaltung) sind vorbereitet. Der lokale Katalog enthält Lucide Static 1.58.0 unter ISC-Lizenz; siehe Herkunft und Lizenz. Zur Laufzeit werden keine Symbole von einem CDN geladen.

Unter Symbolpool mit Vorschau verwalten öffnet sich ein Popup. Links siehst du deine vorhandenen Symbole als Kacheln, rechts bearbeitest du das ausgewählte Symbol mit großer Vorschau. Über Neues Symbol ergänzt du einen Eintrag. Der lokale Lucide-Katalog lässt sich nach Namen durchsuchen; jede Auswahl zeigt das zugehörige Bild.

Jedes Symbol hat eine feste Kennung, einen Lucide-Symbolnamen, eine verständliche Bezeichnung und eine Beschreibung, wann es passt. Bei bestehenden Symbolen bleibt die Kennung erhalten. Vier Freigaben steuern die Verwendung: im manuellen Formular verfügbar, für die KI freigegeben, im Text verwendbar und für Zwischenüberschriften verwendbar. Symbolpool speichern übernimmt den Pool zusammen mit den übrigen Einstellungen; Abbrechen verwirft nicht gespeicherte Änderungen.

Pro Stilgruppe wählst du ein optionales Erkennungssymbol und per Checkbox die für die KI erlaubten Symbole. Zusätzlich muss das Symbol im Pool für die KI freigegeben sein. Die KI kennt Bedeutung, Verwendung und erlaubte Positionen. Eigene SVGs oder externe Bildadressen sind ausgeschlossen.

Im manuellen Formular öffnet Symbol mit Vorschau auswählen eine bebilderte Auswahl mit Suche. Ein Klick fügt beispielsweise [[symbol:info]] an die Cursorposition ein. Symbole, die nur für Zwischenüberschriften freigegeben sind, können im Fließtext nicht ausgewählt werden. Für eine Markdown-Zwischenüberschrift setze den Cursor hinter ##. Vorschau, gespeicherter Beitrag und Mail verwenden dieselbe Darstellung.

Stilgruppen-Import/Export übernimmt Symbolkennungen; auf einer anderen Installation muss der passende Symbolpool ebenfalls angelegt sein. Vorhandene Einträge aus Version 1.3.0 bleiben erhalten und starten mit allen bisherigen Freigaben. Beim Deaktivieren verschwinden bereits als Bilder gespeicherte Symbole nicht rückwirkend.

Voraussetzungen

• WordPress 5.8 oder neuer
• PHP 7.4 oder neuer
• Gutenberg-kompatible Beitragsausgabe
• Optional: OpenAI API-Key für KI-Funktionen

Installation

1. Plugin-Ordner nach /wp-content/plugins/ kopieren oder als ZIP installieren.
2. Plugin im WordPress-Backend aktivieren.
3. Benutzerrechte vergeben.
4. Standard-Kategorie und Benachrichtigungen einstellen.
5. Optional OpenAI API-Key hinterlegen.
6. Optional Stilgruppen und Schlagwortoptionen pflegen.

OpenAI API-Key

Der API-Key kann in den Plugin-Einstellungen gespeichert oder bevorzugt in der wp-config.php definiert werden:

define('OPENAI_API_KEY', 'dein-api-key-hier');

Wenn OPENAI_API_KEY gesetzt ist, verwendet das Plugin diesen Wert bevorzugt. Der Key wird dann nicht in den Einstellungen überschrieben.

Nach dem Speichern der Einstellungen wird die Verbindung automatisch getestet. Schlägt der Test fehl, bleibt die bisherige KI-Einstellung zunächst erhalten; ein Administrator kann anschließend bewusst entscheiden, ob die KI deaktiviert werden soll.

Qualität und Prüfungen

Für die lokale Entwicklung werden Composer-Tools genutzt:

composer install
composer run check

composer run check prüft Composer-Metadaten, bekannte Sicherheitsprobleme in Abhängigkeiten, PHP-Syntax, WordPress-Coding-Standards und die lokalen Entwicklungstests. Derselbe Ablauf wird bei Pushes und Pull Requests über GitHub Actions mit PHP 7.4 und PHP 8.3 ausgeführt.

Ein bereinigtes Release-ZIP ohne lokale Konfiguration und Entwicklungswerkzeuge wird erstellt mit:

composer run build:release

Dokumentation

Weitere Informationen stehen im GitHub-Wiki:

• Installation und Einrichtung
• Formular-Übersicht
• Beitrag einreichen
• Gute Beiträge schreiben
• KI-Funktionen
• Einstellungen
• Stilgruppen
• Benutzerrechte und Rollen
• Protokoll und Fehlersuche
• Entwicklung und Roadmap

Repository: jan-erbert/ai-beitragseinreichung-wordpress

Hinweise

• Inhalte werden nur an die OpenAI API gesendet, wenn die KI-Funktion aktiv genutzt wird.
• KI-Ausgaben sollten vor der Veröffentlichung geprüft werden.
• API-Nutzung kann Kosten verursachen.
• Zugangsdaten und API-Keys gehören nicht ins Repository.