Menu element
A menu element displays metadata and content from content items that match the search criteria of the menu element. The search criteria of a menu element can include matching site areas, authoring templates, categories and keywords. We can only use a menu element by creating a menu component. We cannot add a menu element to authoring templates, site areas or content items.
Menu search options
Menu element search options are defined in the Menu Component Query section of the menu element form. These search options define which content items from the site will be displayed in the menu element. Search options can include a combination of search parameters including searches based on authoring templates, categories and site areas.
Menus can search for the following in a website:
- Content with matching authoring templates
- Content with matching site areas
- Content with matching categories
- Content with matching keywords
Between different criteria, menu searches are "and" searches, but within each search criteria, menu searches are "or" searches. For example, a menu element that searches for two different categories and an authoring template will display content items profiled with at least one of each profile type. Content that matches only one profile type are not displayed.
Menus will not display search results if we select a search criteria but do not enter any search parameters. For example, if the menu is configured to display results based on categories, but no categories are specified in the menu form, then no matches are displayed.
Menu sorting options
We can sort menu search results according to following criteria:
- Content document name
- Content document description
- Published date
- Expired date
- General date one
- General date two
- Last modified date
We can select a maximum of three sort options.
Menu paging options
WCM provides flexible paging options to enable you to display search results are generated by the menu element.
- We can specify the number of results displayed in a menu page. For example, a menu defined to show five results per page would display only five records from the set of search results.
- We can indicate where in the results set to begin showing results by specifying which menu page to use as a starting point. As an example, if we are displaying five results per menu page and to show records 6–10, you would start showing search results with the second menu page instead of the first.
- To provide easier navigation of the search results in a menu, we can include a page navigation element in the header or the footer of the menu element. The page navigation element enables stepping forward or backward through multiple menu pages without the need for creating multiple menu elements to display the different pages.
- A large number of search results can cause a delay when the menu element is initially rendered. To prevent this delay, we can limit the maximum number of pages of results that are included in the menu. To further improve the efficiency of the menu, we can also specify how many pages of results should be read beyond the current page, so that paging performance is not affected by rebuilding the menu.
While a page navigation element is a convenient way of displaying and navigating a menu's search results, we can use the menu's paging options to display search results in other ways. For example, if you wanted to show the results in a 3-column table, we could create three menu elements with the same search criteria and then tailor the paging options of each menu to display different result sets:
Menu Results per page Start page Records displayed Menu element 1: 5 1 1 to 5 Menu element 2: 5 2 6 to 10 Menu element 3: 5 3 11 to 15 The three menus could then be referenced within three different cells of a table row in a presentation template.
Parent: Use a menu element
Next topic: Menu element design examplesRelated: Use a menu element