Field templates

Field-level theming determines how the values of a given field are displayed. The resulting output ends up in the $content and $<FIELD_NAME>_rendered variables in the node templates.

Template files

In order to customize field themeing:

  • Copy the content-field.tpl.php template file into your theme's root folder (please keep the contents of the cck/theme folder untouched. For the same reason, need to copy the file instead of just moving it).
  • Edit that copy to your liking. See the comments in cck/theme/content/content-field.tpl.php for a list of all variables available in this template.

Template suggestions

In addition, the theme layer will also look for field-specific variants (suggestions), in the following order of precedence:

content-field-<FIELD_NAME>-<CONTENT_TYPE_NAME>.tpl.php
ex: content-field-field_myfield-story.tpl.php - If present, will be used to theme the 'field_myfield' field when displaying a 'story' node.
content-field-<CONTENT_TYPE_NAME>.tpl.php
ex: content-field-story.tpl.php - If present, will be used to theme all fields of 'story' nodes.
content-field-<FIELD_NAME>.tpl.php
ex: content-field-field_myfield.tpl.php - If present, will be used to theme all 'field_myfield' field in all the content types it appears in.
content-field.tpl.php
If none of the above is present, the base template will be used.
Important:
  • Suggestions work only if the theme also has the base template file. If your theme has content-field-*.tpl.php files, it must also have a content-field.tpl.php file.
  • Whenever you add new template files in your theme, you need to rebuild the theme registry, or the theme engine won't see them.
    You can do that by :
    - visiting the Administer modules page
    - or using Devel module's 'clear cache' link.

See the Working with template suggestions section of the Theme guide for Drupal 6 for more informations about templates and template suggestions.