Modulpozíciók

A JoomlaWiki wikiből

A modulpozícióknak helyőrző szerepe van a sablonban. Pozíciókat határoznak meg a sablonban és megmondják a Joomlának, hogy hova helyezze az egyes pozíciókhoz rendelt modulok kimenetét. A sablon készítőjének teljes ellenőrzése van a modulpozíciók felett. Például a "left" pozíciót a sablon bal oldalán lehet használni egy oldalnavigációs menü megjelenítéséhez. Tehát ha egy modul a "left" pozícióhoz van rendelve, akkor ott fog megjelenni, ahova a sablon készítője a "left" pozíciót helyezi, azonban ez nem feltétlenül a weblap bal oldala.

A templateDetails.xml fájl

A "templateDetails.xml" nevű fájl tartalmazza a telepítéshez szükséges és az általános sablon információt, beleértve a megjelenített modulpozíciókat. Itt egy lista a leggyakrabban használt modulpozíció nevekről:

  1. <positions>
  2.         <position>top</position>
  3.         <position>left</position>
  4.         <position>right</position>          
  5.         <position>bottom</position>
  6.         <position>banner</position>
  7.         <position>syndicate</position>
  8.         <position>footer</position>
  9.         <position>user1</position>
  10.         <position>user2</position>
  11.         <position>user3</position>
  12.         <position>user4</position>  
  13. </positions>

Habár ezek a leggyakrabban használt pozíciók, a sablon készítője tetszőleges nevet adhat bármelyik pozíciónak. Ahogy az látható, az egyes modulpozíciók a <positions> és </positions> tagek között vannak definiálva. Ezeken belül a <position> és </position> tag között adhatjuk meg az egyes pozíciók nevét.

Használat

A Joomla! sablonok bizonyos pozíciókhoz rendelt modulokat jelenítenek meg. Ehhez a <jdoc:include /> utasítást használjuk, ahogy az alábbiakban látható:

  1. <jdoc:include type="modules" name="pozicio neve" style="xhtml" />

Megjelenítés

A sablonban definiált pozíciókat megnézhetjük, ha az URL végére beírjuk a ?tp=1 paramétert:

 http://www.example.com/index.php?tp=1

Forrás: Joomla! Documentation