Tutorial: Ophalen parameter gegevens in een template bestand

Afdrukken PDF
Geschreven door Remco op woensdag 07 januari 2009 22:08, in: Templates (1.5.x)

Ophalen van parameter gegevens in een template bestand

Na een parameter in het templateDetails.xml bestand te hebben gedefinieerd en een waarde ervoor in het params.ini bestand te hebben opgeslagen, blijft het afwachten hoe de huidige waarde van de parameter op te halen, zodat het in de template code kan worden gebruikt.

Gebruik om de waarde van een parameter in uw template code op te halen de functie:

<?php $myParam = $this->params->get( 'parameterName' ); ?>

Merk op dat het $this object in de template altijd de huidige aanleg is van het JDocument object. Merk ook op dat $ $this->params een type JParameter object is.

Bijvoorbeeld, stel uw template heeft een parameter templateColour geheten, met verschillende string waarden die bepalend zijn voor het kleurschema dat moet worden gebruikt. De kleuren zelf zijn omschreven in de CSS-bestanden, waaronder de kleur naam als deel van hun bestandsnamen. De volgende code haalt de parameter op, voegt dan de juiste stylesheet toe om de pagina in de gewenste kleurenschema op te bouwen. 

<?php
$tplColour = $this->params->get( 'templateColour' );
$this->addStyleSheet( $this->baseurl  . '/templates/'
                    . $this->template . '/css/' . $tplColour .'.css' );
?>

Nog een voorbeeld, stel uw template heeft een parameter genaamd authorCopyright die de waarde 0 gebruikt om een verklaring betreffende het auteursrecht te verbergen, of 1 om te tonen. De volgende code haalt de parameter op, dan toont de auteursrecht melding met behulp van een voorwaardelijke PHP statement:

<?php if ($this->params->get( 'authorCopyright' )) : ?>   
     <div class="copyright">
         Copyright © 2008 Fat Pigeon Templates
     </div>
<?php endif; ?>