Drupal-theming Les 5: Het themen van een veld – de template field.tpl.php
In deze les gaan we verder met het themen van Drupal, en dit keer richten we ons op het themen van velden. Na deze les zullen we leren hoe we de uitvoer van Views kunnen themen.
Om een veld te themen, moet je het bestand modules/field/theme/field.tpl.php
kopiëren naar de map templates
van je thema en het hernoemen volgens een van de volgende sjabloonconventies:
-
field--FIELD_TYPE.tpl.php — dit sjabloon wordt toegepast op alle velden van het type
FIELD_TYPE
. Bijvoorbeeld, om alle velden van het typeImage
te themen, maak je een sjabloon met de naamfield--image.tpl.php
. -
field--FIELD_NAME.tpl.php — dit sjabloon wordt toegepast op het veld met de naam
FIELD_NAME
. Bijvoorbeeld, om het veldfield_images
te themen, maak je een sjabloon met de naamfield--field_images.tpl.php
. -
field--BUNDLE.tpl.php — dit sjabloon wordt toegepast op alle velden die behoren tot een entiteit van het type
BUNDLE
. Bijvoorbeeld, om alle velden in een inhoudstypepage
te themen, maak je een sjabloon met de naamfield--page.tpl.php
. -
field--FIELD_NAME--BUNDLE.tpl.php — dit sjabloon wordt alleen toegepast op het veld
FIELD_NAME
binnen een entiteit van het typeBUNDLE
. Bijvoorbeeld, om het veldfield_images
te themen binnen het inhoudstypepage
, maak je een sjabloon met de naamfield--field_images--page.tpl.php
.
Nadat je het sjabloon hebt gekopieerd en hernoemd, moet je de cache wissen en het aangemaakte bestand bewerken. Een beschrijving van alle beschikbare variabelen vind je in de commentaarregels bovenaan het sjabloonbestand.