Unvollständiger Artikel: dieser Artikel ist noch nicht sauber bearbeitet.

Bitte erweitere ihn und entferne erst anschliessend diesen Hinweis.

betrifft
TYPOlight Version	ab 2.8

Extensions	TYPOlight Core, Catalog Version 2

Inhaltsverzeichnis

1 Templates für den Catalog bearbeiten und verändern
2 Voraussetzungen für das Tutorial
3 Grundlagen
- 3.1 Alles ein Array das entries Array
- 3.2 Die Bestandteile der meta-Arrays
  - 3.2.1 Die allgemeinen Parameter
  - 3.2.2 Die speziellen Parameter
    - 3.2.2.1 Dateien
4 Beispiel Anpassungen

Templates für den Catalog bearbeiten und verändern

Der Catalog bringt eine Menge Templates mit. Für fast jedes Modul gibt es einen eigenen Satz Templates. Zusätzlich werden Standard Templates herangezogen um zum Beispiel die Galerie oder die Filter zu generieren.

Da der Catalog aber nur ein Grundgerüst darstellt wird man nicht umhin kommen sich die Templates nach eigenen Wünschen und Vorstellungen anzupassen. Zunächst geht es hier ganz allgemein um das Vorgehen bei der Template Anpassung. Wie man an bestimmte Werte kommt und so an die Ausgaben die man möchte. Zusätzlich werden hier noch ein paar Fallbeispiele vorgestellt, welche zum Teil aus den Wünschen im Forum entnommen sind.

Voraussetzungen für das Tutorial

wie ein Katalog erstellt wird sollte von anderen Tutorials klar sein. Es sollte also ein Katalog vorhanden sein mit Inhalten.
der Umgang mit TYPOlight sollte bekannt sein
wie man Templates bearbeitet sollte in Grundzügen bekannt sein.

Grundlagen

Alles ein Array das entries Array

Um sich die Ausgabe von dem Array anzuschauen braucht man nur diese Zeile in das Template bringen:

<?php print_r($this->entries); ?>

Wenn man sich das Ergebniss nun auf er neu geladenen Seite anschaut ist das nicht gerade schön anzusehen. Alles steht hintereinander und ergibt einen Code Brei. Deswegen sollte man sich das am besten immer direkt in der Quellcode ansicht anschauen. Da bekommt man alles schön eingerückt und verschachtelt zu sehen! Oder man setzt die Ausgabe in dein <pre>-Tag.

Auszug aus von einem Immoblilien Katalog:

Das ist nur ein kleiner Auszug aus der Ausgabe. In dieser Ausgabe stehten verschiedene Dinge.

Am Anfang stehen immer die Grundinformationen (id, catalog_name, parentJumpTo, tablename,showLink, class). Die werden in der Regel nicht gebraucht. Sind aber gut zu wissen, damit man mal kurz schauen kann ob man überhaupt richtig ist ;)

Alle Variablen die man bekommt stehen immer in dem Array data Um an die einzelnen Werte zu kommen, braucht man nur die Arrays von dem Wert durchzugehen bis nach oben.

Beispiel: Den Titel der Immobilie als Überschrift ausgeben:

 <h3><?php echo $entry['data']['immo_titel']['value']; ?></h3>

Das value 'villa in tunesien' soll ausgegeben werden, welches sich in dem Array 'immo_titel' befindet und das ist in dem Array 'data'. So einfach bekommt man einzelne Werte ausgegeben.

Die Bestandteile der meta-Arrays

Die Arrays in so einer Ausgabe sind immer gleich aufgebaut. Je nach Feldtyp etwas anders.

Die Standart Informationen

class -> die CSS-Klassen des Items (eher wichtig in einer Liste, da man dort zum Beispiel even/odd zur Verfügung hat)
link -> Die URL der Leser Seite (auch eher Listen spezifisch)
url -> enthält nur die URL von dem link. Damit kann man seine eigenen Links bauen.
data -> Hier sind alle Felder drinn.

Die allgemeinen Parameter

Jedes Feld hat immer diese 4 Parameter:

   * [label] => Enthält das Label welches im Katalog vergeben wurde
   * [type] => Enthält den Feldtyp. Zum Beispiel: text, file, select, tags
   * [raw] => Enthält die Original Daten direkt aus der Datenbank. Hiermit kann man immer komplett eigene Ausgaben gestalten.
   * [value] => Enthält die vorformatierten Daten: Datei-Bild Feld => Bild Lightbox, Datei-download => den download Link, Text Feld => der Formatierte String (numeric, date, etc.)

Die speziellen Parameter

Dateien

[files] => Beinhaltet ein Array -> [0] .. [xxx] mit den Dateinamen
[meta] => Beinhaltet die meta-Angaben, wie oben genannt

Wenn es sich um eine Datei Handelt (kein Bild) wird das meta-Array diese Werte enthalten:

[url] => die relative URL zum herunterladen
[alt] => Den alt Text
[caption] => die Beschreibung in der meta.txt Datei
[size] => die größe in Byte
[sizetext] => die größe in lesbarer Form (z.B. 230.0 kB)
[icon] => das Icon (gesetzt wird der Standard vom System selber, basierend auf den Mime-Typen)

Wenn es sich um ein Bild handelt, wird das meta-Array diese Werte enthalten:

[src] => den Dateinamen von dem Bild in angepasster größe (wenn das benutzt wird im Katalog selber)
[alt] => Den alt-Text
[lb] => die einzigartige REL=lightbox ID damit die slimbox angesteuert werden kann
[w] => Bild width
[h] => Bild height
[wh] => Bild width/height in einem String

Bei einer referenzierenden Tabelle können noch folgende Inhalte vorhanden sein:

[parentJumpTo] => die ID von dem referenzierenden Katalog (kann in inserttags genutzt werden)
[parentLink] => Der komplette link mit einem Standard Text "View item details"
[parentUrl] => Die relative URL zu der Detail (Leser) Seite

Beispiel Anpassungen

Einfache Überprüfung ob Inhalt vorhanden ist

Es gibt immer wieder einzelne Felder die nur optional zu befüllen sind. Wenn man die Ausgabe von einem Div nur machen möchte wenn auch Inhalte vorhanden sind, kann man das einfach mit einer if-Abfrage erledigen:

 <?php if($entry['data']['immo_bildergalerie']['value']):?><div class="immo_galerie"><?php echo $entry['data']['immo_bildergalerie']['value']; ?></div><?php endif;?>

In dem Beispiel wird die Bildergalerie mit dem Umschließenden div nur dann ausgegeben wenn auch mindestens ein Bild vorhanden ist.

Wie man in eigenen Templates beim Katalog Thumbnails generieren kann

Thumbnails werden in TYPOlight mit der Methode Controller::getImage() generiert. Wichtig dabei ist, dass nicht der ganze Code des Bildes zurückgegeben wird, sondern lediglich die URL zum Thumbnail.

Die Methode sieht wie folgt aus:

getImage($image, $width, $height, $mode='', $target=null)

Die Parameter erklären sich wie folgt:

$image (String) zwingend
- erwartet eine relative URL zum Bild, dass verkleinert werden soll (z.B. 'tl_files/meine_bilder/mein_bild.jpg')
$width (Integer) bedingt optional (Achtung: mind. eine Angabe zu Breite oder Höhe ist zwingend!)
- erwartet eine Zahl, die die Breite in Pixel angibt (z.B. 230)
$height (Integer) bedingt optional (Achtung: mind. eine Angabe zu Breite oder Höhe ist zwingend!)
- erwartet eine Zahl, die die Breite in Pixel angibt (z.B. 230)
$mode (String) optional (weitergehende Informationen auf dem offiziellen TYPOlight-Blog)
- erwartet einen Angabe darüber, wie das Bild behandelt werden soll. Möglich sind:
  - '' (Exaktes Format) - default
  - 'proportional' (Proportional)
  - 'box' (An Rahmen anpassen)
$target (String) optional
- erwartet eine relative URL zu einem Bild, dass ersetzt werden soll (z.B. 'tl_files/meine_bilder/mein_zu_ersetzendes_bild.jpg')

Ein Beispiel für ein Template mit einem Thumbnail von 430px Breite und 300px Höhe, das proportional geparst werden soll, könnte also so aussehen:

<img src="<?php echo $this->getImage('tl_files/meine_bilder/mein_bild.jpg',430,300,'proportional'); ?>" alt="Mein alt-Text für mein Bild" />

Fortlaufende Nummerierung der einzelnen Einträge in einer Liste

Die Paginierung wurde berücksichtigt:

<?php $perpage=3 ?>
<?php $index=0 ?>
<?php foreach ($this->entries as $entry): ?>
  <?php $index++ ?>
  <?php if (isset($_GET['page'])): ?>
    <?php $number = $index + ($perpage * ($_GET['page'] - 1)) ?>
  <?php else: ?>
    <?php $number = $index ?>
  <?php endif; ?>
  ...
<?php endforeach; ?>

Wobei $perpage die Anzahl der Items enhält, die pro Seite ausgegeben werden.

--MacKP 21:44, 21. Mai 2010 (UTC)

Catalog Templates anpassen

Aus Contao Community Documentation

Inhaltsverzeichnis

Templates für den Catalog bearbeiten und verändern

Voraussetzungen für das Tutorial

Grundlagen

Alles ein Array das entries Array

Die Bestandteile der meta-Arrays

Die allgemeinen Parameter

Die speziellen Parameter

Dateien

Beispiel Anpassungen

Einfache Überprüfung ob Inhalt vorhanden ist

Wie man in eigenen Templates beim Katalog Thumbnails generieren kann

Fortlaufende Nummerierung der einzelnen Einträge in einer Liste

Ansichten

Meine Werkzeuge

Suche

Navigation

Verstehen

Verwenden

Entwickeln

Verschiedenes

Werkzeuge