Hitri začetek: pošiljanje pošte wikija prek SMTP

Najkrajša pot od »vtičnik je nameščen« do »preizkusno sporočilo je v prejeti pošti«. Štirje koraki, približno petnajst minut.

Predpogoji

wkmail je nameščen in vklopljen v upravitelju razširitev.
Prijavljeni ste kot skrbnik (superuser).
Imate poštni predal, prek katerega smete oddajati pošto (na lastnem strežniku ali pri ponudniku), in njegovo geslo.
Vrata za oddajo pošte so s tega strežnika dosegljiva, običajno 587 ali 465. Gostovana okolja jih pogosto zaprejo; korak 3 to izmeri, preden začnete dvomiti v nastavitve.

Dokler ima transport vrednost default, DokuWiki še naprej pošilja prek funkcije PHP mail(). Vse lahko torej nastavite, ne da bi ogrozili pošiljanje, ki že deluje – preklopi šele korak 4.

Korak 1: vpišite dostopne podatke

Skrbništvo → Splošne nastavitve, razdelek wkmail – ali s skrbniškega zaslona prek Odpri nastavitve (strežnik, predal, geslo) →.

Za znanega ponudnika izberite njegov profil; strežnik, vrata in šifriranje se nastavijo samodejno. Za lasten strežnik izberite custom in vpišite:

Nastavitev	Pomen
`host`	Strežnik za oddajo pošte. Ni nujno isto ime kot v zapisu MX.
`port`	587 za STARTTLS, 465 za neposredni TLS.
`encryption`	`tls` za STARTTLS, `ssl` za neposredni TLS, `none` brez šifriranja.
`username`	Poštni predal, s katerim se prijavite.
`password`	Geslo – ali bolje sklic, glejte spodaj.

encryption = none uporabite samo za strežnik na istem računalniku. Sicer gre geslo po omrežju v golem besedilu.

Z wkvault namesto gesla vpišete sklic, na primer vault:smtp-predal. Dostopni podatki so tedaj shranjeni na enem mestu, z dokazilom o dostopih, in ne v nastavitvah tega vtičnika.

Korak 2: odprite skrbniški zaslon

Skrbništvo → Pošiljanje pošte, neposredno /doku.php?do=admin&page=wkmail.

Zaslon izvaja preverjanja; same vrednosti so v Splošnih nastavitvah.

Korak 3: izmerite, ali so vrata odprta

Odprite zavihek Trenutni prenos in v vrstici ukazov izberite Izmeri zdaj. Rezultat je v vrstici Vrata dosegljiva, skupaj s starostjo meritve.

Takoj po meritvi Vrata dosegljiva navede odzivni čas strežnika in čas meritve (izmerjeno pravkar). Pod temi podatki zaslon predlaga zapise DNS za vašo pošiljateljsko domeno.

Isto iz ukazne vrstice, na računalniku, ki bo pozneje pošiljal pošto:

php bin/plugin.php wkmail probe

php bin/plugin.php wkmail status

probe izmeri zdaj, status pokaže zadnji shranjeni rezultat, ne da bi meril. Zaprta vrata so motnja, ki se pokaže kot »koda ni nikoli prispela« in sicer ne pusti nobene sledi.

Korak 4: preklopite in pošljite preizkusno sporočilo

Nastavite transport na smtp. Nato v vrstici ukazov izberite Pošlji preizkusno sporočilo. V stranskem predalu, ki se odpre, pod Pošlji na vpišite svoj naslov in tam znova izberite Pošlji preizkusno sporočilo.

Stranski predal Preizkusno sporočilo pošlje sporočilo prek nastavljenega prenosa na naslov, vpisan pod Pošlji na.

Preverjanje rezultata

Zaslon sporoči Sporočilo je sprejeto za dostavo na ….
Sporočilo je v prejeti pošti, ne med neželeno pošto.
Zavihek Dostavljivost pod Skupna ocena pokaže v redu – prebere dejanske zapise DNS vaše pošiljateljske domene in pove, kaj trenutno izkazujejo SPF, DMARC in povratna pot (Return-Path).

Zavihek Dostavljivost ima na vrhu skupno oceno, pod njo pa vsako preverjanje z ugotovitvijo in vrednostjo, ki jo je zaslon prebral v DNS. Pri DKIM piše ni ugotovljeno, ker izbirnika (selector) ni mogoče prebrati iz DNS.

Sprejeto pošiljanje dokazuje samo, da je strežnik za oddajo sporočilo prevzel. Ali sporočilo doseže prejeto pošto, pokažejo preverjanja pod Dostavljivost.

Naslednji korak

wkmail – referenca: vse nastavitve, poravnava pošiljatelja in kaj ta naredi z From in Reply-To.
wkvault – geslo shranite kot sklic namesto kot vrednost.
wkidentity: postopki z enkratno kodo – postopki, ki so odvisni od dostavljene pošte, in izhod prek ukazne vrstice, kadar pošta ne prispe.