Änderungen

Seitenverlauf
Update areas erstellt von Michael Danielczok's avatar Michael Danielczok
Leerzeichenänderungen ausblenden
Inline Nebeneinander
dev/areas.md
Seite @ anzeigen cb65e3a3
# Areas / Zonen definieren _Vorweg ein wichtiger Hinweis. Neue Brick Zonen kann nur ein Paket vom Typ `quiqqer-template` definieren. Andere Module können das im Moment nicht._
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). # Areas / Zonen definieren
```xml 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>
```xml
<!-- global areas --> <templateAreas>
<areas>
<area name="headerSuffix" inheritance="1" priority="1"> <!-- global areas -->
<title> <areas>
<locale ... /> <area name="headerSuffix" inheritance="1" priority="1">
</title> <title>
<description> <locale ... />
<locale ... /> </title>
</description> <description>
</area> <locale ... />
</areas> </description>
</area>
<!-- specific type areas --> </areas>
<layouts>
<layout layout="layout/startPage"> <!-- specific type areas -->
<area name="prefixContentBricks" inheritance="1" priority="2"> <layouts>
<title> <layout layout="layout/startPage">
<locale ... /> <area name="prefixContentBricks" inheritance="1" priority="2">
</title> <title>
<description> <locale ... />
<locale ... /> </title>
</description> <description>
</area> <locale ... />
</description>
<area name="suffixContentBricks" inheritance="1" priority="4"> </area>
<title>
<locale ... /> <area name="suffixContentBricks" inheritance="1" priority="4">
</title> <title>
<description> <locale ... />
<locale ... /> </title>
</description> <description>
</area> <locale ... />
</layout> </description>
</area>
</layouts> </layout>
</templateAreas>
``` </layouts>
# Reihenfolge </templateAreas>
```
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`: # Reihenfolge
```xml 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> ```xml
<layout layout="layout/noSidebar"> <templateAreas>
<area name="prefixContentBricks" inheritance="1" priority="4"> <layouts>
<layout layout="layout/noSidebar">
``` <area name="prefixContentBricks" inheritance="1" priority="4">
# Beispiel
```
Hier ein umfassendes Beispiel: # Beispiel
```xml Hier ein umfassendes Beispiel:
<?xml version="1.0" encoding="UTF-8"?>
<quiqqer> ```xml
<bricks> <?xml version="1.0" encoding="UTF-8"?>
<quiqqer>
<!-- for all bricks --> <bricks>
<brick control="*">
<settings> <!-- for all bricks -->
<setting name="brickFullWidth" type="checkbox"> <brick control="*">
<locale group="quiqqer/template-businesspro" <settings>
var="brickFullWidth"/> <setting name="brickFullWidth" type="checkbox">
</setting> <locale group="quiqqer/template-businesspro"
<setting name="noPadding" type="checkbox"> var="brickFullWidth"/>
<locale group="quiqqer/template-businesspro" </setting>
var="noPadding"/> <setting name="noPadding" type="checkbox">
</setting> <locale group="quiqqer/template-businesspro"
</settings> var="noPadding"/>
</brick> </setting>
</settings>
<!-- promo slider wallpaper 2 content --> </brick>
<brick control="\QUI\Bricks\Controls\Slider\PromosliderWallpaper2Content">
<settings> <!-- promo slider wallpaper 2 content -->
<setting name="promosliderBackground" type="color"> <brick control="\QUI\Bricks\Controls\Slider\PromosliderWallpaper2Content">
<locale group="quiqqer/template-businesspro" <settings>
var="promosliderBackground"/> <setting name="promosliderBackground" type="color">
</setting> <locale group="quiqqer/template-businesspro"
</settings> var="promosliderBackground"/>
</brick> </setting>
</settings>
<!-- defined areas in the template --> </brick>
<templateAreas>
<!-- global areas --> <!-- defined areas in the template -->
<templateAreas>
<areas> <!-- global areas -->
<area name="headerSuffix" inheritance="1" priority="1">
<title> <areas>
<locale group="quiqqer/template-businesspro" <area name="headerSuffix" inheritance="1" priority="1">
var="area.headerSuffix.title" <title>
/> <locale group="quiqqer/template-businesspro"
</title> var="area.headerSuffix.title"
<description> />
<locale group="quiqqer/template-businesspro" </title>
var="area.headerSuffix.description" <description>
/> <locale group="quiqqer/template-businesspro"
</description> var="area.headerSuffix.description"
</area> />
</description>
<area name="footerPrefix" inheritance="1" priority="5"> </area>
<title>
<locale group="quiqqer/template-businesspro" <area name="footerPrefix" inheritance="1" priority="5">
var="area.footerPrefix.title" <title>
/> <locale group="quiqqer/template-businesspro"
</title> var="area.footerPrefix.title"
<description> />
<locale group="quiqqer/template-businesspro" </title>
var="area.footerPrefix.description" <description>
/> <locale group="quiqqer/template-businesspro"
</description> var="area.footerPrefix.description"
</area> />
</description>
<area name="footer" inheritance="1" priority="6"> </area>
<title>
<locale group="quiqqer/template-businesspro" <area name="footer" inheritance="1" priority="6">
var="area.footer.title" <title>
/> <locale group="quiqqer/template-businesspro"
</title> var="area.footer.title"
<description> />
<locale group="quiqqer/template-businesspro" </title>
var="area.footer.description" <description>
/> <locale group="quiqqer/template-businesspro"
</description> var="area.footer.description"
</area> />
</areas> </description>
</area>
<!-- specific type areas --> </areas>
<layouts>
<!-- specific type areas -->
<layout layout="layout/startPage"> <layouts>
<area name="prefixContentBricks" inheritance="1" priority="2">
<title> <layout layout="layout/startPage">
<locale group="quiqqer/template-businesspro" <area name="prefixContentBricks" inheritance="1" priority="2">
var="area.sidebar.prefix.content.title" <title>
/> <locale group="quiqqer/template-businesspro"
</title> var="area.sidebar.prefix.content.title"
<description> />
<locale group="quiqqer/template-businesspro" </title>
var="area.sidebar.prefix.content.description" <description>
/> <locale group="quiqqer/template-businesspro"
</description> var="area.sidebar.prefix.content.description"
</area> />
</description>
<area name="suffixContentBricks" inheritance="1" priority="4"> </area>
<title>
<locale group="quiqqer/template-businesspro" <area name="suffixContentBricks" inheritance="1" priority="4">
var="area.sidebar.suffix.content.title" <title>
/> <locale group="quiqqer/template-businesspro"
</title> var="area.sidebar.suffix.content.title"
<description> />
<locale group="quiqqer/template-businesspro" </title>
var="area.sidebar.suffix.content.description" <description>
/> <locale group="quiqqer/template-businesspro"
</description> var="area.sidebar.suffix.content.description"
</area> />
</layout> </description>
</area>
<layout layout="layout/noSidebar"> </layout>
<area name="noSidebar">
<title> <layout layout="layout/noSidebar">
<locale group="quiqqer/template-businesspro" <area name="noSidebar">
var="area.noSidebar.title" <title>
/> <locale group="quiqqer/template-businesspro"
</title> var="area.noSidebar.title"
<description> />
<locale group="quiqqer/template-businesspro" </title>
var="area.noSidebar.description" <description>
/> <locale group="quiqqer/template-businesspro"
</description> var="area.noSidebar.description"
</area> />
</description>
<area name="prefixContentBricks" inheritance="1" priority="2"> </area>
<title>
<locale group="quiqqer/template-businesspro" <area name="prefixContentBricks" inheritance="1" priority="2">
var="area.sidebar.prefix.content.title" <title>
/> <locale group="quiqqer/template-businesspro"
</title> var="area.sidebar.prefix.content.title"
<description> />
<locale group="quiqqer/template-businesspro" </title>
var="area.sidebar.prefix.content.description" <description>
/> <locale group="quiqqer/template-businesspro"
</description> var="area.sidebar.prefix.content.description"
</area> />
</description>
<area name="suffixContentBricks" inheritance="1" priority="4"> </area>
<title>
<locale group="quiqqer/template-businesspro" <area name="suffixContentBricks" inheritance="1" priority="4">
var="area.sidebar.suffix.content.title" <title>
/> <locale group="quiqqer/template-businesspro"
</title> var="area.sidebar.suffix.content.title"
<description> />
<locale group="quiqqer/template-businesspro" </title>
var="area.sidebar.suffix.content.description" <description>
/> <locale group="quiqqer/template-businesspro"
</description> var="area.sidebar.suffix.content.description"
</area> />
</layout> </description>
</area>
<layout layout="layout/leftSidebar"> </layout>
<area name="leftSidebar" inheritance="1" priority="3">
<title> <layout layout="layout/leftSidebar">
<locale group="quiqqer/template-businesspro" <area name="leftSidebar" inheritance="1" priority="3">
var="area.sidebar.left.title" <title>
/> <locale group="quiqqer/template-businesspro"
</title> var="area.sidebar.left.title"
<description> />
<locale group="quiqqer/template-businesspro" </title>
var="area.sidebar.left.description" <description>
/> <locale group="quiqqer/template-businesspro"
</description> var="area.sidebar.left.description"
</area> />
</description>
<area name="prefixContentBricks" inheritance="1" priority="2"> </area>
<title>
<locale group="quiqqer/template-businesspro" <area name="prefixContentBricks" inheritance="1" priority="2">
var="area.sidebar.prefix.content.title" <title>
/> <locale group="quiqqer/template-businesspro"
</title> var="area.sidebar.prefix.content.title"
<description> />
<locale group="quiqqer/template-businesspro" </title>
var="area.sidebar.prefix.content.description" <description>
/> <locale group="quiqqer/template-businesspro"
</description> var="area.sidebar.prefix.content.description"
</area> />
</description>
<area name="suffixContentBricks" inheritance="1" priority="3"> </area>
<title>
<locale group="quiqqer/template-businesspro" <area name="suffixContentBricks" inheritance="1" priority="3">
var="area.sidebar.suffix.content.title" <title>
/> <locale group="quiqqer/template-businesspro"
</title> var="area.sidebar.suffix.content.title"
<description> />
<locale group="quiqqer/template-businesspro" </title>
var="area.sidebar.suffix.content.description" <description>
/> <locale group="quiqqer/template-businesspro"
</description> var="area.sidebar.suffix.content.description"
</area> />
</layout> </description>
</area>
<layout layout="layout/rightSidebar"> </layout>
<area name="rightSidebar" inheritance="1" priority="3">
<title> <layout layout="layout/rightSidebar">
<locale group="quiqqer/template-businesspro" <area name="rightSidebar" inheritance="1" priority="3">
var="area.sidebar.right.title" <title>
/> <locale group="quiqqer/template-businesspro"
</title> var="area.sidebar.right.title"
<description> />
<locale group="quiqqer/template-businesspro" </title>
var="area.sidebar.right.description" <description>
/> <locale group="quiqqer/template-businesspro"
</description> var="area.sidebar.right.description"
</area> />
</description>
<area name="prefixContentBricks" inheritance="1" priority="2"> </area>
<title>
<locale group="quiqqer/template-businesspro" <area name="prefixContentBricks" inheritance="1" priority="2">
var="area.sidebar.prefix.content.title" <title>
/> <locale group="quiqqer/template-businesspro"
</title> var="area.sidebar.prefix.content.title"
<description> />
<locale group="quiqqer/template-businesspro" </title>
var="area.sidebar.prefix.content.description" <description>
/> <locale group="quiqqer/template-businesspro"
</description> var="area.sidebar.prefix.content.description"
</area> />
</description>
<area name="suffixContentBricks" inheritance="1" priority="4"> </area>
<title>
<locale group="quiqqer/template-businesspro" <area name="suffixContentBricks" inheritance="1" priority="4">
var="area.sidebar.suffix.content.title" <title>
/> <locale group="quiqqer/template-businesspro"
</title> var="area.sidebar.suffix.content.title"
<description> />
<locale group="quiqqer/template-businesspro" </title>
var="area.sidebar.suffix.content.description" <description>
/> <locale group="quiqqer/template-businesspro"
</description> var="area.sidebar.suffix.content.description"
</area> />
</layout> </description>
</layouts> </area>
</templateAreas> </layout>
</bricks> </layouts>
</templateAreas>
</quiqqer> </bricks>
```
</quiqqer>
```

PCSG & QUIQQER support and DEV System - GitLab