A list of news story teasers.
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.
Last reviewed: September 21, 2021
This component has two initial tabs: News List and List. An additional tab appears after the Build list using option is chosen. Stories are shown as 'teasers,' including thumbnail images when available.
Split long lists onto several pages.
Lists with more than 500 teasers will generate a server error and not show any results. More details are in this Known Issue.
Show 'See all' button: Checking this box will create a button in the lower right corner of the list. Clicking the button will display the full list of news items.
'See All' button text: Customize the button text.
Use larger image for first article: Check this button to display a larger image for the top article of the news list. An image will only display if there is one associated with the news item listed.
The 'Full list page' also acts as a 'Host page' path, regardless if the 'See All' button is enabled.
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:
Be careful not to list the parent page here by mistake.
> It can create a loop (Known Issue).
Host Page: (where applicable) Set the preferred page to display your list items. If blank, the current page will be used.
New window: Select so each clicked page is displayed in a new browser window.
When New Window is selected, an additional icon will follow the linked text, to alert visitors that they will be taken to a new browser window, or even leave the current website.
And if the hyperlink goes to a downloadable file, a document icon will instead be shown as well as the file size if the file is on the same server. (Read more about link labels.)
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.
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.
Limit: Choose a maximum number of entries (optional).
If you want all items to appear in the list, do not leave the Limit field blank. Instead, enter a value that you anticipate will meet your needs; for example, 200, 500, etc. (The News Center has used 9999 as a 'very large number' because their archives date to 1990.)
Paginate after: This setting turns on paginated returns, with the maximum number chosen displayed for each page (optional).
Exclude current page: Do not display any entries that link to the page on which the list is shown (optional).
Enable Scheduling: Select to enable shared content Scheduling.
Empty Message: Choose a suitable message that will display if the list is currently empty. (In the example shown above, it will say "Sorry, there is no news today.")
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.
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.
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:
Please note, special characters (e.g. "&", "|", "-") are not permitted in a search query and are automatically removed.
You can also use the search option to list tagged pages. And the above logical operators allow fairly advanced logic for tagged pages that is not possible using other tools.
Official university news stories are already available for use on UBCMS sites as one big collection, split into major topics, as well as collections for each decanal area. This shared content is easily pulled into a News List.
> More on UB News feeds