Contextual linking
Overview
Contextual linking is when content from one site is shared across multiple sites.
Contextual linking is used so that when content is linked from another site, the link will be rendered relative to the current site if possible.
Embedded links such as...
- link elements
- links in HTML
...will reference the site in which the content item is located.
Contextual content linking
Contextual content linking attempts to resolve links by searching for content links and is applied using the element tag.
For example:
<Element type="content" context="current" key="body" link="contextual" />
Contextual content linking can only be used if context=current or context=autofill.
When contextual content linking is used:
- For links to Content:
- A content link for the same content item in the current library is looked for.
- If none are found, an item on the same relative path is looked for.
- For links to Content Links, Site Areas, Sites Try an item on the same relative path is looked for.
Contextual path linking
Contextual path linking will attempt to resolve a link using a relative path technique. Contextual path linking assumes that each site framework that the linked content is stored in has the same site structure. Contextual path linking can be applied to elements referenced using the element tag.
For example:
<Element type="content" context="current" key="body" link="path" />
Contextual content linking can only be used if context=current or context=autofill.
When contextual path linking is used a compatible link is searched for using the same relative path. If no link is found, a link using a similar path higher up in the site framework is searched for.
Setting up the Missed Absolute Path Cache
To improve the performance of contextual linking you can enable a Missed Absolute Path Cache. The Missed Absolute Path Cache functionality requires a dynamic object cache to be setup in WAS before it can be utilized.
Non-clustered environment
- Login to the WebSphere Administrative console for your server.
- Go to Resources tree > Cache Instances .
- Click Object cache instances.
- In the scope section, select the node on which your server is located and then select the server on which the cache is to be set up.
- Click Apply to save your choices.
- Click New to create a new cache.
- Enter missedabspath in the Name field and services/cache/iwk/missed in the JNDI name field. These values are used to lookup the cache and use it. Leave all other fields set to their default values.
- Click OK at the bottom of the form and then Save.
- To enable the cache for your Web content, edit WCMConfigService.properties and ensure missed_absPath.cache.enable=true .
The WCMConfigService.properties file is located in the PROFILE_HOME/PortalServer/wcm/config/ directory.
Restart WebSphere Portal to enable any configuration changes made to this file.
Cluster
- Login to the WebSphere Administrative console for your server.
- Go to Resources > Cache Instances > Object cache instances .
- Click the Browse Clusters button and choose the cluster that you want to create the cache for.
- Click Apply to save your choices.
- Click New to create a new cache.
- Enter missedabspath in the Name field and services/cache/iwk/missed in the JNDI name field. These values are used to lookup the cache and use it. Leave all other fields set to their default values.
- Select Enable Cache Replication.
- Go to the Full group replication domain drop-down box and select the name of the cluster you want to cache.
- Select Choose Push-Only from the Replication type drop down box.
- Enter 1 in the Push Frequency field. Leave all other fields set to their default values.
- Click OK and then Save > Save > OK.
- To enable the cache for your Web content, edit WCMConfigService.properties on every server in the cluster and ensure missed_absPath.cache.enable=true .
The WCMConfigService.properties file is located in the PROFILE_HOME/PortalServer/wcm/config/ directory.
Restart WebSphere Portal to enable any configuration changes made to this file.
Parent topic:
Web content creation features