Views template files

Same name in other branches
  1. 6.x-3.x theme/theme.inc \views_templates

All views templates can be overridden with a variety of names, using the view, the display ID of the view, the display type of the view, or some combination thereof.

For each view, there will be a minimum of two templates used. The first is used for all views: views-view.tpl.php.

The second template is determined by the style selected for the view. Note that certain aspects of the view can also change which style is used; for example, arguments which provide a summary view might change the style to one of the special summary styles.

The default style for all views is views-view-unformatted.tpl.php

Many styles will then farm out the actual display of each row to a row style; the default row style is views-view-fields.tpl.php.

Here is an example of all the templates that will be tried in the following case:

View, named foobar. Style: unformatted. Row style: Fields. Display: Page.

  • views-view--foobar--page.tpl.php
  • views-view--page.tpl.php
  • views-view--foobar.tpl.php
  • views-view.tpl.php
  • views-view-unformatted--foobar--page.tpl.php
  • views-view-unformatted--page.tpl.php
  • views-view-unformatted--foobar.tpl.php
  • views-view-unformatted.tpl.php
  • views-view-fields--foobar--page.tpl.php
  • views-view-fields--page.tpl.php
  • views-view-fields--foobar.tpl.php
  • views-view-fields.tpl.php

Important! When adding a new template to your theme, be sure to flush the theme registry cache!

See also

_views_theme_functions()

File

theme/theme.inc, line 1146

Files

Title File name Summary
views-exposed-form.tpl.php theme/views-exposed-form.tpl.php This template handles the layout of the views exposed filter form.
views-more.tpl.php theme/views-more.tpl.php Theme the more link.
views-view--frontpage.tpl.php test_templates/views-view--frontpage.tpl.php Main view template.
views-view-fields.tpl.php theme/views-view-fields.tpl.php Default simple view template to all the fields as a row.
views-view-grid.tpl.php theme/views-view-grid.tpl.php Default simple view template to display a rows in a grid.
views-view-list.tpl.php theme/views-view-list.tpl.php Default simple view template to display a list of rows.
views-view-row-comment.tpl.php theme/views-view-row-comment.tpl.php Default simple view template to display a single comment.
views-view-row-rss.tpl.php theme/views-view-row-rss.tpl.php Default view template to display a item in an RSS feed.
views-view-rss.tpl.php theme/views-view-rss.tpl.php Default template for feed displays that use the RSS style.
views-view-summary-unformatted.tpl.php theme/views-view-summary-unformatted.tpl.php Default simple view template to display a group of summary lines.
views-view-summary.tpl.php theme/views-view-summary.tpl.php Default simple view template to display a list of summary lines.
views-view-table.tpl.php theme/views-view-table.tpl.php Template to display a view as a table.
views-view-unformatted.tpl.php theme/views-view-unformatted.tpl.php Default simple view template to display a list of rows.
views-view.tpl.php theme/views-view.tpl.php Main view template.