Platform-helyek: a bolt elemei a témában
A {% platform %} tag: melyik helyre mit ad a platform (menü, kereső, kosár, ár, vásárlási űrlap, galéria, jogi sáv), milyen kulcsokkal hangolható, és melyik kötelező.
Frissítve: 2026. október 6.
A téma HTML-t ad, de a bolt működő elemeit – menü, kereső, kosár, ár, kosárba gomb, galéria, jogi sáv – a platform saját komponensei adják. A téma ezeket platform-helyekkel teszi ki:
{% platform 'nev', kulcs: ertek %}
A kulcsok a megjelenést hangolják (osztálynév, darabszám, elrendezés), a tartalmat nem. Ismeretlen hely-név már a feltöltésnél hiba. A hely a kimenetben egy helyőrző elem, amit a bolt a saját komponensére cserél – a komponens HTML-jét a téma nem írhatja át, de CSS-sel formázhatja.
Fejléc és navigáció
| Hely | Kulcsok | Mit ad |
|---|---|---|
| nav | categories (0–30), jump_types | A bolt főmenüje (almenükkel). categories: ennyi főkategória a menü végén; jump_types: vesszővel elválasztott blokktípusok, amelyek kezdőlapi címére ugró link kerül a menübe. |
| search_box | id, class | Keresőmező. |
| cart_link | class, show_total | Kosár-link darabszámmal; show_total: false elrejti az összeget. |
| wishlist_link, account_link | class | Kedvencek, fiók. |
| mobile_menu | class, nav_class, label, categories, links, all_label, wishlist_label, account_label, jump_types, search_class, search_id, search_outside | Telefonos menüpanel. links: true → „Összes termék”, „Kedvenceim”, „Fiókom” alapfeliratokkal; a …_label kulcsokkal saját felirat. search_class megadásával kereső is kerül a panelbe (search_outside: true → a nav elem elé). |
| drawer_menu | label, close_label, nav_label, nav_class, search_id, search_class, categories, links, …_label | Oldalról nyíló menüpanel keresővel. |
| dept_menu | label, nav_label, all_label | Osztály-/kategóriamenü a főkategóriákból. |
| color_scheme | class | Világos/sötét kapcsoló; csak akkor jelenik meg, ha a kereskedő „a látogató kapcsolhatja” színmódot választott. Sötét palettás témában kötelező kitenni. |
| marquee | text, play_label, pause_label | Futó szöveges sáv megállító gombbal (üres text esetén nem jelenik meg). |
| icon | name, class | A platform ikonkészletének egy ikonja. |
Lábléc és jogi elemek
| Hely | Kulcsok | Mit ad |
|---|---|---|
| legal_links | – | **Kötelező a layoutban, feltétel nélkül.** A jogi sáv: jogi hivatkozások, süti-beállítás gomb, szavatossági értesítés (ha a bolt bekapcsolta és nincs külön warranty_notice), fizetési logók, ©. Ha a footer_columns is ki van téve, a sáv nem ismétli a linkeket. |
| footer_columns | – | Lábléc-oszlopok a kereskedő beállításai szerint (bennük a kötelező jogi oszlop). |
| social_links | – | Közösségi linkek, ha a kereskedő megadta. |
| payment_logos | – | Ma nem ad kimenetet: a fizetési logók a jogi sávban (legal_links) jelennek meg. Kitehető, de üres marad. |
| cookie_settings | – | Süti-beállítás gomb külön elhelyezéshez. |
| warranty_notice | – | Szavatossági (jótállási) értesítés külön elhelyezéshez, ha a bolt kéri; ilyenkor a legal_links nem ismétli. |
Listaoldalak
| Hely | Kulcsok | Mit ad |
|---|---|---|
| breadcrumbs | – | Morzsamenü (kategória- és termékoldalon, keresésnél). |
| listing_controls | price, id | Rendezés és szűrők (tulajdonság, ár, készlet); price: false elrejti az árszűrőt. Csak listaoldalon ad kimenetet. |
| pager | – | Lapozás („Továbbiak betöltése”). Csak listaoldalon. |
| home_sections | offset, limit | A kereskedő kezdőlap-blokkjai (a téma snippets/card.liquid kártyájával); offset/limit: a lista egy szelete, ha a téma több helyre osztja. |
Termék
A product kulcs értéke mindig a termék azonosítója: product.id, vagy ciklusban a ciklusváltozó id-ja (p.id). Csak az adott sablonban elérhető termék (product, related, listing.products, section.products) adható át.
| Hely | Kulcsok | Mit ad |
|---|---|---|
| price | product | **Kötelező a termékoldalon.** Az ár, akciónál az Omnibus-szabály szerinti korábbi legalacsonyabb árral. |
| buy_form | product, look, id, form_id, sticky | **Kötelező a termékoldalon.** Változatválasztó, mennyiség, kosárba. look: pills (alap) vagy list; sticky: false kikapcsolja a ragadó viselkedést. |
| safety_info | – | **Kötelező a termékoldalon.** A termékbiztonsági (GPSR) adatok blokkja. |
| card_buy | product, class | Kártyán „Kosárba” vagy „Változatok” gomb. |
| product_image | product, class, alt, index | Termékkép lusta betöltéssel; index: hányadik kép (0 az első). |
| gallery | product, class, layout | Galéria: telefonon húzással lapozható, asztalin bélyegképes (thumbs) vagy egymás alatti (stack), kattintásra nagyítás. |
| rating | product, class | Értékelés-összesítő a kártyán (ha a bolt használja az értékeléseket). |
| wishlist_button | product, class | Kedvencekhez adás. |
| garan_badge | product | GARAN címke, ha a termékhez tartozik. |
| buy_bar | product, label | Mobilon végig látható vásárlási sáv: ár és ugrás a vásárlási űrlaphoz; termék nélkül a kiemelt termékkel. |
| video | src, poster, class | Videó-elem a platform lejátszójával (src: a videó címe, poster: előnézeti kép). |
Példa termékoldali szekció (az Üres alapból):
<h1>{{ product.title }}</h1>
<p class="s-product__price">{% platform 'price', product: product.id %}</p>
{% platform 'buy_form', product: product.id %}
{% platform 'safety_info' %}
{% for para in product.description_paragraphs %}<p>{{ para }}</p>{% endfor %}