> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/sk/brand-pages/brand-page-retailer-integration-guide/module-capabilities.md).
# Schopnosti modulu
Tento dokument popisuje každý dostupný typ modulu, jeho polia, obmedzenia a možnosti konfigurácie. Použite ho ako príručku pre maloobchodníkov o tom, čo jednotlivé moduly podporujú a čo môžu značky konfigurovať pri vytváraní obsahu stránky značky (Brand Page).
***
## Prehľad typov modulov
| Modul | Účel |
| -------------------- | ----------------------------------------------------------------------------- |
| Hero banner | Médiá na celú šírku s nadpisom, podnadpisom a výzvou na akciu (CTA) |
| Obrázok | Samostatný obrázok s voliteľným popiskom, alternatívnym textom a odkazom |
| Text | Nadpis, podtitul, hlavný text alebo vlastný viacriadkový text |
| Rozdelený rozloženie | Dvojstĺpcové alebo vrstvené rozloženie obsahujúce moduly Obrázok a/alebo Text |
| Galéria obrázkov | Mriežka obrázkov s voliteľným názvom sekcie, popisom a výzvou na akciu (CTA) |
| Ponuka filtrov | Navigačný panel s označenými položkami filtrov |
| Mriežka produktov | Vybraná mriežka produktov s voliteľným filtrovaním a výzvou na akciu (CTA) |
## Spoločné polia (všetky moduly)
Každý modul zdieľa nasledujúce systémovo spravované polia. Značky ich nenastavujú priamo.
| Pole | Popis |
| --------------------------- | --------------------------------------------------------------------------- |
| `id` | Automaticky vygenerovaný jedinečný identifikátor |
| `brandPageModuleTemplateId` | Pája obsah so šablónou modulu maloobchodníka |
| `order` | Pozícia zobrazenia na stránke (spravovaná pomocou funkcie presunutia myšou) |
| `optionality` | Či je celý modul povinný, alebo sa dá preskočiť (definuje maloobchodník) |
## 1. Hero banner
Banner na celú šírku, ktorý kombinuje obrázok na pozadí, prekrytie, text nadpisu a výzvu na akciu. Zvyčajne ide o prvý modul na stránke značky (Brand Page).
### Médiá
| Pole | Povinné? | Obmedzenia |
| ----------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| Obrázok | Povinné | Formáty: `GIF`, `JPG`, `PNG`, `SVG` · Min. rozmery: definuje maloobchodník · Max. veľkosť súboru: definuje maloobchodník |
| Alternatívny text | Povinné alebo Voliteľné (definuje maloobchodník) | Popisný text pre prístupnosť |
{% hint style="info" %}
Podpora videa sa plánuje, ale zatiaľ nie je k dispozícii. Momentálne sa akceptuje iba obrázok.
{% endhint %}
### Prekrytie
Maloobchodník definuje, či je pre tento modul k dispozícii prekrytie:
| Nastavenie | Správanie |
| --------------------- | ------------------------------------------------------------------- |
| `disabled` | Bez prekrytia — obrázok sa zobrazuje bez akejkoľvek farebnej vrstvy |
| `optional` (povolené) | Značka sa môže rozhodnúť povoliť alebo zakázať prekrytie |
| `required` | Prekrytie sa zobrazuje vždy; značka ho nemôže vypnúť |
Keď je prekrytie povolené, značka si vyberie štýl pozadia. Maloobchodník určuje, ktoré štýly sú ponúkané:
| Štýl | Popis |
| ---------- | ----------------------------- |
| `gradient` | Gradovaný prechod z obrázka |
| `solid` | Plochý farebný blok za textom |
Obe možnosti môžu byť sprístupnené súčasne.
### Textový obsah
| Pole | Povinné? | Obmedzenia |
| ---------------------------------- | ---------------------------------------------------------- | --------------------------------------------------------------- |
| Nadpis | Povinné | Max. počet znakov: definuje maloobchodník |
| Podnadpis | Voliteľné | Max. počet znakov: definuje maloobchodník |
| Text tlačidla výzvy na akciu (CTA) | Povinné, Voliteľné alebo Zakázané (definuje maloobchodník) | Max. počet znakov: definuje maloobchodník |
| URL odkazu výzvy na akciu (CTA) | Povinné, Voliteľné alebo Zakázané (definuje maloobchodník) | Max. počet znakov: definuje maloobchodník · Musí byť platná URL |
{% hint style="info" %}
Text výzvy na akciu a odkaz výzvy na akciu sa konfigurujú spoločne. Ak je výzva na akciu zakázaná, nezobrazí sa ani jedno pole. Nemôžete mať odkaz výzvy na akciu bez tlačidla výzvy na akciu a naopak.
{% endhint %}
### Zarovnanie textu
Maloobchodník definuje, ktoré možnosti zarovnania sú k dispozícii. Možné hodnoty: `left`, `center`, `right`. Značka si vyberá z ponúkanej sady.
## 2. Obrázok
Samostatný obrázok s voliteľným titulkom, alternatívnym textom a cieľom odkazu.
### Nahrávanie obrázka
| Pole | Povinné? | Obmedzenia |
| ----------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| Obrázok | Povinné | Formáty: `GIF`, `JPG`, `PNG`, `SVG` · Min. rozmery: definuje maloobchodník · Max. veľkosť súboru: definuje maloobchodník |
| Alternatívny text | Povinné alebo Voliteľné (definuje maloobchodník) | Popisný text pre prístupnosť |
### Titulok
| Pole | Povinné? | Obmedzenia |
| ------- | --------- | ------------------------------------------------------ |
| Titulok | Voliteľné | Max. počet znakov: definované predajcom · Jeden riadok |
{% hint style="info" %}
Dostupnosť titulku definuje predajca. Ak predajca titulky nepovolil, pole sa nezobrazí.
{% endhint %}
### Odkaz
Každý obrázok môže voliteľne odkazovať na cieľ. Značka si vyberá jeden z troch typov odkazov:
| Typ odkazu | Popis |
| ---------- | -------------------------------------------------------------------------------------- |
| `image` | Bez odkazu — obrázok nie je interaktívny |
| `url` | Po výbere presmeruje na vlastnú URL |
| `product` | Presmeruje na konkrétnu stránku s detailom produktu (vybranú pomocou výberu produktov) |
### Dodatočné textové riadky
Niektoré moduly Obrázok podporujú dodatočné označené textové riadky vedľa obrázka (napríklad názov alebo popis zobrazený pod alebo nad obrázkom). Dostupnosť, označenia, veľkosti písma a to, či je každý riadok povinný alebo voliteľný, definuje predajca.
## 3. Text
Flexibilný textový modul, ktorý podporuje jednoriadkové a viacriadkové varianty.
### Varianty
Predajca definuje, ktorý variant modul používa:
| Variant | Popis |
| ---------- | ---------------------------------------------------------------------------------------- |
| `headline` | Jeden výrazný riadok textu — veľký, tučný |
| `tagline` | Jeden sprievodný riadok — menší ako nadpis |
| `body` | Jeden blok hlavného textu — zobrazuje sa ako textová oblasť |
| `lines` | Viacero pomenovaných textových riadkov, každý s vlastnou veľkosťou písma a voliteľnosťou |
### Polia — jednoriadkové varianty (`headline`, `tagline`, `body`)
| Pole | Povinné? | Obmedzenia |
| ---- | -------- | ------------------------------------------------------------- |
| Text | Povinné | Max. počet znakov: definované predajcom (platí pre celé pole) |
### Polia — viacriadkový variant (`lines`)
Každý riadok definuje predajca samostatne:
| Pole | Povinné? | Obmedzenia |
| ----------- | ---------------------------------------------------------------- | ---------------------------------------------------------------- |
| Text riadku | Povinné alebo Voliteľné (pre každý riadok, definované predajcom) | Max. počet znakov: definované predajcom (platí pre každý riadok) |
| URL riadku | Voliteľné | Dostupné iba na riadkoch, kde je `isHyperlink` povolené |
### CTA
| Pole | Povinné? | Obmedzenia |
| ---------------------------------- | ---------------------------------------------------------- | ------------------- |
| Text tlačidla výzvy na akciu (CTA) | Povinné, Voliteľné alebo Zakázané (definuje maloobchodník) | — |
| URL odkazu výzvy na akciu (CTA) | Povinné, Voliteľné alebo Zakázané (definuje maloobchodník) | Musí byť platná URL |
{% hint style="info" %}
Voliteľnosť CTA platí pre text aj URL súčasne. Ak je zakázaná, nezobrazí sa ani jedno pole.
{% endhint %}
### Zarovnanie
Definované predajcom. Možné hodnoty: `left`, `center`, `right`. Platí pre všetok text v module.
### Maximálna šírka
Predajca nastavuje `maxWidth` obmedzenie, ktoré limituje, aký široký sa môže textový blok zobraziť (napríklad `600px` or `80%`). Ide o obmedzenie zobrazenia, nie o obmedzenie obsahu.
## 4. Rozdelené rozloženie
Kontajner rozloženia, ktorý obsahuje dva alebo viac podriadených modulov usporiadaných v stĺpcoch alebo riadkoch. Podriadené moduly sú moduly **Obrázok** a/alebo **Text**. Vkladanie je podporované do hĺbky 2, ale Rozdelené rozloženia nemôžete vkladať na kmeňovej úrovni.
### Možnosti rozloženia
| Rozloženie | Možnosti |
| ---------- | ----------------------------------------------------------------------------------------- |
| `columns` | Vedľa seba. Pomer: `50:50`, `33:67`, or `67:33` (definované predajcom, ktoré sú ponúkané) |
| `rows` | Usporiadané zvisle nad sebou |
### Medzery
Medzeru medzi podriadenými prvkami definuje predajca na základe škály medzier v dizajnovej príručke predajcu.
### Podriadené prvky
| Vlastnosť | Hodnota |
| --------------------------------- | ------------------------------------------------------------------------------------------- |
| Povolené typy podriadených prvkov | `Image`, `Text` |
| Počet podriadených prvkov | Definované predajcom (`numChildren`) |
| Vkladanie | Podriadené Rozdelené rozloženie môže samo obsahovať moduly `Image` a `Text` (max. hĺbka: 2) |
{% hint style="info" %}
Dôležité
Do Rozdeleného rozloženia nemôžete umiestniť Hero Banner, Galériu obrázkov, Ponuku filtrov ani Mriežku produktov.
{% endhint %}
## 5. Galéria obrázkov
Mriežka obrázkov s voliteľnou hlavičkou sekcie, popisom a spodným CTA.
### Hlavička sekcie
| Pole | Povinné? | Obmedzenia |
| ------------ | ---------------------------------------------------------- | ---------- |
| Názov sekcie | Povinné, Voliteľné alebo Zakázané (definuje maloobchodník) | — |
| Popis sekcie | Povinné, Voliteľné alebo Zakázané (definuje maloobchodník) | — |
### Rozloženie galérie
Definované predajcom pre každý breakpoint:
| Vlastnosť | Popis |
| ------------- | -------------------------------------------------------------------------------------- |
| Stĺpce | Počet stĺpcov na mobilných zariadeniach, tabletoch a počítačoch (definované predajcom) |
| Výška obrázka | Výška v pixeloch alebo percentách pre každý breakpoint (definované predajcom) |
| Medzera | Rozstup medzi obrázkami (zo štýlového manuálu predajcu) |
### Obrázky
| Vlastnosť | Obmedzenia |
| -------------------------- | ---------------------------------------------------------------- |
| Minimálny počet obrázkov | Definované predajcom (musíte pridať aspoň tyle) |
| Maximálny počet obrázkov | Definované predajcom (nemožno prekročiť tento počet) |
| Formáty | `GIF`, `JPG`, `PNG`, `SVG` |
| Minimálne rozmery | Definované predajcom |
| Maximálna veľkosť súboru | Definované predajcom |
| Alternatívny text | Povinné alebo voliteľné pre každý obrázok (definované predajcom) |
| Popisok ku každému obrázku | Voliteľné, max. počet znakov: definované predajcom |
| Odkaz ku každému obrázku | `image` (žiadne) · `url` · `product` — rovnaké ako modul Obrázok |
### Dodatočné riadky textu pre každý obrázok
Rovnaké ako v module Obrázok — označenia, veľkosti písma a voliteľnosť pre každý riadok definované predajcom.
### CTA (v spodnej časti galérie)
| Pole | Povinné? | Obmedzenia |
| ---------------------------------- | ---------------------------------------------------------- | ------------------- |
| Text tlačidla výzvy na akciu (CTA) | Povinné, Voliteľné alebo Zakázané (definuje maloobchodník) | — |
| URL odkazu výzvy na akciu (CTA) | Povinné, Voliteľné alebo Zakázané (definuje maloobchodník) | Musí byť platná URL |
| Zarovnanie CTA | `left`, `center`, `right` (definované predajcom) | — |
## 6. Ponuka filtrov
Horizontálny navigačný panel s označenými položkami filtrov. Použite ho na umožnenie nakupujúcim filtrovať obsah na stránke (napríklad podľa kategórie alebo podkategórie).
### Položky
| Vlastnosť | Obmedzenia |
| ------------------------ | -------------------------------------------------------------------------------------- |
| Minimálny počet položiek | Definované predajcom (musíte pridať aspoň tyle) |
| Maximálny počet položiek | Definované predajcom (nemožno prekročiť tento počet) |
| Text označenia | Max. počet znakov: definuje maloobchodník |
| Hodnota filtra | Interná hodnota používaná logikou filtrovania. Max. počet znakov: definované predajcom |
### Zarovnanie
Definované predajcom. Možné hodnoty: `left`, `center`.
Položky filtra je možné preusporiadať. Označenie je to, čo vidí nakupujúci; hodnota je to, čo sa aplikuje ako filter. Nemusia to byť rovnaké reťazce.
## 7. Mriežka produktov
Vybraná mriežka produktov zvolených značkou, s voliteľnou hlavičkou sekcie, filtrovaním a CTA.
### Hlavička sekcie
| Pole | Povinné? | Obmedzenia |
| ------------ | ---------------------------------------------------------- | ---------- |
| Názov sekcie | Povinné, Voliteľné alebo Zakázané (definuje maloobchodník) | — |
| Popis sekcie | Povinné, Voliteľné alebo Zakázané (definuje maloobchodník) | — |
### Produkty
| Vlastnosť | Obmedzenia |
| ------------------------- | -------------------------------------------------- |
| Minimálny počet produktov | Definované predajcom |
| Maximálny počet produktov | Definované predajcom |
| Zdroj produktov | Vybrané pomocou výberu produktov z katalógu značky |
| Poradie zobrazenia | Presúvanie v rámci modulu |
### CTA karty produktu
Predajca rozhodne, či sa na každej karte produktu zobrazí tlačidlo CTA:
| Nastavenie | Správanie |
| ---------- | ----------------------------------------------------------------- |
| Zakázané | Žiadne tlačidlo CTA na kartách produktov |
| Povolene | Zobrazí sa tlačidlo CTA; predajca nastaví text označenia tlačidla |
{% hint style="info" %}
Ak je povolené, všetky karty produktov v mriežke zdieľajú rovnaké označenie CTA (nastavené predajcom, nie značkou).
{% endhint %}
### Filtrovanie
Predajca môže voliteľne povoliť filtrovanie na stránke pre mriežku produktov:
| Nastavenie | Popis |
| ------------------- | ------------------------------------------------------------------ |
| `enabled` | Nakupujúci môžu filtrovať mriežku produktov |
| `showActiveFilter` | Zvýrazní aktuálne aktívny filter |
| `showResultCount` | Zobrazuje, koľko výsledkov zodpovedá aktívnemu filtru |
| `emptyStateMessage` | Vlastná správa zobrazená, keď žiadne produkty nezodpovedajú filtru |
{% hint style="info" %}
Filtrovanie funguje v spojení s modulom Ponuka filtrov. Hodnoty filtra nastavené na produktoch sa musia zhodovať s hodnotami položiek filtra v Ponuke filtrov.
{% endhint %}
### CTA (v spodnej časti mriežky)
| Pole | Povinné? | Obmedzenia |
| ---------------------------------- | ---------------------------------------------------------- | ------------------- |
| Text tlačidla výzvy na akciu (CTA) | Povinné, Voliteľné alebo Zakázané (definuje maloobchodník) | — |
| URL odkazu výzvy na akciu (CTA) | Povinné, Voliteľné alebo Zakázané (definuje maloobchodník) | Musí byť platná URL |
| Zarovnanie CTA | `left`, `center`, `right` (definované predajcom) | — |
## Odkaz na obmedzenie
### `ContentLimit` — model obmedzenia textového poľa
| Hodnota | Význam |
| ----------------------- | --------------------------------------------------------------------- |
| `disabled` | Pole nie je v tejto šablóne k dispozícii |
| `allowed` + `maxChars` | Pole je voliteľné; ak je vyplnené, nemôže prekročiť `maxChars` znakov |
| `required` + `maxChars` | Pole musí byť vyplnené; nemôže prekročiť `maxChars` znakov |
### `ImageConstraints` — model obmedzení odosielania obrázka
| Vlastnosť | Popis |
| ----------------- | -------------------------------------------------------------------------------------------- |
| `altOptionality` | `required` or `allowed` |
| `minWidth` | Minimálna šírka obrázka v pixeloch (voliteľné) |
| `minHeight` | Minimálna výška obrázka v pixeloch (voliteľné) |
| `maxFileSizeMb` | Maximálna veľkosť súboru v megabajtoch (voliteľné) |
| `acceptedFormats` | Podmnožina `GIF`, `JPG`, `PNG`, `SVG` (voliteľné — ak nie je nastavené, akceptujú sa všetky) |
### `CtaConfig` — model obmedzení výzvy na akciu (call-to-action)
| Vlastnosť | Popis |
| ------------- | ----------------------------------- |
| `optionality` | `required` · `allowed` · `disabled` |
| `alignment` | `left` · `center` · `right` |
## Čo je definované predajcom vs. fixné
| Konfigurácia | Predajca nastavuje toto | Fixované platformou |
| ---------------------------------------------------- | :-------------------------------------: | :-------------------------------: |
| Či je možné modul preskočiť | ✅ | |
| Maximálne limity počtu znakov | ✅ | |
| Minimálne rozmery obrázka a maximálna veľkosť súboru | ✅ | |
| Ktoré formáty obrázkov sú akceptované | ✅ (podmnožina podporovaných platformou) | |
| Či je CTA povinné, voliteľné alebo zakázané | ✅ | |
| Či je k dispozícii prekrytie (Hero) | ✅ | |
| Ktoré možnosti zarovnania textu sú ponúkané | ✅ | |
| Možnosti pomeru stĺpcov (Split Layout) | ✅ | |
| Min/max počet obrázkov (Image Gallery) | ✅ | |
| Min/max počet produktov (Product Grid) | ✅ | |
| Dostupné typy modulov | | ✅ (7 typov, fixné) |
| Podporovaný typ média (Hero) | | ✅ (iba obrázok; video sa plánuje) |
| Typy odkazov pre obrázky | | ✅ (image · url · product) |
| Maximálna hĺbka vorenia pre Split Layout | | ✅ (hĺbka 2) |
| Povolene dcérske typy pre Split Layout | | ✅ (iba Image a Text) |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.citrusad.com/retail-media-interface/integration/sk/brand-pages/brand-page-retailer-integration-guide/module-capabilities.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.