XML configuration interface parameters for the Web Content Viewer
As with other portlets in your portal, you can use the XML configuration interface (xmlaccess command) to deploy and configure the Web Content Viewer. To simplify the configuration of the portlet with the XML configuration interface, the portlet parameters you can specify accept path values in addition to the standard IDs.
By default, the Web Content Viewer is configured with unique IDs. This has the advantage that the configuration does not break if an item is renamed of moved. However, when you are configuring a portlet with the XML configuration interface, it can be difficult to determine the unique ID of an item. When you are configuring the Web Content Viewer, you can reference web content items by their path, as well as by their IDs, by using the following parameters:
-
AUTHORINGTEMPLATE_OVERRIDE
Specifies the authoring templates of the profile section. The parameter can contain multiple values, which are separated by commas. The list can contain both ID and path values.
-
CATEGORY_OVERRIDE
Specifies the categories of the profile section. To list multiple categories, separate the categories by commas. You can use both ID values and path values.
-
SITEAREA_OVERRIDE
Specifies the site areas of the profile section. To list multiple site areas, separate the site areas by commas. You can use both ID values and path values.
-
WCM_BROADCASTS_TO
Specifies the link broadcasting setting for the Web Content Viewer. Values include:
WCM_LINKING_DYNAMIC
: Information about the web content item that is displayed in the Web Content Viewer is used to dynamically determine to which page the context is broadcast.WCM_LINKING_SELF
: The context of the current Web Content Viewer is broadcast to other Web Content Viewers on the same portal page.WCM_LINKING_OTHER
: The context of the current Web Content Viewer is broadcast to other Web Content Viewers on another portal page, as specified by theWCM_PORTAL_PAGE_ID
parameter.WCM_LINKING_NONE
: The context of the current Web Content Viewer is not broadcast to other Web Content Viewers.
-
WCM_COMPONENT_IDR
Specifies a library component and is only used if content type Component is selected.
-
WCM_CONTENT_COMPONENT
Specifies the name of the element to be displayed, when the
WCM_CONTENT_TYPE
parameter has the valueCONTENT_COMPONENT
. -
WCM_CONTENT_CONTEXT_IDR
Specifies the content render context. It can be a content item or site area, as specified by the
WCM_CONTENT_CONTEXT_TYPE
parameter. -
WCM_CONTENT_CONTEXT_TYPE
Specifies the type of the configured content context. Values include:
CONTENT
: Indicates that the content context is a content item.PARENT
: Indicates that the content context is a site area.
-
WCM_CONTENT_TYPE
Specifies the item to be displayed. Values include:
CONTENT
: Indicates that the item to be displayed is a content item.COMPONENT
: Indicates that the item to be displayed is a component.CONTENT_COMPONENT
: Indicates that the item to be displayed is an element.SUMMARY
: Indicates that the item is to be rendered with the summary presentation template. A summary presentation template can be specified in the item's content template.ALTERNATE
: Indicates that the item is to be rendered with the alternative presentation template, as specified by the parameterWCM_DESIGN_IDR
.
-
WCM_DESIGN_IDR
Specifies an alternative presentation template.
-
WCM_LISTENS_TO
Specifies how the Web Content Viewer is configured to receive links that are broadcast from other Web Content Viewers. Values include:
WCM_LINKING_OTHER
: Information is received from any Web Content Viewer broadcasting links.WCM_LINKING_SELF
: Information is received only from this Web Content Viewer.WCM_LINKING_NONE
: No information from other Web Content Viewers is received.
-
WCM_PAGE_TITLE
Used with the
WCM_PAGE_TITLE_TYPE
parameter, this parameter specifies the page title for the Web Content Viewer. Values include:- The user-defined title for the page, if the
WCM_PAGE_TITLE_TYPE
parameter has a value ofWCM_PAGE_TITLE_TYPE_GENERAL
. - The name of the resource bundle containing the title for the page, if the
WCM_PAGE_TITLE_TYPE
parameter has a value ofWCM_PAGE_TITLE_TYPE_RESBUN
. WCM_PAGE_TITLE_TYPE
Specifies how the page title is displayed for the Web Content Viewer. Values include:
WCM_PAGE_TITLE_TYPE_DEFAULT
: The default title that is defined in the portal's administration interface is used.WCM_PAGE_TITLE_TYPE_GENERAL
: A user-defined title is used, as specified byWCM_PAGE_TITLE
parameter.WCM_PAGE_TITLE_TYPE_RESBUN
: The title is defined in a resource bundle, as specified byWCM_PAGE_TITLE
parameter.WCM_PAGE_TITLE_TYPE_DYN
: The title is defined by the value of the Display title field for the content item that is displayed in the Web Content Viewer.WCM_PAGE_TITLE_TYPE_DYN_CONTENT_CMPNT
: The title is defined by the value of an element of the content item that is displayed in the Web Content Viewer. You must also specify the element name using the WCM_PAGE_TITLE parameter.
- The user-defined title for the page, if the
-
WCM_PORTAL_PAGE_ID
Specifies the unique name or object ID of the page, which is the target for link broadcasts when the
WCM_BROADCASTS_TO
parameter is set toWCM_LINKING_OTHER
. -
WCM_PORTLET_TITLE
Used with the
WCM_PORTLET_TITLE_TYPE
parameter, this parameter specifies the portlet title for the Web Content Viewer. Values include:- The user-defined title for the portlet, if the
WCM_PORTLET_TITLE_TYPE
parameter has a value ofWCM_PORTLET_TITLE_TYPE_GENERAL
. - The name of the resource bundle containing the title for the portlet, if the
WCM_PORTLET_TITLE_TYPE
parameter has a value ofWCM_PORTLET_TITLE_TYPE_RESBUN
.
- The user-defined title for the portlet, if the
-
WCM_PORTLET_TITLE_TYPE
Specifies how the portlet title is displayed for the Web Content Viewer. Values include:
WCM_PORTLET_TITLE_TYPE_DEFAULT
: The default title that is defined in the portal's administration interface is used.WCM_PORTLET_TITLE_TYPE_GENERAL
: A user-defined title is used, as specified byWCM_PORTLET_TITLE
parameter.WCM_PORTLET_TITLE_TYPE_RESBUN
: The title is defined in a resource bundle, as specified byWCM_PORTLET_TITLE
parameter.WCM_PORTLET_TITLE_TYPE_DYN
: The title is defined by the value of the Display title field for the content item that is displayed in the Web Content Viewer.WCM_PORTLET_TITLE_TYPE_DYN_CONTENT_CMPNT
: The title is defined by the value of an element of the content item that is displayed in the Web Content Viewer. You must also specify the element name using theWCM_PORTLET_TITLE
parameter.
When specifying a content path, you must begin with the forward slash character (/
) followed by the library name, as indicated in the following examples of valid content paths:
/mylib/myfolder/mysitearea/mycontent
or
/mylib/mypresentationtemplate
Note
If you configure an item by its path rather than by its ID, the portlet configuration can become invalid if the item is renamed or moved. If an item has been configured by its path, the Web Content Viewer displays a small path icon after the item when you are in the Edit Shared Settings or Configure mode.
Important
When configuring an item by its path, you cannot build the path from the Display title fields of the items in the path. You must use the Name fields of the items when specifying the path.