Knihy
Aby bylo možné nabízet knihy zákazníkům, je nejprve nutné vytvořit formáty a nahrát je do Miguela. Pro vytvoření knihy stačí zadat titul a identifikátor (nebo kód produktu). Knihy se mohou vytvářet přes administraci anebo pomocí API.
Identifikátor knihy
Identifikátor se používá pro párování knihy s produktem na e-shopu nebo při komunikaci přes API. Takže je vhodné používat nějaký jednotný a srozumitelný systém. Můžete si jej nastavit na jakýkoliv text, číslo nebo třeba ISBN.
V našem nakladatelství používáme URL slug z titulu (pro knihu Čtyřhodinové tělo použijeme ctyrhodinove-telo,
všechny znaky malé, bez diakritiky a místo mezer pomlčka).
- nedoporučujeme diakritiku
- doporučujeme použít pouze následující znaky
a-z,A-Z,0-9,-,_,@,.,/a+. - doporučujeme použít jednoduchý, univerzální a čitelný formát
- délka není omezená, ale doporučujeme délku do 50 znaků
Nahrávání souborů
Aby se mohly nabízet knihy, je nutné je nejprve nahrát. Soubory se nahrávají na bezpečné centrální uložiště v Miguelovi. Miguel podporuje několik formátů pro e-knihy a audioknihy (viz Formáty). Je také možné nahrát několik různých formátů k jedné knize. Například EPUB a PDF, pokud chcete nabízet jak jednoduchou tak i graficky složitou variantu.
Při nahrávání se knihy validují. U některých formátů může validace trvat i několik minut, záleží na velikosti, komplexnosti knihy a také na aktuálním vytížení Miguela. Nejdéle trvá nahrávání EPUB (viz Formáty > EPUB > Validace).
Verzování
U každého souboru lze určit číslo verze, to umožňuje mít v Miguelovi víc verzí jedné knihy (při generování knihy se vždy použije soubor s nejvyšším číslem verze). Původně byla tato funkce zamýšlena pro uchovávání všech verzí knihy v čase, ale zjišťujeme, že se tato možnost nepoužívá a naopak způsobuje komplikace. Tuto funkci proto nejspíš v budoucnu odstraníme a při nahrání nové verze se předchozí po nějakém čase smaže.