WebToDate/Rozesílání e-mailem/Tipy a návody
Tipy pro vytváření stránek definujících obsah e-mailů
URL ve stránkách
Všechna URL vložená přes klíčová slova WebToDate (adresy obrázků, odkaz na odhlášení z e-mailu apod.) mají relativní odkazy začínající lomítkem. Modul sám nikam adresu serveru nedoplňuje. Proto je třeba (v šabloně, ve stylech apod.) s tímto počítat a na odpovídající místa doplnit začátek URL adres (zpravidla http://www.neco.cz). Týká se to zejména obrázků či jiných objektů vložených do stránky a odkazů na zprávy.
Nejčastější problémy v konfiguraci serveru
Pokud modul žádné e-maily neodesílá, bývá často problém v konfiguraci serveru.
V prvé řadě v souboru php.ini zkontrolujte nastavení v sekci [mail function], zejména SMTP a sendmail_from resp. sendmail_path.
Funkce pro odesílání e-mailů vyžaduje aktivaci PHP knihovny PEAR. Postupujte dle instalačního manuálu WebToDate - aktivuje knihovnu spuštěním PHP skriptu PEAR/go-pear.php z příkazové řádky, tj. např.:
c:\winnt\system32\php.exe c:\PHP\PEAR\go-pear.php.
Pokud provozujete instalaci na serveru s MS Windows a IIS a v php.ini máte nakonfigurováno využívání interní SMTP služby, nezapomeňte, že služba ve výchozím stavu pracuje jako běžný SMTP server. To znamená, že je nejen třeba povolit příslušné porty pro odeslání e-mailů, ale musí být přístup i k DNS serveru, aby byla služba schopna zpracovat e-mailové adresy.
Možnosti změny registrace odběrů uživatelem
Možnosti změny registrací se liší podle toho, v jakém je modul nastaven režimu. Vždy je možné do e-mailů generovat URL pro odhlášení z odběru. V režimu registrací přístupných pouze pro registrované je vždy možné registraci zapsat, jen pokud je uživatel registrován a přihlášen. Pro změny registrace je v tomto případě vhodné využít stránku /scripts/modules/mailinglist/list.php, kde si uživatel může měnit dle potřeby svoje odběry i adresu, na kterou chce e-maily zasílat.
V anonymním režimu je vždy ihned proveden zápis registrace. Pokud uživatel použije registrační formulář podruhé, vyhodnocuje se zadaná e-mailová adresa. Pokud je e-mailová adresa v databázi modulu nalezena, je předchozí záznam smazán a uložena nová registrace. Pokud adresa nalezena není, vzniká další nový registrační záznam.
Odběry s aktivací
Modul může pracovat v následujícím režimu:
- Uživatel se zaregistruje k odběru nějakého newsletteru vyplněním formuláře na www stránkách
- Je mu ihned odeslán e-mail, ve kterém se nachází aktivační URL
- Uživatel klikem na toto URL aktivuje zasílání odběru na jeho adresu, zobrazí se potvrzovací stránka
Aby modul pracoval v tomto režimu, je třeba:
- V nabídce Administrace - Odběry ve vlastnostech daného odběru zaškrtnout Registrace vyžaduje aktivaci a Odesílat aktivační e-mail.
- Vytvořit předlohu pro aktivační e-mail. V předloze lze použít klíčová slova <!--WTD_MLIST(LIST)--> (název aktivovaného odběru) a <!--WTD_MLIST(ACTURL)--> (aktivační URL)
- V nabídce Nastavení - Globální - E-maily modulu vyplnit všechna nastavení týkající se aktivačních e-mailů.
Pro každý odběr je zasílán samostatný e-mail. Pokud tedy např. nadefinujeme registrační formulář jako
<form action="/scripts/modules/mailinglist/subscribe.php" method="post">
Zasílat newsletter:<br />
<input type="hidden" name="mlist[]" value="1" />
<input type="hidden" name="mlist[]" value="2" />
<input type="hidden" name="locale" value="CS" />
<input type="text" name="email" /> <input type="submit" name="subscribe" value="Přihlásit" />
</form>
a odběry s ID 1 i 2 jsou nastaveny tak, že vyžadují aktivaci, uživatel se tímto formulářem zaregistruje k oběma odběrům, přijdou mu dva aktivační e-maily a v obou musí použít aktivační URL.
Registrace k odběrům v anonymním a autentizovaném režimu
V režimu vyžadujícím přihlášení může uživatel měnit seznam odběrů, typicky pomocí stránky /scripts/modules/mailinglist/list.php. Pokud přidá odběr a odběr vyžaduje aktivaci, je zaslán aktivační e-mail. Pokud odstraní odběr, zmizí záznam z tabulky registrací k odběrům a pokud odběr následně zase přidá, jedná se v podstatě o novou registraci k odběru (modul si neuchovává informaci o tom, že uživatel k tomuto odběru již byl v minulosti přihlášen) a znovu se generuje aktivační e-mail.
V tomto režimu může uživatel rovněž změnit e-mailovou adresu beze změny seznamu odběrů. V takovém případě jsou všechny odběry vyžadující aktivaci převedeny opět do neaktivovaného stavu a na novou adresu se odesílají aktivační e-maily.
V anonymním režimu se zapíše při registraci záznam uživatele a záznam přihlášení k odběru. V takovém případě se pro odběry vyžadující aktivaci odešle aktivační e-mail. Pokud uživatel znovu použije nějaký registrační formulář k odběru, hledá se v tabulce podle e-mailové adresy. Je-li adresa nalezena, mohou nastat dva případy:
- Jde o pokus zaregistrovat se znovu ke stejnému odběru - pak se v databázi modulu nic nemění.
- Jde o pokus přidat další odběr - pak se stávající registrace odběrů ponechávají nezměněny a pouze v tabulce registrací k odběrům se přidá další odběr, pokud tento nový odběr vyžaduje aktivaci, tak se opět zasílá aktivační e-mail.
Odběry pro SMS služby
Modul může rovněž shromažďovat telefonní čísla pro nějakou provozovanou SMS službu. Registrační formulář v takovém případě může vypadat zhruba následovně:
<form id="mmagazine-order" action="/scripts/modules/mailinglist/subscribe.php">
<table>
<tr><td colspan="3">
<h1>Mobilní magazín</h1>
<p> Číslo zadávejte ve formátu +420 123 456 789.</p>
</td></tr>
<tr>
<td><ul>
<li><input id="link01" type="checkbox" name="mlist[]" value="4" /> <label for="link01">Odběr 1</label></li>
<li><input id="link02" type="checkbox" name="mlist[]" value="5" /> <label for="link02">Odběr 2</label></li>
<li><input id="link03" type="checkbox" name="mlist[]" value="6" /> <label for="link03">Odběr 3</label></li>
</ul></td>
<td><label for="link07">Telefon</label> <input id="link07" type="text" name="gsm" class="form-phone" /></td>
<td class="right bottom"><input type="submit" value="Zaregistrovat" /></td>
</tr>
</table>
<input type="hidden" name="locale" value="CZ" />
<input type="hidden" name="tmplid" value="168" />
</form>
Tento formulář zapisuje do pole GSM zadané telefonní číslo a registruje uživatele k odběrům s ID 4, 5 nebo 6 podle toho, jaká zaškrtávací okénka vyplnil, potvrzovací stránka má vynucené ID předlohy 168.
Pro tento případ nemá smysl odesílat aktivační e-mail. Místo toho je doporučeno zobrazit v stránce potvrzující registraci aktivační kód pomocí klíčového slova <!--WTD_MLIST(CODE)-->.
Další funkcionalitu týkající se SMS služeb ovšem tento modul nepodporuje. V databázi je zapsána registrace a aktivační kód, tyto údaje je třeba předat příslušnému provozovateli SMS služeb tak, aby mohl požadovat aktivaci služby zasláním přiděleného registračního kódu na příslušné telefonní číslo.
