Dokumentaci k tomuto pluginu přeložil do češtiny Vladimír Ajgl (vlada [zavinac] ajgl [tecka] cz) a naposledy zkontroloval dne 21.4.2013. 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 a ChangeLog.
'Doporučení Amazon' je postranní plugin, který přistupuje ke službám Amazonu. Tyto mohou být použity k získání informací o produktech prodávaných na Amazonu. Tyto informace můžete využít k odkazování na produkty Amazonu, k zobrazování doporučení nebo k posílení Vašich obchodních zájmů v rámci Affiliate Business programu (partnerství s Amazonem).
'Doporučení Amazon' je postranní plugin, který zobrazí nastavený počet náhodných produktů Amazon z předem připraveného seznamu.
Abyste mohli využívat tento plugin, budete potřebovat Amazon API key. Kromě toho Váš server musí mít povolení připojit se k severům Amazonu (některé webhostingy to mohou zakazovat). Plugin vyžaduje Serendipity alespoň ve verzi 1.4.1, aby si mohl jednoduše zaregistrovat vlastní tlačítka do nástrojové lišty.
API key je jedinečný textový řetězec, který obdržíte od Amazon a který jednoznačně identifikuje Váš blog. To umožňuje Amazonu identifikovat návštěvníky z Vašeho blogu, případné akce partnera Amazon a celkový provoz. Nezapomeňte si předem přečíst Podmínky použití od Amazonu, ať víte, co můžete a nemůžete dělat s jejich API.
V dřívějších dobách Amazon nevyžadoval použití osobního API klíče. Od 15.srpna 2009 je to vyžadováno k přístupu do databáze Amazonu.
Pro získání Amazon API key navštivte stránku aws.Amazon.com a zaregistrujte se. Budou po Vás vyžadovat jméno, email a kontaktní informace.
Po registraci můžete Vaše údaje najít podstránce "Your Account > Access Identifiers" (Váš účet > Přístupové údaje - přímý odkaz).
Pro získání Associate ID (partnerský program) musíte navštívit příslušnou stránku Amazon ("Amazon.com Associates Central") a zaregistrovat se také tam. Získaný klíč pak naleznete na stránce partnerského účtu.
Plugin 'Doporučení Amazon' může být nainstalován obvyklým způsobem pomocí Spartaca, nebo zkopírování pluginu do podadresáře plugins/ a instalací v Administrační sekci Serendipity na stránce 'Konfigurace pluginů' po kliknutí na odkaz 'Klikněte zde pro instalaci postranních pluginů'
Jakmile je plugin nainstalován, můžete ho nastavit kliknutím na jeho nadpis ve výpisu pluginů na stránce 'Konfigurace pluginů'. Budete teď muset nastavit pár věcí:
Plugin také závisí na pluginu "Amazon Media Button" ("Tlačítko médií Amazon"). Pokud tento plugin nemáte nainstalovný, Spartacus by ho měl automaticky nainstalovat na základě závislostí pluginů. Budete muset nastavit i plugin "Tlačítko médií Amazon". Prosím zopakujte níže uvedené kroky i pro něj.
Jednoduše zadejte do textového pole seznam ASIN oddělených čárkou a nastavte volby dle libosti. Jakmile je nastavení dokončené, plugin začne posílat požadavky na Amazon a začne v postranním sloupci zobrazovat náhledy a nadpisy s odkazem na produkt na stránky Amazon.