Dokumentaci k tomuto pluginu přeložil do češtiny Vladimír Ajgl (vlada [zavinac] ajgl [tecka] cz) a naposledy zkontroloval dne 15.1.2012. Od té doby mohl být plugin pozměněn nebo mohly být rozšířené jeho funkce. Zkontrolujte pro jistotu i aktuální anglickou dokumentaci.
"Amazon chooser" je základním pluginem pro přístup k službám serveru Amazon. Ty slouží k získání informací o produktech prodávaných na Amazonu. Vy můžete použít tyto informace k zobrazení odkazů na produkty na Amazonu, k vytvoření návrhů, ale také Vám umožňuje využít výhod Obchodního partnera Amazon.
Tento plugin přidá vlastní tlačítko do správce příspěvku. Při psaní příspěvku uvidíte přídavné tlačítko, které Vám umožní vybrat produkt ze seznamu produktů Amazon. Tento produkt bude připojen k příspěvku blogu.
Abyste mohli využít tento plugin, budete potřebovat Amazon API klíč. Dále je nezbytné, aby váš server/firewall umožňoval připojení k serverům Amazonu. Nakonec tento plugin vyžaduje verzi Serendipity 1.4.1 nebo novější, aby mohl přidávat vlastní tlačítka do editoru.
API klíč je jedinečný řetězec znaků, který obdržíte od Amazonu, abyste se mohli identifikovat, abyste mohli identifikovat Váš blog. Tato identifikace umožňuje Amazonu sledovat odkazy, případné akce Obchodního partnera Amazon, a vytížení jednotlivých uživatelů. Nezapomeňte si přečíst Podmínky použití služby na Amazonu, abyste věděli, co je a není přípustné dělat s API klíčem.
Donedávna Amazon nevyžadoval použití osobního API klíče. Od 15.srpna 2009 je to ale povinnost. Jinak nemůžete používat databázai Amazonu.
Pro žádost o Amazon API klíč navštivte stránku aws.Amazon.com a zaregistrujte se. Budou po Vás žádat jméno, emailovou adresu a kontaktní informace.
Po registraci naleznete Vaše data na stránce "Your Account > Access Identifiers" (přímý odkaz).
Pro žádost o Associate ID (identifikátor pro program Obchodního partnerství) je třeba navštívit vyhrazený server Amazon ("Amazon.com Associates Central") a zapsat se také tam. Tento klíč je následně k nalezení na stránce vašeho partnerského účtu.
Plugin "Amazon-Chooser" lze nainstalovat běžným způsobem pomocí pluginu SPARTACUS. Případně též zkopírováním souborů do podadresáře "plugins/" a nainstalováním v administrační sekci blogu kliknutím nejdříve na odkaz "Konfigurace pluginů" a dále na "Klikněte pro nainstavoání nového pluginu UDÁLOSTÍ".
Jakmile je plugin nainstalovaný, můžete měnit jeho nastavení po kliknutí na název pluginu v sekci "Konfigurace pluginů". Význam jednotlivých voleb nastavení je vysvětlen níže.
Při psaní příspěvku na blog můžete kliknout na tlačítko "Amazon media" (a jde to ve WYSIWYG módu). Otevře se nové vyskakovací okno. V něm můžete vyhledat knihu nebo jiný produkt. Na straně s výsledky hledání vyberete položku, kterou chcete zobrazit v blogu. Jakmile to uděláte, bude položka vložena do příspěvku pomocí následující značky:
[amazon_chooser]32423434X,Books[/amazon_chooser]
Při zobrazení příspěvku bude tato značka nahrazena informacemi o produktu staženými z Amazon serveru. Toto nahrazení je automatické a děje se při každém zobrazení stránky znovu, takže návštěvníci uvidí například aktuální cenu. Pokud znáte identifikátor položky (tzv. ASIN), můžete značku napsat do příspěvku ručně, bez použití tlačítka "Amazon media".
Výsledky hledání jsou na Amazonu cachovány jednu hodinu. Přímo v pluginu jsou výsledky hledání cachovány 12 hodin. Pokud chcete vyčistit cache, jednoduše vymažte obsah adresáře templates_c/amazonchooser/ directory.