Feltöltés és automatikus ellenőrzés

Hol töltöd fel a témacsomagot, ki teheti, mit ellenőriz a rendszer, milyen hibaüzenetek jöhetnek, és mi történik siker után (kiválasztás, kép, letöltés, törlés).

Frissítve: 2026. október 6.

A témát a bolt adminjában töltöd fel: Webáruház → Megjelenés, jobb oldalt a Saját témák kártya, Téma feltöltése gomb, .zip fájl. A rendszer a teljes csomagot ellenőrzi, és csak hibátlan csomagot ment – hibánál semmi nem íródik, a kártyán megjelenik „A téma nem tölthető fel, mert:” és a hibalista (fájlnévvel, ahol van, sorral).

Ki és mennyit

Mi	Szabály
Jogosultság	A bolt tulajdonosa, adminja vagy közreműködő (collaborator) szerepkörű tagja.
Gyakoriság	Boltonként és felhasználónként 20 feltöltés óránként; felette „Túl sok feltöltés” hiba.
Darabszám	Legfeljebb 10 saját téma boltonként; a 11. feltöltés előtt törölj egyet.
Fájl	Csak .zip, legfeljebb 20 MB.
Tárhely	A képek és betűk a bolt médiatárába kerülnek, és a bolt tárhelyét terhelik; törléskor felszabadulnak.

Mit ellenőriz a rendszer (ebben a sorrendben)

A zip
Valódi zip-e, mérete, a bejegyzések száma (legfeljebb 1500) és a kicsomagolt méret (legfeljebb 60 MB) – már kibontás közben, az útvonalakkal együtt (tiltott útvonal, túl mély könyvtár, tiltott karakter, ismeretlen könyvtár, nem engedett fájltípus). Ha itt hiba van, a többi ellenőrzés nem fut.
Kötelező fájlok
layout/theme.liquid, templates/index.json, product.json, collection.json, locales/hu.json, en.json, de.json, theme.json.
Bináris fájlok
Fájlonkénti méret (30 MB), a téma képe (2 MB), és hogy a fájl eleje egyezik-e a kiterjesztéssel (PNG, JPEG, GIF, WebP, WOFF2).
Forrásfájlok
Méret (512 KB, a CSS kivételével), érvényes JSON, a CSS tiltott konstrukciói, az SVG tiltott elemei.
Sablonok
Minden .liquid fájl szigorú elemzése ugyanazzal a motorral, ami a boltban fut: tiltott tag (include, layout, block), ismeretlen platform-hely, ismeretlen szűrő, szintaktikai hiba; a szekciók schema-leírójának JSON-ja.
Hivatkozások és kötelező helyek
Minden render által hivatkozott snippet létezik-e; a layoutban (és a header-/footer-group szekciókban) feltétel nélkül ott van-e a legal_links; a templates fájlokban a sections és order érvényes-e, létezik-e minden szekciótípus; a termékoldalon feltétel nélkül ott van-e a price, buy_form, safety_info.
Szótárak
A sablonokban t szűrővel használt minden kulcs megvan-e mindhárom nyelvben.
theme.json
A leíró minden mezője a szabályok szerint; a saját x- blokkok schema-leírója; sötét palettánál a color_scheme hely megléte; a logo_url fájlja benne van-e a csomagban. Végül: a sablonok, szótárak és stíluslapok együtt legfeljebb 8 MB.

Hibaüzenetek

A hibalista első 20 tétele jelenik meg. Jellemző üzenetek:

Üzenet	Mit jelent, mit tegyél
Csak .zip témacsomag tölthető fel. / A témacsomag legfeljebb 20 MB lehet.	A fájl nem zip, vagy túl nagy.
zip: a csomag legfeljebb 1500 fájlt tartalmazhat / a kicsomagolt téma legfeljebb 60 MB lehet	Vedd ki a felesleges fájlokat (pl. forrásképek, .git, node_modules).
<fájl>: ismeretlen könyvtár (engedett: layout, templates, …)	Csak az engedett könyvtárak lehetnek a csomagban; a gyökérben csak theme.json és screenshot.
<fájl>: ebben a könyvtárban nem engedett fájltípus: .js	JavaScript, .map, .scss stb. nem lehet a csomagban.
<fájl>: hiányzik	Kötelező fájl hiányzik.
<fájl>: a tartalom nem egyezik a kiterjesztéssel	Átnevezett vagy sérült kép/betű.
assets/theme.css: @import nem engedett / külső vagy tiltott url(): … / szkriptet futtató CSS-konstrukció	Lásd a CSS-szabályok cikket.
<fájl>: hibás JSON (…)	Érvénytelen JSON a templates, locales, config vagy theme.json fájlban.
<fájl>: the 'include' tag is not allowed / platform: unknown slot 'x' / undefined filter: x	Tiltott tag, ismeretlen platform-hely vagy szűrő a sablonban (a motor üzenete, a sor számával).
<fájl>: a hivatkozott snippet nem létezik: nev	Hiányzik a snippets/nev.liquid.
layout/theme.liquid: a kötelező platform-hely hiányzik vagy feltételhez kötött: legal_links	Tedd ki feltétel nélkül a layoutba (vagy a header-/footer-group egy szekciójába).
templates/product.json: a termékoldalon kötelező platform-hely hiányzik vagy feltételhez kötött: price	Ugyanez a price, buy_form, safety_info helyekre a termékoldal szekcióiban.
templates/x.json: sections és order kötelező / az order ismeretlen szekciót említ / nem létező szekciótípus	Javítsd a template JSON-t vagy hozd létre a sections/<type>.liquid fájlt.
locales/en.json: hiányzó fordítási kulcs: …	Vedd fel a kulcsot mindhárom szótárban.
theme.json id: … / name: … / version: x.y.z / tokens.primary: kötelező / palette.sale: #rrggbb	A leíró mezői; részletek a theme.json cikkben.
theme.json palette_dark: sötét palettához a fejlécben kell a {% platform 'color_scheme' %} hely	Tedd ki a color_scheme helyet valamelyik sablonban.
sections/x-sav.liquid schema: name (1–60 karakter) kötelező	A saját blokk schema-leírója hiányos.
A használatban lévő téma nem törölhető	Válts előbb másik témára a Téma kártyán, mentsd, aztán törölj.

Siker után

Kiválasztás
A téma megjelenik a Téma kártya galériájában a theme.json szerinti névvel és verzióval. Ott választod ki, nézed meg élő előnézetben (asztali és mobil nézet, kezdőlap, kategória, termék, keresés), és mented – ugyanúgy, mint a beépítetteket. A téma csak a feltöltő boltban választható.
Mintatermékek
Termék nélküli boltban a rendszer felajánlja a mintatermékeket (Kérsz mintatermékeket?), hogy legyen mit megnézni. Ha már van termék, mintatermék nem kerül be.
Kép
A téma sorában a galériakép cserélhető vagy törölhető (Kép feltöltése, Kép cseréje, Kép törlése; PNG, JPEG vagy WebP, legfeljebb 2 MB). Ez felülírja a csomagban érkezett screenshot fájlt.
Letöltés, törlés
Letöltés: ugyanaz a csomag (theme.json + sablonok + képek), újra feltölthető formában. Téma törlése: a használatban lévő (bármelyik kirakaton aktív) téma nem törölhető; törléskor a képek is törlődnek a médiatárból.