Schnelleinstieg: Wiki-Mail über SMTP versenden

Der kürzeste Weg von „Plugin ist installiert“ zu „eine Testnachricht liegt im Posteingang“. Vier Schritte, etwa fünfzehn Minuten.

Voraussetzungen

wkmail ist installiert und im Erweiterungsmanager aktiviert.
Sie sind als Superuser angemeldet.
Ein Postfach, über das Sie einliefern dürfen – eigener Server oder Anbieterkonto – samt Kennwort.
Der Einlieferungsport ist von diesem Server aus erreichbar, üblicherweise 587 oder 465. Gehostete Umgebungen sperren ihn oft; Schritt 3 misst das, bevor Sie an der Konfiguration zweifeln.

Solange transport auf default steht, versendet weiterhin DokuWiki über PHP mail(). Sie können also alles einstellen, ohne den laufenden Mailversand zu gefährden – erst Schritt 4 schaltet um.

Schritt 1: Die Zugangsdaten eintragen

Administration → Konfiguration, Abschnitt wkmail – oder vom Verwaltungsbildschirm aus über Einstellungen öffnen (Server, Postfach, Kennwort) →.

Für einen bekannten Anbieter wählen Sie dessen Profil; Server, Port und Verschlüsselung werden dann gesetzt. Für einen eigenen Server wählen Sie custom und tragen ein:

Einstellung	Bedeutung
`host`	Der Einlieferungsserver. Nicht zwangsläufig derselbe Name wie im MX-Eintrag.
`port`	587 für STARTTLS, 465 für unmittelbares TLS.
`encryption`	`tls` für STARTTLS, `ssl` für unmittelbares TLS, `none` für unverschlüsselt.
`username`	Das Postfach, mit dem Sie sich anmelden.
`password`	Das Kennwort – oder besser ein Verweis, siehe unten.

encryption = none nur gegen einen Server auf demselben Rechner. Sonst geht das Kennwort im Klartext über das Netz.

Mit wkvault tragen Sie statt des Kennworts einen Verweis ein, zum Beispiel vault:smtp-postfach. Der Zugang liegt dann an einer Stelle, mit Zugriffsnachweis, statt in der Konfiguration dieses Plugins.

Schritt 2: Den Verwaltungsbildschirm öffnen

Administration → Mailversand, direkt /doku.php?do=admin&page=wkmail.

Der Bildschirm führt die Prüfungen aus; die Werte selbst stehen im Konfigurationsmanager.

Schritt 3: Messen, ob der Port offen ist

Öffnen Sie den Reiter Aktueller Transport und wählen Sie in der Befehlsleiste Jetzt messen. Das Ergebnis steht in der Zeile Port erreichbar, mit dem Alter der Messung.

Reiter Aktueller Transport direkt nach Jetzt messen: Transport, Server, Postfach, Port erreichbar mit der Antwortzeit und dem Vermerk gerade eben gemessen, Absenderausrichtung

Der Reiter direkt nach Jetzt messen: Port erreichbar nennt die Antwortzeit des Servers und wann gemessen wurde. Unter diesen Angaben schlägt der Bildschirm die DNS-Einträge für Ihre Absenderdomäne vor. Die Adressen im Bild sind Beispieldaten.

Dasselbe von der Kommandozeile, auf dem Rechner, der später versenden soll:

php bin/plugin.php wkmail probe

php bin/plugin.php wkmail status

probe misst jetzt, status zeigt das zuletzt gespeicherte Ergebnis, ohne zu messen. Ein geschlossener Port ist die Störung, die als „der Code kam nie an“ auftritt und sonst nichts hinterlässt.

Schritt 4: Umschalten und eine Testnachricht senden

Setzen Sie transport auf smtp. Wählen Sie danach in der Befehlsleiste Testnachricht senden. In der Schublade tragen Sie unter Senden an Ihre eigene Adresse ein und wählen dort erneut Testnachricht senden.

Die Schublade Testnachricht. Die Nachricht geht über den eingestellten Transport an die Adresse unter Senden an.

Ergebnis prüfen

Der Bildschirm meldet Nachricht zur Zustellung an … angenommen.
Die Nachricht liegt im Posteingang, nicht im Spamordner.
Der Reiter Zustellbarkeit zeigt im Gesamturteil in Ordnung – er liest die tatsächlichen DNS-Einträge Ihrer Absenderdomäne und sagt, was SPF, DMARC und der Return-Path derzeit aussagen.

Reiter Zustellbarkeit: Gesamturteil in Ordnung, darunter die Prüfungen für Absender, SPF, DMARC und Return-Path mit Befund und gelesenem Wert, DKIM nicht ermittelbar

Der Reiter Zustellbarkeit: oben das Gesamturteil, darunter jede Prüfung mit ihrem Befund und dem Wert, den der Bildschirm im DNS gelesen hat. DKIM steht auf nicht ermittelbar, weil sich der Selektor nicht aus dem DNS ablesen lässt.

Ein angenommener Versand belegt nur, dass der Einlieferungsserver die Nachricht genommen hat. Ob sie den Posteingang erreicht, entscheiden die Prüfungen unter Zustellbarkeit.

Nächster Schritt

wkmail – Referenz: alle Einstellungen, die Absenderausrichtung und was sie mit From und Reply-To macht.
wkvault – das Kennwort als Verweis ablegen statt als Wert.
wkidentity: Einmalcode-Abläufe – die Abläufe, die auf zugestellte Mail angewiesen sind, und der Ausweg über die Kommandozeile, wenn sie es einmal nicht ist.