Search, landing pages and tag clouds in conjunction with other Dynamic List components.
This feature works comparably in both the Classic and Flex UI versions of the UBCMS. In the future, screenshots and language will be updated to reflect Flex UI.
This is one of a series of Dynamic List components that are designed to work together, centering on the Dynamic List Builder.
It is always required for a dynamic list; the other optional elements are listed in Related Components (right sidebar).
Last reviewed: September 21, 2021
Dynamic Lists are user-centric in the sense that the content is prepared on-the-fly based on user actions (e.g. a search query or a link that is clicked), and does not need to be previously prepared as standard UBCMS pages.
For example, a link to 'see more on this topic' could drive a tagged search. And this list of topic links can be generated automatically. For example, a standard looking search could evolve into a faceted search with successive layers of filters as selected by the user.
A course catalog search "anthropology" could then allow choice between the semester of availability, time offered, online versus classroom setting, etc., and individual filters can readily be removed if they are no longer desirable. All of this functionality and content can be delivered automatically.
This component has only one tab.
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.
Tag filter - Select one or more tags to limit the pages that are returned. All tags must be matched for a page to be included.
Limit / Page size - Set a maximum number of items to display. (It is possible to set up pagination when this is used in conjunction with the Dynamic List Pager.)
Start at - Select how many items you would like to skip at the beginning of the list (example: '5' will skip the first four items and begin the list at the fifth item). Left blank, the default value of '1' will result in the list displaying every item in your list. This setting can be useful if you wish to feature several items in one group, perhaps at the top of your news page, or on your homepage, and NOT have them repeated with the rest of your list displayed elsewhere on your site.
Title - Add a descriptive title as a user hint. It is only displayed when the list first appears (e.g. "Matching Titles," or "Search results").
Empty text - Choose a suitable message that will display if the list is currently empty. (By default it will say "No matching pages.")
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:
New window - Select so each clicked page is displayed in a new browser window.
Require query - Choose between:
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.
Reverse order - Check the box to select whether you would like to inverse the order selected in the Order by field.
Primary - If there are several of these components on this page, the one marked primary will be selected by dynamic list components on other pages.
Host page - Specify on what page of your site you would like any shared content shown. By default will be the current page.
Alternative text ('Alt text') is a best practice for all your UBCMS images and is often required for accessibility so screen readers can tell visually disabled users what they are not seeing.
Images displayed as teasers in lists require Alt text. Normally this is supplied in the original listed pages, often in shared content, and in some cases, in the metadata of the referenced images in Assets.
Best practice, Alt text should be added whenever an image is uploaded into Assets.
To avoid confusion, every unique link on a page must have unique link text. It is not hard to compose comprehensive text for manually coded links, but links that are generated automatically by lists and carousels must also be different, which takes more planning.
Also consider Call to Action, Button, and Tabs components, as well as the pagination and "see all" links in the Event and News List components which may have the same labels and appear more than once on a page. (Some of these have additional label settings that can help prevent this redundancy.)
Best practice: when creating shared content pages that will be used in lists, use distinct titles, or set the Navigation Title in the page Properties so none of your pages have the same title if they are displayed together. Also take advantage of additional label settings in other components when you will have several on a page.
Links in many components can be set to open in a new browser window (or tab). The user can thus explore the new page, while preserving the source page (and your website) in the original tab. However, this can be confusing if the user does not realize a new tab has opened. They may become lost, confused how they arrived on that new page and unable to return to your site.
Best practice: let the user control their experience and stay in the same tab, with two notable exceptions: