126 lines
5.5 KiB
HTML
126 lines
5.5 KiB
HTML
|
<html>
|
|||
|
|
<head>
|
|||
|
|
<meta http-equiv="content-type" content="text/html; charset=windows-1250">
|
|||
|
|
<meta name="generator" content="PSPad editor, www.pspad.com">
|
|||
|
|
<title>Dokumentace: Hodnocen<65> (Community rating)</title>
|
|||
|
|
</head>
|
|||
|
|
|
|||
|
|
<style>
|
|||
|
|
code {
|
|||
|
|
display: block;
|
|||
|
|
background-color: #cccccc;
|
|||
|
|
border: solid 1px #666666;
|
|||
|
|
margin: 5px;
|
|||
|
|
padding: 5px;
|
|||
|
|
}
|
|||
|
|
</style>
|
|||
|
|
<body>
|
|||
|
|
|
|||
|
|
<h1>Dokumentace k pluginu 'Hodnocen<65>'</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 19.6.2010. 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="Readme">aktu<EFBFBD>ln<EFBFBD> anglick<63> "readme"</a> a <a href="ChangeLog">ChangeLog</a>.
|
|||
|
|
<p>
|
|||
|
|
|
|||
|
|
<p>
|
|||
|
|
Tento plugin ve sv<73> podstat<61> pouze poskytuje API - program<61>torsk<73> rozhran<61>, neboli soubor funkc<6B>, kter<65> m<><6D>ete pou<6F><75>vat v <20>ablon<6F>ch Smarty.
|
|||
|
|
</p>
|
|||
|
|
|
|||
|
|
<h2>P<EFBFBD><EFBFBD>prava soubor<6F></h2>
|
|||
|
|
<p>
|
|||
|
|
Budete pot<6F>ebovat obr<62>zky se symboly hodnocen<65> (hv<68>zdi<64>ky, medaile, ...). Ty jsou sou<6F><75>st<73> pluginu, nach<63>zej<65> se v podadres<65><73>i "img/".
|
|||
|
|
<p>
|
|||
|
|
Zkop<EFBFBD>rujte tyto soubory do podadres<65><73>e "img" ve va<76><61> aktu<74>ln<6C> <20>ablon<6F>/stylu vzhledu!
|
|||
|
|
|
|||
|
|
<h2>Backend</h2>
|
|||
|
|
<p>
|
|||
|
|
Tento plugin umo<6D><6F>uje vytvo<76>it hodnot<6F>c<EFBFBD> stupnici pro jakoukoliv polo<6C>ku si usmysl<73>te. V n<>sleduj<75>c<EFBFBD>m p<><70>kladu budeme hodnotit filmy na z<>klad<61> IMDB odkaz<61> a ID <20><>sla pro ka<6B>d<EFBFBD> hodnocen<65> film.
|
|||
|
|
<p>
|
|||
|
|
Pot<EFBFBD> co nainstalujete plugin, jd<6A>te do Administra<72>n<EFBFBD> sekce a vytvo<76>te nov<6F> p<><70>sp<73>vek. Pod<6F>vejte se na konec str<74>nky, tam najdete odstavec "Hodnocen<65>" (Community Rating).
|
|||
|
|
|
|||
|
|
<p>
|
|||
|
|
Tady naleznete rozbalovac<61> panel, kam m<><6D>ete p<>id<69>vat hodnocen<65> v<>ci ("IMDB", "V<>robek", ...) a zadat hodnocen<65>. Pro jeden p<><70>sp<73>vek m<><6D>ete zadat v<>ce typ<79> a hodnocen<65>.
|
|||
|
|
<p>
|
|||
|
|
Hodnocen<EFBFBD>, kter<65> jste takto zadali, jsou Va<56>e osobn<62> hodnocen<65> a jsou ulo<6C>ena datab<61>zov<6F> tabulce serendipity_entryproperties.
|
|||
|
|
<p>
|
|||
|
|
Te<EFBFBD> kdy<64> jsme zadali hodnocen<65>, ur<75>it<69> ho pot<6F>ebujeme zobrazit a uk<75>zat n<>v<EFBFBD>t<EFBFBD>vn<76>k<EFBFBD>m str<74>nek. K tomu mus<75>me zm<7A>nit <20>ablony.
|
|||
|
|
|
|||
|
|
<h2>entries.tpl</h2>
|
|||
|
|
<p>
|
|||
|
|
Pou<EFBFBD><EFBFBD>v<EFBFBD>n<EFBFBD> funkc<6B> API rozhran<61> m<> smysl pouze v <20>ablon<6F> entries.tpl.
|
|||
|
|
<p>
|
|||
|
|
Odrolujte nakonec a prohl<68>dn<64>te si HTML k<>d. Nejd<6A><64>ve si mus<75>te rozmyslet, kde se m<> hodnocen<65> zobrazovat.
|
|||
|
|
<p>
|
|||
|
|
Dobr<EFBFBD> m<>sto je t<>eba n<>sleduj<75>c<EFBFBD> <20>sek k<>du:
|
|||
|
|
|
|||
|
|
<code>
|
|||
|
|
<div class="serendipity_entry_extended"><a id="extended"></a>{$entry.extended}
|
|||
|
|
</code>
|
|||
|
|
|
|||
|
|
<p>
|
|||
|
|
Tento <20><>dek je zodpov<6F>dn<64> za zobrazen<65> roz<6F><7A><EFBFBD>en<65> textov<6F> <20><>sti p<><70>sp<73>vku. Zobrazovat hodnocen<65> hned pod n<>m zn<7A> jako dobr<62> n<>pad.
|
|||
|
|
<p>
|
|||
|
|
Aby se zobrazovalo hodnocen<65> filmu, vlo<6C>te do k<>du n<>sleduj<75>c<EFBFBD> tag:
|
|||
|
|
|
|||
|
|
<code>
|
|||
|
|
{communityrating_show data=$entry.properties type="IMDB"}
|
|||
|
|
</code>
|
|||
|
|
Tato funkce vlo<6C><6F> po<70>adovan<61> data o hlasov<6F>n<EFBFBD> ("data") do <20>ablony ("IMDB") a zobraz<61> na str<74>nce Va<56>e hodnocen<65>.
|
|||
|
|
<p>
|
|||
|
|
Tak<EFBFBD> m<><6D>ete zobrazovat hodnocen<65> jin<69>ch lid<69>, kte<74><65> pou<6F><75>vaj<61> tento plugin. Ud<55>l<EFBFBD>te to n<>sledovn<76>:
|
|||
|
|
|
|||
|
|
<code>
|
|||
|
|
{communityrating_show data=$entry.properties type="IMDB" who="garvin" url="http://www.blog_kamarada.cz/index.php?/plugin/communityrating"}
|
|||
|
|
</code>
|
|||
|
|
|
|||
|
|
Pomoc<EFBFBD> parametr<74> "who" a "url" m<><6D>ete zadat adresu blogu kamar<61>da. M<><4D>ete p<>irozen<65><6E> p<>idat libovoln<6C> po<70>et vol<6F>n<EFBFBD> funkce {communityrating_show}.
|
|||
|
|
|
|||
|
|
<h2><EFBFBD>ablony pro hodnocen<65></h2>
|
|||
|
|
<p>
|
|||
|
|
Pro zobrazen<65> hodnocen<65> m<><6D>ete pou<6F><75>t pro ka<6B>d<EFBFBD> typ hodnocen<65> v<>ci (IMDB, V<>robek, ...) a pro ka<6B>d<EFBFBD>ho kamar<61>da jinou <20>ablonu. Tedy <20>e ka<6B>d<EFBFBD> kombinace m<><6D>e vypadat jinak.
|
|||
|
|
<p>
|
|||
|
|
Jako v<>choz<6F> je pou<6F>ita <20>ablona, kter<65> zobrazuje hv<68>zdi<64>ky jako indik<69>tor hodnocen<65>.
|
|||
|
|
<p>
|
|||
|
|
<EFBFBD>ablony jsou pojmenovan<61> jako "communityrating_IMDB.tpl" nebo "communityrating_IMDB_garvin.tpl". Prvn<76> <20><>st ozna<6E>uje typ v<>ci ("_IMDB"). Druh<75> <20><>st n<>zvu ("", "_garvin") je jm<6A>no kamar<61>da, od kter<65>ho zobrazujeme hodnocen<65>. Tak<61>e si m<><6D>ete hodnocen<65> tak, <20>e se pro ka<6B>d<EFBFBD>ho ciz<69>ho hodnotitele bude zobrazovat odli<6C>n<EFBFBD>!
|
|||
|
|
|
|||
|
|
<h2>RSS Kan<61>ly</h2>
|
|||
|
|
|
|||
|
|
<p>
|
|||
|
|
Informaci o hodnocen<65> m<><6D>ete tak<61> p<>idat do RSS kan<61>lu. Pou<6F>ijte stejnou funkci API rozhran<61> v <20>ablon<6F> RSS kan<61>lu, jmenuje se feed_*.tpl. A nezapome<6D>te p<>ipojit parametr "escaped='true'" podle n<>sleduj<75>c<EFBFBD>ho p<><70>kladu:
|
|||
|
|
|
|||
|
|
<code>
|
|||
|
|
{communityrating_show data=$entry.properties type="IMDB" escaped="true"}
|
|||
|
|
</code>
|
|||
|
|
|
|||
|
|
<h2>Postup p<>id<69>n<EFBFBD> nov<6F>ho typu v<>ci</h2>
|
|||
|
|
<ol>
|
|||
|
|
<li>Nastavte plugin "Hlasov<6F>n<EFBFBD>". Upravte pol<6F><6C>ko, kter<65> obsahuje seznam aktu<74>ln<6C> pou<6F>it<69>ch typ<79>. P<>idejte sv<73>j vlastn<74> typ na konec. Odd<64>lova<76>em je <20><>rka ",". Zad<61>vejte n<>zvy bez diakritiky a speci<63>ln<6C>ch znak<61>.</li>
|
|||
|
|
<li>Zkop<EFBFBD>rujte obr<62>zky img/stars_XXX_(full|half|zero).png tak, abyste mohli vytvo<76>it obr<62>zky pro V<><56> nov<6F> typ. Pokud p<>id<69>te nov<6F> typ "auta", mus<75> se obr<62>zky jmenovat "stars_auta_full.png", "stars_auta_half.png", "stars_auta_zero.png".
|
|||
|
|
</li>
|
|||
|
|
<li>Vytvo<EFBFBD>te nov<6F> soubor <20>ablony "communityrating_auta.tpl"</li> bu<62> v adres<65><73>i pluginu, nebo v adres<65><73>i Va<56><61> aktu<74>ln<6C> <20>ablony/stylu vzhledu. Upravte <20>ablonu podle pot<6F>eby.
|
|||
|
|
<li>Upravte <20>ablonu "entries.tpl". Vlo<6C>te do n<> n<>sleduj<75>c<EFBFBD> <20><>dek:
|
|||
|
|
<code>
|
|||
|
|
{communityrating_show data=$entry.properties type="auta"}
|
|||
|
|
</code>
|
|||
|
|
</li>
|
|||
|
|
</ol>
|
|||
|
|
|
|||
|
|
<h2>Postup p<>id<69>n<EFBFBD> nov<6F>ho kamar<61>da</h2>
|
|||
|
|
<ol>
|
|||
|
|
<li>Nejprve se p<>esv<73>d<EFBFBD>te, <20>e kamar<61>d nainstaloval plugin do sv<73>ho blogu serendipity. Tak<61> se p<>edpokl<6B>d<EFBFBD>, <20>e zn<7A>te URL adreu kamar<61>dova blogu.</li>
|
|||
|
|
<li>P<EFBFBD>idejte nov<6F> soubory <20>ablon. <20>ekn<6B>me, <20>e chcete zobrazovat, jak kamar<61>d "garvin" hodnotil filmy podle IMDB. Pak budete pot<6F>ebovat vytvo<76>it soubor "communityrating_IMDB_garvin.tpl".
|
|||
|
|
</li>
|
|||
|
|
<li>Upravte <20>ablonu "entries.tpl". Vlo<6C>te do n<> n<>sleduj<75>c<EFBFBD> <20><>dek:
|
|||
|
|
<code>
|
|||
|
|
{communityrating_show who="garvin" url="http://garvin/index.php?/plugin/communityrating" data=$entry.properties type="auta"}
|
|||
|
|
</code>
|
|||
|
|
</li>
|
|||
|
|
</ol>
|
|||
|
|
|
|||
|
|
<h2>CHANGE_LOG (HISTORIE VERZ<52>)</h2>
|
|||
|
|
<ul>
|
|||
|
|
<li>Nejnov<EFBFBD>j<EFBFBD><EFBFBD>: Dop<6F>edn<64> kompatibilita se smarty3</li>
|
|||
|
|
</ul>
|
|||
|
|
|
|||
|
|
</body>
|
|||
|
|
</html>
|