Tutorial: Module posities

Afdrukken PDF
Geschreven door Remco op woensdag 14 januari 2009 20:46, in: Templates (1.5.x)

Module posities zijn plaats-bepalers in een template.

Zij identificeren de posities binnen een template en vertel de Joomla! applicatie waar de uitvoer voor de modules dient te komen. De template ontwerper heeft de volledige controle over module posities, door het maken van verschillen tussen de modellen en de door Joomla! respectievelijk standaard toegewezen functies aan modules vanuit de installatie voorbeeld data.

Bijvoorbeeld de module positie "links" zou kunnen worden gebruikt in de linkerkant van een template voor een site navigatie menu. Dus als een module is toegewezen aan de "Links" positie, wordt daar weergegeven wat de ontwerper zet in de "links" module positie - niet noodzakelijkerwijs de linkerkant van de pagina.

templateDetails.xml

Het templateDetails.xml bestand bevat alle installatie en essentiële informatie voor een template, met inbegrip van de module posities die ze hanteert en toont. Hier is een korte lijst van de gebruikte benamingen voor de verschillende module posities.

<positions>
<position>boven</position>
<position>links</position>
<position>rechts</position>
<position>onderkant</position>
<position>banner</position>
<position>syndicate</position>
<position>voettekst</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
</positions>

Hoewel deze vaak worden gebruikt, is het aan de template ontwikkelaar om zowel een module positie naam en een begeleidend weergavestijl te kiezen. De toevoeging van module posities, zoals hierboven weergegeven, moet staan tussen de <position> en </positions>-tags.

Gebruik en Implementatie

Een Joomla! template toont een set van modules toegevoegd aan een specifieke positie met behulp van de zoals hieronder staat weergegeven (voor meer informatie over zie jdoc verklaringen):

<jdoc:include type="modules" name="name of module position" style="xhtml" />