Avvio rapido: inviare la posta del wiki via SMTP

Il percorso più breve da «il plugin è installato» a «un messaggio di prova è nella casella in arrivo». Quattro passi, circa quindici minuti.

Prerequisiti

wkmail è installato e attivato nel gestore delle estensioni.
Siete autenticati come superuser.
Una casella tramite cui potete consegnare — server proprio o account di un fornitore — e la sua password.
La porta di consegna è raggiungibile da questo server, di norma la 587 o la 465. Gli ambienti in hosting spesso la chiudono; il passo 3 lo misura prima che dubitiate della configurazione.

Finché transport vale default, DokuWiki continua a inviare tramite PHP mail(). Potete quindi preparare l'intera configurazione senza mettere a rischio la posta già funzionante del wiki — solo il passo 4 commuta.

Passo 1: inserire le credenziali

Amministrazione → Configurazione, sezione wkmail — oppure dalla schermata di amministrazione tramite Apri le impostazioni (server, casella, password) →.

Per un fornitore noto scegliere il suo profilo; server, porta e cifratura vengono impostati per voi. Per un server proprio scegliere custom e inserire:

Impostazione	Significato
`host`	Il server di consegna. Non necessariamente lo stesso nome del record MX.
`port`	587 per STARTTLS, 465 per TLS immediato.
`encryption`	`tls` per STARTTLS, `ssl` per TLS immediato, `none` senza cifratura.
`username`	La casella con cui vi autenticate.
`password`	La password — o meglio un riferimento, vedi sotto.

Usare encryption = none soltanto verso un server sulla stessa macchina. Altrimenti la password attraversa la rete in chiaro.

Con wkvault installato, al posto della password si inserisce un riferimento, per esempio vault:mail-smtp. La credenziale sta allora in un unico luogo, con registrazione degli accessi, e non nella configurazione di questo plugin.

Passo 2: aprire la schermata di amministrazione

Amministrazione → Invio della posta, direttamente /doku.php?do=admin&page=wkmail.

La schermata esegue le verifiche; i valori stessi stanno nel gestore della configurazione.

Passo 3: misurare se la porta è aperta

Sotto Trasporto attuale scegliere Misura ora. La risposta compare nella riga Porta raggiungibile.

Lo stesso dalla riga di comando, sulla macchina che invierà:

php bin/plugin.php wkmail probe

php bin/plugin.php wkmail status

probe misura adesso, status mostra l'ultimo esito memorizzato senza misurare. Una porta chiusa è il guasto che si manifesta come «il codice non è mai arrivato» e non lascia altro da vedere.

Passo 4: commutare e inviare una prova

Impostare transport su smtp. Poi, sotto Messaggio di prova, inserire il proprio indirizzo in Inviare a e scegliere Invia messaggio di prova.

Verifica del risultato

La schermata segnala Messaggio accettato per il recapito a ….
Il messaggio è nella casella in arrivo, non nella posta indesiderata.
La sezione Recapitabilità è a posto — legge i record DNS reali del vostro dominio mittente e dice che cosa affermano attualmente SPF, DMARC e il percorso di ritorno.

Una consegna accettata dimostra soltanto che il server di consegna ha preso il messaggio. Se arrivi in casella lo decidono le verifiche sotto Recapitabilità.

Passo successivo

wkvault — conservare la password come riferimento invece che come valore.
wkidentity — le procedure che dipendono dall'arrivo della posta e la via d'uscita da riga di comando quando non arriva.
wkmail (in tedesco) — la pagina del pacchetto: tutte le impostazioni e che cosa l'allineamento del mittente fa con From e Reply-To.