Module documentation

Kategorie produktů

Dobrá struktura kategorií je jedním z hlavních předpokladů použitelného e-shopu — zákazník se v ní musí zorientovat během několika sekund a zároveň podle ní musí být schopen cíleně filtrovat nabídku. Modul `/product-category` proto slouží k uspořádání katalogu do smysluplné taxonomie, ve které lze kategorie skládat do **hierarchického stromu** (nadřazené a podřazené), přiřazovat produktům jejich zařazení a nastavovat vlastnosti ovlivňující zobrazení na webu i export do zbožových srovnávačů. Protože se katalog v čase proměňuje a roste, je modul postaven tak, aby zvládl i velké struktury a ch...

Last updated 24 April 2026

Dobrá struktura kategorií je jedním z hlavních předpokladů použitelného e-shopu — zákazník se v ní musí zorientovat během několika sekund a zároveň podle ní musí být schopen cíleně filtrovat nabídku. Modul /product-category proto slouží k uspořádání katalogu do smysluplné taxonomie, ve které lze kategorie skládat do hierarchického stromu (nadřazené a podřazené), přiřazovat produktům jejich zařazení a nastavovat vlastnosti ovlivňující zobrazení na webu i export do zbožových srovnávačů. Protože se katalog v čase proměňuje a roste, je modul postaven tak, aby zvládl i velké struktury a chránil konzistenci hierarchie při každé úpravě — díky tomu lze taxonomii průběžně vyvíjet, aniž by administrátor musel řešit dopady na existující produkty, URL adresy nebo historická data.

Dvě zobrazení

Modul nabízí dvě navzájem doplňující se zobrazení, mezi kterými se přepíná v horní liště. Seznamové zobrazení je klasická tabulka se všemi kategoriemi, filtry a možností řazení; hodí se nejlépe pro hromadné úpravy, kdy administrátor potřebuje rychle projít mnoho záznamů a opravit stejnou vlastnost na více místech. Stromové zobrazení vykresluje hierarchii jako rozbalovací diagram, v němž jsou na první pohled vidět vztahy mezi nadřazenými a podřazenými kategoriemi; uzly lze rozbalovat a sbalovat, což se osvědčuje při orientaci v rozsáhlých katalozích a při plánování přesunů celých větví.

Přehled kategorií

Tabulka v seznamovém zobrazení obsahuje všechny údaje potřebné k rozhodnutí o dalším kroku — obrázek kategorie, její název, interní kód, odkaz na nadřazenou kategorii, krátký popis, příznaky aktivity, interního charakteru a B2B, dále počet produktů spadajících do dané kategorie a číselnou pozici pro řazení. Stejně jako u produktů se tabulka automaticky obnovuje každých 20 sekund, takže souběžné úpravy jiných uživatelů nebo změny z importu se projeví okamžitě.

Hierarchie a životní cyklus

Každá kategorie může mít svou nadřazenou kategorii; pokud ji nemá, považuje se za kořenovou (top-level) kategorii. Systém si interně udržuje takzvanou cestu kategorií (path enumeration), která se automaticky přepočítává při každé změně rodiče — díky tomu lze kategorie libovolně přesouvat, prohlubovat nebo vracet na kořen, aniž by administrátor musel ručně vyplňovat drobečkovou navigaci. Operace je bezpečná i u velmi hlubokých stromů, protože přepočet cesty se vždy dotýká celé podřízené větve naráz.

Stav kategorie nevyjadřuje lineární posloupnost, ale sadu vzájemně se kombinujících příznaků, které společně určují, komu se kategorie zobrazí:

  • Aktivní — kategorie se zobrazuje v katalogu na e-shopu a je dostupná pro zákazníky.
  • Neaktivní — kategorie je dočasně skrytá, ale produkty do ní lze stále přiřazovat a zůstávají viditelné, pokud patří do jiné aktivní kategorie.
  • Interní — kategorie slouží výhradně k internímu členění (reporty, statistiky, marketingové akce) a zákazníkům se nikdy nezobrazuje.
  • B2B — kategorie se zobrazuje pouze ověřeným firemním zákazníkům s aktivním B2B účtem.

ℹ️ Informace: Skrytí nadřazené kategorie automaticky neskrývá její podkategorie. Každý uzel hierarchie má vlastní stav a systém s ním nakládá nezávisle — to umožňuje i scénáře typu „veřejná podkategorie pod skrytou nadkategorií", které se občas hodí například při A/B testování.

Vytvoření nové kategorie

Tlačítko Add v pravém horním rohu otevře formulář pro založení kategorie. Jedinou povinnou položkou je název; kód a slug se dopočítají automaticky z názvu, ale lze je ručně upravit. Pro vytvoření podkategorie stačí vybrat nadřazenou kategorii — nová kategorie se okamžitě zařadí pod zvolený uzel v hierarchii. Každá kategorie musí mít v rámci organizace unikátní kód; pokud zadaný kód už existuje, systém jej odmítne a vyzve k zadání jiného.

💡 Tip: Při budování nového katalogu je efektivnější nejprve vytvořit kostru hlavních kategorií (kořenové uzly) a teprve potom postupně doplňovat podkategorie a do nich jednotlivé produkty. Ušetříte si tím pozdější přesuny celých větví.

Detail kategorie

Kliknutím na řádek se otevře detail kategorie rozdělený do záložek podle typu činnosti, kterou zrovna řešíte. Záložka Přehled obsahuje základní údaje a umožňuje editaci názvu, popisu, příznaků i volbu nadřazené kategorie. Galerie slouží k nahrávání obrázků kategorie pro marketingové účely a v současné verzi je ve vývoji. Záložka Produkty zobrazuje seznam produktů dynamicky filtrovaný podle právě otevřené kategorie; z tohoto místa lze hromadně měnit zařazení, pořadí nebo označovat hlavní kategorii u jednotlivých produktů. Poslední záložka Přesměrování ovládá URL adresy a staré odkazy pro účely SEO — nastavuje se v ní, jak mají na novou adresu kategorie ukazovat historické odkazy z indexů vyhledávačů.

Přiřazování produktů

Produkt může být současně ve více kategoriích, což odpovídá reálnému chování katalogů — tričko patří do „Oblečení", „Muži", „Novinky" a „Výprodej" zároveň. Jedna z přiřazených kategorií se vždy označuje jako hlavní a systém ji používá ve dvou klíčových situacích: v drobečkové navigaci na e-shopu a ve feedech pro zbožové srovnávače, které vyžadují právě jednu kategorii na produkt.

Produkt lze přiřazovat třemi rovnocennými cestami, mezi kterými administrátor volí podle toho, odkud začíná. Z detailu produktu na záložce Kategorie má multivýběr všech dostupných kategorií a pohodlně určí hlavní. Z detailu kategorie na záložce Produkty spravuje přiřazení v opačném směru a může hromadně přidávat nebo odebírat desítky produktů. A třetí cesta je kontextové menu v seznamu produktů s akcí Upravit kategorii, která slouží pro rychlou změnu hlavní kategorie bez otevírání detailu.

⚠️ Upozornění: Odstranění produktu z kategorie nezruší jeho zařazení v jiných kategoriích. Pokud však produkt odstraníte z poslední kategorie, zůstane v katalogu nezařazený a nemusí se vůbec zobrazovat ve veřejném výpisu — před masivní reorganizací kategorií proto doporučujeme stav překontrolovat.

Pozice a řazení

Každá kategorie má číselnou pozici, která určuje její pořadí v rámci jedné úrovně hierarchie. Pozice se uplatňuje na e-shopu při výpisu kategorií v menu nebo v seznamu podkategorií u nadřazené kategorie. Hodnotu lze upravit ručně v detailu, nebo přetažením řádků v tabulce; nová kategorie automaticky získá nejvyšší volné číslo, takže se bez zásahu ocitne na konci výpisu a případné úpravy pořadí zůstávají explicitním rozhodnutím administrátora.

Vícejazyčný obsah

Název a popis kategorie se zadávají pro každý jazyk organizace zvlášť. Slug (část URL adresy) se generuje z názvu v daném jazyce, takže každá jazyková verze kategorie má vlastní kanonickou adresu optimalizovanou pro místní vyhledávače a čtenáře. Vícejazyčný obsah funguje stejně jako u produktů — pokud jazyk nemá vyplněný překlad, e-shop se řídí nastavenou fallback logikou organizace a místo prázdné stránky zobrazí překlad ve výchozím jazyce.

Filtrace a vyhledávání

Při práci s velkým katalogem je filtrace nezbytná. Tabulka umožňuje omezit výběr podle stavu (aktivní, neaktivní, interní, B2B), podle nadřazené kategorie a plnotextově podle názvu i kódu. Vyhledávání zohledňuje všechny jazykové varianty názvu, takže stačí zadat výraz v libovolném jazyce a systém najde odpovídající záznamy napříč celou organizací — administrátor tak nemusí při hledání ručně přepínat jazyky.

Dobré praktiky

💡 Tip: Nevytvářejte zbytečně hluboké hierarchie. Z praxe se osvědčuje maximálně tři až čtyři úrovně zanoření — hlubší stromy komplikují navigaci zákazníkům, komplikují orientaci v administraci a zpomalují rozhodování.

💡 Tip: Používejte interní kategorie pro seskupení produktů, které chcete reportovat společně, ale nechcete je zákazníkům prezentovat jako samostatnou nabídku. Typicky sem patří sekce „zboží v akci", „produkty z likvidace" nebo „sezónní položky", kde jde primárně o manažerský pohled na data.

Build with the API

Every module shipped here is also exposed via the REST API.