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 type page, 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 type BUNDLE. Par exemple, pour thématiser le champ field_images dans un contenu de type page, 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.