5.4. Boxen

5.4.1. Einführung

Seitenbezogene Boxen können für jede inhaltliche Seite separat angelegt werden. Sie erlauben es somit, im Gegensatz zu Globalen Boxen (siehe Abschnitt 5.3, „Globale Boxen“), auf inhaltlichen Seiten jeweils unterschiedliche Inhalte anzuzeigen.

Seitenbezogene Boxen eignen sich beispielsweise für Seitenspalten, deren Struktur und Aussehen gleich, die Inhalte aber abhängig von der aufgerufenen Seite unterschiedlich sein sollen.

5.4.2. Verwaltung

Da Boxen seitenindividuell sind, erfolgt deren Verwaltung im Submenü der Seitenverwaltung unter dem Menüpunkt Boxen.

Abbildung 5.10. Übersicht über vorhandene Boxen

Übersicht über vorhandene Boxen

Die Übersicht zeigt die vorhandenen Boxen in alphabetischer Reihenfolge und bietet Links zum Hinzufügen, Bearbeiten und Löschen von Boxen.

Über Bestehende Boxen übernehmen haben sie die komfortable Möglichkeit Boxen, die anderen Seiten zugeordnet sind, der aktuellen Seite hinzuzufügen (asynchron, ohne Neu-Laden der Seite). Dieses erspart viele Klicks und ausufernde Copy & Paste Orgien.

Abbildung 5.11. Offene Ansicht der Option: Bestehende Boxen übernehmen

Offene Ansicht der Option: Bestehende Boxen übernehmen

Funktionsspalten: Bestehende Boxen übernehmen

Name

Name/Titel der Box.

Seite

Name der Seite, der die Box zugeordnet ist, respektive für die sie angelegt wurde.

Inhalt(Quellansicht)

Begrenzte Anzeige des Inhaltes der Box.

Anzeigen

Durch einen Klick auf die Schaltfläche Anzeige wird ihnen innerhalb der Seite der vollständige Inhalt der Box angezeigt.

Box übernehmen

Die Schaltfläche Box übernehmen veranlasst, das die ausgewählte Box der aktuellen Seite hinzugefügt wird.

Das Formular zum Hinzufügen respektive Editieren der Boxen besteht nur aus einigen wenigen Feldern:

Abbildung 5.12. Neue Box anlegen

Neue Box anlegen

Name

Der Name der Box. Kommt ausser im Administrationsbereich nicht zum Einsatz. Muss innerhalb eines Projekts einzigartig sein.

Inhalt

Inhalt der Box.

Textkonverter

Textkonverter, der auf den Inhalt der Box appliziert werden soll (siehe Abschnitt 8.2, „Textkonverter“).

Makros anwenden

Entscheidet, ob die vorhandenen Textmakros auf den Inhalt der Box appliziert werden sollen (siehe Abschnitt 8.3, „Textmakros“).

Priorität

Legt die Sortierung in der Anzeige einer Seite im Admin-Interface fest. Je größer die Zahl, desto stärker wird der Eintrag gewichtet.

Gleichzeitig bieten die seitenabhängigen Boxen Unterstützung durch den Mediamanager (siehe Abschnitt 6.2, „Der Mediamanager“).

5.4.3. Ausgabe

Auch seitenabhängige Boxen können über einen in allen Seitenvorlagen vorhandenen Link ausgewählt und automatisch in eine Seitenvorlage eingesetzt werden. Klicken Sie dazu auf den entsprechenden Link über dem Textbereich zum Editieren der Vorlage (siehe Abbildung 5.13, „Box referenzieren“). Hierbei wird der Code automatisch eingesetzt und es muss nur noch die ID angepasst werden.

Abbildung 5.13. Box referenzieren

Box referenzieren

Beispiel 5.6. Box anhand des Namens ausgeben

Um eine einzelne Box auszulesen, wird der Name (im Beispiel headerbild) der jeweiligen Box benötigt. Der Code zum Auslesen der Box kann auch über ein Pop-up (s.o.) generiert und eingesetzt werden.

{* Box mit dem Namen headerbild auslesen*}
{select_simple ns="Content" class="Box" method="selectBoxUsingName"
	var="box" page=$page.id name="headerbild"}

ID der Box: {$box.id}
Name der Box: {$box.name}
Inhalt der Box: {$box.content}

[Anmerkung] Anmerkung

Die im vorherigen Beispiel genutzte Wertangabe des Parameters var (hier: box) ist frei wählbar.

Beispiel 5.7. Box anhand der ID ausgeben

Alternativ (steht nicht als automatisch einsetzbarer String zur Verfügung) können Sie eine Box auch anhand der ID (im Beispiel 1) auslesen.

{* Box mit der ID 1 auslesen*}
{select_simple ns="Content" class="Box" method="selectBox"
	var="box" id="1"}

ID der Box: {$box.id}
Name der Box: {$box.name}
Inhalt der Box: {$box.content}

[Anmerkung] Anmerkung

Die im vorherigen Beispiel genutzte Wertangabe des Parameters var (hier: box) ist frei wählbar.

Beispiel 5.8. Boxen ausgeben

Sollen mehrere Boxen ausgegeben werden, empfiehlt es sich in der Regel, mehrmals einfach nur eine Box in der gewünschten Reihenfolge auszugeben. Es ist aber auch möglich, alle aufs Mal auszulesen.

{select_named ns="Content" class="Box" method="selectBoxes"
	var="boxes"}

{foreach from=$boxes item="_box"}
	ID der Box: {$_box.id}
	Name der Box: {$_box.name}
	Inhalt der Box: {$_box.content}
{/foreach}

[Anmerkung] Anmerkung

Die im vorherigen Beispiel genutzte Wertangabe des Parameters var (hier: boxes) ist frei wählbar.