Systém sledování vrácených e-mailů
From LimeSurvey Manual
Úvod
Systém sledování vrácených e-mailů dokáže vyhledat a označit e-maily, které nebyly doručeny příjemcům (respondentům průzkumu). Systém vychází ze zprávy o selhání doručení e-mailu. Proto potřebuje e-mailovou adresu, na kterou lze tyto zprávy odesílat, aby bylo možné vrácené e-maily sledovat. Kromě adresy účtu jsou vyžadovány také přihlašovací údaje k účtu a podrobnosti o připojení.
Požadavky
Na vašem serveru musí být nainstalován modul php5-imap. Zda tomu tak je, můžete zjistit pomocí tlačítka Zobrazit PHPInfo, které najdete na stránce Globální nastavení vaší instalace LimeSurvey na záložce Přehled:

Dále vyhledejte sekci imap (pro rychlé vyhledání použijte Ctrl+F). Pokud se sekce imap zobrazí, je vše v pořádku:

Pokud nemáte nainstalovaný php5-imap a máte k serveru přístup root, můžete jej nainstalovat podle postupu specifického pro vaši distribuci. Například pokud používáte Debian, podívejte se na tento odkaz. Po instalaci nezapomeňte restartovat webový server (např. spuštěním příkazu "apache/usr/sbin/apache2ctl restart" v terminálu).
Jak to funguje
Základní myšlenkou při vývoji systému bylo omezit ruční práci a snížit možné lidské chyby, které mohou vzniknout při ručních úpravách každého pole.
Základní myšlenka tohoto systému spočívá v tom, že při odesílání e-mailu systém sledování vrácených e-mailů automaticky přidá do záhlaví e-mailu ID průzkumu a ID tokenu, aniž by si toho administrátor všiml.

Tato záhlaví (známá také jako vlastní záhlaví) jsou přidávána do každého e-mailu s pozvánkou odeslaného prostřednictvím LimeSurvey respondentům průzkumu.
Když se e-mail vrátí, přijde původní záhlaví spolu se záhlavím oznámení o doručení. Systém poté zkontroluje nové e-maily a zpracuje ty, které tato vlastní záhlaví obsahují. Chybné e-mailové adresy v tabulce respondentů pak zobrazí červenou barvou písma.
Nastavení systému
Systém může fungovat globálně (pro všechny průzkumy) nebo lokálně (pouze pro konkrétní průzkum), a nastavení lze proto uložit odpovídajícím způsobem. Globální nastavení vrácených e-mailů lze uložit v části Globální nastavení -> Nastavení vrácených e-mailů. Zobrazí se následující možnosti:

- Výchozí e-mailová adresa serveru pro vrácené nedoručené e-maily: Toto je e-mailová adresa, na kterou budou vrácené e-maily odesílány. Pro rychlejší zpracování vrácených e-mailů doporučujeme používat adresu, která slouží pouze systému sledování vrácených e-mailů v LimeSurvey.
- Typ serveru: Pokud je nastaveno na "Vypnuto", nebudou dostupné žádné funkce zpracování vrácených e-mailů. Chcete-li systém sledování vrácených e-mailů v LimeSurvey používat, zvolte "POP" nebo "IMAP".
- Jméno a port serveru: Název serveru a (v případě potřeby) port oddělený dvojtečkou. Číslo portu obvykle není nutné uvádět, pokud e-mailový server nepoužívá nestandardní port.
- Uživatelské jméno: Uživatelské jméno pro účet POP/IMAP.
- Heslo: Heslo pro účet POP/IMAP.
- Typ šifrování: Pokud se používá šifrování, nastavte zde správný typ (SSL nebo TLS).
Chcete-li použít nastavení vrácených e-mailů pouze pro jeden průzkum, otevřete požadovaný průzkum -> přejděte do menu průzkumu a klikněte na záložku Respondenti -> v hlavním panelu nástrojů stránky klikněte na možnost Pozvánky a upomínky -> klikněte na Nastavení vrácených e-mailů. Načte se následující stránka:

Další možnost představuje položka Použité nastavení odrážek. Zde můžete zvolit, zda použijete:
- žádné nastavení vrácených e-mailů;
- lokální nastavení vrácených e-mailů. Pokud ho zvolíte, budete muset vyplnit zbývající pole lokálního nastavení vrácených e-mailů;
- globální nastavení vrácených e-mailů. V tomto případě se použije nastavení vrácených e-mailů vaší instalace LimeSurvey.
Použití e-mailového serveru LimeSurvey Cloud
Pokud používáte e-mailový server LimeSurvey Cloud, budou mít všechny vaše e-maily adresu odesílatele "noreply@limesurvey.org". Tyto e-maily však budou mít záhlaví Reply-to s vaší e-mailovou adresou. Pokud se tedy někdo pokusí odpovědět, může psát přímo vám.
Vrácené e-maily se při používání serveru LimeSurvey Cloud zpracovávají automaticky. Nemusíte nic nastavovat ani spouštět zpracování vrácených zpráv, stačí ponechat výchozí nastavení beze změny. Vše probíhá kouzelně na pozadí. Mějte na paměti, že může trvat 10–15 minut, než se vrácený e-mail zpracuje a příslušný záznam se označí.
Spuštění zpracování vrácených zpráv
Před spuštěním zpracování vrácených zpráv nezapomeňte nejprve odeslat e-mailové pozvánky respondentům průzkumu.
Ve verzi 3.0+ můžete po nastavení systému sledování vrácených e-mailů spustit zpracování vrácených zpráv takto: otevřete domovskou stránku průzkumu -> v menu průzkumu klikněte na kartu Respondenti -> klikněte na Invitations & reminders (na panelu nástrojů) -> Začít zpracování vrácených zpráv.

Po výběru této možnosti se během zpracování zobrazí indikátor průběhu a následně souhrn konečného stavu zpracování.
Odeslané e-mailové pozvánky začnou být kontrolovány. Výsledky kontroly se zobrazí v tabulce respondentů (možná budete muset stránku ručně obnovit). U všech záznamů, jejichž pozvánky se vrátily, budou e-mailové adresy označeny červeným písmem. Jejich Stav e-mailu se také změní z "OK" na "bounced".

Spuštění zpracování vrácených zpráv ve verzi 2.5
Ve verzi 2.50+ můžete po nastavení systému zpracování vrácených zpráv spustit zpracování vrácených zpráv z domovské stránky průzkumu: Invitations & reminders -> Začít zpracování vrácených zpráv.

Po výběru této možnosti se během zpracování zobrazí indikátor průběhu a následně souhrn konečného stavu zpracování.
Odeslané e-mailové pozvánky začnou být kontrolovány. Výsledky kontroly se zobrazí v tabulce respondentů (možná budete muset stránku ručně obnovit). U všech záznamů, jejichž pozvánky se vrátily, budou e-mailové adresy označeny červeným písmem. Jejich Stav e-mailu se také změní z "OK" na "bounced".
Příklad
Abyste lépe pochopili, jak systém sledování vrácených e-mailů v LimeSurvey funguje, prohlédněte si následující příklad:
1. Přidejte respondenty do tabulky respondentů. Ujistěte se, že každý z nich má přiřazený token a e-mailovou adresu.
2. Vyberte respondenty, kterým chcete poslat pozvánku do průzkumu:

Klikněte na tlačítko Vybraní respondenti... a zvolte možnost Poslat e-mailové pozvánky.
3. Chvíli počkejte, aby se e-maily stihly odeslat respondentům průzkumu.
4. Nyní můžete použít systém sledování vrácených e-mailů v LimeSurvey. Klikněte na Invitations & reminders a vyplňte pole nastavení vrácených e-mailů údaji o připojení a účtu vaší osobní e-mailové schránky:

Pole můžete také nechat prázdná. Zpracování vrácených zpráv bude stále fungovat, jen nebudete dostávat žádné e-maily související se zpracováním vrácených zpráv. Stav e-mailu u záznamů v tabulce respondentů se však aktualizuje.
Jak můžete vidět níže, systém sledování vrácených e-mailů používáme s bezplatným účtem Gmail. Informace o nastavení připojení pro Gmail najdete na tomto odkazu. Nezapomeňte také v nastavení svého účtu Gmail povolit IMAP/POP.

Vyplňte pole. Vyberte požadovaný server a nastavení šifrování. Poté klikněte na tlačítko Uložit v pravé horní části obrazovky.
5. Nyní můžete kliknout na tlačítko Začít zpracování vrácených zpráv:

Systém sledování vrácených e-mailů začne vyhledávat ID průzkumu, ID tokenu a oznámení o doručení, která jsou připojena k záhlaví každého vráceného e-mailu. Pokud tato vlastní záhlaví existují, systém změní barvu písma chybných e-mailových adres v tabulce respondentů na červenou. Stav e-mailu příslušných záznamů se také změní z OK na bounced.
