Vorweg ein wichtiger Hinweis. Neue Brick Zonen kann nur ein Paket vom Typ quiqqer-template definieren. Andere Module können das im Moment nicht.
Areas / Zonen definieren
Die XML Datei bricks.xml ermöglichst dem Entwickler, verschiedene Zonen für Bausteine zu definieren. Die Zonen können entweder allgemein für alle Seiten bestimmt werden, oder für jeweilige Layouts. Z. B. Linke Bausteinzone wird nur im Layout mit 2 Spalten eingesetzt (links Sidebar und rechts der eigentliche Seiteninhalt).
<templateAreas>
<!-- global areas -->
<areas>
<area name="headerSuffix" inheritance="1" priority="1">
<title>
<locale ... />
</title>
<description>
<locale ... />
</description>
</area>
</areas>
<!-- specific type areas -->
<layouts>
<layout layout="layout/startPage">
<area name="prefixContentBricks" inheritance="1" priority="2">
<title>
<locale ... />
</title>
<description>
<locale ... />
</description>
</area>
<area name="suffixContentBricks" inheritance="1" priority="4">
<title>
<locale ... />
</title>
<description>
<locale ... />
</description>
</area>
</layout>
</layouts>
</templateAreas>Definition von Zonen für bestimmte Seitentypen
In bricks.xml Datei kann man auch Brick Zonen definieren, die nur für bestimmte Seitentypen gelten. Dadurch werden diese Zonen nur auf den entsprechenden Seiten angezeigt und erscheinen nicht auf allen Seiten.
<quiqqer>
<bricks>
<templateAreas>
<!-- specific site type areas -->
<siteTypes>
<type type="quiqqer/PACKAGE:types/SITE_TYPE">
<area name="headerSuffix" inheritance="1" priority="1">
<title>
<locale ... />
</title>
<description>
<locale ... />
</description>
</area>
</type>
</siteTypes>
</templateAreas>
</bricks>
</quiqqer>
Reihenfolge
Um die Benutzerfreundlichkeit zu erhöhen, wird empfohlen die Reihenfolge der Zonen (orientiert an logischer Anordnung der Internetseite) zu bestimmen. Beispiel: der Kopfbereich (header) wird als erste Zone definiert und die Fußzeile (footer) als letzte. Das geschieht durch das Attribut priority:
<templateAreas>
<layouts>
<layout layout="layout/noSidebar">
<area name="prefixContentBricks" inheritance="1" priority="4">
Beispiel
Hier ein umfassendes Beispiel:
<?xml version="1.0" encoding="UTF-8"?>
<quiqqer>
<bricks>
<!-- for all bricks -->
<brick control="*">
<settings>
<setting name="brickFullWidth" type="checkbox">
<locale group="quiqqer/template-businesspro"
var="brickFullWidth"/>
</setting>
<setting name="noPadding" type="checkbox">
<locale group="quiqqer/template-businesspro"
var="noPadding"/>
</setting>
</settings>
</brick>
<!-- promo slider wallpaper 2 content -->
<brick control="\QUI\Bricks\Controls\Slider\PromosliderWallpaper2Content">
<settings>
<setting name="promosliderBackground" type="color">
<locale group="quiqqer/template-businesspro"
var="promosliderBackground"/>
</setting>
</settings>
</brick>
<!-- defined areas in the template -->
<templateAreas>
<!-- global areas -->
<areas>
<area name="headerSuffix" inheritance="1" priority="1">
<title>
<locale group="quiqqer/template-businesspro"
var="area.headerSuffix.title"
/>
</title>
<description>
<locale group="quiqqer/template-businesspro"
var="area.headerSuffix.description"
/>
</description>
</area>
<area name="footerPrefix" inheritance="1" priority="5">
<title>
<locale group="quiqqer/template-businesspro"
var="area.footerPrefix.title"
/>
</title>
<description>
<locale group="quiqqer/template-businesspro"
var="area.footerPrefix.description"
/>
</description>
</area>
<area name="footer" inheritance="1" priority="6">
<title>
<locale group="quiqqer/template-businesspro"
var="area.footer.title"
/>
</title>
<description>
<locale group="quiqqer/template-businesspro"
var="area.footer.description"
/>
</description>
</area>
</areas>
<!-- specific type areas -->
<layouts>
<layout layout="layout/startPage">
<area name="prefixContentBricks" inheritance="1" priority="2">
<title>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.prefix.content.title"
/>
</title>
<description>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.prefix.content.description"
/>
</description>
</area>
<area name="suffixContentBricks" inheritance="1" priority="4">
<title>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.suffix.content.title"
/>
</title>
<description>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.suffix.content.description"
/>
</description>
</area>
</layout>
<layout layout="layout/noSidebar">
<area name="noSidebar">
<title>
<locale group="quiqqer/template-businesspro"
var="area.noSidebar.title"
/>
</title>
<description>
<locale group="quiqqer/template-businesspro"
var="area.noSidebar.description"
/>
</description>
</area>
<area name="prefixContentBricks" inheritance="1" priority="2">
<title>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.prefix.content.title"
/>
</title>
<description>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.prefix.content.description"
/>
</description>
</area>
<area name="suffixContentBricks" inheritance="1" priority="4">
<title>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.suffix.content.title"
/>
</title>
<description>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.suffix.content.description"
/>
</description>
</area>
</layout>
<layout layout="layout/leftSidebar">
<area name="leftSidebar" inheritance="1" priority="3">
<title>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.left.title"
/>
</title>
<description>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.left.description"
/>
</description>
</area>
<area name="prefixContentBricks" inheritance="1" priority="2">
<title>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.prefix.content.title"
/>
</title>
<description>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.prefix.content.description"
/>
</description>
</area>
<area name="suffixContentBricks" inheritance="1" priority="3">
<title>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.suffix.content.title"
/>
</title>
<description>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.suffix.content.description"
/>
</description>
</area>
</layout>
<layout layout="layout/rightSidebar">
<area name="rightSidebar" inheritance="1" priority="3">
<title>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.right.title"
/>
</title>
<description>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.right.description"
/>
</description>
</area>
<area name="prefixContentBricks" inheritance="1" priority="2">
<title>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.prefix.content.title"
/>
</title>
<description>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.prefix.content.description"
/>
</description>
</area>
<area name="suffixContentBricks" inheritance="1" priority="4">
<title>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.suffix.content.title"
/>
</title>
<description>
<locale group="quiqqer/template-businesspro"
var="area.sidebar.suffix.content.description"
/>
</description>
</area>
</layout>
</layouts>
</templateAreas>
</bricks>
</quiqqer>