Az áruházban lehetőség van különböző funkciók használatára úgynevezett boxok formájában. Ezek a boxok alapértelmezetten megjelennek a boxokat összesítő/listázó részen illetve lehetőség van rá, hogy direkt módon kiemeld/beágyazd a kinézet egyéb pontjain. Így van lehetőség arra, hogy egy megkülönböztetett helyen jelenjen meg egy olyan tartalom, ami alapvetően a kinézetben máshol található. Így tudsz fejlécben elhelyezni kategóriamenüt főoldalon és ezzel egyidejűleg az aloldalakon ugyanezt elhelyezni pl. az oldalsávban.
A megvalósítás szintaktikája:
[[ box|name:[box_neve];[box_változó_neve]:[box_változó_értéke]; ]]
Automatikus boxgenerálás
Az áruházban lévő boxok tekintetében a kinézeteket boxos vagy nobox-os elnevezéssel lehet illetni, hogy alapértelmezetten van-e oldalsáv a kinézetben, amiben a boxok automatikusan generálva megjelennek vagy nincs ilyen sáv. Ahol van oldalsáv, ott külön mezők segítségével generáljuk a boxokat, így lehetőség van az admin felületen beállítani azok sorrendjét, illetve csak azok jelennek meg természetesen, amelyek be vannak kapcsolva vagy rendelkeznek tartalommal. A boxok sorrendjét a
Beállítások / Kinézet, Arculat / Box sorrend módosítás menüpont alatt van lehetőséged módosítani.
Az alábbi kódrészletben a boxok tömbjének a végigjárását indítja és zárja le a ciklus.
[[ box1_start ]]
.....
[[ box1_end ]]
Az alábbi mező a cikluson belül az adott box címét adja vissza.
[[ box1_title ]]
Az alábbi mező a cikluson belül az adott box tartalmát adja vissza.
[[ box1_content ]]
Fontos!
Ha a boxok automatikus generálásához használatos rész nem szerepel a sablonban, úgy a sorrendezéshez kapcsolódó beállítás nem elérhető!
Box kiemelések
A boxokat a saját egyedi nevükkel lehet kiemelni, amelyek a sablon elnevezésekből erednek.
Belépés/Profil box
[[ box|name:login; ]]
Chat box
[[ box|name:chat; ]]
Fizetési megoldások box
[[ box|name:checkout; ]]
Fórum box
[[ box|name:forum; ]]
Hírek box
[[ box|name:news; ]]
Hírlevél box
[[ box|name:newsletter; ]]
Jelszóemlékeztető box
[[ box|name:remind; ]]
Kategória box
[[ box|name:cat; ]]
Keresés box
[[ box|name:search; ]]
Kosár box
[[ box|name:cart; ]]
Látogató számláló box
[[ box|name:counter; ]]
Naptár box
[[ box|name:calendar; ]]
Nyelvváltó box
[[ box|name:lang; ]]
Összehasonlítás box
[[ box|name:compare; ]]
Partner box
[[ box|name:partner; ]]
Pénznemváltó box
[[ box|name:currency; ]]
Plusz adatok szűrés box
[[ box|name:product_data; ]]
Szavazás box
[[ box|name:vote; ]]
Szűrés box
[[ box|name:filter; ]]
Tanusítvány
[[ box|name:cert; ]]
Tartalmi elemek box
[[ box|name:page; ]]
Termékajánló box
[[ box|name:product_ref; ]]
Top termékek box
[[ box|name:product_top; ]]
Utoljára megtekintett termékek box
[[ box|name:product_last; ]]
Box változók
Megadhatók különböző box változók, amelyek befolyásolják a visszakapott értékeket. Ilyen módon lehet például feltételeket definiálni, amik az adott box layout-jában felhasználhatók különböző elágazásokra. Egy konkrét példát tekintve: tegyük fel, hogy szeretnél az áruházban két keresőt, layout szinten eltérő kinézettel. Ehhez a "disp" nevű box változót kell használni és bármilyen szöveges értéket adni neki.
Ezután a layout-ban használható az ehhez kapcsolódó feltétel, aminek az előtagját a megadott box változó értéke adja illetve az utána szereplő "_disp":
{% if [box_változó_értéke]_disp %}
.....
{% endif %}
Ezután ha két különböző módon szeretnéd a layout-ot felépíteni, akkor a boxhoz tartozó fájlban a leírt feltétellel elágaztathatsz és aszerint fog megjelenni a vásárlói felületen a box.
Összehasonlítás box változói
Be lehet kapcsolni a képkezelést, így a háttérben a termék képei is le lesznek kérve. Csak akkor érdemes bekapcsolni, ha a képeket felhasználod a kinézetben, bekapcsolni az "1" érték megadásával lehet.
[[ box|name:compare;img:1; ]]
A bekapcsolt képkezelés mellett meg lehet szabni, hogy a bekért kép maximum milyen széles legyen. Itt a mérethez egész számértéket kell megadni, ami pixelben értendő.
[[ box|name:compare;img_width:150; ]]
A bekapcsolt képkezelés mellett meg lehet szabni, hogy a bekért kép maximum milyen magas legyen. Itt a mérethez egész számértéket kell megadni, ami pixelben értendő.
[[ box|name:compare;img_height:150; ]]
Kosár box változói
A kosár boxban be lehet állítani, hogy milyen árformátumban jelenjenek meg az árak. A box változó megadása nélkül az egyéb árformátumot használja a rendszer. Ezt a
Beállítások / Pénznemek, Árkijelzés / Árformátum menüpont alatt tudja az
Egyéb árformátum mezőben módosítani. A megadható értékek a
gross (bruttó ár),
net (nettó ár) és a
cart, amelyet adminisztrációs felületen lehet módosítani a
Beállítások / Alapbeállítások menüpont alatt a
Működés lapfül
Kosár szekciójában lévő
A kosárban az összesítésnél melyik ár jelenjen meg beállítással.
[[ box|name:cart;price_format:cart; ]]
Be lehet kapcsolni a képkezelést, így a háttérben a termék képei is le lesznek kérve. Csak akkor érdemes bekapcsolni, ha a képeket felhasználod a kinézetben, bekapcsolni az "1" érték megadásával lehet.
[[ box|name:cart;img:1; ]]
A bekapcsolt képkezelés mellett meg lehet szabni, hogy a bekért kép maximum milyen széles legyen. Itt a mérethez egész számértéket kell megadni, ami pixelben értendő.
[[ box|name:cart;img_width:150; ]]
A bekapcsolt képkezelés mellett meg lehet szabni, hogy a bekért kép maximum milyen magas legyen. Itt a mérethez egész számértéket kell megadni, ami pixelben értendő.
[[ box|name:cart;img_height:150; ]]
Keresés box változói
A keresés box esetében lehetőség van megadni az azonosításhoz használatos utótagot (suffix), amely szükséges abban az esetben, ha több helyen szeretnél keresés boxot elhelyezni a sablonba. Ennek köszönhetően a két box elkülönülten tud működni.
[[ box|name:search;suffix:_desktop; ]]
Pénznemváltó box változói
A pénznem váltó box esetében lehetőség van megadni az azonosításhoz használatos utótagot (suffix), amely szükséges abban az esetben, ha több helyen szeretnél pénznem váltó boxot elhelyezni a sablonba. Ennek köszönhetően a két box elkülönülten tud működni.
[[ box|name:currency;suffix:_desktop; ]]
Termék ajánló boxok változói
Meg lehet szabni, hogy termékajánló box melyik lista oldali sablont használja. A megadott értéknek megfelelően az
box_product_list_[text].html fájlt használja sablonként, ahol az
[text] a
product_list_layout box változóban megadott érték.
[[ box|name:product_ref;product_list_layout:5; ]]
Kiemelés paraméter: artlist_layout:[int]
Kategória box változói
Meg lehet szabni, hogy sablont használjon a kategória menü generálásakor illetve a megadott sorszámú sablont használja alapértelmezetten.
[[ box|name:cat;layout:1; ]]
Meg lehet szabni, hogy az adott szinten a kategória menüben milyen sablont használjon. Ehhez a
layout_level[x]:[y] box változót lehet használni, ahol az
x értéke adja meg a struktúrában a szintet, az
y pedig az adott szinten használni kívánt sablon számát.
[[ box|name:cat;layout_level0:0; ]]
Meg lehet szabni, hogy a kategória menü sablonja cache-elve legyen e. A cache alapértelmezetten egy órán át nem évül el, kivéve ha a kategória rendszerben módosítasz valamit. Ha
0 értéket adsz meg, akkor ki lehet kapcsolni ezt a cache-t.
[[ box|name:cat;layout_cache:1; ]]
Meg lehet szabni, hogy a kategória menü kibontása cache-elve legyen e, így ne kérje le minden esetben a teljes kategória rendszert az oldalbetöltéskor. A cache alapértelmezetten egy órán át nem évül el, kivéve ha a kategória rendszerben módosítasz valamit.
0 érték megadásával ki lehet kapcsolni ezt a cache-t.
[[ box|name:cat;expand_cache:1; ]]
Ha nem csak egy, hanem több kategória menüre van szükségünk, akkor lehetőség van a kibontás cache-t név alapján szétbontani, így azok teljes mértékig szeparálhatóak. Az itt megadott érték csak szám és betű karaktereket tartalmazhat, illetve "_" karaktert a tagoláshoz!
[[ box|name:cat;expand_cache_name:desktop; ]]
Meg lehet szabni, hogy a kategória menü kibontását ne globálisan, hanem kategóriánként cache-elje. Ez azért fontos, mert ha különböző kategóriáknál eltérő módon kell kinéznie valamely tartalomnak a kategória menüben, akkor az első betöltésnél elmenti és a többi esetben is azt adja vissza. Ez tipikusan az aktív kategória megjelölésénél számít az újabb kinézetek esetében.
0 értékkel ki lehet kapcsolni ezt a cache-t.
[[ box|name:cat;expand_cache_per_cats:1; ]]
Meg lehet szabni, hogy a kategória menü mindig ajax-osan kinyíló legyen, azaz mindig csak egy szintet töltsön be, amit épp aktuálisan látni vagy kinyitni szeretnél.
[[ box|name:cat;ajax:1; ]]
Tartalmi elemek box változói
Meg lehet szabni, hogy melyik plusz menü tartalmát emeljük ki a boxban. Ehhez az adott plusz menü egyedi azonosítóját kell megadni.
[[ box|name:page;page:123456; ]]
Meg lehet szabni, hogy melyik sablont használja a tartalmi elem box. Ennek megfelelően a
content_page_[text].html fájlt használja sablonként, ahol a
[text] a
layout box változóban megadott érték.
[[ box|name:page;layout:blog; ]]
Meg lehet szabni, az adott oldal alapján kiemelt tartalmi elem box maximum hány darab tartalmi elemet adjon vissza.
[[ box|name:page;limit:4; ]]
Meg lehet szabni, az adott oldalon belül melyik tartalmi elemet adja vissza.
[[ box|name:page;filter_content_id:123456; ]]
Meg lehet szabni, az adott oldal alapján kiemelt tartalmi elem box milyen típusú tartalmi elemeket adjon vissza. Ilyen típusok a
normal,
blog,
form,
gallery és
product.
[[ box|name:page;filter_type:blog; ]]
