_1@2x.png)
Overriding GravityView templates
How to use your own template files
- In your theme, create a
/gravityview/directory - Find the template file you want to modify. They're located in the
[yoursite.com]/wp-content/plugins/gravityview/templates/directory. - Copy the file and its folder structure to your theme's
/gravityview/directory - That file will now be used instead of the GravityView file!
Template override example:
You want to modify the list-header.php file. Instead of editing the GravityView plugin, you should copy the template file to your theme so that it doesn't get overwritten when GravityView is updated.
First, create a file in your theme's directory like so:
[yoursite.com]/wp-content/themes/[yourtheme]/gravityview/templates/views/list/
Then copy the file you wish to modify, in this case list-header.php
- From the GravityView directory:
[yoursite.com]/wp-content/plugins/gravityview/templates/views/list/list-header.php - To your theme's
gravityviewdirectory:[yoursite.com]/wp-content/themes/[yourtheme]/gravityview/templates/views/list/list-header.php
The same goes for overriding field display
If you want to change how the Gravity Forms List field type is displayed
- Copy from the GravityView directory:
[yoursite.com]/wp-content/plugins/gravityview/templates/fields/field-list-html.php - Paste to the
/gravityview/fields/sub-directory in your theme:[yoursite.com]/wp-content/themes/[yourtheme]/gravityview/templates/fields/field-list-html.php
Template File Hierarchy
GravityView has the ability to override templates based on the View ID, the connected Gravity Forms Form ID, the ID of the page that a View is embedded on (if using the shortcode).
view-[View ID]-table-footer.phpform-[Form ID]-table-footer.phppage-[ID of post or page where view is embedded]-table-footer.phptable-footer.php
For example, if you wanted to override the layout for the single entry view using the Table layout, you would use table-single.php.
If you want to override how it looks for a View with ID 46, you would create a file named view-46-table-single.php. The final path would be [yoursite.com]/wp-content/themes/[yourtheme]/gravityview/view-46-table-single.php.
The same applies for widgets (using widget IDs) and fields (see "overriding field display" above). Want a different layout for your List fields? view-46-single.php
Overriding the page template
You can override the page template used to display GravityView Views by creating a single-gravityview.php template file. This is useful, for example, if you want GravityView Views to be displayed without sidebars, or without a menu bar.
GravityView Views are "Custom Post Types" with a slug of gravityview. You can override how your theme displays single GravityView Views by creating a single-gravityview.php template file. Duplicate the post.php or page.php file in your template directory, rename it single-gravityview.php and start modifying!