additional_plugins/serendipity_event_linktrimmer/documentation_cs.html

102 lines
6.2 KiB
HTML
Raw Normal View History

<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=windows-1250">
<title>Dokumentace: Zkracova<76> adres</title>
</head>
<body>
<h1>Dokumentace k pluginu 'Linktrimmer'<br />
<small>(serendipity_event_linktrimmer)</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) a naposledy zkontroloval dne 22.6.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="documentation_en.html">aktu<EFBFBD>ln<EFBFBD> anglickou dokumentaci</a> a <a href="ChangeLog">ChangeLog</a>.
<h2>Popis pluginu</h2>
<p>Plugin Link-trimmer V<>m umo<6D><6F>uje provozovat na blogu vlastn<74> zkracova<76> adres. Podobn<62> jako t<>eba tr.im nebo tinyurl.com.</p>
<p>M<EFBFBD><EFBFBD>ete zadat libovolnou intern<72> (uvnit<69> blogu) nebo extern<72> (jak<61>koliv jin<69>) URL adresu. Plugin si zap<61><70>e tuto adresu do datab<61>ze a p<>i<EFBFBD>ad<61> k n<> kr<6B>tk<74> identifik<69>tor. Pak m<><6D>ete pos<6F>lat jin<69>m lidem m<>sto p<>vodn<64> dlouh<75> adresy tuto novou kr<6B>tkou, kter<65> lze l<>pe zapamatovat. V podstat<61> budete m<>t na blogu vlastn<74> malou slu<6C>bu podobnou komer<65>n<EFBFBD>m slu<6C>b<EFBFBD>m tr.im nebo tinyurl.
</p>
<h2>Pro<EFBFBD> d<>l<EFBFBD> to, co d<>l<EFBFBD>?</h2>
<p>Kr<EFBFBD>tk<EFBFBD> URL adresy jsou pova<76>ovan<61> za v<>ce sexy a obecn<63> p<><70>jemn<6D>j<EFBFBD><6A>. V<>hoda toho, <20>e m<>te vlastn<74> zkracova<76>, je, <20>e m<><6D>ete sami ovliv<69>ovat jeho v<>stupy, p<>esm<73>rov<6F>n<EFBFBD> a dobu platnosti odkaz<61>. Kdy<64> pou<6F><75>v<EFBFBD>te extern<72> slu<6C>by/servery, m<><6D>e se v<>m st<73>t, <20>e p<>ijdete o v<>echny odkazy, pokud server spadne. P<>i vlastn<74>m p<>esm<73>rova<76>i v<>m tak<61> do odkaz<61> nikdo nebude vkl<6B>dat reklamy.</p>
<p>V<EFBFBD>hoda ciz<69>ch slu<6C>eb nicm<63>n<EFBFBD> je jejich zn<7A>most. Lid<69> je pou<6F><75>vaj<61> a v<>d<EFBFBD>, co od nich mhou o<>ek<65>vat.</p>
<h2>Co tento plugin NED<45>L<EFBFBD>?</h2>
<p>Nep<EFBFBD>ed<EFBFBD>l<EFBFBD>v<EFBFBD> automaticky URL adresy zadan<61> v blogu na kr<6B>tk<74> adresy. Plugin serendipity_event_trackexits d<>l<EFBFBD> n<>co na ten zp<7A>sob a pou<6F><75>v<EFBFBD> tyto v<>stupy pro statistick<63> <20><>ely.
</p>
<p>Tento plugin v sou<6F>asn<73> dob<6F> nevede statistiky pou<6F>it<69>. Plugin je sp<73><70>e ve f<>zi (funguj<75>c<EFBFBD>ho) prototypu.</p>
<h2>Jak pou<6F><75>vat tento plugin?</h2>
<p>Pokud chcete zkracovat adresy, m<>te dv<64> mo<6D>nosti. Na <20>vodn<64> str<74>nce po p<>ihl<68><6C>en<65> do adminsitr<74>torsk<73> sekce m<><6D>ete zadat URL adresu, kter<65> se m<> zkr<6B>tit, stejn<6A> jako m<><6D>ete zadat p<>eddefinovan<61> hash, kter<65> bude pou<6F>it jako adresa po zkr<6B>cen<65>. Pokud jej ponech<63>te pr<70>zdn<64>, bude vytvo<76>en automaticky. Hash (zkr<6B>cen<65> adresa) pak bude zkracovan<61> odkaz zak<61>dovan<61> funkc<6B> base62. Ten sest<73>v<EFBFBD> z <20><>slic 0-9, mal<61>ch p<>smen a-z a velk<6C>ch A-Z. To znamen<65>, <20>e nejd<6A><64>ve budete m<>t velmi kr<6B>tk<74> odkazy a <20><>m v<>ce odkaz<61> ulo<6C><6F>te, t<>m budou zkr<6B>cen<65> reprezentace del<65><6C>. Nicm<63>n<EFBFBD> znamen<65> to nap<61><70>klad, <20>e abyste m<>li odkazy del<65><6C> ne<6E> t<>i znaky, mus<75>te jich m<>t alespo<70> 10000:-)</p>
<p>Jakmile zad<61>te URL adresu, klin<69>te na tla<6C><61>tko "GO" (prov<6F>st nebo n<>jak podobn<62> se jmenuje v <20>esk<73>m p<>ekladu), zobraz<61> se V<>m zkr<6B>cen<65> odkaz, kter<65> m<><6D>ete zkop<6F>rovat.</p>
<p>Fin<EFBFBD>ln<EFBFBD> odkaz pou<6F><75>v<EFBFBD> p<>edponu, kterou m<><6D>ete zm<7A>nit v nastaven<65> pluginu.</p>
<p>Jin<EFBFBD> zp<7A>sob, jak vytvo<76>it zkr<6B>cen<65> odkaz, je za<7A><61>t ps<70>t nov<6F> p<><70>sp<73>vek blogu, kliknou na tla<6C><61>tko "Linktrimmer" (je p<><70>stupn<70> jak ve WYSIWYG na NE-WYSIWYG editoru). Pak se otev<65>e vyskakovac<61> okno s pol<6F><6C>kem pro zad<61>n<EFBFBD> adresy ke zkr<6B>cen<65>.</p>
<p>Kdy<EFBFBD> ve vyskakovac<61>m oknu kliknete na tla<6C><61>tko "GO", bude do rozepsan<61>ho p<><70>sp<73>vku automaticky vlo<6C>en odkaz se zkr<6B>cenou adresou. C<>l odkazu bude zkr<6B>cen<65> adresa a v popisu bude adresa p<>vodn<64>ho odkazu.</p>
<h2>Bezpe<EFBFBD>nost</h2>
<p>V<EFBFBD>echny zkracovan<61> odkazy jsou <20><>slovan<61> vzestupn<70>. To umo<6D><6F>uje n<>v<EFBFBD>t<EFBFBD>vn<76>k<EFBFBD>m "odhadnout" a pak si prohl<68>dnout i ostatn<74> odkazy. To je ale ve skute<74>nosti p<>ednost. Tak<61>e do zkracova<76>e NEUKL<4B>DEJTE odkazy na citliv<69> str<74>nky, nebo alespo<70> pou<6F>ijte vlastn<74> (ne p<>eddefinovanou) zkr<6B>cenou adresu.</p>
<h2>Jak p<>izp<7A>sobit plugin</h2>
<p>Pomoc<EFBFBD> <20>ablony plugin_linktrimmer.tpl m<><6D>ete zm<7A>nit vzhled rozhran<61> pluginu. Tuto <20>ablonu ulo<6C>te do adres<65><73>e V<>mi pou<6F><75>van<61>ho stylu vzhledu. CSS stylopis je nejlep<65><70> m<>nit p<><70>mo ve zm<7A>n<EFBFBD>n<EFBFBD> <20>ablon<6F>.</p>
<p>Vychytral<EFBFBD> zp<7A>sob, jak vyu<79><75>t p<>esm<73>rov<6F>n<EFBFBD> pro zkr<6B>cen<65> URL adres je n<>sleduj<75>c<EFBFBD>. Pokud m<>te v<>ce ne<6E> jednu dom<6F>nu, m<><6D>ete pou<6F><75>vat dom<6F>nu s nejkrat<61><74>m n<>zvem jako z<>kladnu pro p<>esm<73>rov<6F>n<EFBFBD>. Nap<61><70>klad, <20>ekn<6B>me, <20>e m<>te 2 dom<6F>ny. Serendipity b<><62><EFBFBD> na http://www.strasnedlouhadomena.com/serendipity/2009/index.php and druh<75>, dote<74> nevyu<79><75>van<61>, dom<6F>na je is http://leto.com. A te<74> chcete, aby zkr<6B>cen<65> odkazy nebyly ve tvaru http://www.strasnedlouhadomena.com/serendipity/2009/l/4711, ale m<>sto toho jen http://leto.com/4711.</p>
<p>Toho doc<6F>l<EFBFBD>te pomoc<6F> apache modulu mod_Rewrite a zaps<70>n<EFBFBD>m n<>sleduj<75>c<EFBFBD>ho k<>du do souboru .htaccess v ko<6B>enov<6F>m adres<65><73>i dom<6F>ny leto.com:</p>
<p>RewriteRule ^([0-9A-Za-z]{1,3})$ http://www.strasnedlouhadomena.com/serendipity/2009/l/$1 [L,QSA]</p>
<p>To znamen<65>, <20>e server leto.com nejd<6A><64>ve provede p<>esm<73>rov<6F>n<EFBFBD> adresy na plnou dlouhou adresu na server, kde b<><62><EFBFBD> blog. Tam plugin vytvo<76><6F> zbytek p<>esm<73>rovac<61> pr<70>ce. V<>imn<6D>te si, <20>e v tomto p<><70>kladu byl pou<6F>it hash (zkratka) dlouh<75> 3 znaky. Pokud m<>te v<>ce odkaz<61> ne<6E> n<>kolik tis<69>c, budete to cht<68>t zm<7A>nit nap<61>. na p<>t , tj. {1,5}. Dejte si jenom pozor, <20>e toto p<>esm<73>rov<6F>n<EFBFBD> nekoliduje se jm<6A>ny existuj<75>c<EFBFBD>h adres<65><73><EFBFBD>. (pozn. p<>ekladatele: To se d<> <20>e<EFBFBD>it pomoc<6F> direktivy RewriteCond. V ka<6B>d<EFBFBD>m p<><70>pad<61> je lep<65><70> se koliz<69>m vyhnout.)</p>
<h2>Historie verz<72> (ChangeLog)</h2>
<ul>
<li>verze 1.3</li>
<ul>
<li>p<EFBFBD>id<EFBFBD>na volba pro schov<6F>n<EFBFBD> zkracova<76>e adres na hlavn<76> str<74>nce administra<72>n<EFBFBD> sekce</li>
<li>Pou<EFBFBD>it<EFBFBD> nativn<76> funkce API - roz<6F>i<EFBFBD>uje serendipity verzi >= 1.3</li>
</ul>
<li>verze 1.1 a 1.2</li>
<ul>
<li>oprava statick<63>ch php5 funkc<6B></li>
</ul>
<li>verze 1.0</li>
<ul>
<li>Nezobrazovat na tabuli (POC)</li>
</ul>
<li>verze 0.9</li>
<ul>
<li>P<EFBFBD>id<EFBFBD>na cesta k obr<62>zku CKEDITOR ready</li>
</ul>
<li>verze 0.8</li>
<ul>
<li>dop<EFBFBD>edn<EFBFBD> kompatibilita se Smarty3</li>
</ul>
<li>verze 0.7</li>
<ul>
<li>Pou<EFBFBD>it<EFBFBD> znakov<6F> sady latin1_general_cs kv<6B>li hled<65>n<EFBFBD> s mal<61>mi/velk<6C>mi p<>smeny. D<>ky u<>ivateli [danst0]</li>
</ul>
<li>verze 0.6 [danst0]</li>
<ul>
<li>Umo<EFBFBD>nen<EFBFBD> pou<6F>it<69> v jin<69>ch pluginech</li>
</ul>
<li>verze 0.5</li>
<ul>
<li>Odstran<EFBFBD>n<EFBFBD> nepot<6F>ebn<62>ho die()</li>
</ul>
<li>verze 0.1</li>
<ul>
<li><EFBFBD>vodn<EFBFBD> release. Viz dokumentace.</li>
</ul>
</ul>
</body>
</html>