Location: PHPKode > projects > Laffer > docs/laffer-web-client-manual.html
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
<html>
<head><!-- Copyright (c) 2003-2005  Slavei  Karadjov, hide@address.com -->
<title>Laffer: Free Instant Message Environment</title>
 	
<meta content="text/html; charset=utf-8" http-equiv="Content-Type"><meta name="description" content="Laffer: Complete Open Source Environment For IM Communications"><meta name="keywords" content="laffer im instant message messanger icq msn aol jabber yahoo j2me bluetooth html javascript perl php">
<meta name="author" content="Slavei Karadjov - hide@address.com - http://laffer.sf.net">
<style type="text/css">
         .newst{font-family:verdana, arial, helvetica, geneva; font-size:20px; font-weight:bold; color:#000000}
         .newsb{font-family:verdana, arial, helvetica, geneva; font-size:12px; color:#000000}
         .head1{font-family:verdana, arial, helvetica, geneva; font-size:18px; font-weight:bold; color:#000000}
         .head2{font-family:verdana, arial, helvetica, geneva; font-size:12px; font-weight:bold; color:#000000}
         .head3{font-family:verdana, arial, helvetica, geneva; font-size:18px; font-weight:bold; color:#FFFFFF}
         .disclaimer{font-family:verdana, arial, helvetica, geneva; font-size:10px; color:#000000}
         A{font-family:verdana, arial, helvetica, geneva; text-decoration:none;}
         A:hover{text-decoration:underline}
</style>
<link rel="top" href="http://laffer.sourceforge.net/cgi-bin/index.pl" title="Laffer Home Page">
<link rel="parent" href="http://laffer.sourceforge.net/cgi-bin/index.pl?page=article&amp;id=docs" title="">
<link rel="next" href="http://laffer.sourceforge.net/cgi-bin/index.pl?page=article&amp;id=docs&amp;key=373321466" title="How To Translate Laffer Interface To Your Favourite Language ">
<link rel="prev" href="http://laffer.sourceforge.net/cgi-bin/index.pl?page=article&amp;id=docs&amp;key=" title=" ">
</head>

 
<body bgcolor="white" text="black">

 <table align="center" cellpadding="4" cellspacing="0" width="90%">
 <tbody><tr>
 	<td class="head3" bgcolor="#003399">
 		<a href="http://laffer.sourceforge.net/" class="head3">Laffer Project</a> <a href="http://laffer.sourceforge.net/" class="head3">URL: http://laffer.sourceforge.net</a>
 	</td>
 </tr>
 </tbody></table>
 
 <table align="center" border="0" cellpadding="4" cellspacing="0" width="90%">
 <tbody><tr>
 	<td class="head2" bgcolor="#eeeeee">
 		
 	</td>
 </tr>
 <tr>
 	<td class="newst">Laffer Web Client Mini Manual</td>
 </tr>
 </tbody></table>
 
 <table align="center" border="0" cellpadding="0" cellspacing="0" width="90%">
 <tbody><tr>
 	<td bgcolor="#999999"><img src="images/clearpixel.gif" height="1" width="1"></td>
 </tr>
 <tr>
 	<td><img src="images/clearpixel.gif" height="3" width="1"></td>
 </tr>
 <tr>
 	<td class="head2">
 		Author: Slavei Karadjov<br>
 		Date: 27-06-2005<br>
 		URL: <a href="http://laffer.sourceforge.net/cgi-bin/index.pl?page=article&amp;id=docs&amp;key=373204563">http://laffer.sourceforge.net/cgi-bin/index.pl?page=article&amp;id=docs&amp;key=373204563</a>
 	</td>
 </tr>
 </tbody></table>
 
 
 <!-- SEPARATOR TABLE -->
 <table align="center" border="0" cellpadding="0" cellspacing="0" width="90%">
 <tbody><tr>
 	<td><img src="images/clearpixel.gif" height="8" width="1"></td>
 </tr>
 <tr>
 	<td bgcolor="#999999"><img src="images/clearpixel.gif" height="1" width="1"></td>
 </tr>
 <tr>
 	<td bgcolor="#cccccc"><img src="images/clearpixel.gif" height="4" width="1"></td>
 </tr>
 <tr>
 	<td bgcolor="#999999"><img src="images/clearpixel.gif" height="1" width="1"></td>
 </tr>
 <tr>
 	<td><img src="images/clearpixel.gif" height="8" width="1"></td>
 </tr>
 </tbody></table>
 <!-- SEPARATOR TABLE -->
 
 <table align="center" border="0" cellpadding="0" cellspacing="0" width="90%">
 <tbody><tr>
 	<td class="newsb">
 		<h2>Table of Contents</h2>
 <ol>
 <li><a href="#intro">Introduction</a></li>
 <li><a href="#working">Working with Laffer Web Client</a></li>
 	<ul>
 	<li><a href="#working-1">Starting Laffer</a></li>
 	<li><a href="#working-2">Logging to Laffer</a></li>
 	<li><a href="#working-3">Connecting to IM networks, like ICQ</a></li>
 	<li><a href="#working-4">Sending message to user</a></li>
 	<li><a href="#working-5">Add Group to Contact List</a></li>
 	<li><a href="#working-6">Hide Users in Group from Contact List</a></li>
 	<li><a href="#working-7">Add User (to Group)</a></li>
 	<li><a href="#working-8">Move User from Group to Group</a></li>
 	<li><a href="#working-9">Delete user from Group</a></li>
 	<li><a href="#working-10">Rename Group in Contact List</a></li>
 	<li><a href="#working-11">Deleting Group from Contact List</a></li>
 	<li><a href="#working-12">Talking to user who is not in the contact list</a></li>
 	<li><a href="#working-13">Changing presence status</a></li>
 	<li><a href="#working-14">Disconnecting</a></li>
 	<li><a href="#working-15">Cleaning users and groups from visible contact list</a></li>
 	</ul>
 <li><a href="#unk-opts">Not so known options</a></li>
 	<ul>
 	<li><a href="#unk-opts-1">Show users' ids</a></li>
 	<li><a href="#unk-opts-2">Show online users only</a></li>
 	<li><a href="#unk-opts-3">Open new pop-up window on new message</a></li>
 	<li><a href="#unk-opts-4">Conference/Chat Room</a></li>
 	<li><a href="#unk-opts-5">Last users that you have talked with</a></li>
 	<li><a href="#unk-opts-6">Finding users in the visible contact list</a></li>
 	</ul>
 <li><a href="#meta">Meta</a></li>
 </ol>
 
 <h2><a name="intro">Introduction</a></h2>
 <p>Laffer Web Client(LWC) is pure HTML web application. It uses JavaScript and DOM.
     Also LWC is Instant Messenger client.
     Think of it as ICQ program that can be started directly from your web browser.
     LWC is not Java applet or Flash page. LWC can be used as web ICQ messenger, MSN, AOL or Yahoo.
     With LWC you can see and modify your contact list, chat with your friends, see if they are online,
     offline or away.
 </p>
 <p>
     LWC has a lot of advantages and some of them are:
 </p><ul>
     <li>you
can start it directly from your browser without the need to download
additional plug-in for you browser, like Java or Flash for example</li>
     <li>it is secure(as much as your web browser is secure). Also your messages to the Laffer server will be encrypted
 if you use SSL</li>
     <li>it can work almost on every modern browser and OS</li>
     <li>uses port 80 and can be used from places where using IM clients is forbidden, like offices or Internet cafes for example</li>
 </ul>
 <p></p>
 <p>You can test Laffer directly from the <a href="http://laffer.sourceforge.net/cgi-bin/index.pl?page=demo">LiveDemo</a>. You will need modern browser that supports JavaScript and DOM Level 2.
     Internet Explorer version 5 or bigger, Mozilla Suite version 1.4 or bigger and Firefox 0.8 or bigger are ok.
     Current versions of Opera, Safari and Konqueror still need improvement but work to some extent.
     Also you have to allow pop-up windows to open from the server where LWC is hosted.
 </p>
 <h2><a name="working">Working with Laffer Web Client</a></h2>
 <h3><a name="working-1">Starting Laffer</a></h3>
 <p>If you have installed Laffer successfully you can start Laffer Web Client(LWC) from the <b>start.html</b> page
 which is located in the web(htdocs) directory of your installation. All you need is to allow pop-up to open
 from this page and to have JavaScript enabled. Clicking on the link Start LAFFER(EN) will new pop-up window
 and the text information will be in English. If you want to use LWC with Bulgarian or Russian language you can click
 on Стартирай LAFFER(BG) or Запусти LAFFER(RU) respectively.
 </p>
 <h3><a name="working-2">Logging to Laffer</a></h3>
 <p>
 When you start Laffer Web Client(LWC) new pop-up window will open which will as you to add your username
 and password in order to log to the Laffer Server.
 </p><blockquote><span style="color: red;">Notice:</span> Don't enter here  your username and password that you use
 to log to ICQ, MSN, AOL or Yahoo instant messenger servers.
 </blockquote>
 If you have started Laffer after you have installed it type <b>USERNAME</b> for username and <b>PASSWORD</b>
 for password. If have started LWC from the  <a href="http://laffer.sourceforge.net/cgi-bin/index.pl?page=demo">LiveDemo page</a> enter
 <b>MANUSER</b> for username and <b>MANPASS</b> for password.
 <p></p>
 
 <h3><a name="working-3">Connecting to IM networks, like ICQ</a></h3>
 After you log in successfully to the Laffer Web Client(LWC) you will see screen that looks like the one in Picture 1.
 <div align="center">
 <img src="images/dbimage.jpeg" title="Logged to Laffer Web Client"><br>
 Picture 1
 </div>
 If you want to log to ICQ you have to do the steps below. The same steps apply for the connecting with other
 instant messenger networks like MSN, AOL and Yahoo.
 <br>Point the mouse pointer over the green box with the text "ICQ" and click the left mouse button.
 This box is sub menu option of the "-- IM networks --" menu.
 A new menu
 below the ICQ box should appear with one active option - ONLINE. Look at figure 2.
 <div align="center">
 <img src="images/connect.png" title="Logged to Laffer Web Client"><br>
 Picture 2
 </div>
 Click with the left mouse over the ONLINE item and new pop-up will appear that will ask you for your
 username/id and password that you use to log to ICQ servers. There is one checkbox "save username and password"
 in the login form.
 <blockquote><span style="color: red;">Notice:</span>
 If you check it the information about your ICQ username and password will be stored
 in encrypted form as a cookie on your browser. This information is NOT stored on the Laffer Server.
 </blockquote>
 Another useful option in the login window is "Messages character set". If you set this option to utf-8, for example,
 all your messages will be converted to utf8. This is useful if all the buddies in your contact list use
 utf8 capable ICQ clients.
 <p>If your username and password for logging to ICQ servers are entered and correct press the "Connect me!" button.
 After seconds this window will disappear, if there is no problem with the connection to ICQ servers, or error text
 will appear on the top of the login form. Also notice that the small red box in the ICQ sub menu will turn to green
 when the connection is established.
 </p><p>If everything with the connection to the ICQ servers is ready you will start to see your buddies and groups in the contact list.
 Notice that some have red boxes in from of their names and others have green boxes. Those with the red boxes
 are buddies which are offline at the moment and those with green boxes are online.
 </p>
 
 
 <h3><a name="working-4">Sending message to user</a></h3>
 <p>Move the mouse pointer over the name of the user you want to send message. Click with the left mouse button
 and a new pop-up window will appear. This is the message window. At the bottom you will see text field for entering
 your message. Write your message and press ENTER to send it.
 </p><blockquote><span style="color: red;">Notice:</span>
 Some Instant Message(IM) networks like MSN allow message to be send only to online users.
 </blockquote>
 When you send your message it will disappear from the text field and will appear in the are above it. If the other
 side replies, the reply message will appear on this area.
 <blockquote><span style="color: red;">Notice:</span>
 There is no need to refresh this window. It is done automatically. In fact there is no need to refresh any window.
 Changes are made dynamically with the help of JavaScript.
 </blockquote>
 Picture 3 illustrates short chat dialog.
 <div align="center">
 <img src="images/message.png" title="Message window"><br>
 Picture 3
 </div>	
 <p></p>
 <h3><a name="working-5">Add Group to Contact List</a></h3>
 <p>
 Move the mouse pointer over the ICQ sub menu. <b>Right</b> click over it and you will see list of options to modify
 your contact list.
 </p><div align="center">
 <img src="images/protocol-context.png" title="Protocol Context Menu"><br>
 Picture 4
 </div>	
 Press "Add group" if you want to add new Group to your ICQ contact list. New pop-up window will
 appear which will ask you for the name of the group. When you are ready press the "Add group" button.
 After some seconds the new group will appear in your contact list
 <p></p>
 <p>If you want to add group to MSN, for example, choose MSN sub menu and follow the same steps that were described in the
 above text.
 </p>
 <h3><a name="working-6">Hide Users in Group from Contact List</a></h3>
 <p>If you want to hide all users in a group move the mouse pointer over the group and click left mouse button.
 To show the users in this group click again the left mouse button.
 </p>
 <h3><a name="working-7">Add User (to Group)</a></h3>
 <p>There are two ways to add user to group.</p>
 <p>The first one is to move the mouse pointer over the desired
 group and to click the <b>right</b> mouse button. A new sub menu will appear. Click on "Add user" and in the new
 pop-up window enter the username/id of the user and his/her nickname, or real name. See Picture 5.<br>
 </p><div align="center">
 <img src="images/group-context.png" title="Group Context Menu"><br>
 Picture 5
 </div>	
 <p></p>
 <p>The second one is to move the mouse pointer over IM networks sub menu options.
 If you want to add new ICQ user to your contact list, for example, move the mouse pointer over ICQ sub menu and click
 the <b>right</b> mouse button. The new menu contains option "Add user"(see picture 4). Click the left mouse button when over it
 and new window for adding user to group will appear
 <br>The same steps apply for all IM networks.
 </p>
 <h3><a name="working-8">Move User from Group to Group</a></h3>
 <p>If you want to move user from one group to another move the mouse pointer over his/her name and click the
 <b>right</b> mouse button. New menu will appear with options to edit user's information. Choose "Move to group"
 and in the new window choose the name of the new group.
 </p><blockquote><span style="color: red;">Notice:</span>
 ICQ users can be moved only between ICQ groups. The same applies to all users in your contact list, which means
 that MSN user can be moved again only between MSN groups.
 </blockquote>
 See Picture 6
 <div align="center">
 <img src="images/user-context.png" title="Buddy Context Menu"><br>
 Picture 6
 </div>
 <p></p>
 <h3><a name="working-9">Delete user from Group</a></h3>
 <p>
 Move the mouse pointer over the name of the desired user in the desired group. Click the <b>right</b>
mouse button and new user context menu will appear(see picture 6). Left
click with the mouse over the "Delete User" option. If you really want
to delete the selected user confirm this in the alert dialog that will
appear. </p>
 
 <h3><a name="working-10">Rename Group in Contact List</a></h3>
 <p>
 Move the mouse pointer over the name of the group you want to rename. Click the <b>right</b>
mouse button and new group context menu will appear(see picture 5).
Left click with the mouse over the "Rename" option. Enter the new group
name in the pop-up window and press the "Rename" button. </p>
 
 <h3><a name="working-11">Deleting Group from Contact List</a></h3>
 <p>
 Move the mouse pointer over the name of the group you want to delete from your contact list. Click the <b>right</b>
mouse button and new group context menu will appear(see picture 5).
Left click with the mouse over the "Delete" option. If you really want
to delete the selected group confirm this in the alert dialog that will
appear. </p>
 
 <h3><a name="working-12">Talking to user who is not in the contact list</a></h3>
 <p>If you don't want to add user to your contact list, or if you know the username of your buddy and don't want
 to search for him/her in the contact list, and want to send message to him/her you can do this following the steps below.
 <br>Move the mouse pointer over ICQ sub menu and press <b>right</b> mouse button to activate ICQ context menu.
 After the menu options there is text field. See picture 7. Enter your buddy username/id and press the button next to the field.
 </p><div align="center">
 <img src="images/qsend.png" title="Send to user by ID"><br>
 Picture 7
 </div>
 New message window will appear and you can <a href="#working-4">send messages to the user</a>.
 
 <br>The same steps apply for all protocols.
 <blockquote><span style="color: red;">Notice:</span>
 Some Instant Message(IM) networks like MSN allow message to be send only to online users.
 </blockquote>
 <p></p>
 
 <h3><a name="working-13">Changing presence status</a></h3>
 <p>
 You can change you presence status for all active user or choose different statuses for user from different
 IM networks.
 </p>
 <p>If you want to change your "global" status to "AWAY" you can do it from the select box which is locate on the bottom
 of the main window. All you need to do if is to select AWAY option. All online users in your contact list will
 receive your "AWAY" presence status.
 </p>
 <p>If you want to change your presence status, only in ICQ, to BUSY move your mouse over the ICQ sub menu and
 press left mouse button. New menu with the available statuses will appear. Choose "AWAY" and left click it.
 <br>
 See also picture 8.
 </p><div align="center">
 <img src="images/status.png" title="Logged to Laffer Web Client"><br>
 Picture 8
 </div>
 <p></p>
 <h3><a name="working-14">Disconnecting</a></h3>
 <p>You can disconnect from all IM networks or only from one. Read <a href="#working-13">Changing presence status</a>
 and choose OFFLINE from the options.
 </p><p>There is another way to disconnect from all IM networks. Move the mouse pointer over '-- IM networks --'
 and press the <b>right</b> mouse button. IM networks context menu will appear.
 Left click over the "Disconnect all" option.
 </p>
 <p>Take a look at the other option in this context menu "Connect all". If you press on this option Laffer Web Client(LWC)
 will try to log you to all IM networks for which you have stored your password. See <a href="#working-3">Connecting to IM networks, like ICQ</a>
 for details.
 </p>
 
 <h3><a name="working-15">Cleaning users and groups from visible contact list</a></h3>
 <p>If you disconnect from IM network the users and groups for this network continue to appear in your
 contact list. There is a way to "clean" those users and groups from the contact list.
 Move the mouse over the disconnected IM network and press the <b>right</b> mouse button. The IM network context menu
 will appear and the last option in this menu is "Clean groups".
 </p><blockquote><span style="color: red;">Notice:</span>
 Pressing "Clean groups" option will clean groups and users only from the current contact list. This will
 not affect in any way your contact list stored on the remote IM server.
 </blockquote>
 <p></p>
 
 <h2><a name="unk-opts">Not so known options</a></h2>
 <p>
 On the top of the main window there are some strange symbols. See picture 9
 </p><div align="center">
 <img src="images/unk-opts.png" title="Configuration options"><br>
 Picture 9
 </div>
 By clicking with the left mouse button over one of these links you can change some settings of the Laffer Web Client.
 
 <h3><a name="unk-opts-1">Show/Hide users' ids</a></h3>
 <p>If you click on "ID[+/-]" you will start to see your buddies ids next to their names.
 Clicking second time over the same option will return the old setting.</p>
 
 <h3><a name="unk-opts-2">Show/Hide online users only</a></h3>
 <p>If you click on "O[+/-]" you will start to see your online buddies only. Those groups that contain only offline users
 will stop to be displayed.
 Clicking second time over the same option will return the old setting. </p>
 
 <h3><a name="unk-opts-3">Don't/Open new pop-up window on new message</a></h3>
 <p>If you click on "W[+/-]" a new window will open automatically when new message arrives.
 Clicking second time over the same option will return the old setting.</p>
 
 <h3><a name="unk-opts-4">Conference/Chat Room</a></h3>
 <p>Clicking
over "RoomFrame" will open new window where you can talk with all users
that are online and that are logged to this Laffer server. This is
ideal for talking with more than one user at a time. </p>
 
 <h3><a name="unk-opts-5">Last users that you have talked with</a></h3>
 <p>Right below these special links and above the contact list you will see the recent buddies that you have
 talked with. Useful for quick reply.
 </p>
 
 <h3><a name="unk-opts-6">Finding users in the visible contact list</a></h3>
 It is difficult to find out a user if you have long contact list. Focus your browser over the contact list.
 Press CTRL+F. Find dialog will appear. Enter the name of the buddy you want to find and hit enter.
 <blockquote><span style="color: red;">Notice:</span>
 In Mozilla based browsers, like Firefox, you can press "/" and activate "Search As You Type" dialog of your browser.
 </blockquote>
 <p>
 
 </p><h2><a name="meta">Meta</a></h2>
 <p>This manual is written by Slavej Karadjov for Laffer Web Client(LWC) version  0.3.2.6 or bigger.<br>
 LWC is part of the <a href="http://laffer.sf.net/">Laffer Project</a>.<br>
 LWC is free software under GPL license.
 </p><br>
 		<p align="center"><font face="verdana, arial, helvetica, geneva" size="-1"><a href="howto-translate-laffer-userinterface.html"> &lt;&lt; How To Translate Laffer Interface To Your Favourite Language</a> | <a href="http://laffer.sourceforge.net/cgi-bin/index.pl?page=article&amp;id=docs&amp;key="> &gt;&gt;</a></font><br>
 	</p></td>
 </tr>
 </tbody></table>
 
 <!-- SEPARATOR TABLE -->
 <table align="center" border="0" cellpadding="0" cellspacing="0" width="90%">
 <tbody><tr>
 	<td><img src="images/clearpixel.gif" height="8" width="1"></td>
 </tr>
 <tr>
 	<td bgcolor="#999999"><img src="images/clearpixel.gif" height="1" width="1"></td>
 </tr>
 <tr>
 	<td bgcolor="#cccccc"><img src="images/clearpixel.gif" height="4" width="1"></td>
 </tr>
 <tr>
 	<td bgcolor="#999999"><img src="images/clearpixel.gif" height="1" width="1"></td>
 </tr>
 <tr>
 	<td><img src="images/clearpixel.gif" height="8" width="1"></td>
 </tr>
 </tbody></table>
 <!-- SEPARATOR TABLE -->
 
 <table align="center" border="0" cellpadding="0" cellspacing="0" width="90%">
 <tbody><tr>
 	<td class="disclaimer">
 	<p class="disclaimer" align="center">
 		<em>All materials in this site are published under <a rel="license" href="http://creativecommons.org/licenses/by-nc/2.0/" target="_blank">Creative Commons License</a> unless otherwise noted.
 		<a rel="license" href="http://creativecommons.org/licenses/by-nc/2.0/" target="_blank"><img alt="Creative Commons License" src="images/somerights20.png" valign="top" align="right" border="0"></a>
 		<br>All trademarks, logos and copyrights mentioned on this site are the property of their respective owners.
 		<br>
 		Copyright © 2004-2005 Slavei Karadjov.
 		<br>
 		All rights reserved. 
 	</em></p>
<em> 	</em></td>
 </tr>
 </tbody></table>
Return current item: Laffer