Build a shared content page that works well with the carousels and slide decks as a bridge page to other content.
Last reviewed: October 11, 2022
State and federal rules require most images to be ADA compliant, with meaningful 'alt text.' > read more on accessible images
Normally you would use a Highlight Template page as a handy bridge page leading to a richer source of content. You are essentially building a teaser, with an automatic link to that other page. This page was developed to work well in our carousel and slide deck components.
Navigate to your shared content area (e.g. /content/shared/www/your-site/) and click New, then select this template.
The page you create will appear with two stacked components and a bottom area that displays any tags that have been associated with the page.
In order for any piece of shared content to function properly, there should not be any blank elements or incomplete links in the page (i.e., a photo component without a photo in it or an incorrect link).
Do not be alarmed if the Sidekick looks empty. This page does not allow any additional components to be added.
The stacked components are very similar to the Sidebar Flex Module.
Heading - Enter a descriptive title for the page that will be displayed in its published teaser.
Primary Link - Add a URL that will be applied to the heading and image.
Alt Text - Add a description of the image for users who may have difficulty seeing it. (Alt text is required by New York State policy for most images.) See webaim.org for tips on writing alt text.
Alt Text is generally required under state and federal accessibility laws. Read more about Alternative Text.
This will show in the published teaser for this page.
The image allows for use of the Adaptive Crop tool.
The tool approximates how your original image will be cropped for desktop, mobile and teaser (thumbnail) views, allowing adjustments to better represent your desired focus in these contexts.
The interface responds to the main Image Size setting. Set the Image Size, then drag the Adaptive Crop cross-hairs to the center of your desired focus, and adjust the three sliders as desired to highlight the three zones.
The interface approximates the final displays. After you make your adjustments, we suggest you preview the results (e.g. using the mobile device emulator). And if you realize the List thumbnail is not working out as desired, consider also loading an image into page Properties that is cropped exactly as desired, where it will be used preferentially for teasers.
It includes a Rich Text Editor that supports basic formatting (bold, italics and bullets) as well as hyperlinks.
Pre-formatted text can be pasted in from other sources (e.g. a word processor). This allows inclusion of additional text formatting such as sub- and super-script, but any incompatibly formatted text will be suppressed (e.g. titles or images).
Add the URL for a YouTube video.
This second component is the standard List Builder.
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:
Do not link to DAM assets using a relative path (/content/dam/...). For these you must use a File Download component. > read more about this Known Issue: Having Trouble Linking Downloadable Files in the DAM
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.)
'Open links in new window' and 'Display as: Full content' are incompatible and will disable each other when selected.
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, an 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.)
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:
'Display as: Full content' and 'Open links in new window' are incompatible and will disable each other when selected.
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.
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.
Using server caching, 'random' content is shuffled to appear fresh for each visitor, but the entire original content collection is not redrawn each time it is presented. Instead, the server randomly pulls a sample of the original content after each cache refresh, and then shuffles that sample for your visitors. If you need to show the entire collection, take advantage of the 'show all' feature when it is available, and if your business needs require a truly random reassortment, please contact the DCT Help Team.
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.)
Mobile limit: Maximum number of items to be displayed on a small screen device.
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.
Host page: Specify on what page of your site you would like any shared content shown. By default will be the current page.
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.")