Abfrage von Parametern eines Joomla 3.X Templates

Hier gibt es einige Codeschnipsel zur Abfrage von Parametern eines Joomla 3.X Templates. Die Parameter müssen in der Datei templateDetails.xml angegeben werden. Anschließend müssen die Parameter im Joomla Backend unter Erweiterungen => Templates => Stile => Stil bearbeiten konfiguriert werden. Für unkonfigurierte Parameter werden Defaultwerte verwendet. Die angelegten Parameter können anschließend in der Index.php ausgelesen und entsprechend verarbeitet werden.

Auslesen eines Parameters

Um den Wert des Parameters containerWidth auszulesen wird in der Index.php folgender Code benötigt :

if ($this->params->get('containerWidth')=="0")
{
    $doc->addStyleSheetVersion($this->baseurl . '/templates/' . $this->template . '/css/900px.css');
}

In diesem Beispiel wird geprüft ob der Wert 0 entspricht und falls dem so ist die CSS-Datei 900px.css aus dem Untervezeichnis css geladen

Anlegen des Parameters

Beispiel : Es soll ein Parameter containerWidth angelegt werden. Im Backend soll der Parameter unter dem Reiter Advanced erscheinen. Der Parameter soll über ein Dropdown Menu drei Auswahlmöglichkeiten 900px / 1100px / 1300px  zur Verfügung stellen.

Um diesen Parameter anzulegen wird in der templateDetails.xml folgender Block benötigt :

<config>
    <fields name="params">                 
        <fieldset name="advanced">         
            <field name="containerWidth" class="" type="list" default="0"
              label="Container Width"
              description="Maximum Widht of the fluid Bootstrap Container">
                <option value="0">900</option>
                <option value="1">1100</option>
                <option value="2">1300</option>
            </field>
        </fieldset>
    </fields>
</config>

Mit diesen Codeschnipseln können Parameter für Templates erstellt und ausgelesen werden. Über die Werte der Parameter kann dann z.B. durch Laden individueller CSS-Dateien das weitere Aussehen des Templates entsprechend beeinflußt werden.