> 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/hu/brand-pages/brand-page-retailer-integration-guide/module-capabilities.md).
# Modulképességek
Ez a dokumentum bemutatja az összes elérhető modultípust, azok mezőit, korlátozásait és konfigurációs lehetőségeit. Használja a kiskereskedőknek szóló referenciaként arra vonatkozóan, hogy az egyes modulok mit támogatnak, és mit konfigurálhatnak a márkák a Brand Page tartalmának létrehozásakor.
***
## Modultípusok áttekintése
| Modul | Cél |
| ------------------ | -------------------------------------------------------------------------------------------- |
| Hero Banner | Teljes szélességű média címsorral, alcímmel és CTA-val |
| Kép | Egyetlen kép választható felirattal, alt szöveggel és hivatkozással |
| Szöveg | Címsor, szlogen, törzsszöveg vagy egyedi többfejléces szöveg |
| Osztott elrendezés | Kétoszlopos vagy egymásra helyezett elrendezés, amely Kép és/vagy Szöveg modulokat tartalmaz |
| Képgaléria | Képrács választható szekciócímmel, leírással és CTA-val |
| Szűrőmenü | Címkézett szűrőelemek navigációs sávja |
| Termékrács | Kurált termékrács választható szűréssel és CTA-val |
## Közös mezők (minden modul)
Minden modul megosztja a következő, rendszer által kezelt mezőket. A márkák ezeket nem állítják be közvetlenül.
| Mező | Leírás |
| --------------------------- | ---------------------------------------------------------------------------------- |
| `id` | Auto-generált egyedi azonosító |
| `brandPageModuleTemplateId` | Tartalmat társít a kiskereskedő modulsablonjához |
| `order` | Megjelenítési pozíció az oldalon (áthúzással kezelve) |
| `optionality` | Hogy az egész modul kötelező-e, vagy átugorható (kiskereskedő által meghatározott) |
## 1. Hero Banner
Egy teljes szélességű banner, amely egyesíti a háttérképet, a fedőréteget, a címsort és egy call-to-action-t. Jellemzően ez az első modul a Brand Page-en.
### Média
| Mező | Kötelező? | Korlátozások |
| ---------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Kép | Kötelező | Formátumok: `GIF`, `JPG`, `PNG`, `SVG` · Min. méretek: kiskereskedő által meghatározott · Max. fájlméret: kiskereskedő által meghatározott |
| Alt szöveg | Kötelező vagy Opcionális (kiskereskedő által meghatározott) | Leíró szöveg az akadálymentesítéshez |
{% hint style="info" %}
A videotámogatás tervezve van, de még nem érhető el. Jelenleg csak kép fogadható el.
{% endhint %}
### Fedőréteg
A kiskereskedő határozza meg, hogy elérhető-e fedőréteg ezen a modulon:
| Beállítás | Viselkedés |
| -------------------------- | ------------------------------------------------------------- |
| `disabled` | Nincs fedőréteg — a kép színréteg nélkül jelenik meg |
| `optional` (engedélyezett) | A márka választhatja a fedőréteg engedélyezését vagy tiltását |
| `required` | A fedőréteg mindig megjelenik; a márka nem tudja kikapcsolni |
Ha a fedőréteg engedélyezve van, a márka kiválasztja a háttérstílust. A kiskereskedő szabályozza, hogy mely stílusokat kínálja fel:
| Stílus | Leírás |
| ---------- | ------------------------------ |
| `gradient` | Fokozatos átmenet a képről |
| `solid` | Egyszínű blokk a szöveg mögött |
Mindkét lehetőség elérhetővé tehető egyidejűleg.
### Szöveges tartalom
| Mező | Kötelező? | Korlátozások |
| --------------------- | ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Címsor | Kötelező | Max. karakterszám: kiskereskedő által meghatározott |
| Alcím | Opcionális | Max. karakterszám: kiskereskedő által meghatározott |
| CTA gomb szövege | Kötelező, Opcionális vagy Letiltott (kiskereskedő által meghatározott) | Max. karakterszám: kiskereskedő által meghatározott |
| CTA hivatkozás URL-je | Kötelező, Opcionális vagy Letiltott (kiskereskedő által meghatározott) | Max. karakterszám: kiskereskedő által meghatározott · Érvényes URL-nek kell lennie |
{% hint style="info" %}
A CTA szöveg és a CTA hivatkozás együtt van konfigurálva. Ha a CTA le van tiltva, egyik mező sem jelenik meg. Nem lehet CTA hivatkozása CTA gomb nélkül, vagy fordítva.
{% endhint %}
### Szövegigazítás
A kiskereskedő határozza meg, hogy mely igazítási lehetőségek érhetők el. Lehetséges értékek: `left`, `center`, `right`. A márka a felkínált készletből választ.
## 2. Kép
Egyetlen kép tetszőleges képaláírással, alt szöveggel és hivatkozási céllal.
### Kép feltöltése
| Mező | Kötelező? | Korlátozások |
| ---------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Kép | Kötelező | Formátumok: `GIF`, `JPG`, `PNG`, `SVG` · Min. méretek: kiskereskedő által meghatározott · Max. fájlméret: kiskereskedő által meghatározott |
| Alt szöveg | Kötelező vagy Opcionális (kiskereskedő által meghatározott) | Leíró szöveg az akadálymentesítéshez |
### Képaláírás
| Mező | Kötelező? | Korlátozások |
| ---------- | ---------- | ----------------------------------------------------------- |
| Képaláírás | Opcionális | Max. karakter: kereskedő által meghatározott · Egyetlen sor |
{% hint style="info" %}
A képaláírás elérhetőségét a kereskedő határozza meg. Ha a kereskedő nem engedélyezte a képaláírásokat, a mező nem jelenik meg.
{% endhint %}
### Hivatkozás
Minden kép tetszőlegesen hivatkozhat egy célhelyre. A márka a három hivatkozástípus egyikét választja:
| Hivatkozás típusa | Leírás |
| ----------------- | --------------------------------------------------------------------------- |
| `image` | Nincs hivatkozás — a kép nem interaktív |
| `url` | Kiválasztáskor egy egyéni URL-re navigál |
| `product` | Egy adott termékadatlapra navigál (a termékválasztón keresztül kiválasztva) |
### További szövegsorok
Egyes Kép modulok támogatják a kép melletti további címkézett szövegsorokat (például a kép alatt vagy felett megjelenő címet vagy leírást). Az elérhetőséget, a címkéket, a betűméreteket, valamint azt, hogy az egyes sorok kötelezőek vagy választhatóak-e, mind a kereskedő határozza meg.
## 3. Szöveg
Egy rugalmas szöveges modul, amely támogatja az egysoros és többsoros változatokat.
### Változatok
A kereskedő határozza meg, hogy a modul melyik változatot használja:
| Változat | Leírás |
| ---------- | ---------------------------------------------------------------------------- |
| `headline` | Egyetlen kiemelt szövegsor — nagy, félkövér |
| `tagline` | Egyetlen kiegészítő sor — kisebb, mint a címsor |
| `body` | Egyetlen törzsszövegblokk — szövegterületként jelenik meg |
| `lines` | Több elnevezett szövegsor, mindegyik saját betűmérettel és választhatósággal |
### Mezők — egysoros változatok (`headline`, `tagline`, `body`)
| Mező | Kötelező? | Korlátozások |
| ------ | --------- | ------------------------------------------------------------------------- |
| Szöveg | Kötelező | Max. karakter: kereskedő által meghatározott (a teljes mezőre vonatkozik) |
### Mezők — többsoros változat (`lines`)
Minden sort függetlenül határoz meg a kereskedő:
| Mező | Kötelező? | Korlátozások |
| ----------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| Sor szövege | Kötelező vagy Választható (soronként, a kereskedő által meghatározva) | Max. karakter: kereskedő által meghatározott (soronként vonatkozik) |
| Sor URL-je | Opcionális | Csak azokon a sorokon érhető el, ahol a(z) `isHyperlink` engedélyezve van |
### CTA
| Mező | Kötelező? | Korlátozások |
| --------------------- | ---------------------------------------------------------------------- | ---------------------------- |
| CTA gomb szövege | Kötelező, Opcionális vagy Letiltott (kiskereskedő által meghatározott) | — |
| CTA hivatkozás URL-je | Kötelező, Opcionális vagy Letiltott (kiskereskedő által meghatározott) | Érvényes URL-nek kell lennie |
{% hint style="info" %}
A CTA választhatósága a szövegre és az URL-re együtt vonatkozik. Ha le van tiltva, egyik mező sem jelenik meg.
{% endhint %}
### Igazítás
Kereskedő által meghatározott. Lehetséges értékek: `left`, `center`, `right`. A modulban lévő összes szövegre vonatkozik.
### Maximális szélesség
A kereskedő beállít egy `maxWidth` korlátozást, amely korlátozza, hogy milyen széles képernyőn jelenhet meg a szövegblokk (például, `600px` or `80%`). Ez megjelenítési korlátozás, nem tartalomkorlátozás.
## 4. Osztott elrendezés
Egy elrendezési tároló, amely két vagy több, oszlopokba vagy sorokba rendezett gyermekmodult tartalmaz. A gyermekek **Kép** és/vagy **Szöveg** modulok. A beágyazás legfeljebb 2-es mélységig támogatott, de a gyökérszinten nem ágyazhat be Osztott elrendezéseket.
### Elrendezési lehetőségek
| Elrendezés | Opciók |
| ---------- | --------------------------------------------------------------------------------------------------------- |
| `columns` | Egymás mellett. Arány: `50:50`, `33:67`, or `67:33` (kereskedő által meghatározott, hogy melyek kínáltak) |
| `rows` | Függőlegesen egymásra rakva |
### Térköz
A gyermekek közötti rés a kereskedő által meghatározott, a kereskedő stílusútmutatójának térközskálájából vett érték.
### Gyermekek
| Tulajdonság | Érték |
| ---------------------------- | ------------------------------------------------------------------------------------------------- |
| Engedélyezett gyermektípusok | `Image`, `Text` |
| Gyermekek száma | Kereskedő által meghatározott (`numChildren`) |
| Beágyazás | Egy gyermek Osztott elrendezés maga is tartalmazhat `Image` és `Text` modulokat (max. mélység: 2) |
{% hint style="info" %}
Fontos
Nem helyezhet el Hero Bannert, Képgalériát, Szűrőmenüt vagy Termékhálót egy Osztott elrendezésen belül.
{% endhint %}
## 5. Képgaléria
Képek hálója tetszőleges szakaszfejléccel, leírással és egy alsó CTA-val.
### Szakaszfejléc
| Mező | Kötelező? | Korlátozások |
| --------------- | ---------------------------------------------------------------------- | ------------ |
| Szakasz címe | Kötelező, Opcionális vagy Letiltott (kiskereskedő által meghatározott) | — |
| Szakasz leírása | Kötelező, Opcionális vagy Letiltott (kiskereskedő által meghatározott) | — |
### Galéria elrendezése
Kereskedő által meghatározott töréspontonként:
| Tulajdonság | Leírás |
| ----------- | --------------------------------------------------------------------------------------------- |
| Oszlopok | Oszlopok száma mobilon, tableten és asztali számítógépen (a kiskereskedő által meghatározott) |
| Képmagasság | Képpont- vagy százalékos magasság törésppontonként (a kiskereskedő által meghatározott) |
| Térköz | Képek közötti távolság (a kiskereskedő stílusútmutatója alapján) |
### Képek
| Tulajdonság | Korlátozások |
| -------------------- | ----------------------------------------------------------------------- |
| Minimális képszám | A kiskereskedő által meghatározott (legalább ennyit hozzá kell adni) |
| Maximális képszám | A kiskereskedő által meghatározott (nem haladhatja meg ezt a számot) |
| Formátumok | `GIF`, `JPG`, `PNG`, `SVG` |
| Min. méretek | A kiskereskedő által meghatározott |
| Max. fájlméret | A kiskereskedő által meghatározott |
| Alt szöveg | Kötelező vagy Opcionális képenként (a kiskereskedő által meghatározott) |
| Képaláírás képenként | Opcionális, max. karakterszám: a kiskereskedő által meghatározott |
| Hivatkozás képenként | `image` (nincs) · `url` · `product` — ugyanaz, mint a Kép modul |
### További szövegsorok képenként
Ugyanaz, mint a Kép modul — a kiskereskedő által meghatározott címkék, betűméretek és opcionálisság soronként.
### CTA (a galéria alján)
| Mező | Kötelező? | Korlátozások |
| --------------------- | ---------------------------------------------------------------------- | ---------------------------- |
| CTA gomb szövege | Kötelező, Opcionális vagy Letiltott (kiskereskedő által meghatározott) | — |
| CTA hivatkozás URL-je | Kötelező, Opcionális vagy Letiltott (kiskereskedő által meghatározott) | Érvényes URL-nek kell lennie |
| CTA igazítása | `left`, `center`, `right` (a kiskereskedő által meghatározott) | — |
## 6. Szűrőmenü
Címkézett szűrőelemek vízszintes navigációs sávja. Használja arra, hogy a vásárlók szűrhessék az oldalon található tartalmat (például kategória vagy alkategória szerint).
### Elemek
| Tulajdonság | Korlátozások |
| ------------------ | -------------------------------------------------------------------------------------------------- |
| Minimális elemszám | A kiskereskedő által meghatározott (legalább ennyit hozzá kell adni) |
| Maximális elemszám | A kiskereskedő által meghatározott (nem haladhatja meg ezt a számot) |
| Címke szövege | Max. karakterszám: kiskereskedő által meghatározott |
| Szűrőérték | A szűrési logika által használt belső érték. Max. karakterszám: a kiskereskedő által meghatározott |
### Igazítás
Kereskedő által meghatározott. Lehetséges értékek: `left`, `center`.
A szűrőelemek sorrendje átrendezhető. A címke az, amit a vásárló lát; az érték az, ami szűrőként alkalmazásra kerül. Nem kell ugyanannak a karakterláncnak lenniük.
## 7. Termékrács
A márka által kiválasztott termékek válogatott rácsa, tetszőleges szakaszfejléccel, szűréssel és CTA-val.
### Szakaszfejléc
| Mező | Kötelező? | Korlátozások |
| --------------- | ---------------------------------------------------------------------- | ------------ |
| Szakasz címe | Kötelező, Opcionális vagy Letiltott (kiskereskedő által meghatározott) | — |
| Szakasz leírása | Kötelező, Opcionális vagy Letiltott (kiskereskedő által meghatározott) | — |
### Termékek
| Tulajdonság | Korlátozások |
| --------------------- | ----------------------------------------------------- |
| Minimális termékszám | A kiskereskedő által meghatározott |
| Maximális termékszám | A kiskereskedő által meghatározott |
| Termékforrás | A márka katalógusából a termékválasztóval kiválasztva |
| Megjelenítési sorrend | Fogd és vidd a modulon belül |
### Termékkártya CTA
A kiskereskedő dönt arról, hogy megjelenjen-e CTA gomb az egyes termékkártyákon:
| Beállítás | Viselkedés |
| ------------ | ------------------------------------------------------------------------ |
| Letiltva | Nincs CTA gomb a termékkártyákon |
| Engedélyezve | Egy CTA gomb jelenik meg; a kiskereskedő állítja be a gomb címkeszövegét |
{% hint style="info" %}
Ha engedélyezve van, a rácsban lévő összes termékkártya ugyanazon a CTA címkén osztozik (amelyet a kiskereskedő állít be, nem a márka).
{% endhint %}
### Szűrés
A kiskereskedő tetszés szerint engedélyezheti az oldalon belüli szűrést a Termékrácshoz:
| Beállítás | Leírás |
| ------------------- | ---------------------------------------------------------------------- |
| `enabled` | A vásárlók szűhetik a termékrácsot |
| `showActiveFilter` | Kiemeli a jelenleg aktív szűrőt |
| `showResultCount` | Megjeleníti, hány találat felel meg az aktív szűrőnek |
| `emptyStateMessage` | Egyéni üzenet jelenik meg, ha egyetlen termék sem felel meg a szűrőnek |
{% hint style="info" %}
A szűrés a Szűrőmenü modullal együttműködve működik. A termékeken beállított szűrőértékeknek meg kell egyezniük a Szűrőmenüben található szűrőelem-értékekkel.
{% endhint %}
### CTA (a rács alján)
| Mező | Kötelező? | Korlátozások |
| --------------------- | ---------------------------------------------------------------------- | ---------------------------- |
| CTA gomb szövege | Kötelező, Opcionális vagy Letiltott (kiskereskedő által meghatározott) | — |
| CTA hivatkozás URL-je | Kötelező, Opcionális vagy Letiltott (kiskereskedő által meghatározott) | Érvényes URL-nek kell lennie |
| CTA igazítása | `left`, `center`, `right` (a kiskereskedő által meghatározott) | — |
## Korlátozás hivatkozása
### `ContentLimit` — szövegmező korlátozási modellje
| Érték | Jelentés |
| ----------------------- | --------------------------------------------------------------------------------- |
| `disabled` | A mező nem érhető el ebben a sablonban |
| `allowed` + `maxChars` | A mező opcionális; ha ki van töltve, nem haladhatja meg a(z) `maxChars` karaktert |
| `required` + `maxChars` | A mezőt ki kell tölteni; nem haladhatja meg a(z) `maxChars` karaktert |
### `ImageConstraints` — képfeltöltési korlátozási modell
| Tulajdonság | Leírás |
| ----------------- | ------------------------------------------------------------------------------------------------------ |
| `altOptionality` | `required` or `allowed` |
| `minWidth` | Kép minimális szélessége képpontban (oszlopban) (otpcionális) |
| `minHeight` | Kép minimális magassága képpontban (sorban) (otpcionális) |
| `maxFileSizeMb` | Maximális fájlméret megabájtban (otpcionális) |
| `acceptedFormats` | Részhalmaza ennek: `GIF`, `JPG`, `PNG`, `SVG` (otpcionális — ha nincs beállítva, mindegyik elfogadott) |
### `CtaConfig` — call-to-action korlátozási modell
| Tulajdonság | Leírás |
| ------------- | ----------------------------------- |
| `optionality` | `required` · `allowed` · `disabled` |
| `alignment` | `left` · `center` · `right` |
## Kereskedő által meghatározott vs. rögzített
| Konfiguráció | A kereskedő állítja be | A platform által rögzítve |
| ----------------------------------------------- | :-------------------------------------------: | :--------------------------: |
| Egy modul átugorható-e | ✅ | |
| Maximális karakterszám-korlátok | ✅ | |
| Kép minimális dimenziói és maximális fájlmérete | ✅ | |
| Mely képformátumok elfogadottak | ✅ (a platform által támogatottak részhalmaza) | |
| A CTA kötelező, opcionális vagy letiltott-e | ✅ | |
| Elérhető-e az overlay (Hero) | ✅ | |
| Mely szövegigazítási opciók biztosítottak | ✅ | |
| Oszloparány-opciók (Split Layout) | ✅ | |
| Min./max. képszám (Image Gallery) | ✅ | |
| Min./max. termékszám (Product Grid) | ✅ | |
| Elérhető modultípusok | | ✅ (7 típus, rögzített) |
| Támogatott médiatípus (Hero) | | ✅ (csak kép; videó tervezve) |
| Hivatkozástípusok képekhez | | ✅ (image · url · product) |
| Split Layout maximális beágyazási mélysége | | ✅ (2-es mélység) |
| Split Layout engedélyezett gyermektípusai | | ✅ (csak Image és 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/hu/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.