Dynamic web content page selection
The web content viewer provides a link broadcasting feature that leverages the content mappings on a web content page to dynamically look up the best matching web content page to render the linked content item.
When the web content viewer is configured to use the Dynamically select a web content page link broadcasting option and a user selects a link to a content item, several tests are performed to determine which web content page should be used to render the selected item. The same mechanism is used when previewing web content on web content pages or when selecting search results produced from the search seedlist 1.0 feature.
- An ordered list with all parent site areas of the selected content item is created. If the selected item itself is a site area, it is part of that list. The order in the list matches the order in the Web Content Manager content hierarchy with the topmost parent being the last item in the list and the direct parent of the selected item (or the item itself) being the first item.
- Based on this ordered list, a lookup is performed to find the web content page that the current user has view access to and that is mapped to the first site areas for which a page content mapping exists. If the content mappings indicate that multiple pages map equally well, the web content viewer selects a single page using the following rules:
- If the current page is among the pages found, the current page takes precedence over the other results.
- If one of the pages indicated by the content mappings is the default content mapping for the page, that page takes precedence over the other results.
- If the previous rules do not identify a page, a page is selected arbitrarily from the set of found pages.
- If a web content page can be determined in the previous test, the selected content item is rendered on this page.
- If no page can be identified by the content mappings, the web content fallback page is used to render the content item.
- If no fallback page is configured or if the user does not have view rights on the fallback page, the Web Content Manager servlet is used to render the item.
To render a content item, the dynamically selected target page needs to contain at least one web content viewer that has been configured to receive links from other portlets. You can develop custom solutions to extend or change the web content page selection process with the Web Content Manager Java API.
Related tasks
Set up a Web content fallback page