Dag 7: Joomla! template tags

Afdrukken

Voordat we gaan beginnen met het maken van de template, moeten we weten op welke manier we de content in de template kunnen krijgen. Dit kan door middel van zogeheten jdoc statements.

Nu het design klaar is moeten we de verschillende elementen van onze Joomla! installatie in de website laden. Joomla! gebruikt hiervoor jdoc statements. Een typische jdoc statement ziet er als volgt uit:

jdoc-statement

We openen een jdoc statement door een '<' te typen, gevolgd door jdoc. Vervolgens vertellen we Joomla! dat we iets in de template willen laden. Dit doen we door direct achter jdoc ':include' te typen. Als laatste willen we weten wat we precies willen laden. Dit doen we door 'type=""' te typen. We sluiten de statement af met '/>'. Nu we weten hoe een jdoc statement er uit ziet, willen we dat allemaal met het type attribuut kunnen laden.

Het type attribuut
Je kan de volgende vijf verschillende typen jdoc statements onderscheiden binnen Joomla!:

  • Head: met dit type wordt de meta-informatie van de website geladen. Denk bijvoorbeeld aan de paginatitel, de auteur, de meta-keywords. In de HTML vind je deze informatie terug tussen de <head> tags; dat is waar we deze jdoc statement zullen plaatsen. De statement ziet er als volgt uit:
    jdoc-statement head

  • Installation: met dit type wordt het Joomla! installatieproces opgeroepen. Deze wordt alleen gebruikt tijdens de installatie van Joomla! zelf. De statement ziet er als volgt uit:
    jdoc-statement installatie

  • Message: met dit type worden systeem en errorberichten van Joomla! geladen. Mocht er zich een fout voordoen, dan kan je met dit type het bericht laden. Let op, dit type mag maar eenmalig voorkomen in de template. De statement ziet er als volgt uit: jdoc-statement message

  • Component: met dit type laden we de hoofdcontent van de website. Als we het wireframe bekijken, wordt dit type geladen waar "Mainbody Content" staat. Dit type komt eenmalig voor in de template. De statement ziet er als volgt uit:
    jdoc-statement component

  • Module/Modules: met deze statements worden de verschillende modules geladen binnen Joomla!. Als we wederom kijken naar het wireframe zien we dat er onder andere een menu, een logo, een laatste nieuws en een banner module moeten worden geladen in de template. Dit type is dan ook de meest gebruikte type jdoc statement. De statements zien er als volgt uit:
    jdoc-statement module
    jdoc-statement modules

    Wat direct opvalt is het verschil tussen module (zonder s) en modules (met s). Wanneer je module gebruikt wordt er eenmalig een module geladen, wanneer je modules gebruikt worden alle modules geladen. Een tweede element dat opvalt is de toevoeging van het name attribuut. Het name attribuut zorgt er voor dat alleen die modules die in Joomla! de positie beschreven hebben in name(bijvoorbeeld: menu) worden geladen.

Het style attribuut
Een laatste attribuut, dat alleen beschikbaar is voor het module type, is het style-attribuut. Met het style-attribuut vertellen we Joomla! hoe we de module willen tonen. In essentie voegt Joomla! bepaalde stukken HTML-code in om de module heen. Joomla! heeft zes verschillende typen, zogeheten module chrome, beschikbaar:

  • None: de standaardkeuze. Als het style-element niet wordt gebruikt, gebruikt Joomla! deze. Deze voegt geen extra HTML-code toe aan de module.
  • Rounded: voegt extra <div> elementen toe aan de module, zodat ronde hoeken kunnen worden gebruikt.
  • Table: voegt een <table> element toe aan de module.
  • Horz: voegt een extra <table> element toe aan de module, zodat opeenvolgende modules horizontaal naast elkaar komen te staan.
  • Xhtml: voegt XHTML-opmaak toe aan de module.
  • Outline: voegt een preview outline opmaak toe aan de module.

Als we kijken naar het ontwerp, zien we dat we voor Poker Magazine een xhtml style attribuut zullen toepassen.

Voor meer informatie over jdoc statements raden we aan om in de officiële Joomla! Documentatie te kijken. Ook voor meer informatie over de typen module chrome kan je de Joomla! Documentatie raadplegen.

Samenvatting
Vandaag hebben we gekeken naar de manieren waarop we in de template modules en content kunnen laden vanuit Joomla!. We hebben gekeken welke verschillende typen template-tags er beschikbaar zijn en wat ze precies doen. Morgen gaan we de template maken en zullen daarbij de template tags-integreren in de HTML.

 

Commentaar (7)Add Comment
André
januari 24, 2010
77.251.50.101
...

Waanzinnig mooi document van jullie.

Echter deze dag raken jullie me kwijt met die technische kreten (tags) ... Maar ga die 24 dagen afmaken ;-))

Nogmaals ... ontzettend bedankt voor deze gratis 'cursus' ...

mvg, André

Peter
mei 28, 2010
82.173.64.21
...

Goed initiatief, zo'n online tutorial. Klein detail bij deze dag 7: in welk document moet ik deze tags aanpassen, invoegen etc? Ik kan het niet terugvinden in deze of vorige afleveringen

Robert Roose
mei 31, 2010
84.27.216.116
...

Dat moet in het index.php bestand van je template.

Mira
september 02, 2010
213.10.228.95
...

Hier mag wel meer uitleg bij. Ik kijk nu in een index.php die standaard uitgeleverd wordt bij joomla. En zie wel tussen allerlei code ook

Mira
september 02, 2010
213.10.228.95
...

Goed, blijkbaar mag ik die jdoc code niet citeren, en is mijn vorige tekstje vreemd geworden. ik zie dus die codes staan tussen allerlei codes, maar met bovenstaande uitleg kan ik eigenlijk niets.

Mira
september 02, 2010
213.10.228.95
...

Ik lees : Als we kijken naar het ontwerp, zien we dat we voor Poker Magazine een xhtml style attribuut zullen toepassen.

WAAR DAN??

Frank
september 27, 2010
204.104.55.242
...

Kijk op deze site voor een korte cursus over templates. Als je dit combineert met wat hier gepresenteerd wordt, dan ben je denk ik een heel end.
http://www.byte.nl/cms/phpwiki/kennisbank/overzicht/template-cursus.html

Schrijf commentaar
 
  kleiner | groter
 

busy