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:

1. Uživatel se zaregistruje k odběru nějakého newsletteru vyplněním formuláře na www stránkách
2. Je mu ihned odeslán e-mail, ve kterém se nachází aktivační URL
3. 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:

1. 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.
2. 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)
3. 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.