Adaptive tags can be used to build links to a variety of
Oracle WebCenter Interaction resources. The Standard tag library (pt:standard)
allows you to create links to specific portal objects, the portal
login page, or to specific portlets. You can also build gatewayed
URLs, disable URL transformation, and enable Hosted Display Mode for
gatewayed pages.
The tags in the
pt:standard tag library are available for use only in Oracle WebCenter
Interaction.
Note: The transformer copies any attributes not in the
PT namespace to the output link tag. These links are platform and
version independent, and do not rely on particular ASP/JSP files or
query string arguments.
The tables below summarize available
standard tags. For a full list of tags and attributes, see the tagdocs.
Page Information: These tags display instance-specific
information for use in portal navigation elements, including the date
and time and the page name and type.
Tag |
Function |
More Information |
pt:standard.currenttime |
Writes the current date and time according to the rules of
the user's chosen locale. Only the full date and time can be displayed;
there is no way to return just the date, just the time, or any other
subset of information. This tag is recalculated every time the code
is pulled out of the cache. |
For example: <pt:standard.currenttime xmlns:pt='http://www.plumtree.com/xmlschemas/ptui/'/>
|
pt:standard.realmname |
Replaced with the portal page type ("My Pages," "Documents,"
"Administration," or "Gateway"). |
For example, the code snippet below
creates the portal banner (the pt://images constant is used to reference
the portal Image Service).<td align="left" colspan="1" id="pt-header-left">
<!--portal banner -->
<img src="pt://images/plumtree/portal/public/img/PT_logo_sm_wht.gif" alt="Plumtree Logo" border="0" align="absmiddle" height="50" width="125" />
</td>
<td align="right" nowrap="nowrap" colspan="1" id="pt-header-right">
<h1 class="banHeader">
<pt:standard.realmname xmlns:pt='http://www.plumtree.com/xmlschemas/ptui/'/>
</h1>
<h2 class="banSubhead">
<pt:standard.pagename xmlns:pt='http://www.plumtree.com/xmlschemas/ptui/'/>
</h2>
</td>
|
pt:standard.pagename |
Replaced with the name of the current portal page (My Page
or Community) or left blank otherwise. |
URLs: These tags provide access to key portal
components, including the stylesheet, portal objects, and the portal
login pages. Additional tags allow you to create gatewayed links and
control hosted display mode for gatewayed pages.
Tag |
Function |
More Information |
pt:standard.stylesheets |
Allows you to enter the current portal stylesheet in the HEAD
of any non-hosted gatewayed HTML page. (In previous versions, this
tag was implemented as pt:styleSheets. This syntax is still supported.) |
For example, <HTML>
<HEAD>
<pt:standard.stylesheets xmlns:pt='http://www.plumtree.com/xmlschemas/ptui/'/>
...
</HEAD>
<BODY>
...
|
pt:standard.displaymode |
Sets the header that tells the portal server to display a page
in the style of the portal, with a portal banner. The tag can also
set the title and subtitle of the page. The displaymode tag does not
display any contents, and should only be used as a singleton. (Note:
Pages in hosted display mode should not contain <HTML>, <HEAD>,
<META>, <TITLE> or <BODY> tags.) |
For example, <pt:standard.displaymode pt:mode="Hosted" pt:title="My title" pt:subtitle="My subtitle"
xmlns:pt='http://www.plumtree.com/xmlschemas/ptui/'/>
|
pt:standard.loginlink |
Creates a link to the portal login page. In previous versions,
this tag was implemented as pt:loginLink. This syntax is still supported. |
For example, <pt:standard.loginlink xmlns:pt='http://www.plumtree.com/xmlschemas/ptui/'>Log in
</pt:standard.loginlink>
|
pt:standard.openerlink |
Creates a link that can open or view an object or properties
of an object that already exists within the portal. |
Accessing Oracle WebCenter Interaction Objects Using Adaptive Tags |
pt:standard.gatewaylink |
Allows you to buildgatewayed links to remote pages. |
Building Gatewayed URLs Using Adaptive Tags |
Constants are also available for useful URLs, including the
Image Service, current stylesheet, and return URL For details, see
con_tags_crossplatform.html.
User-Specific Information: These tags allow you to insert
content on a page based on conditional statements of user and group
membership. For details on implementing these tags, see
Securing Content Based on User Permissions Using Adaptive Tags.
Tag |
Function |
pt:standard.choose |
Denotes the start of a secured content section. |
pt:standard.when |
Includes a test condition that defines who has access to the
enclosed content. |
pt:standard.otherwise |
Includes content that should be displayed as default. |
To access user settings stored in the portal database, use
the pt:usersetting tag. The tag is replaced with the value of the
user setting specified in the pt:name attribute. This tag will decode
%uHHHH encoded values stored in the portal database.
You must configure the Web Service object to send the appropriate
settings. For details on Oracle WebCenter Interaction settings, see
About Oracle WebCenter Interaction Portlet Settings.
<pt:userSetting pt:name="myUserSetting" xmlns:pt='http://www.plumtree.com/xmlschemas/ptui/'/>
Tree Controls: These tags provide links to a popup
window that allows users to select options from a structured list
of objects. For details on implementing these tags, see
Creating Tree Controls Using Adaptive Tags.
Tag |
Function |
pt:standard.tree |
Creates a form button to a popup window that allows users to
select options from a structured list of objects. |
pt:standard.treelink |
Creates a link to a popup window that allows users to select
options from a structured list of objects. |
pt:standard.treeurl |
Returns a URL to a popup window that allows users to select
options from a structured list of objects (can be used in JavaScript).
Does not display the contents of the tag and should only be used as
a singleton tag (i.e. <pt:standard.treeurl/>), rather than as a
tag with both an open and close tag. |