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.