Dokumentaci k tomuto pluginu přeložil do češtiny Vladimír Ajgl (vlada [zavinac] ajgl [tecka] cz) dne 14.4.2013. Od té doby mohl být plugin pozměněn nebo mohly být rozšířené jeho funkce. Zkontrolujte pro jistotu i aktuální anglickou dokumentaci a ChangeLog.
Stáhuje zprávy z emailu a zobrazí je včetně příloh v bloku v postranním sloupci (obsahuje podporu pro mobilní telefony)
ERROR: could not connect to mail server: POP3 connect: Error [0] [Unknown error: 0]
Plugin přidává do administračního menu položku "POP3 stahovač". Kliknutím na něj stáhnete všechny emaily i s přílohami z Vaší emailové schránky pomocí POP3 protokolu. Alternativně může být tento plugin spouštěn samostatně zvenku, typicky pluginem 'Plánovač úloh' nebo Cronem.
Přílohy jsou dekódovány a přesunuty do Knihovny médií. Navíc pokud je 'Příznak "Blog"' nastavený na 'Ano', každý email včetně příloh je zveřejněn jako příspěvek blogu.
SprintPCS (a na nižším stupni, tmobile, cingular a verizon) fotky, videa a audio přílohy jsou rozpoznány a "vyčištěny" před publikováním.
První nastavení v POP3 stahovači royhoduje, jestli POP3 stahovač funguje jako "interní" nebo "externí" plugin.
Ve výchoyím stavu se POP3 stahovač spouští jako "interní". To znamená, že vytváří další položku menu v administračním rozhraní a spustí se pouze pokud manuálně kliknete na tuto položku menu "POP3 stahovač". Takhle jednoduché to je.
Alternativně ho můžete spouštět jako "externí" plugin. To znamená, že je spouštěn z vnějšku blogu přístupem na speciální URL adresu. Abyste nejrůznějším darebákům zabránili ve spouštění POP3 stahovače (nemělo by to vliv na bezpečnost, ale bylo by to otravné:-) ), tak si zvolíte hestlo, které zadáte v nastavení POP3 stahovače, které musí být zadáno na konci spouštěcí URL adresy.
URL adresa pro externí spouštění vypadá nějak takto:
http://www.vasblog.cz/serendipity/index.php?/plugin/VASE_HESLOnebo pokud je zapnuté přepisování adres (neboli Apache mod_rewrite), můžete použít i následující formát:
http://www.vasblog.cz/serendipity/plugin/VASE_HESLO
Správnost nastavení byste měli být schopni ručně otestovat tak, že zadáte výše zmíněnou URL adresu do vašeho webového prohlížeče.
Pak můžete přidat položku do Cronu, který bude spouštět POP3 stahovač v přednastavených intervalech. Testoval jsem to pomocí lynxu, ale mělo by to fungovat i pomocí wget a curl. Tady je řádka do Cronu, kterou používám:
*/30 * * * * /usr/local/bin/lynx -dump http://www.mujblog.cz/serendipity/index.php?/plugin/MOJE_HESLO >> /htdocs/serendipity/uploads/0000log.txt 2>&1samozřejmě, pokud máte zapnuté přepisování adres (neboli Apache mod_rewrite), můžete použít následující formát:
*/30 * * * * /usr/local/bin/lynx -dump http://www.mujblog.cz/serendipity/plugin/MOJE_HESLO >> /htdocs/serendipity/uploads/0000log.txt 2>&1tady je verze pomocí wgetu:
*/30 * * * * /usr/local/bin/wget -O - -q http://www.mujblog.cz/serendipity/plugin/MOJE_HESLO >> /htdocs/serendipity/uploads/0000log.txt 2>&1a verze pomocí GETu:
*/30 * * * * /usr/local/bin/GET http://www.mujblog.cz/serendipity/index.php?/plugin/MOJE_HESLO >> /htdocs/serendipity/uploads/0000log.txt 2>&1
Tato Cronová úloha spustí POP3 stahovač každých 30 minut. Všechny logovací výstupy jsou zapsány do souboru "0000log.txt". Zvolil jsem toto jméno tak, aby skončilo v Knihovně médií až úplně na konci. Pokud zvolíte filtrování pomocí "názvu souboru" a "sestupně", skoro magicky se zobrazí jako první položka v Knihovně médií. Mohli byste si ho také pojmenovat "aaaalog.txt" a pak by se vždy zobrazoval na začátku. Můžete použít Knihovnu médií k přečtení tohoto logovacího souboru pokaždé, když máte podezření, že POP3 stahovač nefunguje správně.
POP3 stahovač automaticky rozpozná některé přílohy z mobilních telefonů (aktuálně pouze u operátorů v USA) a přesune všechny fotky, videa a zvukové soubory do vaší Knihovny médií. Podpora této funkce ja daleko od ideálu, ale funguje docela dobře pro Sprint a celkem ujde pro některé telefony u ostatních operátorů.