Drupal-Themeing Lektion 5: Thematisierung eines Feldes. Vorlage field.tpl.php.

In dieser Lektion setzen wir die Thematisierung von Drupal fort und thematisieren diesmal Felder. Nach dieser Lektion werden wir die Ausgabe von Views thematisieren.

Um ein Feld zu thematisieren, muss die Datei modules/field/theme/field.tpl.php in den Ordner templates deines Themes kopiert und ihr ein neuer Name nach einem der folgenden Muster gegeben werden:

• field--FIELD_TYPE.tpl.php — die Vorlage wird auf alle Felder des Typs FIELD_TYPE angewendet. Zum Beispiel, um alle Felder vom Typ Bild zu thematisieren, erstellt man eine Vorlage mit dem Namen field--image.tpl.php.

• field--FIELD_NAME.tpl.php — die Vorlage wird auf das Feld mit dem Namen FIELD_NAME angewendet. Zum Beispiel, um das Feld mit dem Namen field_images zu thematisieren, erstellt man eine Vorlage mit dem Namen field--field_images.tpl.php.

• field--BUNDLE.tpl.php — die Vorlage wird auf alle Felder angewendet, die einer Entität vom Typ BUNDLE hinzugefügt wurden. Zum Beispiel, um alle Felder in einem Inhaltstyp page zu thematisieren, erstellt man eine Vorlage mit dem Namen field--page.tpl.php.

• field--FIELD_NAME--BUNDLE.tpl.php — die Vorlage wird nur auf das Feld FIELD_NAME angewendet, das zu einer Entität vom Typ BUNDLE hinzugefügt wurde. Zum Beispiel, um das Feld field_images im Inhaltstyp page zu thematisieren, erstellt man eine Vorlage mit dem Namen field--field_images--page.tpl.php.

Nachdem die Vorlage kopiert und umbenannt wurde, muss der Cache geleert und die erstellte Datei bearbeitet werden. Eine Beschreibung aller verfügbaren Variablen befindet sich in den Kommentaren der Vorlage.