Mintarendszer
A muPortal egyik alapja az SQL réteg mellett a mintarendszer. Ennek segítségével választható külön a PHP kódtól a HTML kód. Előnye, hogy az is egyszerűen készíthet saját témákat vagy szerkeszthet egy meglévőt, aki nem rendelkezik PHP ismeretekkel.
Mintafájlok elhelyezkedése, elnevezése
A mintafájlok a mu-sys/tpl-mintaneve/
könyvtárban találhatóak, .tpl
vagy .tpx
kiterjesztéssel.
Ajánlott fájlnév: előtag_modulnév[_funkció].tp?
Célszerű a rendszerhez tartozó, valamint megosztott fájlokat c_
előtaggal, a
modulokhoz tartozó fájlokat m_
, illetve a panelekhez tartozó fájlokat p_
előtaggal elnevezni.
Amennyiben egy modul több különféle funkcióra is használható, célszerű szétbontani
több csomagra, például m_user_forgotpw.tpx
, m_user_profile.tpx
.
Mintafájl, mintacsomag
A muPortal két különféle mintát különböztet meg. Az egyszerűbbik az egyszerű minta,
(kiterjesztése .tpl
). Ennek jellemzője, hogy a fájl maga az egész minta.
Amennyiben egy modulhoz több mintára is szükség van, nem javasolt a használata.
A bonyolultabb a mintacsomag (kiterjesztése .tpx
). Mint a nevéből is
kiderül, itt egy fájl több mintát tartalmaz. Az egyes minták HTML megjegyzéssel vannak
elválasztva, így benyithatóak hagyományos HTML szerkesztőkbe is. Egy ilyen blokk a
következőképp néz ki:
<!-- BEGIN minta_neve --> ... minta HTML kódja ... <!-- END minta_neve -->
A többi mintát az előző után kell elhelyezni. Egymásba ágyazni nem lehet őket. Egy mintára
a csomag betöltése után a minta_neve
címke alatt lehet hivatkozni. A megjegyzések
természetesen nem fognak szerepelni a kész HTML kódban.
Cserélendő helyek
Mivel dinamikus oldalakat szeretnénk létrehozni, ezért egyes részeket ki kell cserélni a sablonban. Ezeket a részeket egy azonosítóval kell ellátni, és ezt az azonosítót kapcsos zárójelbe kell tenni. Például:
A megrendelő neve: <b>{NAME}</b>
A minta meghívásakor a {NAME} azonosítót fogja kicserélni a rendszer. Célszerű az azonosítók megadásakor csupa nagybetűt használni, és kerülni az ékezetes betűket.
Előre definiált cserék
Vannak előre definiált cserék. Ezek betöltéskor végrehajtódnak. Ezek a cserék a következőek:
-
D_IMAGES
Az egyik leggyakrabban használt csere: A téma könyvtárában lévő 'images' könyvtár elérési útvonalát adja meg. A mintákhoz tartozó képeket (például háttérkép, keret, ikonok...) célszerű a
témakönyvtár/images
könyvárba elhelyezni, és az útvonal megadásakor nem teljes elérési útvonalat használni, hanem a cserét. -
D_TEMPLATE
A téma alapkönyvtárát adja vissza
-
D_LANG
Ha többnyelvű honlapot készítünk előfordulhat olyan, hogy más-más kép kell a különböző nyelvekhez. Ez a csere a nyelvi fájlok elérési útvonalához vezet.