additional_plugins/serendipity_event_popfetcher/documentation_cs.html

164 lines
8.7 KiB
HTML
Raw Normal View History

<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=windows-1250">
<title>Dokumentace: POP3 stahova<76></title>
<style>
pre {
display: block;
padding: 5px;
border: solid 1px #333333;
background-color: #cccccc;
}
</style>
</head>
<body>
<h1>Dokumentace k pluginu 'POP3 stahova<76>'<br />
<small>(serendipity_event_popfetcher)</small></h1>
<p>Dokumentaci k tomuto pluginu p<>elo<6C>il do <20>e<EFBFBD>tiny Vladim<69>r Ajgl (vlada [zavinac] ajgl [tecka] cz) dne 14.4.2013. Od t<> doby mohl b<>t plugin pozm<7A>n<EFBFBD>n nebo mohly b<>t roz<6F><7A><EFBFBD>en<65> jeho funkce. Zkontrolujte pro jistotu i <a href="docs.txt">aktu<EFBFBD>ln<EFBFBD> anglickou dokumentaci</a> a <a href="ChangeLog">ChangeLog</a>.
</p>
<h2>Autor</h2>
Jason Levitt - <a href="mailto:fredb86@users.sourceforge.net">fredb86@users.sourceforge.net</a>
<h2>Popis pluginu</h2>
<p>St<EFBFBD>huje zpr<70>vy z emailu a zobraz<61> je v<>etn<74> p<><70>loh v bloku v postrann<6E>m sloupci (obsahuje podporu pro mobiln<6C> telefony)</p>
<h2>Obsah<h2>
<ul>
<li><a href="#nedostatky">Zn<EFBFBD>m<EFBFBD> nedostatky</a></li>
<li><a href="#pozadavky">Po<EFBFBD>adavky</a></li>
<li><a href="#popis">Popis</a></li>
<li><a href="#externi_interni">Extern<EFBFBD> proti intern<72>mu pou<6F>it<69></a></li>
<li><a href="#mobily">Podpora mobiln<6C>ch telefon<6F></a></li>
</ul>
<a name="nedostatky"> </a>
<h2>Zn<EFBFBD>m<EFBFBD> nedostatky</h2>
<ul>
<li>
<h3>emaily ve form<72>tu HTML</h3>
POP3 stahova<76> o<>ek<65>v<EFBFBD> emaily ve form<72>tu <20>ist<73>ho textu. HTML emaily mohou fungovat, ale jejich zobrazen<65> bude nejsp<73><70> m<>n<EFBFBD> ne<6E> optim<69>ln<6C>.
</li>
<li>
<h3>POP3 p<>es SSL</h3>
Pokud se sna<6E><61>te p<>istupovat k POP3 p<>es SSL <20>ifrovan<61> spojen<65> (na portu 995) a nem<65>te nainstalovan<61> PHP roz<6F><7A><EFBFBD>en<65> OpenSSL, uvid<69>te n<>sleduj<75>c<EFBFBD> chybovou hl<68><6C>ku: <pre>ERROR: could not connect to mail server: POP3 connect: Error [0] [Unknown error: 0]</pre>
</li>
</ul>
<a name="pozadavky"> </a>
<h2>Po<EFBFBD>adavky</h2>
<ul>
<li>Serendipity 0.8 nebo nov<6F>j<EFBFBD><6A></li>
<li>PHP 4.1 nebo nov<6F>j<EFBFBD><6A>, nebo PHP 5.x</li>
<li>Emailov<EFBFBD> <20><>et p<><70>stupn<70> pomoc<6F> protokolu POP3</li>
</ul>
V<><56> emailov<6F> POP3 server mus<75> podporovat UIDL (v<>echny modern<72> POP3 servery podporuj<75> UIDL). Pokud chcete p<>istupovat k <20><>t<EFBFBD>m Gmail, nebo k dal<61><6C>m <20><>t<EFBFBD>m, kter<65> pou<6F><75>vaj<61> <20>ifrov<6F>n<EFBFBD> POP3 p<>es SSL, mus<75>te m<>t nainstalovan<61> PHP roz<6F><7A><EFBFBD>en<65> OpenSSL. K zapnut<75> POP3 p<>es SSL jednodu<64>e zm<7A><6D>te v nastaven<65> pluginu port ze 110 na 995.
<a name="popis"> </a>
<h2>Popis</h2>
<p>
Plugin p<>id<69>v<EFBFBD> do administra<72>n<EFBFBD>ho menu polo<6C>ku "POP3 stahova<76>". Kliknut<75>m na n<>j st<73>hnete v<>echny emaily i s p<><70>lohami z Va<56><61> emailov<6F> schr<68>nky pomoc<6F> POP3 protokolu. Alternativn<76> m<><6D>e b<>t tento plugin spou<6F>t<EFBFBD>n samostatn<74> zvenku, typicky pluginem 'Pl<50>nova<76> <20>loh' nebo Cronem.
</p>
<p>
P<><50>lohy jsou dek<65>dov<6F>ny a p<>esunuty do Knihovny m<>di<64>. Nav<61>c pokud je 'P<><50>znak "Blog"' nastaven<65> na 'Ano', ka<6B>d<EFBFBD> email v<>etn<74> p<><70>loh je zve<76>ejn<6A>n jako p<><70>sp<73>vek blogu.
</p>
<p>
SprintPCS (a na ni<6E><69><EFBFBD>m stupni, tmobile, cingular a verizon) fotky, videa a audio p<><70>lohy jsou rozpozn<7A>ny a "vy<76>i<EFBFBD>t<EFBFBD>ny" p<>ed publikov<6F>n<EFBFBD>m.
</p>
<a name="externi_interni"> </a>
<h2>Extern<EFBFBD> proti intern<72>mu pou<6F>it<69></h2>
<p>
Prvn<76> nastaven<65> v POP3 stahova<76>i royhoduje, jestli POP3 stahova<76> funguje jako "intern<72>" nebo "extern<72>" plugin.
</p>
<p>
Ve v<>choy<6F>m stavu se POP3 stahova<76> spou<6F>t<EFBFBD> jako "intern<72>". To znamen<65>, <20>e vytv<74><76><EFBFBD> dal<61><6C> polo<6C>ku menu v administra<72>n<EFBFBD>m rozhran<61> a spust<73> se pouze pokud manu<6E>ln<6C> kliknete na tuto polo<6C>ku menu "POP3 stahova<76>". Takhle jednoduch<63> to je.
</p>
<p>
Alternativn<76> ho m<><6D>ete spou<6F>t<EFBFBD>t jako "extern<72>" plugin. To znamen<65>, <20>e je spou<6F>t<EFBFBD>n z vn<76>j<EFBFBD>ku blogu p<><70>stupem na speci<63>ln<6C> URL adresu. Abyste nejr<6A>zn<7A>j<EFBFBD><6A>m dareb<65>k<EFBFBD>m zabr<62>nili ve spou<6F>t<EFBFBD>n<EFBFBD> POP3 stahova<76>e (nem<65>lo by to vliv na bezpe<70>nost, ale bylo by to otravn<76>:-) ), tak si zvol<6F>te hestlo, kter<65> zad<61>te v nastaven<65> POP3 stahova<76>e, kter<65> mus<75> b<>t zad<61>no na konci spou<6F>t<EFBFBD>c<EFBFBD> URL adresy.
</p>
<p>
URL adresa pro extern<72> spou<6F>t<EFBFBD>n<EFBFBD> vypad<61> n<>jak takto:
<pre>http://www.vasblog.cz/serendipity/index.php?/plugin/VASE_HESLO</pre>
nebo pokud je zapnut<75> p<>episov<6F>n<EFBFBD> adres (neboli Apache mod_rewrite), m<><6D>ete pou<6F><75>t i n<>sleduj<75>c<EFBFBD> form<72>t:
<pre>http://www.vasblog.cz/serendipity/plugin/VASE_HESLO</pre>
</p>
<p>
Spr<70>vnost nastaven<65> byste m<>li b<>t schopni ru<72>n<EFBFBD> otestovat tak, <20>e zad<61>te v<><76>e zm<7A>n<EFBFBD>nou URL adresu do va<76>eho webov<6F>ho prohl<68><6C>e<EFBFBD>e.
</p>
<p>
Pak m<><6D>ete p<>idat polo<6C>ku do Cronu, kter<65> bude spou<6F>t<EFBFBD>t POP3 stahova<76> v p<>ednastaven<65>ch intervalech. Testoval jsem to pomoc<6F> lynxu, ale m<>lo by to fungovat i pomoc<6F> wget a curl. Tady je <20><>dka do Cronu, kterou pou<6F><75>v<EFBFBD>m:
<pre>*/30 * * * * /usr/local/bin/lynx -dump http://www.mujblog.cz/serendipity/index.php?/plugin/MOJE_HESLO
>> /htdocs/serendipity/uploads/0000log.txt 2>&1</pre>
samoz<6F>ejm<6A>, pokud m<>te zapnut<75> p<>episov<6F>n<EFBFBD> adres (neboli Apache mod_rewrite), m<><6D>ete pou<6F><75>t n<>sleduj<75>c<EFBFBD> form<72>t:
<pre>*/30 * * * * /usr/local/bin/lynx -dump http://www.mujblog.cz/serendipity/plugin/MOJE_HESLO
>> /htdocs/serendipity/uploads/0000log.txt 2>&1</pre>
tady je verze pomoc<6F> wgetu:
<pre>*/30 * * * * /usr/local/bin/wget -O - -q http://www.mujblog.cz/serendipity/plugin/MOJE_HESLO
>> /htdocs/serendipity/uploads/0000log.txt 2>&1</pre>
a verze pomoc<6F> GETu:
<pre>*/30 * * * * /usr/local/bin/GET http://www.mujblog.cz/serendipity/index.php?/plugin/MOJE_HESLO
>> /htdocs/serendipity/uploads/0000log.txt 2>&1</pre>
</p>
<p>
Tato Cronov<6F> <20>loha spust<73> POP3 stahova<76> ka<6B>d<EFBFBD>ch 30 minut. V<>echny logovac<61> v<>stupy jsou zaps<70>ny do souboru "0000log.txt". Zvolil jsem toto jm<6A>no tak, aby skon<6F>ilo v Knihovn<76> m<>di<64> a<> <20>pln<6C> na konci. Pokud zvol<6F>te filtrov<6F>n<EFBFBD> pomoc<6F> "n<>zvu souboru" a "sestupn<70>", skoro magicky se zobraz<61> jako prvn<76> polo<6C>ka v Knihovn<76> m<>di<64>. Mohli byste si ho tak<61> pojmenovat "aaaalog.txt" a pak by se v<>dy zobrazoval na za<7A><61>tku. M<><4D>ete pou<6F><75>t Knihovnu m<>di<64> k p<>e<EFBFBD>ten<65> tohoto logovac<61>ho souboru poka<6B>d<EFBFBD>, kdy<64> m<>te podez<65>en<65>, <20>e POP3 stahova<76> nefunguje spr<70>vn<76>.
</p>
<a name="mobily"> </a>
<h2>Podpora mobiln<6C>ch telefon<6F></h2>
<p>
POP3 stahova<76> automaticky rozpozn<7A> n<>kter<65> p<><70>lohy z mobiln<6C>ch telefon<6F> (aktu<74>ln<6C> pouze u oper<65>tor<6F> v USA) a p<>esune v<>echny fotky, videa a zvukov<6F> soubory do va<76><61> Knihovny m<>di<64>. Podpora t<>to funkce ja daleko od ide<64>lu, ale funguje docela dob<6F>e pro Sprint a celkem ujde pro n<>kter<65> telefony u ostatn<74>ch oper<65>tor<6F>.
</p>
<h2>Historie verz<72> (ChangeLog)</h2>
<ul>
<li>verze 1.42</li>
<ul>
<li>P<EFBFBD>id<EFBFBD>n<EFBFBD> syntxe [attach:X] k textov<6F>m p<><70>loh<6F>m, kde X ozna<6E>uje <20><>slo p<><70>lohy (za<7A><61>n<EFBFBD> od <20><>sla 1), u p<><70>loh, kter<65> maj<61> b<>t vlo<6C>eny inline</li>
</ul>
<li>verze 1.41</li>
<ul>
<li>Nyn<EFBFBD> um<75> parsovat vlo<6C>en<65> HTML obr<62>zky a nahradit je soubory z p<><70>loh</li>
</ul>
<li>verze 1.37 [danst0]</li>
<ul>
<li>Zm<EFBFBD>na funkce 'ereg' na 'preg_hatcm'</li>
<li>P<EFBFBD>id<EFBFBD>no n<>v<EFBFBD><76>t<EFBFBD> k indikaci, jestli je zobrazen n<>hled nebo cel<65> obr<62>zek.</li>
</ul>
<li>verze 1.36</li>
<ul>
<li>Umo<EFBFBD>n<EFBFBD>n<EFBFBD> nastaven<65> podadres<65><73>e Maildir pro ulo<6C>en<65> email<69> a lad<61>n<EFBFBD> funkce pluginu.</li>
<li>Zvy<EFBFBD>ov<EFBFBD>n<EFBFBD> po<70><6F>tadla duplicit v p<><70>loh<6F>ch, aby se zabr<62>nilo probl<62>m<EFBFBD>m v p<><70>pad<61>, <20>e je ve stejn<6A> sekund<6E> p<>ijat v<>c ne<6E> jeden email s p<><70>lohami.</li>
</ul>
<li>verze 1.35</li>
<ul>
<li>Detekce format=flowed</li>
<li>Opravena chyba, kter<65> nevy<76>istila spr<70>vn<76> "roz<6F><7A><EFBFBD>enou textovou <20><>st" pro n<>sleduj<75>c<EFBFBD> email, co<63> vedlo k tomu, <20>e se m<>chaly texty r<>zn<7A>ch email<69>.</li>
</ul>
<li>verze 1.34</li>
<ul>
<li>P<EFBFBD>id<EFBFBD>na schopnost rozpoznat emaily poslan<61> jako odpov<6F><76> (Re:/Aw:/Wg:) a publikovat je jako koment<6E><74>e sp<73><70>e ne<6E> jako p<><70>sp<73>vky.</li>
<li>P<EFBFBD>id<EFBFBD>na schopnost rozpoznat datum importovan<61>ho emailu</li>
<li>P<EFBFBD>id<EFBFBD>na mo<6D>nost pro zapnut<75> n<>v<EFBFBD><76>t<EFBFBD> $debug pro logov<6F>n<EFBFBD> zpr<70>v z v<>stupu Cronu</li>
<li>Rozpozn<EFBFBD>n<EFBFBD> n<>kter<65>ch z<>kladn<64>ch textov<6F>ch zna<6E>ek (->, >>, => apod.), aby byly escapov<6F>ny.</li>
<li>Odstran<EFBFBD>n<EFBFBD> v<>ech CR/LF znak<61> ufnit<69> tag<61> &lt;embed&gt; a &lt;object&gt; a uvnit<69> v<>ech HTML tag<61>.</li>
<li>Nahrazen<EFBFBD> HTML uvnit<69> koment<6E><74>ov<6F>ch mail<69> zna<6E>kami BBCode.</li>
<li>Detekce znakov<6F> sady us-ascii jako ISO-8859-1</li>
<li>Ukl<EFBFBD>d<EFBFBD>n<EFBFBD> nahran<61>ch soubor<6F> v adres<65><73>ov<6F> struktu<74>e ROK/M<>S<EFBFBD>C.</li>
<li>Zach<EFBFBD>zet s obr<62>zky vlo<6C>en<65>mi do textu tak, <20>e budou vlo<6C>eny do roz<6F><7A><EFBFBD>en<65> textov<6F> <20><>sti po prvn<76>m.</li>
</ul>
<li>verze 1.33</li>
<ul>
<li>Vylep<EFBFBD>eno dek<65>dov<6F>n<EFBFBD> <20>et<65>zc<7A>, aby nefungovalo pouze UTF-8 <-> ISO. D<>ky u<>ivateli [B. Tittelbach] (<a href="https://sourceforge.net/tracker/?func=detail&atid=542822&aid=2831116&group_id=75065">https://sourceforge.net/tracker/?func=detail&atid=542822&aid=2831116&group_id=75065</a>)</li>
</ul>
</ul>
</body>
</html>