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

Wählen Sie unter Aktueller Transport die Schaltfläche Jetzt messen. Das Ergebnis steht in der Zeile Port erreichbar.

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. Tragen Sie danach im Abschnitt Testnachricht unter Senden an Ihre eigene Adresse ein und wählen Sie Testnachricht senden.

Ergebnis prüfen

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

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.