E-Mail Versand

Das E-Mail-Versand-Modul konfiguriert den SMTP-Versand für das gesamte Netzwerk. Alle ausgehenden E-Mails des Weinhold Frameworks – von Kalender-Erinnerungen bis zu Passwort-Reset-Mails – laufen über diese eine zentrale Konfiguration.

Allgemein

Konfiguration

SMTP-Server, Port, Verschlüsselung (TLS/SSL/keine), Benutzername und Passwort werden einmalig unter Weinhold → E-Mail Versand für das gesamte Netzwerk eingetragen. Einzelne Subsites können optional einen abweichenden Absendernamen und eine eigene Absenderadresse festlegen, sofern das netzwerkweit erlaubt ist. Ist kein SMTP konfiguriert, greift automatisch der lokale Mailserver über WordPress‘ Standard-wp_mail().

E-Mail-Templates

Andere Module können eigene E-Mail-Templates registrieren, die im Dashboard unter Weinhold → E-Mail Versand → Templates mit individuellem Betreff und Nachrichtentext angepasst werden können – netzwerkweit und zusätzlich pro Subsite überschreibbar. Aktuell nutzen u. a. Gerätesicherheit, Security Manager und Bastard des Monats dieses System für ihre Benachrichtigungs-Mails.

In der Praxis

Auf weinify.de läuft der gesamte transaktionale E-Mail-Versand – Passwort zurücksetzen, Kalender-Erinnerungen, Modul-Benachrichtigungen – über dieses Modul. Kein Plugin-Wirrwarr, eine zentrale Stelle.

Dateien

modules/email_delivery.php – einzige Datei des Moduls: SMTP-Konfiguration, Passwort-Verschlüsselung, Absender-Filter, komplettes E-Mail-Template-System, Admin-Oberflächen (Netzwerk + Site), Cleanup.

Für Entwickler

Ein eigenes Template registrieren

Beim eigenen Modul-Init über den Filter weinhold_email_templates einen Eintrag mit label, module, description, default_subject, default_body und variables registrieren. Immer verfügbare Platzhalter in jedem Template: {site}, {datetime}, {manage_url} – zusätzlich die selbst in variables gelisteten. Versand dann über weinhold_send_module_mail($template_id, $to, $context, $site_id) statt direktem wp_mail().

Auflösungsreihenfolge

Sowohl Absender als auch Betreff/Text eines Templates werden in der Reihenfolge Site-Override → Netzwerk-Anpassung → Modul-Default aufgelöst (weinhold_email_get_resolved_template()). Templates lassen sich netzwerkweit deaktivieren, dann sendet weinhold_send_module_mail() gar nicht erst.

SMTP-Erkennung & Passwortschutz

weinhold_email_delivery_should_use_smtp() nutzt SMTP nicht nur, wenn die Checkbox aktiv ist, sondern auch dann, wenn ein SMTP-Host UND Zugangsdaten/Auth gesetzt sind – schützt gegen ein versehentlich deaktiviertes SMTP bei sonst vollständig ausgefüllter Konfiguration. Das SMTP-Passwort wird nie im Klartext gespeichert, sondern mit AES-256-CBC verschlüsselt (Schlüssel aus dem WordPress-AUTH_KEY bzw. -Salt abgeleitet); alte Klartext-Werte werden beim Lesen automatisch erkannt und weiterhin akzeptiert (Migrationsfall).

Wichtige Funktionen

Funktion	Beschreibung
weinhold_send_module_mail($template_id,$to,$context,$site_id)	Zentraler Versand für Modul-E-Mails über das Template-System
weinhold_email_get_resolved_template($template_id,$site_id)	Löst Betreff/Text/Absender eines Templates auf
weinhold_email_delivery_get_effective_settings()	Liefert die tatsächlich wirksamen SMTP-/Absender-Einstellungen (inkl. Subsite-Override)
weinhold_email_delivery_send_test_mail($to,$scope)	Versendet eine Test-Mail und fängt Fehler zur Anzeige im Dashboard ab

Besonderheiten

Absender-Override gilt nur temporär pro Mail: weinhold_send_module_mail() hängt bei abweichendem Template-Absender kurzzeitig eigene wp_mail_from/wp_mail_from_name-Filter ein und entfernt sie sofort nach dem Versand wieder – andere, zeitgleich versendete E-Mails bleiben unberührt.

Test-Ergebnisse werden als Transient gespeichert (24 Stunden), nicht dauerhaft in Optionen – nach dem Testen im Dashboard bleibt das Ergebnis eine Weile sichtbar, verschwindet danach automatisch von selbst.

Fällt die Verschlüsselung aus irgendeinem Grund aus (z. B. openssl-Erweiterung fehlt), wird das Passwort unverschlüsselt gespeichert statt den Vorgang abzubrechen – bewusste Entscheidung gegen Datenverlust, auf Kosten geringerer Sicherheit in diesem Randfall.

Versionshistorie

Version	Datum	Änderung
1.0.0	22.09.2026	Einführung der Versionierung.

Email Delivery

The Email Delivery module configures SMTP sending for the entire network. All outgoing emails from the Weinhold Framework — from calendar reminders to password reset emails — run through this single central configuration.

General

Configuration

SMTP server, port, encryption (TLS/SSL/none), username, and password are entered once under Weinhold → Email Delivery for the entire network. Individual subsites can optionally set a different sender name and address, if allowed network-wide. If no SMTP is configured, the local mail server is used automatically via WordPress‘ default wp_mail().

Email Templates

Other modules can register their own email templates, customizable in the dashboard under Weinhold → Email Delivery → Templates with an individual subject and body — network-wide, and additionally overridable per subsite. Currently, Device Security, Security Manager, and Bastard of the Month use this system for their notification emails, among others.

In Practice

On weinify.de, all transactional email sending — password resets, calendar reminders, module notifications — runs through this module. No plugin clutter, one central place.

Files

modules/email_delivery.php – the module’s only file: SMTP configuration, password encryption, sender filters, the complete email template system, admin UIs (network + site), cleanup.

For Developers

Registering Your Own Template

In your own module’s init, register an entry with label, module, description, default_subject, default_body, and variables via the weinhold_email_templates filter. Always-available placeholders in every template: {site}, {datetime}, {manage_url} — plus whichever ones you list yourself in variables. Send via weinhold_send_module_mail($template_id, $to, $context, $site_id) instead of calling wp_mail() directly.

Resolution Order

Both the sender and the subject/body of a template are resolved in the order site override → network customization → module default (weinhold_email_get_resolved_template()). Templates can be disabled network-wide, in which case weinhold_send_module_mail() doesn’t send at all.

SMTP Detection & Password Protection

weinhold_email_delivery_should_use_smtp() uses SMTP not only when the checkbox is enabled, but also when an SMTP host AND credentials/auth are set — protects against SMTP being accidentally disabled while the rest of the configuration is otherwise complete. The SMTP password is never stored in plain text; it’s encrypted with AES-256-CBC (key derived from the WordPress AUTH_KEY/salt); old plain-text values are automatically detected on read and still accepted (migration case).

Key Functions

Function	Description
weinhold_send_module_mail($template_id,$to,$context,$site_id)	Central send path for module emails via the template system
weinhold_email_get_resolved_template($template_id,$site_id)	Resolves a template’s subject/body/sender
weinhold_email_delivery_get_effective_settings()	Returns the actually effective SMTP/sender settings (including subsite override)
weinhold_email_delivery_send_test_mail($to,$scope)	Sends a test email and captures errors for display in the dashboard

Special Cases

Sender override is only temporary per email: when a template’s sender differs, weinhold_send_module_mail() briefly hooks its own wp_mail_from/wp_mail_from_name filters and removes them right after sending — other emails sent at the same time are unaffected.

Test results are stored as a transient (24 hours), not permanently in options — after testing in the dashboard, the result stays visible for a while and then disappears on its own.

If encryption fails for any reason (e.g. the openssl extension is missing), the password is stored unencrypted instead of aborting the operation — a deliberate choice against data loss, at the cost of reduced security in that edge case.

Version History

Version	Date	Change
1.0.0	22.09.2026	Introduction of versioning.

email-versand