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
File
- modules/
views/ templates/ views.theme.inc, line 1211 - Preprocessors and helper functions to make theme development easier.
Files
Name |
Location | Description |
|---|---|---|
| views-exposed-form.tpl.php |
modules/ |
This template handles the layout of the views exposed filter form. |
| views-more.tpl.php |
modules/ |
Theme the more link. |
| views-view-fields.tpl.php |
modules/ |
Default simple view template to all the fields as a row. |
| views-view-grid.tpl.php |
modules/ |
Default view template to display a rows in a grid. |
| views-view-list.tpl.php |
modules/ |
Default simple view template to display a list of rows. |
| views-view--promoted.tpl.php |
modules/ |
Main view template. |
| views-view-row-comment.tpl.php |
modules/ |
Default simple view template to display a single comment. |
| views-view-row-rss.tpl.php |
modules/ |
Default view template to display a item in an RSS feed. |
| views-view-rss.tpl.php |
modules/ |
Default template for feed displays that use the RSS style. |
| views-view-summary.tpl.php |
modules/ |
Default simple view template to display a list of summary lines. |
| views-view-summary-unformatted.tpl.php |
modules/ |
Default simple view template to display a group of summary lines. |
| views-view-table.tpl.php |
modules/ |
Template to display a view as a table. |
| views-view.tpl.php |
modules/ |
Main view template. |
| views-view-unformatted.tpl.php |
modules/ |
Default simple view template to display a list of rows. |