IBM R1 manual Disclaimer and a word about conventions, Acronyms and abbreviations

Page 7

Static text is resourced in .properties and .txt files in the properties (and, in the case of the LMM server, templates) directories for the LMM and Delivery servers and the Offline Learning Client (under source\resources). These directories contain resource bundles for the various languages that the LMS supports.

Colors and fonts are typically specified in a Cascading Style Sheet (CSS) file. CSS files are grouped by browser type (under Web\<server>\css\<language>\<browser>, for example, Web\LMM\css\en\styInternetExplorer5).

Graphical imagesGIF and JPEG filesreside in the images directory for the LMM and Delivery servers and the Offline Learning Client in the web directory (for example, web\LMM\images).

As suggested earlier, you can modify a JSP’s functionality as well as its display attributes, by editing the JSP itself. The JSP files for the web\LMM server, Delivery server, and Offline Learning Client reside in the web\LMM, web\ds, and web\duc directories, respectively.

A disclaimer and a word about conventions

This document is not an exhaustive description of all the ways in which you can customize the LMS. Rather, it covers a broad range of changes that customers typically want to make to the application to customize its look and feel and control users’ access to features.

Some changes that you can make to the application are specific to a particular window, while others are system wide. For example, if you change the text of the aboutLMM.title property in the ApplicationResources.properties for the LMM, this will affect only one JSP (aboutLMM.jsp). However, if you change the text of, say, the button.cancel property in the ApplicationResources.properties for the LMM, this change will be realized in all the LMM JSPs that have a Cancel button. Examples in this document remark on this distinction only where it might not be obvious.

As mentioned previously, the application’s CSS files are browser-specific, one set being for use with Internet Explorer™ and another for use with Netscape®. These two sets of style sheets do not differ significantly from each other; they differ in their details. Rather than show changes for both style sheets, the examples in this document refer to the style sheets for Internet Explorer, with the understanding that the examples could, with minor adjustments, apply equally well to the style sheets for Netscape.

Note: When you edit a CSS file, your changes should appear in the interface the next time the user logs on. (If not, emptying the user's browser's cache should remedy the situation.) When you edit a .properties file, however, you need to stop and restart the Web Publishing Service for your changes to take effect. The reason for this difference is that CSS files are processed immediately by the client, while .properties files are processed by Java code on the server.

Acronyms and abbreviations

The following table contains a list of possible unfamiliar acronyms and abbreviations used in this document or appearing in the directory tree, or both:

2 IBM Lotus Learning Management System Release 1 Customization Guide

Page 6 Page 8
Image 7
Page 6 Page 8
Contents Customization Guide Licensed Materials Property of IBM DisclaimerList of Trademarks Page Table of Contents Creating a tab Customization setsIndex Customizing the user interface Acronyms and abbreviations Disclaimer and a word about conventionsAcronym or What it stands for Abbreviation Page Changing settings Chapter Changing settings through the user interface or XMLPage To add a role to the system Chapter Controlling access to features through permissionsTo explicitly assign a role to a user To modify permissions settings for an existing roleTo assign a role to a user To automatically assign a role to a userControlling access to features Page Anatomy of a Help topic Chapter Customizing HelpScript Background-repeat repeat-x Mosaic-bgScript Head Replacing a context-sensitive Help topic Editing an existing Help topicLmsform action=/prefSubmit.do % Adding your own Help topic HREF=shenrolled.html target=topEnrolled courses/Abr HREF=shnotifications.html target=topNotifications/AbrOverview Chapter Customizing JavaServer PagesLMS JSP tag libraries Anatomy of a TLD fileServerNameWEB-INFtld String formName = request.getParameterformName Referencing the url tag in a JSPDefining the url tag in the TLD file ServerNameWEB-INFclassescomlotuselearntaglib Rtexprvaluetrue/rtexprvalue Attribute TagAnatomy of a JSP Learning Management System serverDefining a page as a JSP Including tag library descriptor files Localizing page contentReferencing Struts tags Including the JSPs that comprise the main template Including JavaScript source codeDiv Td class=formBoxTitleBg colspan=3 valign=middle nowrapLogicnotPresent LogicnotMatch Div class=formBoxPositionInnerLogicpresent LogicnotPresent logicpresent name=invalidFormLocalizing page text Delivery serverScript language=JavaScript src=js/delivery.js/script Displaying errors to the userPopulating a frameset in a JSP Defining resizable frames Frameset Html Making global changesChanging the application style Applying customization setsBrowser-version Editing existing CSS filesServerNamecsslanguageCodebrowserType Language-version@import urlmyStyles.css Adding your own CSS filesReplacing CSS files Changing the font size or font style of the applicationServerNameWEB-INFclassesresourcesserverNameproperties Updating page textLmslinklmsimg src=images/name.gif… //lmslink Titlelmsmessage key=application.title //titleApplication.title = IBM Lotus Learning Management System Adding and replacing graphicsDelivery server Replacing the application logoLearning Management System server Image.alt.logo = IBM Lotus Learning Management SystemChanging the style of an individual JSP Changing individual JSPsReplacing a reference to a CSS style DeliverylogoURL resource=images/myCompanyLogo.gifChanging the functionality of an individual JSP Editing existing JSP tagsSpecifying the next page to display Submitting a form Canceling the submission of a formEditing form Bean values with the lmshidden tag Custom fields Removing JSP tagsLmshidden name=%=formName% property=unmodifiedKeywords Lmshidden property=userEventIt then checks to see if its a text box type field LogicnotPresent Logicequal Page Attribute name=HealthPlanChoice type=java.lang.String Chapter Customizing SearchCustomizing user searches Adding Ldap attributes to User Search pagesRemoving fields from User Search pages HealthPlanChoice = Employees Health PlanRemoving fields from Offerings Search pages Customizing Offerings Catalog searchesCustomizing course management and resource searches Adding custom fields to the Offerings CatalogRemoving fields from the Search pages Creating a customization set Chapter Customization setsLMM De en Etc De en etc. SalesCSPage Attribute Name Type Modified Size Path Customization sets Page Users Chapter Creating a tab@ taglib uri=/WEB-INF/tld/lms.tld prefix=lms % Users.jspTd width=1 valign=top Page Users.rosterUsers.subtitle = Roster Users Navigation.xml Users.rosterUsers.search.confirm Users.rosterUsers.searchTrail TrailManageUsers TrailTrail TrailManageRoles Trail TrailManageProfilesLabel tag breadcrumbs Content tag JSP file namesName tag page names and resourced text Target tag struts action-mappingUsers.rosterUsers.search.confirm HelpPage tag context-sensitive Help Adding custom permissionsTitle tag title bar text Permissions tag permission to displayPermid UpdatetimeOid Name0000000000000000PERM 0000000000003000PERM 0000000000009300PERM Copy the JSPs ExamplePage Creating a tab END Index Content Area Creating a tab Div Second linked page customGoodbye.jsp looks like this Page Create Help files Customtab.htmlCustomtabb.html Select Maxpermid from Permission Add permissions to the LMS databaseEdit ApplicationResources.properties Navigation Edit navigation.xmlAssign permissions Namestudenthome/nameCreating a tab Page Index
Top Page Image Contents