Monday, May 4, 2009

Installing the Instant STLinks package

Instant STLinks a customized version of IBM Lotus STLinks. It presents a much richer UI and allows you to display a customized feedback form before the chat begins.
First, you need to unzip the file called ‘Instant STLinks package.zip’ Use the extract method, rather than dragging and dropping the files out of the zip file. If done correctly, the extracted files should all be in one folder called ‘InstantStlinks’
Sametime comes equiped by default with an STLinks package. It can be found on your Sametime Server located by default at: ..domino/data/domino/html/Sametime/stlinks
It is best to leave this package alone and place the Instant STLinks package as a separate folder in the directory ..domino/data/domino/html/Sametime/
So in the Sametime folder, you will have two STLinks packages. One in the folder ‘stlinks’, and the other in the folder ‘InstantSTLinks’
At this point, the STLinks package is installed. Next we need to create a test HTML page which uses custom STLinks.
There are two ways to enable your webpage with the Instant STLinks package. When an agent clicks your STLink on your webpage, you can choose to have them be directed to the Information Submission form, or directly to the chat window. Both options will first require you to setup the html code on your webpage (By default the Instant STLinks package is set to direct a web visitor to the information submission form; see above sections for how to disable this). Below are the basic elements you need to setup an STLink on your webpage.
<head>
<link rel="STYLESHEET" href="”<CODEBASE">/stlinks.css" TYPE="text/css">
<script src="">/stlinks.js"> </script>
<script> setSTLinksURL("<codebase>");
</script>
<script> writeSTLinksApplet("Web Visitor","",false);
</script>
</head>
<body>
<script>
writeSametimeLink("<sametime>","<display>",false,<openform?>);
</script>
</body>


The first part is the code which goes into the head of your html page. This is code required to prepare the STLinks. is the path to the Instant STLinks directory on your Sametime server. For example if you are using Lotus’s stock STLinks package, would be “http://mydom.mycompany.com/Sametime/STLinks The second part is the code which you can place in the body of your html page. This is the code which actually creates the link to start the chat. is the Sametime username written like you would use it to login on a Sametime client (Note this needs to be case sensitive). is the name which will be displayed on your web page as the STLink. is an optional variable, meaning that you do not need to include it. However, if it equals true, then the Information submission form will be opened (if it is set to in stlinks.js). If it equals false, the Info form is not opened. This is useful if you have multiple STLinks on one webpage, where some are links to QueueBots and others are not.

No comments: