In het vorige artikel (zie Joomla Templates De Basisonderdelen Van Een Joomla Design) heb ik uitgelegd wat de basisonderdelen zijn van een Joomla 1.5 ontwerp. Een paar bestanden zijn daarbij aan bod gekomen die ik in dit artikel nader zal toelichten: 'templateDetails.xml' en 'params.ini'.

Wat betekent templateDetails.xml?

Het bestand templateDetails.xml is van cruciaal belang, omdat dit bij de installatie van je template precies aangeeft welke overige bestanden er aanwezig moeten zijn. Vergeleken met Joomla 1.0.x heeft dit bestand meer mogelijkheden. Ik neem ze stuk voor stuk met je door. De volgende onderdelen kunnen maximaal 1x voorkomen:

  • name - Zet hier de naam van je template.
  • creationDate - De datum waarop je het template hebt gemaakt.
  • author - De auteur of auteurs van het template.
  • authorEmail - Hoe je per e-mail bereikt kan worden.
  • authorUrl - Wat je website is.
  • copyright - De voorwaarden die je aan het gebruik van het template stelt.
  • license - Geef hier aan of het via een publieke licentie te gebruiken is.
  • version - Het versienummer. Dit is met name handig als je je template verbetert. Geef er dan een volgend versie nummer aan.
  • description - Een korte omschrijving van je template.

Een aantal van deze onderdelen zie je als je na een installatie bij het template kijkt naar de details.

joomla-templates-informatie

De volgende onderdelen kunnen meerdere keren voorkomen. Met name in deze onderdelen zitten nieuwe mogelijkheden van Joomla 1.5:

  • files - Een lijst van bestanden (inclusief paden) die nodig zijn voor je template. Denk hierbij aan stylesheets, afbeeldingen en een favicon, javascript, php en html bestanden. Ook params.ini (waarover straks meer) en templateDetails.xml zelf staan erbij.
  • languages - Als je site aan de 'voorkant' voor de gewone bezoeker meertalig is, kan je dit hier aangeven. Dit is een nieuw element binnen Joomla 1.5!
  • administration - Als je site aan de 'achterkant' voor de beheerder meertalig kan je dit hier aangeven.
  • positions - Hier geef je aan welke posities je in je ontwerp hebt opgenomen en door de gebruiker ingesteld kunnen worden. In het volgende artikel in deze serie ga ik hier nader op in.
  • params - Als je meerdere versies van een ontwerp hebt (bijv. een groene en een oranje variant), dan geef je in dit onderdeel aan welke parameters nodig zijn om die verschillen tot uiting te brengen. Door ze hier als parameters in te stellen kan de beheerder van de website deze via de beheeromgeving zelf aanpassen. Hieronder zie je hoe dit eruit ziet voor het rhuk_milkyway template. Rechtsboven zijn de kleur, achtergrond en breedte van het template in te stellen.
joomla-templates-instellingen-params-500

Kijk in de templateDetails.xml van de twee meegeleverde templates van Joomla hoe je binnen deze elementen de afzonderlijke onderdelen precies moet invullen. Dit wijst zich vanzelf.

Wat doet params.ini?

Als een beheerder deze instellingen wijzigt worden deze opgeslagen in 'params. ini'. Maar omdat een ontwerp natuurlijk een basisinstelling moet hebben, maak je zelf dit bestand alvast aan met de standaardwaarden van je ontwerp. Met deze waarden zal het template - nadat het voor de eerste keer geinstalleerd is - starten.

Gemakkelijk een templateDetails.xml maken

Het is veel werk om zelf een templateDetails.xml te maken. Je vergeet gemakkelijk een bestand te vermelden. Maar er is een plugin die dat (gedeeltelijk) voor je doet: de Joomla templateDetails.xml Generator. Zie http://extensions.joomla.org/component/option,com_mtree/task,viewlink/link_id,585/Itemid,35/. Deze plug is helaas nog niet aangepast aan Joomla 1.5, maar je kunt het wel als basis gebruiken.

Hoe nu verder?

In het volgende artikel in deze serie zullen we verder gaan kijken naar Modules en Posities. Deze kennis heb je nodig voordat je aan de slag gaat met de index van het ontwerp.

(Zie Joomla Templates Modules En Posities)