README

Rundmails an ausgewählte Benutzerrollen – für die modulare Intranet-Plattform.

Eine Ausgabe wird an eine oder mehrere Rollen adressiert und erst nach ausdrücklicher Freigabe verschickt. Der Versand läuft über den Ausgangskorb des Core und ist damit automatisch gedrosselt.

Zwei Wege, eine Ausgabe zu schreiben

Umschaltbar über Reiter; beide Fassungen bleiben gespeichert, modus entscheidet nur, welche gilt. Wer hin- und herwechselt, verliert seine Arbeit nicht.

Baukasten – Überschrift, Textabsatz, Bild, Knopf, Trennlinie. Eingetippter Text wird immer maskiert; das Layout ist nicht zerschießbar. Für alle, die kein HTML schreiben.
Eigener Code – aufgebaut wie der Editor unter Mailvorlagen: Formatierte Fassung (WYSIWYG mit Umschalter auf Quelltext) · Reiner Text · Vorschau mit Testmail. Der Knopf „Aus Baukasten übernehmen" erzeugt aus den Bausteinen einen Startpunkt, den man dann von Hand feinschleift.

Im Code-Modus ist außerdem wählbar, wie der Code verschickt wird:

In die Vorlage einsetzen (Standard) – das HTML kommt als Inhalt in den Newsletter-Rahmen, mit Kopf, Logo, Anrede und Fuß. Wie beim Baukasten, nur der Inhalt ist selbst geschrieben.
Komplett eigener Code – das HTML ist die ganze Mail. Kein Rahmen, keine Anrede; der Verfasser liefert alles selbst (inkl. <html> und Abbinder). Für fertige Kampagnen-Templates aus einem anderen Werkzeug.

Beim Baukasten ist der Rahmen immer an – dort sind die Bausteine Fragmente.

Platzhalter

{{ name }}, {{ ausgabe }} und {{ betreff }} funktionieren in beiden Modi und werden je Empfänger einzeln gefüllt.

⚠️ Das erledigt bewusst dieses Modul (Support\Platzhalter), nicht der Core: VorlagenMailer ersetzt Platzhalter in der Vorlage, in einem einzigen Durchgang – was dabei eingesetzt wird (bei uns die ganze Ausgabe als {{ inhalt }}), wird nicht noch einmal durchsucht. Ohne diesen Zwischenschritt stünde {{ name }} wörtlich in der Mail.

Im Maillog

Jede Newsletter-Mail erscheint im Maillog des Core (Verwaltung → Maillog) mit dem Auslöser Newsletter – auch die „komplett eigener Code"-Mails, die über Mail::html() statt über eine Vorlage laufen. Möglich macht das ein interner Header, den der Core beim Einliefern ausliest und wieder entfernt (VorlagenMailer::quelleMarkieren(), ab dem entsprechenden Core-Stand).

Zustellung je Empfänger (auf der Ausgaben-Seite)

Unterhalb einer freigegebenen Ausgabe steht an wen sie ging bzw. geht, mit dem echten Stand aus dem Maillog des Core – seitenweise (50/Seite):

Status	Bedeutung
Versendet	Vom Mailserver angenommen (mit Zeitpunkt).
Im Ausgangskorb	Eingeliefert, wartet auf den gedrosselten Versand.
Wartet auf Einlieferung	Noch nicht an den Ausgangskorb übergeben.
Versand fehlgeschlagen	Nach mehreren Versuchen aufgegeben (mit Fehlertext).
Übersprungen	Nie verschickt (gesperrt / keine echte Adresse), mit Grund.

Damit die Seite genau ihre eigenen Maillog-Zeilen findet, schreibt der Versand je Mail eine Referenz newsletter:<ausgabe>:<empfänger> in die Core-Spalte mail_outbox.referenz (über den Header X-Intranet-Referenz). Ein Betreff-Vergleich wäre unzuverlässig, wenn zwei Ausgaben denselben Betreff tragen.

⚠️ Braucht Core mit der mail_outbox.referenz-Spalte. Fehlt sie (älterer Core), bleibt die Übersicht beim Stand „Eingeliefert", statt mit einem Fehler auszusteigen.

Installation

composer require do1emu/module-newsletter
php artisan migrate
php artisan modules:sync
php artisan storage:link   # nur einmalig, falls noch nicht geschehen (Bild-Bausteine)

⚠️ Der Scheduler muss laufen. Ohne * * * * * php artisan schedule:run bleibt jede Ausgabe im Status „Versand läuft" stehen – wie jede andere Mail des Intranets auch.

Wie es arbeitet

Das Modul erfindet keinen zweiten Mailweg. Es schreibt in dieselbe mail_outbox wie jede andere Mail. Daraus folgt ohne eigenes Zutun:

Drosselung über das Stundenlimit (Einstellungen → Mailversand). Ein Newsletter an 900 Personen rieselt bei Limit 250 über rund vier Stunden raus.
Vorfahrt für Wichtiges: 2FA- und Passwort-Mails haben Priorität 10 und überholen den Newsletter (Priorität 0). Niemand wartet Stunden auf seinen Anmeldecode.
Künstliche Adressen (.intern) fallen still raus – Benutzer ohne echte Mailadresse sprengen den Versand nicht.

Der Command newsletter:versenden läuft minütlich und liefert höchstens --anzahl (Standard 200) Empfänger je Lauf ein. Das schützt den einzelnen Lauf vor dem Zeitlimit; das Tempo nach außen bestimmt weiterhin der Ausgangskorb.

Zielgruppen

Auswählbar sind alle Rollen, die es in dieser Instanz gibt – das Modul bringt keine eigenen mit und kennt keine fest verdrahteten Gruppen. Wer im Admin-Panel eine neue Rolle anlegt, kann sie sofort anschreiben. Zusätzlich gibt es „Alle Benutzer".

Immer ausgeschlossen: gesperrte Konten und Adressen, an die nicht zugestellt werden kann. Die Aufschlüsselung („erreicht 412 von 917") steht schon im Formular, bevor man freigibt.

Vorlagen

Das Modul meldet zwei Einträge unter Verwaltung → Mailvorlagen an:

Schlüssel	Was es ist
`_rahmen_newsletter`	Eigener Rahmen: Kopf, Logo, farbiger Streifen, Fußzeile. Getrennt vom Rahmen der Systemmails, weil ein Rundbrief anders aussehen darf.
`newsletter`	Was um jede Ausgabe steht: Anrede, Abbinder. Der Betreff wird über `{{ betreff }}` durchgereicht – wer will, macht daraus `[Schule] {{ betreff }}`.

Beides ist im Backend bearbeitbar, hat Live-Vorschau, Testmail und „Standard wiederherstellen".

⚠️ Der eigene Rahmen braucht Core ≥ VorlagenDefinition mit $rahmen-Feld. Mit einem älteren Core meldet das Modul seine Vorlagen nicht an und der Versand fällt auf den allgemeinen Rahmen zurück.

Wer darf schreiben?

Wer das Modul sehen darf, darf auch schreiben und freigeben. Für eine eigene Redaktion legt man im Admin-Panel eine Rolle an und gibt das Modul nur ihr frei (Modulverwaltung → Sichtbarkeit).

Bekannte Grenzen

Keine Anhänge. 900× dasselbe PDF in der Outbox-Tabelle wäre kein guter Tausch – die Outbox speichert jede Mail vollständig. Stattdessen: Datei als Bild-Baustein hochladen oder verlinken.
Keine Abmeldung (Opt-out). Für eine interne Rundmail an Mitglieder vertretbar; ein Abmelde-Link bräuchte einen Token-Link ohne Anmeldung.
Kein zeitversetzter Versand. Freigabe heißt: läuft ab jetzt.

do1emu / module-newsletter

Maintainers

Package info

Statistics

Security