Auf einer lokalen WordPress-Site verschwinden E-Mails meist spurlos: wp_mail() übergibt sie an PHPs mail(), das sie auf einem Mac nirgendwohin schickt, wo sie Ihnen nützen. Mit Mailbox leiten Sie WordPress per SMTP an einen Server auf Ihrem Mac, und jede E-Mail — Passwort-Resets, WooCommerce-Bestellungen, Einsendungen über Kontaktformulare — erscheint vollständig gerendert.
1. Server in Mailbox starten
Öffnen Sie Mailbox. Beim ersten Start legt Mailbox einen Server auf Port 2525 an — stellen Sie sicher, dass er gestartet ist. Wenn Sie stattdessen einen weiteren Server hinzufügen, wählt Mailbox dafür einen freien Port; verwenden Sie dann diesen Port in den folgenden Schritten.
2. wp_mail() über SMTP senden
Legen Sie ein Must-Use-Plugin unter wp-content/mu-plugins/local-mailbox.php an. Must-Use-Plugins werden automatisch geladen, und wenn Sie dieses aus der Versionskontrolle heraushalten, gelangt es nie in die Produktion.
<?php
/**
* Plugin Name: Local Mailbox SMTP
* Description: Sends all wp_mail() email to Mailbox on this Mac. Development only.
*/
add_action('phpmailer_init', function ($phpmailer) {
$phpmailer->isSMTP();
$phpmailer->Host = '127.0.0.1';
$phpmailer->Port = 2525;
$phpmailer->SMTPAuth = false;
$phpmailer->SMTPSecure = '';
$phpmailer->SMTPAutoTLS = false;
});
// Sites on http://localhost send from "wordpress@localhost", which wp_mail() rejects.
add_filter('wp_mail_from', function ($from) {
return is_email($from) ? $from : 'wordpress@example.test';
});
Der erste Teil leitet E-Mails ohne Authentifizierung und ohne TLS über SMTP — Mailbox verwendet beides nicht. Der zweite behebt eine Eigenheit: Standardmäßig sendet WordPress von wordpress@ plus der Domain Ihrer Site, und bei einer Site unter http://localhost:8080 enthält die Domain dieser Adresse keinen Punkt, sodass wp_mail() sie ablehnt, bevor die E-Mail überhaupt gesendet wird.
Lieber ein Plugin? Ein SMTP-Plugin wie WP Mail SMTP funktioniert ebenfalls: Wählen Sie den Mailer „Other SMTP“, Host 127.0.0.1, Port 2525, Verschlüsselung None und schalten Sie die Authentifizierung aus. Auf einer localhost-Site setzen Sie außerdem eine Absenderadresse mit einer echt aussehenden Domain.
3. Test-E-Mail senden
Mit WP-CLI:
wp eval 'var_dump( wp_mail( "test@example.com", "Hello from WordPress", "It works!" ) );'
bool(true) bedeutet, dass die E-Mail übergeben wurde, und sie erscheint in Mailbox. Oder nutzen Sie einfach Lost your password? auf der Anmeldeseite.
Local, DDEV und andere Docker-Setups
Läuft WordPress in einem Container, ist 127.0.0.1 der Container selbst. Verwenden Sie host.docker.internal als Host; wird die Verbindung abgelehnt, aktivieren Sie in Mailbox Netzwerkzugriff erlauben (Einstellungen → Allgemein) und starten Sie den Server neu. Das in DDEV integrierte Mailpit fängt nur PHPs mail() ab — sobald WordPress per SMTP sendet, empfängt stattdessen Mailbox die E-Mail. DDEV erwartet, dass Dienste auf dem Host auf allen Interfaces lauschen, aktivieren Sie in diesem Fall also Netzwerkzugriff erlauben.
Fehlerbehebung
wp_mail()gibt false zurück — hängen Sie sich anwp_mail_failedund loggen Sie den Fehler.Invalid address: (From)bedeutet, dass der Filterwp_mail_fromfehlt; ansonsten liegt es meist an einem gestoppten Server oder einem falschen Port.- E-Mails kommen weiterhin nicht an — ein anderes SMTP-Plugin überschreibt die Einstellungen. Deaktivieren Sie es lokal, oder richten Sie es auf Mailbox aus.
Als Nächstes prüfen
WooCommerce- und Theme-E-Mails lassen sich bekanntermaßen nur schwer in allen Clients sauber darstellen. Führen Sie die HTML-Kompatibilitätsprüfung aus, um zu sehen, welches CSS Outlook oder Gmail nicht darstellen, und prüfen Sie Bestell-E-Mails mit der Mobilvorschau auf einem Bildschirm in Smartphone-Größe.