FELHASZNÁLÓI SEGÍTSÉG (HOGYAN...?)
A Vásártér találati listájának felépítése, megjelenitési definíciói
A Vásártér találati listája használható az esetleges szűkítések alapján lekért termék információk, és az egyes termékek kosárba helyezésének elő- és elkészítésre. A találati lista beállításaihoz a következő alapelvekre kell figyelni:
Behelyettesítési területek
A Vásártér lista alapelve az, hogy a beállítások egyszerre a találati listában megjelenő egy találatra vonatkoznak. Tehát minden beállítás ismétlődni fog minden talált termék esetén, csak az adatok különböznek majd. A továbbiakban mindig egy megjelenített adatcsoporton belülre vonatkozó szerkesztést végzünk.
Elsőként ún. Behelyettesítési területeket kell létrehoznunk. Ezek azonositónevek, amelyeket szabadon helyezhetünk el a HTML-kódban maszk formában, pl.:
<table>
<tr><td>**BEMUTATO_TERULET**</td></tr>
</table>
Az azonosítónevek " (idéző) és ' (aposztróf) jelet nem tartalmazhatnak. A rendszer kis és nagybetűk között nem tesz különbséget. Az azonosítónevek elé és mögé maszkként történő használathoz ** (két darab csillag) jelet helyezünk közvetlenül, szóköz nélkül. (Tehát a bemutato_terulet azonosítónév maszkként **BEMUTATO_TERULET** lesz.)
A Vásártér találati listájának beállításait a cfg/variables_aru.php állományban végezhetjük el, az érintett területet
###########################################################
# VASARTER LISTA BEALLITASOK
###########################################################
megjegyzés vezeti be, és
###########################################################
# VASARTER LISTA BEALLITASOK VEGE
###########################################################
megjegyzés jelzi a végét.
A Behelyettesítési területek azonosítóneveit be kell tehát állítani a cfg/variables_aru.php megfelelő részében is, erre a $VASARTER["mezo"] tömb szolgál:
##########################################################
# Vasarter behelyettesitesi teruletek
# A HTML kodban a mezo maszk kerul behelyettesitesre
# pl **LEIRAS**. **NETTOAR**, **BRUTTOAR**
$VASARTER["mezo"] = array(
'0' => 'bemutato_terulet'
);
Az azonosítónevek bejegyzésének módja az, hogy adunk egy indexet minden azonosítónak (esetünkben 0-t), majd értékként megadjuk az azonosítónevet. Az indexek sorszámként növekednek, minél több Behelyettesítési területet használunk, annál magasabb indexek következnek, pl.:
##########################################################
# Vasarter behelyettesitesi teruletek
# A HTML kodban a mezo maszk kerul behelyettesitesre
# pl **LEIRAS**. **NETTOAR**, **BRUTTOAR**
$VASARTER["mezo"] = array(
'0' => 'elso_azonosito',
'1' => 'masodik_azonosito',
'2' => 'harmadik_azonosito',
'3' => 'negyedik_azonosito'
);
Az indexet célszerű nullától kezdve, egyesével növelni. Az indexek szerepe a defíniciók létrehozásakor jelenik majd meg, az egyes Behelyettesítési területekre a cfg/variables_aru.php szerkesztése során az indexek segítségével fogunk hivatkozni.
Megjelenitési (mező) definíciók
A létrehozott és beállított Behelyettesítési terület(ek)en megjelenítendő információkat a megjelenítési mező definíciókkal szabályozhatjuk. A definíciókat a $VASARTER["def"] tömb tárolja. A tömbön belül minden létrehozott Behelyettesítési terület indexének megfelelő indexű tömb jön létre, pl. az 1. Behelyettesítési terület indexéhez kapcsolódó tömböt így hozhatjuk létre:
##########################################################
# Az 1. VASARTER mezo definicioi
$mezolepteto = 0;
$mezo = $VASARTER["mezo"][$mezolepteto];
$VASARTER["def"][$mezo] = array();
A következőket pedig:
$mezolepteto++;
$mezo = $VASARTER["mezo"][$mezolepteto];
$VASARTER["def"][$mezo] = array();
A továbbiak során mindig az adott mezőn belüli bejegyzéseket fogjuk definiálni, tehát a mindenkori $VASARTER["def"][$mezo] elemen (és egyben asszociatív tömbön) belül fogunk dolgozni.
A mezöket bejegyzések alkotják. A megjelenítés során ezeket a bejegyzéseket tölti fel adattal és írja ki a böngésző felé a program. A bejegyzések feldolgozása sorrendben (sorszám szerint történik), a megjelenítés tehát erre támaszkodik, az egyes bejegyzések helyzete a weboldalon ettől a sorrendtől függ. Ugyanakkor az elhelyezkedést a használt STYLESHEET ("css") segítségével a sorrendtől függetlenül is befolyásolhatjuk.
A bejegyzések tehát sorszámokat kapnak. A sorszámozást célszerű 0-val kezdeni, és egyesével nővelni. Az első bejegyzés sorszámát így állíthatjuk be:
$bejegyzes = 0;
Ezután következhet az adott bejegyzés részletes definiálása. Ezután adhatunk meg újabb bejegyzéseket:
$bejegyzes++;
Minden bejegyzés sorszám növelést az adott bejegyzés részletes definiálása követ. A továbbiakban a mindenkori $VASARTER["def"][$mezo][$bejegyzes] elemen (és egyben asszociatív tömbön) belül fogunk dolgozni.
Az adott elem definiálásakor elsőként létrejön a hozzátartozó tömb:
$VASARTER["def"][$mezo][$bejegyzes] = array();
Ezt követően adjuk meg a bejegyzés paramétereit. Elsőként azt, hogy a találati listában szereplő adat forrása mi lesz:
$VASARTER["def"][$mezo][$bejegyzes]["forras"] = 'aru';
Négyféle forrást jelölhetünk meg: aru, aruinfo, aruinfotipus, kep.
A forrás aru, ha célunk például az áru nevének, vagy más, alapvető adatának megjelenítése. Itt a tároló SQL-mező nevét kell ismernünk (pl.: title).
A forrás aruinfo, ha az áru egy konkrét tulajdonságát akarjuk megjeleníteni, mégpedig olyat, amelynek az elnevezését ismerjük (pl.: Bruttó ár).
A forrás aruinfotipus, ha az áru egy tulajdonságtípusát akarjuk kiíratni, ennek az elnevezését nem ismerjük, vagy egyes termékeknél más és más néven tároljuk az ehhez tartozó értékeket, ugyanakkor a tulajdonságtípusát ismerjük (pl.: 1).
A forrás kep, ha az áruhoz tartozó képet akarunk a bejegyzésben megjeleníteni.
Példák a lehetséges forrástípusokra (egy bejegyzésen belül egyszerre csak egy forrás adható meg):
$VASARTER["def"][$mezo][$bejegyzes]["forras"] = 'aru';
$VASARTER["def"][$mezo][$bejegyzes]["forras"] = 'aruinfo';
$VASARTER["def"][$mezo][$bejegyzes]["forras"] = 'aruinfotipus';
$VASARTER["def"][$mezo][$bejegyzes]["forras"] = 'kep';
A következő lépés, hogy a kiválasztott forrásból milyen értékhez kapcsolható adatot használjon a program a bejegyzés megjelenítése során:
$VASARTER["def"][$mezo][$bejegyzes]["ertek"] = 'title';
A különböző forrástípusok esetén a szóbajövő értékek eltérőek lehetnek.
Ha a forrás aru, akkor a következő értékeket használhatjuk:
id - a termék azonosítókódja az SQL-táblában
arugroupid - a termékcsoport azonosítókódja az SQL-táblában
title - a termék neve
afakor - a termék adóköre (amennyiben használt)
keszletdarab - a termékből raktáron lévő mennyisége száma (amennyiben használt)
Például:
$VASARTER["def"][$mezo][$bejegyzes]["forras"] = 'aru';
$VASARTER["def"][$mezo][$bejegyzes]["ertek"] = 'title';
Ha a forrás aruinfo, akkor az érték az áru valamelyik tulajdonságának elnevezése. Az itt használható értékek attól függnek, hogy az Adminisztrációs felületen az adott termékcsoporthoz milyen tulajdonságokat milyen néven hoztunk létre. Ebből következően előredefiniált értékek nincsenek. Ha például egy terméknek létezik Bruttó ár, Magasság, Garancia tulajdonsága, akkor ezek valamelyikét adhatjuk meg értéknek aruinfo forrás esetén.
Például:
$VASARTER["def"][$mezo][$bejegyzes]["forras"] = 'aruinfo';
$VASARTER["def"][$mezo][$bejegyzes]["ertek"] = 'Magasság';
Ha a forrás aruinfotipus akkor értékként az adott tulajdonság típus azonosítószámát adhatjuk meg. Az azonosítószámok a cfg/variables_aru.php állomány TERMEK TULAJDONSAG TIPUSOK szekciójában definiáltak, alapértelmezésben a következő értékek használhatók:
0 - szöveg típusú tulajdonság
1 - ár típusú tulajdonság
2 - leírás (hosszú) típusú tulajdonság
3 - garancia típusú tulajdonság
4 - számérték típusú tulajdonság
5 - kód típusú tulajdonság
6 - file típusú tulajdonság
Például:
$VASARTER["def"][$mezo][$bejegyzes]["forras"] = 'aruinfotipus';
$VASARTER["def"][$mezo][$bejegyzes]["ertek"] = '1';
Ha a forrás kep, a rendszer nem veszi figyelembe az értéket.
Például:
$VASARTER["def"][$mezo][$bejegyzes]["forras"] = 'kep';
$VASARTER["def"][$mezo][$bejegyzes]["ertek"] = '';
A következő beállítással a bejegyzéshez stílust rendelhetünk. A hozzárendelt stílus leíróját a Cascading Style Sheets (CSS) szabványnak megfelelően a weboldal más részén kell definiálni. A stílus aru, aruinfo és aruinfotipus forrás esetén SPAN tag CLASS mezőjében, kep forrás esetén az IMG tag CLASS mezőjében szerepel hivatkozásként. A stílus befolyásolhatja a bejegyzés elhelyezkedését, méretét, kinézetét, viszonyát a többi bejegyzéssel, vagy a weboldal más részeivel. Példa:
$VASARTER["def"][$mezo][$bejegyzes]["css"] = 'stilus_osztaly';