Enterprise Knowledge Platform Adding the Login Form to Any Web Page
EKP Adding the Login Form to Any Web Page 21JAN03 2 Table of Contents 1. Introduction...4 Overview... 4 Requirements... 4 2. A Simple Form...5 3. A Simple Form with Improved Layout...6 4. The Default EKP Login Page...7
EKP Adding the Login Form to Any Web Page 21JAN03 3 Document Information Document ID: EN012 Document title: EKP Login Form Version: 1.0 Document date: 21 January 2003 This document may be revised from time to time. Please check NetDimensions Support site at www.netdimensions.com/support for updates to this and other documents or send an e-mail to support@netdimensions.com to request the most recent version. Please report any errors or feedback with this document by sending an e-mail to support@netdimensions.com. Copyright Information Copyright 2000-2004 by NetDimensions Ltd. All Rights Reserved. Information in this document is subject to change without notice. The software described herein is furnished under a license agreement, and it may be copied only in accordance with the terms of that agreement. No part of this publication may be reproduced, transmitted, or translated in any form or by any means without the prior written permission of NetDimensions Ltd. All company and product names used herein may be trademarks or registered trademarks of their respective companies unless stated otherwise. How to Contact NetDimensions Support +852 2122 4588 1 866 206 6698 US toll-free number +852 2122 4588 support@netdimensions.com www.netdimensions.com/support General Enquiries +852 2122 4500 +852 2122 4588 info@netdimensions.com www.netdimensions.com
EKP Adding the Login Form to Any Web Page 21JAN03 4 1. Introduction Overview EKP is a Java-based middleware server that works on a variety of platforms and in cooperation with a Web server or transaction server. Users (learners, instructors and administrators) access all features of EKP with a standard Web browser such as Internet Explorer. Users must first login to EKP by entering a user ID and password into a form on a Web page. Typically when EKP is installed a Web page is created which contains the EKP login form. To login, users need to know the location of this Web page so they can load it into their browser. However, the EKP login form does not need to be placed on its own page it can be added to any other page, such as an organization s home page, so that users can login from there. Further, the login form can exist in multiple places making access to EKP very convenient for everyone who needs it. This guide explains how to create a custom login page, or add the EKP login form to another Web page. Requirements The EKP login form is written in standard HTML (Hypertext Markup Language), the language of the World-wide Web. The login form is very simple so anyone with a basic knowledge of HTML should be able to add the form to an existing (or new) page. To view and edit HTML you will need to use a text editor such as Windows Notepad. Alternatively you may choose to use a WYSIWYG editor such as Microsoft s FrontPage or Macromedia s Dreamweaver.
EKP Adding the Login Form to Any Web Page 21JAN03 5 2. A Simple Form At its most basic, the EKP form comprises 5 elements or tags. Each of these is required for the form to work. These are: Notes: 1. <FORM method="post" action="url"> 2. <INPUT type="hidden" name="tx" value="verify"> 3. <INPUT type="text" name="uid" size="x"> 4. <INPUT type="password" name="pwd" size="y"> 5. <INPUT type="submit" value="submit"> The <FORM> tag must be closed using </FORM> The second tag is hidden so nothing is displayed but EKP requires this tag to be present. Tags 3 and 4 will display input boxes. The width of each box ( X and Y ) is specified in characters. A suitable size setting is 20. Tag 5 will display a button for submitting the form. The text displayed on the button can be changed by editing the text in the value= attribute. The following is sample HTML for a simple form: <FORM method="post" action="http://ekp.yourdomain.com/ekp/servlet/ekp"> <INPUT type="hidden" name="tx" value="verify"> <P>User Id :<INPUT type="text" name="uid" size="20"></p> <P>Password :<INPUT type="password" name="pwd" size="20"></p> <P><INPUT type="submit" value="submit"></p> </FORM> The HTML above will produce a form that looks like this when viewed with a Web browser: You will need to edit the URL in the action attribute of the first tag, i.e. the opening <FORM> tag, (highlighted in the sample above) so that it matches the location of your EKP system. If you are not sure what this should be, ask your system administrator.
EKP Adding the Login Form to Any Web Page 21JAN03 6 3. A Simple Form with Improved Layout The example above is the most simple form that will work. However, it is likely that you will want the form to have a label clearly stating what it is and for the layout to be more attractive. The following sample code builds on the above example by adding a label EKP Login and improving the appearance of the form by using a table to layout the various elements. <FORM method="post" action="http://ekp.yourdomain.com/ekp/servlet/ekp"> <INPUT type="hidden" name="tx" value="verify"> <TABLE border="0" cellspacing="3" cellpadding="0"> <TR colspan="2"> <TD><BIG>EKP Login</BIG></TD> <TR> <TD>User Id :</TD> <TD><INPUT type="text" name="uid" size="20"></td> <TR> <TD>Password :</TD> <TD><INPUT type="password" name="pwd" size="20"></td> <TR colspan="2"> <TD><INPUT type="submit" value="submit"></td> </TABLE> </FORM> The HTML above will produce a form that looks like this when viewed with a Web browser: Further enhancement of the form is possible using standard Web page design techniques such as: Using a background image or color Using a graphical submit button Adding links to pages for instructions or other useful information See the next Section for an example of a this.
EKP Adding the Login Form to Any Web Page 21JAN03 7 4. The Default EKP Login Page The default EKP login page looks like this: You can see that, although the page is more complex, it still contains the basic elements required i.e. the input boxes for user name and password and the submit button (in this case an image is used). By changing the graphics and colors used, the login form can be customized to match your company image. This would typically be carried out by someone with experience in designing graphics and Web pages. In the example above you can se that graphical links have been added for help, lost password and contact us. These are typical but you can add links to any pages you like.