Professionelle E-Mail-zu-Artikel-Automatisierung für Joomla 5 und Joomla 6

RegioMail2Content ist eine umfangreiche Joomla-Erweiterung zur kontrollierten, automatisierten Verarbeitung eingehender E-Mails zu regulären Joomla-Artikeln. Die Erweiterung verbindet konfigurierte E-Mail-Postfächer mit Joomla und übernimmt den gesamten Verarbeitungsweg vom Abruf einer Nachricht über Absenderprüfung, Filterung, Aufbereitung und Regelverarbeitung bis hin zur Erstellung oder Aktualisierung eines normalen com_content-Artikels.

Das zentrale Prinzip besteht darin, E-Mails nicht einfach ungeprüft zu veröffentlichen. RegioMail2Content arbeitet stattdessen mit einer mehrstufigen Verarbeitungskette:

Postfach → IMAP/OAuth2 → Queue → E-Mail-/MIME-Analyse → Absenderprüfung → Mail2Content-Tags → Filter und Sanitizing → Bilder und Anhänge → Regeln und Vorlagen → Quarantäne oder Joomla-Artikel → Audit, Rückmeldung und Monitoring

Das Zielobjekt bleibt dabei immer ein regulärer Joomla-Artikel. Dadurch lassen sich die erzeugten Inhalte mit den normalen Joomla-Funktionen, Kategorien, Workflows, Benutzerrechten, Tags, Templates, Erweiterungen und SEO-Werkzeugen weiterverwenden.

Einsatzmöglichkeiten

RegioMail2Content eignet sich besonders für Webseiten und Portale, bei denen Inhalte regelmäßig per E-Mail angeliefert werden. Dazu gehören beispielsweise regionale Nachrichtenportale, Presseportale, Vereinsplattformen, Behörden- und Organisationsseiten, Veranstaltungsportale, Unternehmenswebseiten oder redaktionell betreute Joomla-Systeme.

Eine Redaktion könnte beispielsweise bestimmten Vereinen, Feuerwehren, Gemeinden oder Unternehmen erlauben, Presseinformationen per E-Mail einzureichen. RegioMail2Content erkennt den Absender, wendet dessen individuelle Regeln an, bereitet Text und Bilder auf und erzeugt daraus einen Joomla-Artikel.

Ebenso kann die Erweiterung dazu verwendet werden, Meldungen zunächst nur in eine Warteschlange oder Quarantäne zu übernehmen. Ein Administrator oder Redakteur kann diese anschließend kontrollieren und freigeben.

Postfachverwaltung

RegioMail2Content kann mehrere E-Mail-Postfächer verwalten. Dadurch lassen sich unterschiedliche Redaktionsbereiche, Themengebiete oder Organisationen voneinander trennen.

Unterstützt werden klassische IMAP-Verbindungen sowie OAuth2-basierte Authentifizierungswege. Vorgesehen sind unter anderem generische OAuth2-Konfigurationen sowie Integrationspfade für Google Workspace und Microsoft 365.

Für jedes Postfach können eigene Verarbeitungseinstellungen hinterlegt werden. Dazu gehören beispielsweise Zielkategorien, Sprache, Veröffentlichungsverhalten, Absenderregeln, Filterprofile oder Templates.

Der E-Mail-Abruf berücksichtigt technische Schutzmechanismen wie Locking, Ownership-Tokens, Queue-Limits, Cursor beziehungsweise UID-Verarbeitung, Retry-Verhalten und Ressourcenbudgets. Dadurch soll verhindert werden, dass mehrere Abrufprozesse dieselben Nachrichten gleichzeitig verarbeiten oder ein fehlerhafter Abruf den gesamten Prozess blockiert.

Absenderverwaltung und Berechtigungsmodell

Ein wesentlicher Sicherheitsbaustein von RegioMail2Content ist die kontrollierte Absenderverwaltung.

Nicht jede eingehende E-Mail darf automatisch zu einem veröffentlichten Joomla-Artikel werden. Absender können daher einzeln hinterlegt, aktiviert, deaktiviert oder Gruppen zugeordnet werden.

Die Konfiguration folgt einer Vererbung:

System → Postfach → Absendergruppe → Absender

Damit lassen sich gemeinsame Einstellungen zentral definieren und anschließend für einzelne Gruppen oder Absender überschreiben.

Zu den möglichen Einstellungen gehören unter anderem Kategorie, Inhaltssprache, Autor, Veröffentlichungsmodus, Joomla-Workflow und Workflow-Phase, Quelle und Disclaimer, Content-Modus, erlaubte Mail2Content-Tags, Filterprofil, Behandlung externer Bilder und zu verwendende Artikelvorlage.

Dadurch können beispielsweise mehrere Feuerwehren dieselben Grundeinstellungen erhalten, während eine einzelne Feuerwehr trotzdem eine abweichende Zielkategorie oder Vorlage verwenden kann.

Mail2Content-Tags

RegioMail2Content besitzt eine eigene Tag-Syntax, mit der Absender den Aufbau eines Artikels direkt innerhalb einer E-Mail beeinflussen können.

Beispiele sind:

[TITLE=...]

[LANG=...]

[CATEGORY=...]

[ARTICLE_TAGS=...]

[INTRO]...[/INTRO]

[READMORE]

[H1]...[/H1]

[H2]...[/H2]

[BOLD]...[/BOLD]

[QUOTE]...[/QUOTE]

[IMAGE=...]

[INTROIMAGE=...]

[FULLIMAGE=...]

Darüber hinaus existieren Tags für Artikelaktualisierungen, Übersetzungsgruppen und weitere Verarbeitungsschritte.

Kritische Tags werden gesondert behandelt. Ein Absender darf deshalb nicht automatisch jede beliebige Anweisung ausführen. Nicht erlaubte Tags können abhängig von der Konfiguration neutralisiert, abgelehnt oder zur Quarantäne führen.

Artikelvorlagen

Mit Artikelvorlagen kann festgelegt werden, wie die aus einer E-Mail gewonnenen Inhalte zusammengesetzt werden.

Dafür stehen Platzhalter wie {TITLE}, {INTRO}, {CONTENT}, {IMAGES}, {SOURCE}, {DISCLAIMER}, {DATE} und {AUTHOR} zur Verfügung.

RegioMail2Content 1.0.25 wurde in diesem Bereich zusätzlich optimiert. Die mitgelieferten Vorlagen verwenden möglichst wenig zusätzliches HTML. Unnötige <div>-Container wurden aus den Beispielvorlagen entfernt, damit das Joomla-Frontend-Template möglichst wenig beeinflusst wird.

Auch ein zusätzliches <h1>{TITLE}</h1> wird in den Standardvorlagen vermieden, weil der Joomla-Artikeltitel normalerweise bereits vom verwendeten Template ausgegeben wird.

Dadurch können Vorlagen beispielsweise sehr schlank aufgebaut werden:

{INTRO}

{CONTENT}

{IMAGES}

{SOURCE}

{DISCLAIMER}

Neben den eigentlichen Vorlagen enthält die Erweiterung integrierte Beispiele und Erläuterungen zur richtigen Verwendung von Mail2Content-Tags und Template-Platzhaltern.

E-Mail-Verarbeitung und Queue

Eingehende Nachrichten werden nicht zwangsläufig unmittelbar als Artikel geschrieben. RegioMail2Content verfügt über eine eigene Queue.

Damit kann der gesamte Importprozess kontrolliert und nachvollziehbar durchgeführt werden.

Nachrichten können unter anderem gesammelt, verarbeitet, erneut geprüft oder – sofern keine schützenswerten Verknüpfungen bestehen – entfernt werden.

Seit den vorhergehenden Versionen stehen dafür auch Mehrfachauswahlfunktionen wie „Ausgewählte verarbeiten“ und „Ausgewählte entfernen“ zur Verfügung.

Artikelverknüpfte oder anderweitig relevante Datensätze werden dabei geschützt. Audit- und Nachweisdaten werden nicht einfach unkontrolliert gelöscht.

HTML-Sanitizing und Inhaltsfilter

E-Mail-Inhalte können aus unterschiedlichsten Quellen stammen und teilweise komplexes oder problematisches HTML enthalten.

RegioMail2Content besitzt deshalb eine eigene Sicherheits- und Filterebene.

HTML kann bereinigt und auf erlaubte Strukturen reduziert werden. Unerwünschte Elemente, Attribute, Links oder eingebettete Inhalte können entfernt oder behandelt werden.

Dadurch soll verhindert werden, dass E-Mail-Inhalte beispielsweise unerwünschtes JavaScript, gefährliche URLs oder problematische HTML-Strukturen in einen Joomla-Artikel übertragen.

Zusätzlich können Text-, HTML- und Bildfilter konfiguriert werden.

Bilder, CID-Bilder und externe Inhalte

Viele HTML-E-Mails enthalten eingebettete Bilder über sogenannte CID-Verweise. RegioMail2Content kann solche Inhalte erkennen und in die Artikelverarbeitung einbeziehen.

Auch externe Bilder können verarbeitet werden, unterliegen jedoch einer eigenen Sicherheitsrichtlinie.

Dabei spielt insbesondere der Schutz vor Server-Side Request Forgery (SSRF) eine wichtige Rolle. Externe URLs werden deshalb nicht einfach ungeprüft vom Server abgerufen.

Zusätzlich können Bildrichtlinien und Filter verwendet werden, um unerwünschte Bilder, Trackingelemente oder nicht zugelassene Quellen auszusondern.

Regel-Engine

Mit der Regel-Engine kann festgelegt werden, wie unterschiedliche Nachrichten automatisch behandelt werden.

Regeln können auf Eigenschaften einer E-Mail reagieren und entsprechende Aktionen auslösen. Damit lassen sich beispielsweise Nachrichten anhand von Absender, Inhalt oder anderen Merkmalen unterschiedlichen Verarbeitungswegen zuordnen.

Ein integrierter Regeltest ermöglicht es, Regeln zu prüfen, bevor sie produktiv auf eingehende Nachrichten angewendet werden.

Das reduziert das Risiko, dass eine falsch konfigurierte Regel unerwartete Artikel erzeugt oder Nachrichten falsch behandelt.

Dry-Run und Testcenter

Für produktive Systeme ist es wichtig, neue Regeln oder Konfigurationen testen zu können, ohne dabei sofort Inhalte zu veröffentlichen.

RegioMail2Content besitzt deshalb einen Dry-Run- beziehungsweise Testmodus.

Ein Dry-Run soll keinen produktiven Artikel schreiben und keine produktiven Cursor oder Verarbeitungszähler verändern. Diese Trennung gehört ausdrücklich zum Sicherheitsmodell der Erweiterung.

Damit kann überprüft werden, wie eine E-Mail erkannt, gefiltert, aufbereitet und verarbeitet würde.

Quarantäne

Nicht jede Nachricht muss sofort abgelehnt oder veröffentlicht werden.

Verdächtige, unvollständige oder nicht eindeutig verarbeitbare Nachrichten können in die Quarantäne verschoben werden.

Dadurch erhält ein Administrator oder Redakteur die Möglichkeit, problematische Nachrichten manuell zu prüfen.

Die Quarantäne eignet sich beispielsweise für unbekannte Absender, nicht erlaubte Steuer-Tags, problematische Anhänge, fehlerhafte Inhalte oder Nachrichten, bei denen automatische Regeln keine eindeutige Entscheidung treffen können.

Joomla-Workflow

RegioMail2Content kann mit dem Joomla-Workflow zusammenarbeiten.

Ein automatisch erzeugter Artikel muss daher nicht unmittelbar veröffentlicht werden. Er kann beispielsweise zunächst einem redaktionellen Status oder einer bestimmten Workflow-Phase zugeordnet werden.

Damit lässt sich RegioMail2Content auch in Webseiten einsetzen, bei denen Inhalte grundsätzlich vor der Veröffentlichung redaktionell geprüft werden müssen.

Artikel aktualisieren

Die Erweiterung ist nicht ausschließlich auf die Erstellung neuer Artikel ausgelegt.

Über entsprechende Steuerinformationen können bestehende Artikel erkannt und aktualisiert werden.

Hierfür existieren unter anderem Tags wie CONTENT-ID und ACTION.

Damit können beispielsweise regelmäßige Statusmeldungen oder fortlaufend aktualisierte Informationen verarbeitet werden, ohne jedes Mal einen neuen Joomla-Artikel anzulegen.

Dublettenerkennung und Idempotenz

E-Mail-Systeme können Nachrichten mehrfach liefern oder Abrufprozesse erneut durchführen.

RegioMail2Content besitzt deshalb Mechanismen zur Dublettenerkennung und Idempotenz.

Dabei können unter anderem Message-ID, Mail-Hash, Content-Hash, Importinformationen und weitere Merkmale berücksichtigt werden.

Ziel ist, dass dieselbe Nachricht nicht versehentlich mehrfach als Artikel angelegt wird.

Mehrsprachige Inhalte

RegioMail2Content unterstützt mehrsprachige Joomla-Webseiten.

Eine Nachricht kann einer bestimmten Inhaltssprache zugeordnet werden. Zusätzlich existieren Funktionen für Übersetzungsgruppen.

Die Backend-Oberfläche unterstützt aktuell:

Deutsch, Englisch, Französisch, Spanisch, Italienisch und Portugiesisch.

Bereits für Version 1.0.24 wurde die vollständige Runtime-Schlüsselparität dieser sechs Sprachpakete geprüft.

Mehrsprachige integrierte Hilfe

Seit RegioMail2Content 1.0.26 enthält die Erweiterung einen eigenen Backend-Menüpunkt „Hilfe & Dokumentation“.

Die Hilfe richtet sich automatisch nach der im Joomla-Backend eingestellten Sprache.

Sie beschreibt unter anderem den grundsätzlichen Workflow, Postfächer und OAuth2, Absenderverwaltung, Queue, Mail2Content-Tags, Vorlagen, Filter, Regeln, Bilder, Quarantäne, Workflow, Dubletten, Diagnosen, Scheduler, Sicherheit und typische Arbeitsschritte.

Damit muss für die grundlegende Bedienung nicht zwingend eine externe Dokumentationsseite aufgerufen werden.

Quellen und Disclaimer

Für redaktionelle Systeme ist die Kennzeichnung der Herkunft eines Inhalts wichtig.

RegioMail2Content kann Quellenangaben und Disclaimer in die Artikelverarbeitung einbeziehen.

Diese Angaben können beispielsweise abhängig vom Absender oder von einer Absendergruppe automatisch ergänzt werden.

Mit den Template-Platzhaltern {SOURCE} und {DISCLAIMER} können diese Informationen anschließend an der gewünschten Position innerhalb des Artikels ausgegeben werden.

Auditlog und Protokollierung

Automatisierte Veröffentlichungsprozesse sollten nachvollziehbar bleiben.

RegioMail2Content verfügt deshalb über Audit- und Protokollierungsfunktionen.

Dadurch kann nachvollzogen werden, welche Verarbeitungsschritte durchgeführt wurden und welche Entscheidungen oder Fehler während des Imports aufgetreten sind.

Sensible Daten und Zugangsdaten sollen dabei nicht ungeschützt protokolliert werden.

Systemprüfung und Diagnose

Die Erweiterung besitzt eine eigene Systemprüfung.

Geprüft werden können unter anderem Plattform, Datenbank, Plugins, Scheduler, Workflow, Dateien, Sprachen und weitere Integrationspunkte.

Bei Verbindungsproblemen unterscheidet die Diagnose beispielsweise zwischen DNS-/Netzwerkproblemen, TLS-Problemen, Timeout, Authentifizierung, OAuth2, IMAP-Ordnern, Datenbankschema, MIME-/Parsing-Problemen oder dem Fall, dass schlicht keine Nachricht vorhanden ist.

Damit sollen Fehlermeldungen möglichst aussagekräftig sein und nicht nur einen allgemeinen Fehler anzeigen.

Scheduler und automatische Verarbeitung

RegioMail2Content enthält ein Joomla-Task-Plugin.

Dadurch kann der E-Mail-Abruf über den Joomla Scheduler automatisiert werden.

Ein Administrator muss den Abruf somit nicht ständig manuell auslösen.

In Kombination mit Queue, Locking und Retry-Mechanismen kann daraus ein weitgehend automatisierter Mail-to-Content-Workflow aufgebaut werden.

Backup und Migration

RegioMail2Content verfügt über einen eigenen Bereich für Backup & Migration.

Konfigurations- und Diagnosedaten können exportiert werden.

Seit Version 1.0.27 wurden die direkten Exportwege zusätzlich korrigiert: Exporte sollen nun tatsächlich als Datei heruntergeladen werden und nicht mehr lediglich als Textinhalt im Browser erscheinen.

Dies betrifft unter anderem JSON-Backup, Diagnose-JSON, Nachrichten-Quelldaten und Auditlog-CSV.

Datenschutz und Retention

Für gespeicherte Nachrichten und Protokolldaten existieren Retention- beziehungsweise Aufbewahrungsfunktionen.

Damit können Daten nach definierten Regeln verwaltet und langfristig unnötige Datenbestände reduziert werden.

Gerade bei produktiven Mail-Systemen ist dies relevant, da E-Mails personenbezogene oder anderweitig vertrauliche Informationen enthalten können.

Sicherheitskonzept

RegioMail2Content wurde mit einer umfangreichen Sicherheitsarchitektur entwickelt.

Berücksichtigt werden unter anderem SQL-Injection, Cross-Site-Scripting, CSRF, ACL, IDOR/BOLA, SSRF, Path Traversal, Symlink-Angriffe, unsichere Uploads, MIME-Manipulation, XML/XXE, OAuth2-Secrets, Open Redirects, Host-Header-Probleme, Regex-DoS, CSV-Formula-Injection sowie der Schutz sensibler Diagnose- und Logdaten.

Unbekannte, deaktivierte oder nicht zugeordnete Absender sollen niemals automatisch veröffentlicht werden. Server-seitige Absenderregeln, ACL und Sanitizing dürfen nicht durch Angaben innerhalb einer E-Mail umgangen werden.

Technischer Aufbau

RegioMail2Content besteht aus einem vollständigen Joomla-Paket mit drei wesentlichen Erweiterungen:

com_regiomail2content – zentrale Administrations- und Verarbeitungskomponente

plg_task_regiomail2content – Integration in den Joomla Scheduler

plg_content_regiomail2contentsource – Content-Plugin für die Verarbeitung beziehungsweise Ausgabe zugehöriger Quellinformationen

Die Entwicklungsbasis ist auf Joomla 5 und Joomla 6 ausgelegt.

Typischer Arbeitsablauf

Ein typischer produktiver Einsatz könnte folgendermaßen aussehen:

Ein Administrator richtet zunächst ein IMAP- oder OAuth2-Postfach ein. Anschließend werden vertrauenswürdige Absender oder Absendergruppen angelegt. Für diese werden Zielkategorie, Sprache, Veröffentlichungsstatus, Filterprofil und Artikelvorlage festgelegt.

Ein berechtigter Absender sendet danach eine E-Mail an das eingerichtete Postfach.

RegioMail2Content ruft die Nachricht ab, übernimmt sie in die Queue und analysiert Absender, MIME-Struktur, Mail2Content-Tags, Text, HTML, Bilder und Anhänge. Anschließend werden Filter und Regeln angewendet.

Ist die Nachricht zulässig, werden die Inhalte anhand der hinterlegten Artikelvorlage zusammengesetzt und ein normaler Joomla-Artikel erzeugt. Ist eine automatische Verarbeitung nicht möglich oder nicht erlaubt, kann die Nachricht stattdessen in der Quarantäne verbleiben.

Der gesamte Ablauf kann über Auditlog, Diagnose und Systemprüfung nachvollzogen werden.

Vorteile von RegioMail2Content

Der wesentliche Vorteil besteht darin, dass E-Mail als sehr einfaches Eingabemedium mit der strukturierten Inhaltsverwaltung von Joomla verbunden wird.

Ein externer Autor benötigt nicht zwingend einen Joomla-Backend-Zugang. Gleichzeitig behält der Webseitenbetreiber die Kontrolle über Absender, Kategorien, Veröffentlichungsstatus, Vorlagen, Regeln und Sicherheit.

Dadurch lassen sich große Mengen regelmäßig eintreffender Inhalte effizienter verarbeiten, ohne die redaktionelle und sicherheitstechnische Kontrolle vollständig aufzugeben.

Zusammenfassung

RegioMail2Content ist weit mehr als ein einfacher „E-Mail zu Joomla-Artikel“-Importer. Die Erweiterung bildet eine komplette Verarbeitungsschicht zwischen einem E-Mail-Postfach und dem Joomla Content Management System.

Sie kombiniert IMAP und OAuth2, Absenderverwaltung, Queue-Verarbeitung, Mail2Content-Tags, Filter und HTML-Sanitizing, Bildverarbeitung, SSRF-Schutz, Artikelvorlagen, Regel-Engine, Quarantäne, Joomla-Workflow, Artikelaktualisierung, Dublettenerkennung, Mehrsprachigkeit, Scheduler, Auditlog, Diagnose, Backup und Migration sowie eine integrierte mehrsprachige Dokumentation.

Dadurch eignet sich RegioMail2Content insbesondere für Joomla-Projekte, bei denen viele Inhalte regelmäßig aus unterschiedlichen externen Quellen angeliefert und dennoch kontrolliert, nachvollziehbar und sicher in die bestehende Joomla-Infrastruktur übernommen werden sollen.