AquaLogic Interaction and AquaLogic Ensemble provide a collection of useful XML tags that can be included in the markup returned by any gatewayed page, including pagelets. Using the attributes defined in the tag, the gateway transforms the XML and replaces it with standard HTML to be displayed in a browser. These concepts also apply to portlets; a portlet is a pagelet designed for use in the ALI portal.
For example, when used in a banner pagelet/portlet in the ALI portal, the following code is replaced with the date and time in the current user's locale.
<pt:standard.currenttime xmlns:pt='http://www.plumtree.com/xmlschemas/ptui/'/>
The Adaptive Tag libraries provide access to a wide range of components. The Adaptive Tag collection currently includes libraries for use in both ALI portal and Ensemble.
For detailed information on using tags, see the next page. For information on how the portal processes tags, see Adaptive Tag Control Flow. You can also create custom tags; for details, see Creating Custom Adaptive Tags.
For a full list of tags and attributes, see the TagDocs.
The cross-product Adaptive Tag libraries provide key functionality for use in pagelets that work in both Ensemble and the ALI portal. These libraries include core tags, constants, common tags, and logic tags.
The Core Tags library provides two basic tags to support core tag functionality.
pt:core.debugmode toggles debug mode.
pt:core.html allows you to use HTML tags within JavaScript, and supports attribute replacement.
Constants tags provide access to useful URLs: the stylesheet, Image Service, and the correct return URL for the current user.
The pt://styles URL replacement marker is replaced with the stylesheet URL in hosted pages and pagelets in both ALI portal and Ensemble.
<link type="text/css" href="pt://styles" rel="StyleSheet"></link>
The pt://images URL replacement marker is replaced with the URL to the Image Service in both ALI portal and Ensemble.
<img src="pt://images/plumtree/portal/public/img/icon_help.gif">
The pt://return URL replacement marker is replaced with a URL that returns users to the page from which they came in both ALI portal and Ensemble (i.e., the page on which the pagelet that launched the page is hosted).
<a href="pt://return">Back</a>
The Common Tags library provides access to useful functionality, including URL transformation and namespace definition. This library also allows you to insert error information in the page, and CSS and JavaScript references in the Head element in a gatewayed HTML page.
Logic Tags handle basic logic, including creating data objects and collections, setting shared variables, and looping over a data collection.
The ALI portal tag libraries include tags to display portal navigation components, portal ui components, and standard ui elements. Tags in the standard and transformer libraries also provide access to useful functionality, including URL transformation and logic based on user and group membership.
Navigation Tags are used with Data Tags to build complete custom navigation solutions for the portal. The AquaLogic Pages and AquaLogic Pathways also include tags to insert components into portal navigation.
The Pages tag library allows you to insert Pages elements in ALI portal navigation. This library is explained on the Using Adaptive Tags: Pages page.
The Pathways tag library allows you to insert Pathways search in ALI portal navigation. This library is explained on the Adding Pathways Search page.
UI Tags allow you to add standard portal UI components to any pagelet/portlet, including search inputs and buttons, login components, access to account settings, error messages, and more. Tags from the Standard Tag library can be used to display instance-specific information, including the date and time and the page name and type.
The Standard Tags library contains most of the tags available in portal version 5.x, previously called "transformer tags." This package includes tags for the following purposes:
Links: Build links to almost any portal object, Community pages, login pages, or any gatewayed page. You can also set Hosted Display Mode for any gatewayed page.
User-Specific Information: Provide user-specific content, leveraging settings and portal permissions. Use conditional statements to secure content based on user or group membership.
Tree Controls: Create custom selection trees of portal objects.
Legacy tags not included in the Standard library are provided in the Transformer Tags library (6.1 and earlier) or the Common Tags library (Ensemble / ALI 6.1MP1 and above).
The Ensemble library provides tags to insert pagelets in Ensemble consumer pages and access authentication and role information for Ensemble resources.
Next: Using Adaptive Tags