<h1>Dokumentace k pluginu 'Doporu<72>en<65> Amazon'<br/>
<small>(serendipity_plugin_amazon)</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 21.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 <ahref="documentation_en.html">aktu<EFBFBD>ln<EFBFBD> anglickou dokumentaci</a> a <ahref="Changelog">ChangeLog</a>.
</p>
<h2>Co tento plugin d<>l<EFBFBD></h2>
<p>'Doporu<72>en<65> Amazon' je postrann<6E> plugin, kter<65> p<>istupuje ke slu<6C>b<EFBFBD>m Amazonu. Tyto mohou b<>t pou<6F>ity k z<>sk<73>n<EFBFBD> informac<61> o produktech prod<6F>van<61>ch na Amazonu. Tyto informace m<><6D>ete vyu<79><75>t k odkazov<6F>n<EFBFBD> na produkty Amazonu, k zobrazov<6F>n<EFBFBD> doporu<72>en<65> nebo k pos<6F>len<65> Va<56>ich obchodn<64>ch z<>jm<6A> v r<>mci Affiliate Business programu (partnerstv<74> s Amazonem).</p>
<p>'Doporu<72>en<65> Amazon' je postrann<6E> plugin, kter<65> zobraz<61> nastaven<65> po<70>et n<>hodn<64>ch produkt<6B> Amazon z p<>edem p<>ipraven<65>ho seznamu.</p>
<h2>Po<EFBFBD>adavky</h2>
<p>Abyste mohli vyu<79><75>vat tento plugin, budete pot<6F>ebovat Amazon API key. Krom<6F> toho V<><56> server mus<75> m<>t povolen<65> p<>ipojit se k sever<65>m Amazonu (n<>kter<65> webhostingy to mohou zakazovat). Plugin vy<76>aduje Serendipity alespo<70> ve verzi 1.4.1, aby si mohl jednodu<64>e zaregistrovat vlastn<74> tla<6C><61>tka do n<>strojov<6F> li<6C>ty.</p>
<h2>Jak po<70><6F>dat o Amazon API key</h2>
<p>API key je jedine<6E>n<EFBFBD> textov<6F><20>et<65>zec, kter<65> obdr<64><72>te od Amazon a kter<65> jednozna<6E>n<EFBFBD> identifikuje V<><56> blog. To umo<6D><6F>uje Amazonu identifikovat n<>v<EFBFBD>t<EFBFBD>vn<76>ky z Va<56>eho blogu, p<><70>padn<64> akce partnera Amazon a celkov<6F> provoz. Nezapome<6D>te si p<>edem p<>e<EFBFBD><65>st Podm<64>nky pou<6F>it<69> od Amazonu, a<> v<>te, co m<><6D>ete a nem<65><6D>ete d<>lat s jejich API.</p>
<p>V d<><64>v<EFBFBD>j<EFBFBD><6A>ch dob<6F>ch Amazon nevy<76>adoval pou<6F>it<69> osobn<62>ho API kl<6B><6C>e. Od 15.srpna 2009 je to vy<76>adov<6F>no k p<><70>stupu do datab<61>ze Amazonu.</p>
<p>Pro z<>sk<73>n<EFBFBD> Amazon API key nav<61>tivte str<74>nku <ahref="http://aws.amazon.com/">aws.Amazon.com</a> a <ahref="http://www.amazon.com/gp/aws/registration/registration-form.html">zaregistrujte se</a>. Budou po V<>s vy<76>adovat jm<6A>no, email a kontaktn<74> informace.</p>
<p>Pro z<>sk<73>n<EFBFBD> Associate ID (partnersk<73> program) mus<75>te nav<61>t<EFBFBD>vit <ahref="https://affiliate-program.amazon.com/gp/associates/apply/main.html">p<EFBFBD><EFBFBD>slu<EFBFBD>nou str<74>nku Amazon ("Amazon.com Associates Central")</a> a zaregistrovat se tak<61> tam. Z<>skan<61> kl<6B><6C> pak naleznete na str<74>nce partnersk<73>ho <20><>tu.</p>
<h2>Instalace pluginu</h2>
<p>Plugin 'Doporu<72>en<65> Amazon' m<><6D>e b<>t nainstalov<6F>n obvykl<6B>m zp<7A>sobem pomoc<6F> Spartaca, nebo zkop<6F>rov<6F>n<EFBFBD> pluginu do podadres<65><73>e plugins/ a instalac<61> v Administra<72>n<EFBFBD> sekci Serendipity na str<74>nce 'Konfigurace plugin<69>' po kliknut<75> na odkaz 'Klikn<6B>te zde pro instalaci postrann<6E>ch plugin<69>'</p>
<p>Jakmile je plugin nainstalov<6F>n, m<><6D>ete ho nastavit kliknut<75>m na jeho nadpis ve v<>pisu plugin<69> na str<74>nce 'Konfigurace plugin<69>'. Budete te<74> muset nastavit p<>r v<>c<EFBFBD>:</p>
<p>Plugin tak<61> z<>vis<69> na pluginu "Amazon Media Button" ("Tla<6C><61>tko m<>di<64> Amazon"). Pokud tento plugin nem<65>te nainstalovn<76>, Spartacus by ho m<>l automaticky nainstalovat na z<>klad<61> z<>vislost<73> plugin<69>. Budete muset nastavit i plugin "Tla<6C><61>tko m<>di<64> Amazon". Pros<6F>m zopakujte n<><6E>e uveden<65> kroky i pro n<>j.</p>
<h3>Nastaven<EFBFBD> pluginu</h3>
Ujist<EFBFBD>te se pros<6F>m, <20>e jsou nastaveny n<>sleduj<75>c<EFBFBD> volby v pluginu "Tla<6C><61>tko m<>di<64> Amazon":
Toto je V<><56> kl<6B><6C>, kter<65> identifikuje ka<6B>d<EFBFBD> po<70>adavek na Amazonu. Vypad<61> jako: XKIAIEKPOU3U4MLELLQA. M<><4D>ete ho naj<61>t na dom<6F>c<EFBFBD> str<74>nce Amazonu po p<>ihl<68><6C>en<65> na podstr<74>nce "Your Account > Access Identifiers " (V<><56><20><>et > P<><50>stupov<6F><20>daje).</li>
Tajn<6A> p<><70>stupov<6F> kl<6B><6C> pro v<>voj<6F><6A>e Amazon - je to n<>co jako heslo, kter<65>m se prokazujete. Na str<74>nce Amazonu ho najdete pod Developer Access Key. Poprv<72>, kdy<64> ho budete cht<68>t pou<6F><75>t, si ho vygenerujete na Amazonu, nebo klikn<6B>te na tla<6C><61>tko "Zobrazit", pak se V<>m zobraz<61> hodnota sou<6F>asn<73>ho kl<6B><6C>e.</li>
Tento identifik<69>tor je d<>le<6C>it<69> p<>ipojit ke ka<6B>d<EFBFBD>mu odkazu na Amazon, aby V<>m generoval prokliky v partnersk<73>m programu (Affiliate Business Program). Tento ID najdete na str<74>nce partnersk<73>ho programu Amazon.</li>
</ol>
V pluginu 'Doporu<72>en<65> Amazon' m<><6D>ete nastavit n<>sleduj<75>c<EFBFBD> volby:
Zde m<><6D>ete nastavit, na jak<61> server budete p<>esm<73>rov<6F>vat n<>v<EFBFBD>t<EFBFBD>vn<76>ky blogu po kliknut<75> na V<>m inzerovan<61> produkty Amazon.</li>
<li><strong>Otv<EFBFBD>rat odkazy v nov<6F>m okn<6B></strong><br/>
Plugin bude zobrazovat v<>echny odkazy na Amazon v nov<6F>m okn<6B>.</li>
Po<50>et minut na cachov<6F>n<EFBFBD> v<>stupu pluginu. Po<50>adavky na Amazon jsou cachov<6F>ny 24 hodin, zat<61>mco zobrazen<65> text je cachov<6F>n 60 minut. Toto nastaven<65> umo<6D><6F>uje lehk<68> zv<7A><76>en<65> v<>konu t<>m, <20>e se nebude aktualizovat v<>stup podle serveru Amazon b<>hem doby cachov<6F>n<EFBFBD>. Vypn<70>te cachov<6F>n<EFBFBD> nastaven<65>m "0".</li>
</ol>
<h2>Pou<EFBFBD>it<EFBFBD></h2>
<p>Jednodu<EFBFBD>e zadejte do textov<6F>ho pole seznam ASIN odd<64>len<65>ch <20><>rkou a nastavte volby dle libosti. Jakmile je nastaven<65> dokon<6F>en<65>, plugin za<7A>ne pos<6F>lat po<70>adavky na Amazon a za<7A>ne v postrann<6E>m sloupci zobrazovat n<>hledy a nadpisy s odkazem na produkt na str<74>nky Amazon.</p>
<h2>Historie verz<72> (ChangeLog)</h2>
<ul>
<li>verze 1.22</li>
<ul>
<li>oprava od u<>ivatele [danst0], p<>id<69>no sledov<6F>n<EFBFBD> anal<61>z</li>
</ul>
<li>verze 1.21</li>
<ul>
<li>Aktualizace pluginu, aby spr<70>vn<76> zpracoval v<>voj<6F><6A>sk<73> ID. Zjevn<76> tenhle plugin nikdo nepou<6F><75>v<EFBFBD>.</li>
</ul>
<li>verze 1.20</li>
<ul>
<li>p<EFBFBD>eps<EFBFBD>n<EFBFBD> vkl<6B>dac<61> syst<73>mu, aby podporoval Amazon Product Advertising API</li>
