A jdoc utasítások
A JoomlaWiki wikiből
A jdoc utasítások az összes Joomla! sablonban megtalálhatók és meghatározzák, hogy a Joomla! vagy a bővítmények kimenete hol jelenjen meg az oldalon. Egy jellemző jdoc utasítás a következőképpen néz ki:
<jdoc:include type="component" />
A <jdoc:include /> utasítás a Joomla! egyik utasítása, amellyel oldaltól függő tartalmat lehet megjeleníteni. Számos <jdoc:include /> utasítás létezik, mindegyik más részét jeleníti meg egy Joomla! oldalnak.
A "type" attribútum a megjelenített tartalom típusát határozza meg a <jdoc:include /> utasításon belül. Például a <jdoc:include type="head" /> utasítás a "head" típust használja (type="head"). Megjegyzés: A jdoc utasítások használatához idézőjelet kell használni, aposztróffal nem fog működni.
Tartalomjegyzék |
Component
<jdoc:include type="component" />
Ez az elem csak egyszer szerepelhet az oldal törzsében, a fő tartalmat jeleníti meg.
Head
<jdoc:include type="head" />
Ez az elem csak egyszer szerepelhet az oldal fejlécében, a stíluslapokat, szkripteket és meta elemeket jeleníti meg.
Installation
<jdoc:include type="installation" />
Ez az elem a Joomla! telepítő sablonján belül használható, nincs hatása a felhasználó vagy adminisztrátor oldali sablonokban. Valamelyest a "component" típushoz hasonló, a telepítő egyes lépéseinek fő tartalmát jeleníti meg. Message
<jdoc:include type="message" />
Ez az elem csak egyszer szerepelhet az oldal törzsében. Rendszer és hibaüzeneteket jelenít meg. Az üzenetek stílusa a templates/system/css/system.css fájlban található.
Module
<jdoc:include type="module" name="breadcrumbs" /><jdoc:include type="module" name="menu" /><jdoc:include type="module" name="submenu" style="rounded" id="submenu-box" />
Ez az elem egy adott modult jelenít meg. A modul nevét a "name" attribútumban lehet megadni. A kérdéses modulpozíciónak publikálva és elérhetőnek kell lennie az adott felhasználó számára, hogy az megjelenjen. További attribútumok adhatók meg az elrendezés és a megjelenés meghatározásához.
Modules
Több modul megjelenítéséhez az alábbi kódot használhatjuk. A modulok különböző területekre vannak felosztva modulpozíciók használatával. Ezeket a modulpozíciókat a "templateDetails.xml" fájlban lehet létrehozni. A jdoc:include utasítás name="pozicio neve" attribútumával lehet megjeleníteni. További attribútumok segítségével módosíthatjuk az elrendezést és a kinézetet.
Az alábbiakban néhány gyakran használt utasításra láthatunk példát:
<jdoc:include type="modules" name="debug" /><jdoc:include type="modules" name="icon" /><jdoc:include type="modules" name="left" style="rounded" /><jdoc:include type="modules" name="left" style="xhtml" /><jdoc:include type="modules" name="right" style="xhtml" /><jdoc:include type="modules" name="status" /><jdoc:include type="modules" name="syndicate" /><jdoc:include type="modules" name="title" /><jdoc:include type="modules" name="toolbar" /><jdoc:include type="modules" name="top" /><jdoc:include type="modules" name="top" style="xhtml" /><jdoc:include type="modules" name="user1" style="xhtml" /><jdoc:include type="modules" name="user2" style="xhtml" /><jdoc:include type="modules" name="user3" /><jdoc:include type="modules" name="user4" />
Megjegyzés: A name="user3" modulpozíció alapértelmezés szeint a felső menü pozíciója.
A style attribútum
Az opcionális style="" attribútum a "module" és "modules" typusoknál érhető el a <jdoc:include /> utasításon belül. Az attribútum értéke egy úgynevezett "chrome" stílusra hivatkozik, amely a modul kimenetét veszi körül. Ha a "style" attribútum nincs megadva, alapértelmezésként a "none" érték kerül alkalmazásra.
Forrás: Joomla! Documentation
