Vertical content lists
What is a vertical content list?
Vertical content lists are used to automatically list node pages, such as projects or articles, on panel pages. Pages can be displayed in a variety of ways.
Use vertical content lists when:
- you want to automatically list pages of a particular type on a panel page in date or alphabetic order.
Vertical content lists shouldn't be used when:
- you want to curate which items are displayed or set a specific order
- you want to list content from another site
- you want to list panel pages.
How to create a vertical content list
Vertical content lists can be created by:
- site builders.
Use the in-place editor to create a vertical content list:
- Click 'Customize this page' in the black Drupal menu at the bottom of the page, and then click the plus icon (+) in the blue box at the top of the page.
- Select 'View panes' from the side menu. You can then filter items in the list by typing 'vertical' into the 'Quick filter' box.
- Select your desired display option.
- If you want to filter your list using a taxonomy term, enter a taxonomy term ID in the 'Content: Has taxonomy term ID (with depth)' field.
- If more than 10 items will be displayed in your list, tick the 'Use pager' box.
- Enter the number of items you want to display in your list in the 'Num items' field.
- Select the content types you want to display in the list. Hold down 'Ctrl' on your keyboard and click to select multiple content types.
- Select a sorting option from the 'Sort by' drop-down menu.
- Click 'Finish' to add the vertical content list to the panel page.
- Apply a section style to the panel to finalise the layout.
- Click 'Save' in the black Drupal menu at the bottom of the page to publish the changes.
How to edit a vertical content list
Vertical content lists can be edited by:
- editors
- site coordinators
- site builders.
To edit a vertical content list, follow the instructions for editing panels on panel pages.
Display options
There are several display options for vertical content lists. Each option uses a different view mode to display your content:
- Vertical content list: Card displays content using cards.
- Vertical content list: Card compact displays content using compact cards.
- Vertical content list: Card Horizontal displays content using horizontal cards.
- Vertical content list: Compact displays content in a vertical list using small teaser images.
- Vertical content list: Teaser displays content in a vertical list using larger teaser images.
- Vertical content list: Teaser 2 Column displays content in two vertical columns using larger teaser images.
Best practice
- Use taxonomy terms to group articles and events into related categories. You can then use the taxonomy term ID to control which items appear in your vertical content lists.
- Limit lists to 6 or 9 items per page when using Card or Card compact displays.
- Limit lists to 1 item when using the Card Horizontal display.
Fields
Complete all required fields and as many optional fields as possible to provide the best user experience.
All display options except Vertical content list: Card Horizontal
Field name | Required field? | Notes |
---|---|---|
Content: Has taxonomy term ID (with depth) | No | Filters pages using the specified taxonomy term ID number. |
Use pager | No | If more than the 'Num items' value are included in your list, ticking this box displays pagination to access additional pages. Pagination can be configured using the following options:
|
Pager ID | No | Default pagination page to display when the page loads. |
Num items | No | Determines the number of pages that will appear in your list. Default option is 9 or 10 items, depending on the display option selected. |
Offset | No | Skips a defined number of pages before selecting the first page that will be displayed in the list. Default option is 0. |
Type | No | Determines the type of content that will be displayed. |
Sort by | No | Displays pages by title, date or surname. |
Order | No | Displays the pages in your list in ascending or descending order |
Vertical content list: Card Horizontal
Field name | Required? | Notes |
---|---|---|
Content: Has taxonomy term ID (with depth) | No | Filters pages using the specified taxonomy term ID number. |
Offset | No | Skips a defined number of pages before selecting the first page that will be displayed in the list. Default option is 0. |
Type | No | Determines the type of content that will be displayed. |
Sort by | No | Displays pages by title, date or surname. |
Order | No | Displays the pages in your list in ascending or descending order |