Änderungen

Seitenverlauf
Update areas erstellt von Michael Danielczok's avatar Michael Danielczok
Leerzeichenänderungen ausblenden
Inline Nebeneinander
dev/areas.md
Seite @ anzeigen a7abdecf
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).
```xml
<templateAreas>
<!-- global areas -->
<areas>
<area name="headerSuffix" inheritance="1" priority="1">
<title>
</title>
<description>
</description>
</area>
</areas>
<!-- specific type areas -->
<layouts>
<layout layout="layout/startPage">
<area name="prefixContentBricks" inheritance="1" priority="2">
<title>
</title>
<description>
</description>
</area>
<area name="suffixContentBricks" inheritance="1" priority="4">
<title>
</title>
<description>
</description>
</area>
</layout>
</layouts>
</templateAreas>
```
Außerdem empfiehlst sich, die Reihenfolge der Zonen zu bestimmen, orientiert an logischer Anordnung der Internetseite. Beispiel: der Kopfbereich (**header**) wird als erste Zone definiert und die Fußzeile (**footer**) als letzte. Das geschieht durch das Attribut `priority`
```xml
<templateAreas>
<layouts>
<layout layout="layout/noSidebar">
<area name="prefixContentBricks" inheritance="1" priority="4">
```
Hier ein umfassendes Beispiel:
```xml
<?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>
```
```xml
<?xml version="1.0" encoding="UTF-8"?>
<site>
......
......

PCSG & QUIQQER support and DEV System - GitLab