Generating banner markup
This script generates the banner markup that gets inserted into the DOM. The DOM insertion point can be specified using <divElementId>
in the script URL, where <divElementId>
is the id of the element that will contain the navbar. If <divElementId>
is not specified or not available, the HTML is inserted as the first element in the body tag. The script tag must be after the div that has the id divElementId
Also note that an application name must be specified using <appName> . Choose a name that likely will be unique, avoiding generic names like "mail" or "chat". The application name "partner" will cause an additional link to be added to the banner. The link text is "Back to ...". Clicking the link takes the user to the home page.
You can pass in these optional parameters:
Displays the user name in the banner after the name is sanitized. When this parameter is not present, a generic string My Account displays in the banner.
The displayName parameter is no longer supported.
Displays the organization name in the banner after the name is sanitized. When this parameter is not present, a generic string My Organization displays in the banner.
Deprecated beginning with the June 2016 release.
To use the standard IBM Connections Cloud Theme, you must do the following. Note that in a future release (coming soon!), these steps will no longer be necessary for the banner (the banner will provide appropriate Theme support). However, you may choose to still follow these guidelines to style other elements on your page.
1. include the Theme Cascading Style Sheet (CSS).
This provides CSS styling for the entire page, including the navigation banner.
<link rel="stylesheet" href="http://<connections_cloud_server_endpoint>/theming/theme/css/3" type="text/css" />
2. Add the Theme classes to your Body tag
class="lotusui30 lotusui30_body lotusui30_fonts scloud3"
There is a sample which demonstrates incorporating the navbar and the css in your application.
The binary project is available at ibmsbt.openntf.org It is included in sbtsdk/samples/war/ and is named smartcloud.webapp.war .
Parent topic: Application integration for IBM Connections Cloud
Beginning with the June 2016 release, the navigation banner on IBM Verse page is being used on all other pages (Connections application pages, etc.). By default, the "old" banner is still being used for partner integrations whose <appName> is "partner". Banners with any other value for <appName> (other than "partner" that is) will immediately see the new navbar. If your application is using "partner" <appName> , and you want to begin using the new banner, you can do the following:
Beginning with the September 2016 release, add "PNB=1" parameter onto the script tag "src" attribute. The new banner will be displayed, and it will include the "Back to ..." link. Sample script tag: