A témacsomag felépítése
Kiinduló csomag letöltése, a .zip könyvtárai és fájltípusai, kötelező fájlok, méret- és darabszám-korlátok – ahogy a feltöltés ellenőrzi.
Frissítve: 2026. október 6.
A téma egy .zip csomag: Liquid-sablonok, JSON-leírók, egy stíluslap, képek, betűk és három nyelvi szótár. A szerkezet szabad, de a könyvtárnevek, a fájltípusok és néhány kötelező fájl rögzített – a feltöltés ezeket ellenőrzi, és fájlnévvel jelzi, ha valami nem stimmel.
Kiinduló csomag letöltése
Bármelyik boltod (a fejlesztői környezet is) adminjában: Webáruház → Megjelenés, jobb oldalt a Saját témák kártya. Innen letölthető az Üres alap (csak a kötelező elemek: fejléc menüvel, kosárral és fiókkal; kezdőlap, kategória-, kereső- és termékoldal; lábléc a jogi sávval; egy rövid CSS) vagy bármelyik beépített, sablonnyelvű téma csomagja. Ügyfélre szabott (egyedi) témák nem tölthetők le kiinduló csomagként.
A letöltött csomagot kicsomagolod, átírod, újra becsomagolod, és saját témaként töltöd fel. A saját, már feltöltött témád is letölthető a Letöltés gombbal – ugyanabban a formában, újra feltölthetően.
Könyvtárak és fájltípusok
A zip gyökerében lehet közvetlenül a téma, vagy egyetlen alkönyvtárban (a csomagoló programok így szoktak dolgozni) – mindkettő jó. Csak a lenti könyvtárak engedettek, bennük csak a felsorolt kiterjesztések; a gyökérben ezen felül a theme.json és a téma képe (screenshot.jpg, .png vagy .webp) lehet.
| Könyvtár | Engedett fájltípus | Mire való |
|---|---|---|
| layout/ | .liquid | Az oldalkeret: layout/theme.liquid (kötelező) |
| templates/ | .json | Oldalsablonok: melyik szekciók, milyen sorrendben |
| sections/ | .liquid, .json | Szekciók (a fájl végén schema-leíró); header-group.json, footer-group.json |
| snippets/ | .liquid | Újrahasznosítható részletek a render taghez; a termékkártya: snippets/card.liquid |
| blocks/ | .liquid | Blokk-sablonok |
| config/ | .json | Beállítás-leírók |
| locales/ | .json | Szótárak: hu.json, en.json, de.json (mind a három kötelező) |
| assets/ | .css, .png, .jpg, .jpeg, .webp, .gif, .svg, .woff2 | A stíluslap (assets/theme.css), képek, betűk. JavaScript nincs. |
| preview/ | .png, .jpg, .jpeg, .webp | Előnézeti képek |
Fájl- és könyvtárnév: betű, szám, pont, kötőjel, aláhúzás (legfeljebb 81 karakter). Legfeljebb 4 könyvtárszint. Visszaper, abszolút út és „..” tiltott. Ismeretlen könyvtár, vagy a könyvtárban nem engedett kiterjesztés → hiba a fájl nevével.
Kötelező fájlok
| Fájl | Miért kötelező |
|---|---|
| layout/theme.liquid | Az oldalkeret minden oldal körül; benne a content_for_layout tag és feltétel nélkül a legal_links platform-hely. |
| templates/index.json | Kezdőlap. |
| templates/product.json | Termékoldal; a benne lévő szekciókban feltétel nélkül kell a price, a buy_form és a safety_info platform-hely. |
| templates/collection.json | Kategóriaoldal. |
| locales/hu.json, en.json, de.json | A téma feliratai; minden t-szűrővel használt kulcsnak mindhárom szótárban szerepelnie kell. |
| theme.json | A téma leírója (név, verzió, tokenek, paletta, beállítások, kezdőlap-blokkok). |
Korlátok
| Mi | Korlát |
|---|---|
| A feltöltött .zip | legfeljebb 20 MB |
| Fájlok száma a csomagban | legfeljebb 1500 |
| Kicsomagolt méret | legfeljebb 60 MB |
| Egy fájl | legfeljebb 30 MB |
| Egy forrásfájl (liquid, json, svg) | legfeljebb 512 KB (a CSS-re nem vonatkozik) |
| Sablonok, szótárak és stíluslapok együtt | legfeljebb 8 MB |
| A téma képe (screenshot) | legfeljebb 2 MB |
| Saját témák boltonként | legfeljebb 10 |
A képek és betűk tartalmát a rendszer a fájl eleje (magic bytes) alapján is ellenőrzi: egy .png kiterjesztésű fájl, ami nem PNG, hibát ad („a tartalom nem egyezik a kiterjesztéssel”). A JSON-fájlok elején egy blokk-komment még megengedett, utána érvényes JSON kell.
A téma képe
A csomag gyökerében lévő screenshot.jpg (.png, .webp) a téma képe az admin témagalériájában: 16:10 arány, pl. 1600×1000, legfeljebb 2 MB. Feltöltés után az adminban külön is cserélhető vagy törölhető (PNG, JPEG, WebP).