Build a shared content page that works well with the carousels and slide decks as a bridge page to other content.
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.
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.
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:
Be careful not to list the parent page here by mistake--it can create a loop.
> read more in this Known Issue: Do Not Link to a Child's Parent Page in a List
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 window.
'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: There are several ways in which you can order your list:
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.)
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.")
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).
April 3, 2019