Adaptive tags can be used to build links to a variety of
ALI portal 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
ALI (not in Ensemble).
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.
Tagdocs for all platforms are available on the API Libraries page.
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 ALI 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
About Cross-Platform Adaptive Tag Libraries.
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 ALI 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 ALI database. You must configure the
Web Service object to send the appropriate settings. For details on
ALI settings, see
About ALI 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. |
