186 lines
8.3 KiB
HTML
186 lines
8.3 KiB
HTML
|
<html>
|
|||
|
|
<head>
|
|||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-2">
|
|||
|
|
<title>Dokumentace: Avatar Plugin</title>
|
|||
|
|
</head>
|
|||
|
|
<body>
|
|||
|
|
<h1>Dokumentace pluginy Serendipity ImageSelectorPlus</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 26.6.2011. 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">anglickou dokumentaci</a> a <a href="ChangeLog">ChangeLog</a>.
|
|||
|
|
|
|||
|
|
<h2>Obecn<EFBFBD> popis</h2>
|
|||
|
|
<p>
|
|||
|
|
Plugin ImageSelectorPlus se pou<6F><75>v<EFBFBD> k usnadn<64>n<EFBFBD> pr<70>ce s obr<62>zky, p<>edev<65><76>m k vkl<6B>d<EFBFBD>n<EFBFBD> obr<62>zk<7A> z mediat<61>ky (intern<72> galerie Serendipity).
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
<h2>QuickBlog</h2>
|
|||
|
|
<p>
|
|||
|
|
P<EFBFBD>i nahr<68>v<EFBFBD>n<EFBFBD> obr<62>zku ho rovnou m<><6D>ete vystavit jako p<><70>sp<73>vek. <20>i<EFBFBD>te se podle instrukc<6B> nad formul<75><6C>em QuickBlogu na stran<61> s nahr<68>v<EFBFBD>n<EFBFBD>m soubor<6F>.
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
<h3>Zm<EFBFBD>na vzhledu p<><70>sp<73>vku QuickBlogu</h3>
|
|||
|
|
<p>
|
|||
|
|
Plugin pou<6F><75>v<EFBFBD> <20>ablonu "plugin_quickblog.tpl". Jej<65> zm<7A>nou zm<7A>n<EFBFBD>te vzhled vkl<6B>dan<61>ch obr<62>zk<7A>.
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
<p>Informace o obr<62>zku jsou uchov<6F>ny v poli {$quickblog}, kter<65> m<> tyto <20><>sti:
|
|||
|
|
<ul>
|
|||
|
|
<li>fullimage - cesta a n<>zev velk<6C>ho souboru</li>
|
|||
|
|
<li>image - cesta a n<>zev k n<>hledu</li>
|
|||
|
|
<li>body - t<>lo p<><70>sp<73>vku</li>
|
|||
|
|
<li>exif_mode - zp<7A>sob z<>sk<73>n<EFBFBD> exif tag<61> z fotky ('internal', 'jhead', 'none')</li>
|
|||
|
|
<li>exif - pole obsahuj<75>c<EFBFBD> r<>zn<7A> exif tagy, pro jejich n<>zvy si najd<6A>te dokumentaci exif tag<61> - jejich n<>zvy pou<6F>ijte n<>sledovn<76>, p<><70>klad $quickblog.exif.COMMENT nebo $quickblog.exif.Focal_length</li>
|
|||
|
|
</ul>
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
<h2>Hromadn<EFBFBD> vkl<6B>d<EFBFBD>n<EFBFBD> obr<62>zk<7A></h2>
|
|||
|
|
Dal<61><6C> funkc<6B> je hromadn<64> vkl<6B>d<EFBFBD>n<EFBFBD> obr<62>zk<7A>. Funguje na principu, <20>e v textu p<><70>sp<73>vku nap<61><70>ete xml strukturu, kterou plugin nahrad<61> obr<62>zky z datab<61>ze.
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
<h3>Kdy se to hod<6F>?</h3>
|
|||
|
|
<p>
|
|||
|
|
Kdy<64> p<><70>ete fotoblog a pot<6F>ebujete do p<><70>sp<73>vku vkl<6B>dat v<>ce obr<62>zk<7A> najednou. Kdy<64> m<>te pades<65>t fotek, kter<65> jsou nav<61>c o<><6F>slovan<61>, tak je m<><6D>ete vlo<6C>it bu<62> po jedn<64>, jak to Serendipity umo<6D><6F>uj<75> v z<>kladu, nebo pomoc<6F> jedin<69> <20><>dky s pou<6F>it<69>m popisovan<61>ho pluginu.
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
<h3>P<EFBFBD><EFBFBD>klady</h3>
|
|||
|
|
<h4>P<EFBFBD><EFBFBD>klad 1 - vkl<6B>d<EFBFBD>me <20><>sti galerie</h4>
|
|||
|
|
<code><pre>
|
|||
|
|
<mediainsert>
|
|||
|
|
<gallery name="MyHolidays/" />
|
|||
|
|
<media type="single" name="pict0034" />
|
|||
|
|
<media type="single" name="pict0032" />
|
|||
|
|
<media type="range" prefix="pict00" start="35" stop="52" />
|
|||
|
|
</mediainsert>
|
|||
|
|
</pre></code>
|
|||
|
|
<p>
|
|||
|
|
Takto vlo<6C><6F>me z galerie "MyHolidays" obr<62>zek "pict0034", po n<>m obr<62>zek "pict0032" a pak v<>echny obr<62>zky od "pict0035" do "pict0052".
|
|||
|
|
|
|||
|
|
<ul>
|
|||
|
|
Chov<6F>n<EFBFBD> pluginu:
|
|||
|
|
<li>Zobrazuje pouze obr<62>zky, kter<65> jsou p<><70>tomny v datab<61>zi. Tak<61>e pokud zrovna obr<62>zky 44,45,48 a 50 v datab<61>zi nejsou, pluginu to nevad<61> a nespadne. Jednodu<64>e tyto obr<62>zky vynech<63>.</li>
|
|||
|
|
<li>Zachov<EFBFBD>v<EFBFBD> po<70>ad<61> obr<62>zk<7A> z xml. Tedy obr<62>zek 34 bude zobrazen p<>ed obr<62>zkem 32.</li>
|
|||
|
|
</ul>
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
<h4>P<EFBFBD><EFBFBD>klad 2 - vkl<6B>d<EFBFBD>me celou galerii najednou</h4>
|
|||
|
|
<code><pre>
|
|||
|
|
<mediainsert>
|
|||
|
|
<gallery name="MyHolidays/" />
|
|||
|
|
<media type="gallery" />
|
|||
|
|
</mediainsert>
|
|||
|
|
</pre></code>
|
|||
|
|
|
|||
|
|
<h3>D<EFBFBD>le<EFBFBD>it<EFBFBD></h3>
|
|||
|
|
<p>Plugin je relativn<76> citliv<69> na (ne)spr<70>vnost syntaxe xml. Pokud nen<65> bezchybn<62>, typicky zapomenete na ukon<6F>ovac<61> zp<7A>tn<74> lom<6F>tko v tagu media, m<><6D>ete vy<76>adit z <20>innosti cel<65> blog!!! (prost<73> nen<65> o<>et<65>en<65> kontrola spr<70>vnosti syntaxe a parser na <20>patn<74> syntaxi havaruje)</p>
|
|||
|
|
|
|||
|
|
<h3>P<EFBFBD>ehled xml tag<61></h3>
|
|||
|
|
<dl>
|
|||
|
|
<dt><mediainsert></dt>
|
|||
|
|
<dd>hlavn<EFBFBD> kontejner pro vkl<6B>dan<61> obr<62>zky</dd>
|
|||
|
|
|
|||
|
|
<dt><gallery></dt>
|
|||
|
|
<dd>cesta ke galerii, ze kter<65> maj<61> b<>t br<62>ny obr<62>zky (reltivn<76> k adres<65><73>i uploads/ - bez <20>vodn<64>ho lom<6F>tka a s ukon<6F>uj<75>c<EFBFBD>m lom<6F>tkem - "MyHolidays" nebo "/MyHolidays/" jsou <20>patn<74>. Spr<70>vn<76> je "MyHolidays/".)</dd>
|
|||
|
|
|
|||
|
|
<dt><media></dt>
|
|||
|
|
<dd>Ur<EFBFBD>uje, kter<65> obr<62>zky maj<61> b<>t vlo<6C>eny. Na z<>klad<61> atributu "type" je mo<6D>no vlo<6C>it obr<62>zky t<>emi zp<7A>soby:
|
|||
|
|
|
|||
|
|
<ul>
|
|||
|
|
<li>"single" - vlo<6C><6F> jeden obr<62>zek se jm<6A>nem zadan<61>m atributem "name"</li>
|
|||
|
|
<li>"gallery" - bez dal<61><6C>ch atribut<75>, vlo<6C><6F> celou galerii</li>
|
|||
|
|
<li>"range" - vlo<6C><6F> <20><>slovan<61> obr<62>zky od obr<62>zku "prefix""start" do obr<62>zku "prefix""stop" (viz. p<><70>klad 1)</li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
|
|||
|
|
<h3>Zm<EFBFBD>na vzhledu vkl<6B>dan<61>ch obr<62>zk<7A></h3>
|
|||
|
|
<p>
|
|||
|
|
Plugin pou<6F><75>v<EFBFBD> <20>ablonu "plugin_mediainsert.tpl". Jej<65> zm<7A>nou zm<7A>n<EFBFBD>te vzhled vkl<6B>dan<61>ch obr<62>zk<7A>.</p>
|
|||
|
|
|
|||
|
|
<p>Informace o obr<62>zku jsou uchov<6F>ny v poli {$plugin_mediainsert_media}, kter<65> m<> tyto <20><>sti:
|
|||
|
|
<ul>
|
|||
|
|
<li>name - jm<6A>no obr<62>zku (n<>zev souboru bez p<><70>pony)</li>
|
|||
|
|
<li>extension - p<><70>pona souboru</li>
|
|||
|
|
<li>realname - cel<65> jm<6A>no souboru, to sam<61> jako {$name}.{$extension}</li>
|
|||
|
|
<li>thumbnail_name - n<>zev souboru s n<>hledem dostanete n<>sledovn<76> - {$name}.{$thumbnail_name}.{$extension}</li>
|
|||
|
|
<li>path - cesta ke galerii, stejn<6A> hodnota, kteoru zad<61>v<EFBFBD>te v tagu "gallery"</li>
|
|||
|
|
<li>comment1 - kr<6B>tk<74> koment<6E><74> z datab<61>ze</li>
|
|||
|
|
<li>width - <20><><EFBFBD>ka p<>vodn<64>ho (velk<6C>ho) obr<62>zku</li>
|
|||
|
|
<li>height - v<><76>ka p<>vodn<64>ho (velk<6C>ho) obr<62>zku</li>
|
|||
|
|
<li>thumbwidth - <20><><EFBFBD>ka n<>hledu</li>
|
|||
|
|
<li>thumbheight - v<><76>ka n<>hledu</li>
|
|||
|
|
</ul>
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
<h2>Rozbalov<EFBFBD>n<EFBFBD> ZIP archiv<69></h2>
|
|||
|
|
|
|||
|
|
<h3>K <20>emu je to dobr<62></h3>
|
|||
|
|
<p>Kup<EFBFBD><EFBFBD>kladu kdy<64> chcete nahr<68>t mnoho soubor<6F> najednou. Nemus<75>te vyb<79>rat jednotliv<69> soubory po jednom (co<63> je zdlouhav<61>). Prost<73> je zabal<61>te do zip archivu, nahrajete tento archiv a ten bude na blogu rozbalen.</p>
|
|||
|
|
|
|||
|
|
<h3>Vlastnosti rozbalov<6F>n<EFBFBD> ZIP<49></h3>
|
|||
|
|
<p>
|
|||
|
|
<ul>
|
|||
|
|
<li>Soubory z archivu jsou rozbaleny do stejn<6A>ho adres<65><73>e, do kter<65>ho je nahr<68>n archiv.</li>
|
|||
|
|
<li>Rozbalen<EFBFBD> soubor (co<63> nemus<75> b<>t nutn<74> obr<62>zky) jsou vlo<6C>eny do datab<61>ze m<>di<64>.</li>
|
|||
|
|
<li>Pokud zvol<6F>te volbu "Zadat vlastnosti", rozbalen<65> obr<62>zky se tak<61> zoraz<61> pro zad<61>v<EFBFBD>n<EFBFBD> vlastnost<73>.</li>
|
|||
|
|
<li>Nenahr<EFBFBD>vejte ZIP archivy s podaders<72><73>i. Netestoval jsem to, ale ob<6F>v<EFBFBD>m se, <20>e se tyto adres<65><73>e nevytvo<76><6F> a v<>echny soubory se rozbal<61> do jednoho adres<65><73>e.</li>
|
|||
|
|
<li>D<EFBFBD>vejte pozor na velikost ZIP archivu. Na webu m<>te nastaven<65> ur<75>it<69> omezen<65> t<>kaj<61>c<EFBFBD> se maxim<69>ln<6C> velikosti nahr<68>van<61>ho souboru (obvykle to b<>v<EFBFBD> 10MB).</li>
|
|||
|
|
</ul>
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
<h2>Automatick<EFBFBD> zm<7A>na velikosti obr<62>zk<7A></h2>
|
|||
|
|
|
|||
|
|
<p>Tato funkce automaticky prohled<65> p<><70>sp<73>vek blogu a vyhled<65> obr<62>zky, kter<65> jsou zad<61>ny ve form<72>:</p>
|
|||
|
|
|
|||
|
|
<pre>
|
|||
|
|
<img src="/uploads/mujobrazek.jpg" width="100" height="150" />
|
|||
|
|
</pre>
|
|||
|
|
|
|||
|
|
<p>Kdy<EFBFBD> najde obr<62>zek v tomto form<72>tu (pokud najde obr<62>zek s definovanou v<><76>kou a/nebo <20><><EFBFBD>kou), nahrad<61> jeho atribut 'src' (adresa obr<62>zku) odkazem na skript pro zm<7A>nu velikosti obr<62>zku 'serendipity_admin_image_selector.php'. Tedy p<>ep<65><70>e odkaz na n<>co jako:</p>
|
|||
|
|
|
|||
|
|
<pre>
|
|||
|
|
<img src="http://www.mujblog.cz/serendipity_admin_image_selector.php?serendipity[image]=1&serendipity[disposition]=inline&serendipity[step]=showItem&serendipity[resizeWidth]=100&serendipity[resizeHeight]=150" width="100" height="150" />
|
|||
|
|
</pre>
|
|||
|
|
|
|||
|
|
<p>Tato vlastnost <20>et<65><74> v<><76> <20><>s, pokud pot<6F>ebujete pou<6F><75>t stejn<6A> obr<62>zek ve v<>ce rozli<6C>en<65>ch a m<><6D>e tak<61> u<>et<65>it <20>as nutn<74> pro sta<74>en<65> obr<62>zk<7A> p<>i prohl<68><6C>en<65> va<76>eho blogu. Vliv na rychlost blogu je minim<69>ln<6C>, proto<74>e se zm<7A>na velikosti obr<62>zku provede jenom jednou, p<>i prvn<76>m p<>episu tagu <img>.
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
<h3>Pozn<EFBFBD>mky</h3>
|
|||
|
|
|
|||
|
|
<ol>
|
|||
|
|
<li>Pom<EFBFBD>r stran obr<62>zku je zachov<6F>n.</li>
|
|||
|
|
<li>Sta<EFBFBD><EFBFBD> definovat pouze jeden z atribut<75> 'width' nebo 'height'. Pokud nen<65> zad<61>n <20><>dn<64> z nich, obr<62>zek je ignorov<6F>n a adresa nen<65> nahrazena adresou na skript pro zm<7A>nu velikosti obr<62>zku.</li>
|
|||
|
|
<li>Pokud jsou zad<61>ny dohromady jak <20><><EFBFBD>ka ('width'), tak v<><76>ka ('height'), obr<62>zek bude zv<7A>t<EFBFBD>en/zmen<65>en p<>i zachov<6F>n<EFBFBD> pom<6F>r<EFBFBD> stran tak, aby se ve<76>el do zadan<61> oblasti.</li>
|
|||
|
|
</ol>
|
|||
|
|
|
|||
|
|
<h2>Auto<EFBFBD>i</h2>
|
|||
|
|
<p>
|
|||
|
|
Garvin Hicking, N<>mecko - v<>echno ostatn<74><br />
|
|||
|
|
Vladim<EFBFBD>r Ajgl (vlada [at] ajgl [dot] cz), <20>esk<73> republika, 19.11.2007 - hromadn<64> vkl<6B>d<EFBFBD>n<EFBFBD> obr<62>zk<7A> do p<><70>sp<73>vk<76> pomoc<6F> XML, hromadn<64> nahr<68>v<EFBFBD>n<EFBFBD> v ZIP souboru
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
|
|||
|
|
<h2>Historie verz<72> (ChangeLog)</h2>
|
|||
|
|
|
|||
|
|
<ul>
|
|||
|
|
<li>nejnov<EFBFBD>j<EFBFBD><EFBFBD> verze</li>
|
|||
|
|
<ul>
|
|||
|
|
<li>Dop<EFBFBD>edn<EFBFBD> kompatibilita se smarty3</li>
|
|||
|
|
</ul>
|
|||
|
|
<li>verze 0.28</li>
|
|||
|
|
<ul>
|
|||
|
|
<li>P<EFBFBD>ed<EFBFBD>v<EFBFBD>n<EFBFBD> prom<6F>nn<6E> $eventData do <20>ablony plugin_mediainsert.tpl, pomoc<6F> smarty tagu {$plugin_mediainsert_entry}.</li>
|
|||
|
|
</ul>
|
|||
|
|
<li>verze 0.20 [Vladim<69>r Ajgl]</li>
|
|||
|
|
<ul>
|
|||
|
|
<li>P<EFBFBD>id<EFBFBD>na dokumentace (documentation_en.html, documentation_cs.html)</li>
|
|||
|
|
<li>P<EFBFBD>id<EFBFBD>n <20>esk<73> p<>eklad</li>
|
|||
|
|
<li>P<EFBFBD>id<EFBFBD>na funkce hromadn<64>ho vkl<6B>d<EFBFBD>n<EFBFBD> fotek do p<><70>sp<73>vk<76> pomoc<6F> XML k<>du (pouze s PHP5)</li>
|
|||
|
|
</ul>
|
|||
|
|
</ul>
|
|||
|
|
|
|||
|
|
</body>
|
|||
|
|
</html>
|