Friendly URL for web content example

This example demonstrates how friendly URLs for web content work with multiple web content viewers on a single portal page. The example describes the portal page structure referenced by the friendly URLs and explains the underlying structure of the content in an Web Content Manager site framework.

The example also describes the configuration of the web content viewers.

Elements in the example

The example is composed of the following elements:

Portal page hierarchy

The portal page hierarchy in this example is:

Content Root
   > Home
      > Human Resources

The page Home has a friendly URL name of home, and the page Human Resources has a friendly URL name of hr. The pages can be accessed directly using the following friendly URLs for pages:

• http://www.example.com:10039/wps/portal/home

• http://www.example.com:10039/wps/portal/home/hr

Web Content Manager site framework

The Web Content Manager site framework resembles the portal page hierarchy:

Web Content (Web content library)
   > Home (site area)
      > Human Resources (site area)
         > HR Welcome (content item)
         > Health (site area)
            > Workplace Safety (content item)
            > Personal Wellness (content item)
   > HR Menu (menu component)

These content items can be referenced by the following content paths:

• Web Content/home/human resources/hr welcome

• Web Content/home/human resources/health/workplace safety

• Web Content/home/human resources/health/personal wellness

The menu component HR Menu is defined to display content from the human resources site area and the health site area.

Content association

The portal page Human Resources contains a content association to the Web Content/home/human resources site area.

Web content viewers

The page Human Resources contains two instances of the web content viewer, Web Content Viewer A and Web Content Viewer B.

• The Web Content Viewer A viewer renders the menu component HR Menu and is configured to broadcast links to this portal page.

• The Web Content Viewer B viewer inherits the content to display from the content association defined for the page Human Resources. The viewer is configured to receive links from other portlets and from itself.

Browsing the example content

With the portal page and web content site framework defined, browsing the content demonstrates how the different elements interact:

1. Navigate to Human Resources page for the first time.

   • The URL that is displayed in the address bar of the browser is http://www.example.com:10039/wps/portal/home/hr/!ut/p/b1/...

   • The URL reflects the friendly URL names of the portal pages Home and Human Resources.

   • The Web Content Viewer A viewer renders the menu component and displays links to the content items HR Welcome, Workplace Safety, and Personal Wellness.

   • The Web Content Viewer B viewer shows the default content item HR Welcome from the site area Human Resources, because of the content association defined on the portal page.

     When the portal page is first displayed, the path of the default content item is not included in the friendly URL.

2. Click Workplace Safety from the list of content items.

   • The URL that is displayed in the address bar in the browser is http://www.example.com:10039/wps/portal/home/hr/health/workplace%20safety/!ut/p/b1/...

   • The Web Content Viewer B viewer displays content item Workplace Safety.

   • The URL is adjusted so that the path to the content item (health/workplace%20safety) becomes part of the URL.

3. Click HR Welcome from the list of content items.

   • The URL that is displayed in the address bar of the browser is http://www.example.com:10039/wps/portal/home/hr/hr%20welcome/!ut/p/b1/...

   • The Web Content Viewer B viewer displays the content item HR Welcome again, giving the same result as when the portal page was viewed for the first time.

   • Because the Web Content Viewer A viewer is broadcasting the link to the content item, the URL that is displayed in the browser is updated to reference the path to the content item (hr%20welcome).

Content item references with friendly URLs for web content

The URL displayed in the web browser can sometimes include the content item path when you browse pages and content with web content viewers. However, we can also reference content items directly in friendly URLs for web content.

For example, to reference the content items HR Welcome, Workplace Safety, and Personal Wellness in the context of the Human Resources page, you would use the following friendly URLs for web content:

• http://www.example.com:10039/wps/portal/home/hr/hr%20welcome

• http://www.example.com:10039/wps/portal/home/hr/health/workplace%20safety

• http://www.example.com:10039/wps/portal/home/hr/health/personal%20wellness

These friendly URLs for web content include URL-encoded space characters (%20) instead of unencoded space characters. Your web browser might accept unencoded space characters when specifying content item names in friendly URLs for web content. However, to ensure consistent behavior from the portal, use the URL-encoded value.

Parent: Friendly URLs and web content viewers