Version:

Acquia Cohesion renames to Site Studio from version 6.2. Tell me more.

    Creating view templates

    You can create templates for Drupal views using the Layout builder. Technically, a template is a View format.

    Before you create your view template: View templates provide the structure for your View page or Block and use View modes to display each result. For example, you may choose to show each result using the Teaser view mode. For this reason, before you create your View template, you should create a template for the View mode you intend to use within your View. View mode templates are created within Content templates.

    Create a view template

    Step 1 - Create a template

    The first step is to create your View template format without any layout. Don't worry about layout for now, you'll add that later. 

    To create a View template:

    1. Navigate to Site Studio > Templates > View templates
    2. Click Add views template
    3. Enter a name in the title field
    4. Click Save and continue.

    Step 2 - Create your view

    The second step is to create your View and select your View template (created in step 1) as the View format:

    To create your View:

    1. Navigate to Structure > Views > Add new view
    2. Enter a name in the View name field
    3. In View settings area select a Content type in the 'of type' drop-down
    4. In page settings, tick the Create a page checkbox. Make a note of the Path as this is the URL of your View page (www.mydomain.com/path)
    5. Within Page display settings select View template in the Display format drop-down
    6. Leave the rest of the settings as they are and click Save and edit
    7. You have now created your View page which uses your View template.

    Step 3 - Layout your view template

    In Step 1, you created a View template so that it could be selected within your View in Step 2. Now you can layout your View template using the Layout builder.

    To layout your View template:

    1. Navigate to Site Studio > Templates > View templates
    2. Click Edit against the View template you created in Step 1
    3. Click on the +plus button on the Layout canvas to open the Sidebar browser
    4. In the Sidebar browser, locate the group of Elements called View elements
    5. Layout your View template by adding the View elements in the following pattern. 
      1. Add the View container element to the Layout canvas. This is required by the View template but requires no configuration
      2. Add the View content element inside the View container element. This is required by the View template to separate the content of the view (the results) from the pagination and filters. It requires no configuration
      3. Add the Pattern repeater element inside the View content element. This allows for repeating patterns within the View results. For more information, see Pattern repeater element
      4. Add a View item inside the Pattern repeater element. This is the individual result from the view query. For more information, see View item element
      5. Add the Pagination element inside the View container element. This must be outside the View content element. For more information, see Pattern repeater element
      6. Add the Filters element inside the View container element. This must be outside the View content element. For more information, see Filters element
    6. Configure the settings of each of the View elements within your layout. For more information about each element and it's settings, see View elements
    7. Click Save and continue.

    The diagram below shows how the View elements must be nested within each other.

    Preview your view

    Now that you've created both your View and your View template, you can preview it by going to your View URL. If you don't know what this is, edit your View and then look for the Path under Page settings. Note: You must have populated some nodes for your View to display them.

    Using other elements within your view template layout

    You can use other content and layout elements in your View template to provide additional layout and content. The important factor is that the View elements are nested within each other in the correct order. The screenshot below shows how the View elements can be used together with other content and layout elements to create a complete template for your View page or block.

    DX8 knowledge base icon

    Frequently asked questions

    Get instant answers to common questions. Available online 24/7.

    Find answers

    Raise a ticket icon

    Raise a support ticket

    To raise a ticket, sign into Acquia Cloud and select Help in the top menu.

    Raise support ticket

    Acquia

    Copyright © 2020 Acquia, Inc. All Rights Reserved. Drupal is a registered trademark of Dries Buytaert.