Thématisation Drupal leçon 5 : Thématisation d’un champ. Modèle field.tpl.php.
Dans cette leçon, nous continuons la thématisation de Drupal et cette fois-ci, nous allons thématiser les champs. Après cette leçon, nous aborderons la thématisation de l'affichage des vues (Views).
Pour thématiser un champ, il faut copier le fichier modules/field/theme/field.tpl.php
dans le dossier templates
de votre thème et le renommer selon l’un des modèles suivants :
-
field--FIELD_TYPE.tpl.php — ce modèle sera appliqué à tous les champs de type
FIELD_TYPE
. Par exemple, pour thématiser tous les champs de type Image, créez un fichier nomméfield--image.tpl.php
. -
field--FIELD_NAME.tpl.php — ce modèle sera appliqué au champ nommé
FIELD_NAME
. Par exemple, pour thématiser le champ nomméfield_images
, créez un fichier nomméfield--field_images.tpl.php
. -
field--BUNDLE.tpl.php — ce modèle sera appliqué à tous les champs attachés à une entité de type
BUNDLE
. Par exemple, pour thématiser tous les champs dans un contenu de typepage
, créez un fichier nomméfield--page.tpl.php
. -
field--FIELD_NAME--BUNDLE.tpl.php — ce modèle sera appliqué uniquement au champ
FIELD_NAME
attaché à une entité de typeBUNDLE
. Par exemple, pour thématiser le champfield_images
dans un contenu de typepage
, créez un fichier nomméfield--field_images--page.tpl.php
.
Une fois le modèle copié et renommé, il faut vider le cache puis modifier le fichier créé. La description de toutes les variables disponibles se trouve dans les commentaires du modèle.