Customizing the Getting Started tabAdded by IBM on February 2, 2011 | Version 1 (Original)
|Help your users get started with your implementation of Lotus Connections by customizing the Getting Started tab that is displayed in the home page.
Help your users get started with your implementation of Lotus Connections by customizing the Getting Started tab that is displayed in the home page.
Before you begin
The Getting Started tab is only available from the Home page. If you do not install the Home Page feature, then no Getting Started tab is available in the product.
About this task
The gettingstarted-config.xml file defines the content of the Getting Started tab in the home page. By default, the tab identifies the following steps in vertical tabs:
You can edit the content that is displayed in each tab and you can add or remove tabs.
- Open a command window, and then start the wsadmin command line tool. See Starting the wsadmin client for more details.
- Use the following command to access the configuration files for the Home page application:
- Check out the Getting started page configuration files using the following command:
- <working_directory> is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft® Windows® operating system.
Note: AIX and Linux only: The directory must grant write permissions or the command will not run successfully.
- <cell_name> is the name of the WebSphere® Application Server cell hosting the Lotus® Connections application. This argument is case-sensitive, so type it with care. If you do not know the cell name, you can determine it by typing the following command in the wsadmin command processor:
- Microsoft Windows:
- From the temporary directory to which you checked out the gettingstarted-config.xml file, open it in a text editor.
- Make any of the following updates that you want:
- To remove one of the vertical tabs, find the <step> element that represents the tab and change the value of its enabled attribute from true to false.
- To add another tab to the list, complete the following steps:
- Copy one of the existing <step> elements and paste it into the <steps> block. The order of the vertical tabs reflects the order of the steps in the <steps> element block, so copy it before and after the steps you want it to be displayed between on the page.
- Change the content of the copied <step> element:
To change what is displayed in a tab, edit the title and content of the page. See the previous bullet for details.
- Change the tab title by adding your title text directly to the element in place of the jsp.start.step1.tab.title key or by specifying a key that you define in a corresponding resource bundle that you also define. For example, the title of the first tab is Welcome. It is defined by the jsp.start.step1.tab.title key that is stored in the com.ibm.lconn.homepage.resources.nls.jsp.jsp_resources resource bundle. It is specified in the title element for that step in the configuration file. The bundle attribute identifies where the resource bundle is stored and the title element itself contains the key value for the title string.
- Define what should be displayed in the tab body using the <body-links> element. The <body-links> element must reference a web page that can be accessed over http and https. The page must be in the same domain as the Homepage, for example an HTML page on the HTTP server of the Lotus Connections deployment.
- To specify the page, provide its web address as the value of the secure and unsecure attributes. For example:
Save and close the gettingstarted-config.xml file.
Run the following command to check the configuration files back in:
Update the version stamp property to force a refresh of user web browsers, so that they will see the changes you made to the Getting Started tab the next time they access the product. See Required post-customization step.
where the <working_directory>
parameters contain the same values you specified for the checkout location.
Parent topic: Customizing the user interface
Administering the Home page from the user interface
Forcing the Getting Started tab to be the default Home page tab
Required post-customization step