List listing

User level: Site Owner; Site Administrator; Site Author; Site Editor; Site Contributor

 

list listing editing screen

[1] Title and Link

widget title and link configuration

Title (optional): input a widget title

Link (optional): create a link to appear at the top-right of the widget

  • Title: provides the link text
  • URL: internal URLs should be inputted using the alias of the page to be linked to, in the format: '/page-alias'; external URLs should be inputted using the full URL, including 'https://'
  • 'Open URL in a New Window' checkbox: when set, clicking the link opens the URL in a new browser tab

[2] Content source selection

Content filtering allows Grid listing, List listing, Carousel, and Slideshow advanced widgets to automatically display items based on content type and subtype, associated taxonomy terms, or a combination of these.

filtered content source - content type selected

(1) Filter by content type: Pages belonging to the selected content type will be displayed in the listing

(2) Filter by content sub-type (visible once content type is selected): Pages belonging to the selected content subtype will be displayed in the listing

(3) Taxonomies associated with the selected content type: Pages with the selected taxonomy terms associated with them will be displayed in the listing

(4) Choose to display taxonomy filters to end users: Taxonomy filters can be displayed to end users (e.g. below), for them to use the listed pages' associated taxonomy terms to filter for topics of interest

taxonomy filters example

Output on a Mosaic site: Taxonomy filters displayed above a Grid listing

Sorting options

The order of items displayed in widgets using the Filtered content source can be managed using the Sorting options.

sorting options

Sorting options for Filtered content

Default sort order and displaying sort order to end users

Default sort order sorts the items in the widget alphanumerically according to: page title (for Page content); publication date (for Article content); event date (for Event content); sort name (for Person content).

The 'Display to end user' checkbox controls the display of a dropdown filter to users. When enabled, the filter can be used to toggle the default sort order between ascending and descending order.

display sort order to end user filter

Output on a Mosaic site: Default sort order displayed to end user

Sorting by custom taxonomy

If taxonomy terms are applied to content listed in the widget, the order of these terms within the taxonomy can be used to determine the order of items listed in the widget. This allows for custom taxonomies to be created for the purpose of ordering the items in listings.

Example of sorting by custom taxonomy

In the Grid listing below, the listing items represent page content and are sorted by the default sort order (alphanumerically by page title). By using custom taxonomy sorting, it's possible to sort the items chronologically.

Example of default sort order being used on a Grid listing

Output on a Mosaic site: Grid listing sorted by default order (page title)

The website this Gird listing belongs to has a custom taxonomy named 'Period', whose terms are date ranges, laid out in a custom order:

'period' custom taxonomy terms

Example custom taxonomy terms: 'Period' taxonomy terms arranged in a customised order

Each of the pages respresented in the Grid listing is tagged with one term from the 'Period' taxonomy.

By selecting the Custom taxonomy sort option, the items in the Grid listing is ordered according the order of the terms in the 'Period' taxonomy:

Grid listing sorted according to order of terms in custom taxonomy

Output on a Mosaic site: Grid listing sorted by custom taxonomy

Note about using custom taxonomy sorting

If a listing has been sorted using a custom taxonomy and the listing contains a page which does not have terms from the sorting custom taxonomy associated with it, the listing item for this page will appear at the beginning of the listing, to make it visible to content editors.

Pages on the website can handpicked to appear in a listing using the Selected content source.

List pages using Selected content

  • type the title of the page you want to list into the text input field
    selected content input field
  • the autocomplete process will display all pages matching the input text in a dropdown list
    selected content input example
  • select the appropriate page from the list
  • to add another page to the listing, click 'Add another item' to create a new text input field

Distinguish between duplicate page titles

Note that page titles are displayed in the dropdown list followed by their respective node IDs (in parentheses). Pages with the same title can be distinguished by referring to their node IDs. To find a page's node ID:

  • go to Manage Content > Content tab
  • use the Title text field to filter for the page title
  • hover over the 'Edit' button for the page (1)
    finding a page's node ID
  • in the bottom-left corner of the browser window the link to the editing area for the page will appear. This contains the text 'node/[number]' (2). The [number] element is the page's node ID

Reorder the listed pages

To reorder pages that have been added to the listing:

  • use the multidirectional arrow within the listing item to drag-and-drop it into a new position in the listing order:
    reordering selected content items

Content to come

Content to come

[3] Widget layout

Content to come

Content to come

list listing margin settings

Margins

When margins are applied to widgets, a space of 32px appears above/below the widget.

Top margin: Add/remove top margin on the widget

Bottom margin: Add/remove bottom margin on the widget.

Width

Three widget widths exist in Mosaic. Not all width settings are available to each widget.

Narrow width

Available to: WYSIWYG

The widget content is displayed at 66.67% width of the page region containing the widget.

Standard width

Available to: All widgets

The widget content is displayed at 100% width of the page region containing the widget.

Full width

Available to: All widgets

Full width displays widgets at 100% width of the page content area.

Full width settings include augmented styles for some widgets, e.g. Full width for Carousel widgets includes 'peeking' (the edges of Carousel items adjacent to the currently viewed items are visible).

List of site pages