List Builder Component

Here you will choose the type of list, as well as additional advanced settings.

Build list using: This drop-down menu asks how you want to build your list. You have the option to build it using:

• Curated list: Build a list with selected choices. Requires you to manually add pages to the list (and maintain).
  • A Curated List tab will automatically appear. Click the magnifying glass icons to select Web pages to be displayed.
  • Use the Up and Down buttons to specify the order that the web pages will be displayed in the list. The minus (-) buttons allow you to delete web pages while the + button enables you to add Web pages.
• Child pages: Populate the content of the list with the pages found in a segment of a website.
  • A Child Pages tab will automatically appear. Click the magnifying glass icon to the right of the Parent Page field to select a folder from which to display pages in your list. (If you build your list with child pages you do not have the option of displaying them in the order of your choice.)
  • Lists built by child pages can show their references in their natural order from the file tree (e.g. Order by {blank} and Order by cq:template).
• Tags: Build a list using the tag words assigned to certain pages. (Read more about Tagging Your Shared Content.)
  
  • A Tags tab will automatically appear. In the Tags field, type the tags you would like to use or select the tags from a drop-down menu by clicking on the downward arrow sign to the right of the field.
    • In the Limit to path field, choose the scope of the list by selecting the page, and subsequent child pages, to which you wish to limit the list. Leave this field blank to populate the list using the content of your entire UBCMS. Web pages with tags matching your selections will then be displayed in your list.
    • Be advised, items in lists built using tags are not sorted in the normal default order even if they all originate in one folder. If you want the items to appear in a specific order, specify that in the Order by field.
  • Tagged pages can also be listed using the Search option, which allows more advanced control. See Tips for building a list 'Build by Search' query.)
  • Lists built by tags cannot show their references in their natural order from the file tree (e.g. Order by {blank} and Order by cq:template).
    

• Search: Use a particular word or phrase to build a list. Any page that contains the searched-for term will be included in the list. Meta-data including tags can also be found in this way -- read more about searching for tagged pages.
  
  • Search query: Enter a predetermined unique keyword or phrase; e.g. "ubgreen-event" in our example.
    This is optional, but with no keyword you will display ALL events in the calendar. More complex queries are possible. (See Tips for building a list 'Build by Search' query.)
  • Start in: Click the magnifying glass icon to choose where to focus the search. Child pages but not the selected parent will be included. Leave blank to use the current page.
  • Lists built by search cannot show their references in their natural order from the file tree (e.g. Order by {blank} and Order by cq:template).
• Another list: Populate your list using another previously created list. This is useful if you want to exactly mirror items displayed on another page, while perhaps limiting the amount of items displayed or changing other display settings.
  • An Another List tab will automatically appear.
    
  • A chooser is provided to select the page from which to pull your list, but currently does not allow you to select the actual list. Contact the DCT Help Team if you need assistance establishing the full reference path.
• Advanced search: Do not choose Advanced Search unless you are familiar with writing queries. Build a list using Java API and REST API. Advanced search accepts a query description, and creates and runs an XPath query.
  
  • An Advanced Search tab will automatically appear.
    
  • If desired, the XPath query will filter the result set and extract facets.
  • Query descriptions are made up from a set of predicates.
  • For each predicate type, there is an evaluator component that handles that specific predicate for XPath, filtering and facet extraction.
  • The REST API provides access to these features through HTTP with responses sent in JSON.
  • Lists built by advanced search cannot show their references in their natural order from the file tree (e.g. Order by {blank} and Order by cq:template).

New window: Select so each clicked page is displayed in a new browser tab. When selected, an additional icon will follow the linked text on your published page, to alert visitors they are about to be taken to a new browser tab, and possibly leave the current website.

Note: For accessibility reasons, be careful about sending your visitor to a new tab. This behavior may be unexpected and disortienting. (> Learn more about link accessibility.)

Display as: This drop-down menu asks how you would like your list to be displayed. Lists fall into the general categories of Links, Teasers and Content:

• Links - Display the pages in the list as underlined links. Clicking on one of the links will redirect the user to the page selected. The types of links available are:
  • Plain (default): If no other option is selected, the list will automatically be displayed as a set of plain links. They are bulleted with the right angle bracket (>) symbol.
  • Medium Call to Action: The links are bulleted with the Call to Action component’s circular, exclamatory icon (medium size).
  • Large Call to Action: The links are bulleted with the Call to Action component’s circular, exclamatory icon (large size).
    
  • Compact: The links are shown in a simple comma-separated list.
    
  • Grouped by Date: The un-bulleted list will be displayed with emphasis on the separate entries' time of creation. The date appears as the heading for each entry while the exact time of the page's creation and the link to the page are placed beneath.
  • Grouped by Title: Links are grouped alphabetically by the first letter of their titles and that letter precedes each group; e.g.
    T
    > Terminator
    > Trains, Planes and Automobiles

• News (with dates): This option also displays an un-bulleted list with the date of creation. A simpler format than Links: Grouped by Date, the title of each entry is followed by the date of creation all on a single line.
• Teasers - Display a preview of the information that's on the pages from your list. The types of teasers available are:
  • With Images: Instead of bullets, an image from each page appears to the left of the page’s title. The introductory text of each page is displayed beneath the title. (If no image is available, space will be left to ensure all teasers stay aligned.)
    
  • Without Images: Displays the title of the page with its introductory paragraph. Items are bulleted with the Call to Action component’s circular, exclamatory icon (large size).
  • With Dates: Instead of bullets, an image from each page appears to the left of each page’s title and its date of creation. The page’s introductory paragraph appears below.
  • Grid: Displays the list as a gallery of images. Each page is represented by an image with its name beneath the picture as the link.
  • Directory (with interests): Meant to be used with the Faculty Profile Template, it reveals each person's name, contact details, titles, and research interests.
• Content:
  
  • Full Content Displays the full content of each page in the list.

Order by: Here are some of the ways in which you can order your list. Not all appear in the dropdown. Others may be available on request -- contact the DCT Help Team for details.

Note: Generally it is best to provide a value for this setting. When left blank, the results will obey the natural arrangement of the pages in their parent folder(s), but if the list is set up as a search or advanced search query, results will display by search relevance, and if the list is built by tags, the display order will be unpredictable.

• cq:lastModified: Results displayed chronologically by page last modification date, with the page most recently edited on top.
• cq:template: The order will be established according to its arrangement in the Page Tree, sorted by template type used on each page. (This natural order is not compatible with lists built by tags, search, or advanced search.)
  
• jcr:created: Results displayed chronologically by page creation date, with the earliest created page on top. The results can be confusing because the order in Author will often not match that on the live site. The order of live pages is by first activation date, not original creation date in Author. Subsequent reactivations have no impact, but a page that is deactivated and then reactivated will receive that latest activation date.
  
• jcr:path: Results displayed alphabetically by each page's full path in the UBCMS (/content/www/abs/page-name). For pages all in the same folder, it effectively alphabetizes by page name.
• jcr:title: Results displayed alphabetically by page title.
• navTitle: Results displayed alphabetically by each page's Navigation Title (as set in Page Properties).
• postDate: Results displayed chronologically. For News Article Template pages, this will be by date created. For pages created with other templates, each page must have a Date Created component. If not all pages have a compatible date, the display order will be unpredictable.
• random: Each time someone views the page, the displayed items will be shuffled. (Learn how the UBCMS handles random.)

Note to developers: some additional attributes are available on Author but not your live pages, so cannot be used, e.g. lastReplicated.

Reverse order - Check the box to select whether you would like to inverse the order selected in the Order by field.