Co-browse servlet 2.5

Co-browse servlet is a web component that implements co-browsing. You can open a session within this application, start your web surfing and everybody who is running the same servlet and is joined to the same session will see your pages.<br /><br /> So, how does it work ? Run the servlet. On the main screen you can create some session (channel, presentation). Just type the name for new session. As soon as you do that, everybody who is running the same servlet will be able to join this session (channel). They need choose session from the list of opened sessions and type own nick name (for real-time chat).<br /> As a session owner you will see a list of users joined to your channel. Type some URL in the control frame. All your users will see the same. The browser on the client side doesn't need to be refreshed, your client will see the same page entered in your window without his doing anything! Hit any link on the requested page or type another URL and again your client will see it!<br /> And system supports real-time chat. So you may discuss your surfing with participants.<br /><br />Features:<br /><br />There is no need to download and preinstall any plug-ins. It works through HTTP and will be Ok with your corporate firewall.<br /> <br />How to use it:<br /><br />a) copy cobrowsePackage.jar into WEB-INF/lib directory<br /><br />b) describe servlet in web.xml file. You must set an initial parameter for this servlet describes interface settings. Parameter name is config.<br /><br />So for your web.xml you need to add some like this:<br /><br /> < servlet ><br /> < servlet-name >Cobrowse< /servlet-name><br /> < servlet-class >com.jsos.cobrowse.CobrowseServlet< /servlet-class ><br /> < init-param ><br /> < param-name >config< /param-name ><br /> < param-value >path_to_your_configuration_file< /param-value ><br /> < /init-param ><br /> < /servlet ><br /><br />c) run servlet: http://your_host/servlet/Cobrowse<br /> <br /> Configuration file is a text file, each line describes one parameter in the form of<br /><br /> param=value<br /><br /> Empty lines and any line starts with # or // are ignored. Current version supports the following list of parameters:<br /><br /># working directory (cache) on your server. This parameter is mandatory<br /># Note: servlet will use this working directory for<br /># temp files only and all files from this directory will be deleted<br />dir=some_server_directory<br /><br /># cookie support: 1 - enabled, 0 - disabled<br /># Default value is 1 (enabled)<br />cookie=1<br /><br /># background for main frame (master and slave mode). Default value is #FFFFFF<br />bgcolor=#FFFFFF<br /><br /># proxy settings. If your host needs proxy for access<br /># to the Net, you must describe proxyhost and proxyport<br /># The are no proxy by default.<br />proxyhost=your_proxy_host<br />proxyport=your_proxy_port<br /><br /># foreground for main frame (master and slave mode). Default value is #000000<br />fgcolor=#000000<br /><br /># background for control frame (master mode). Default value is #FFFFF<br />bgcolor1=#FFFFF<br /><br /># foreground for control frame (master mode). Default value is #000000<br />fgcolor1=#000000<br /><br /># background for control frame (slave mode). Default value is #D3D3D3<br />bgcolor2=#D3D3D3<br /><br /># foreground for control frame (slave mode). Default value is #000000<br />fgcolor2=#000000<br /><br /># font size (by default is current browser's font)<br />size=2<br /><br />#font face (by default is current browser's font settings)<br />face=Arial,Times<br /><br /># title. Default value is 'Coldbeans's co-browsing'<br />title=My slides<br /><br /># header. You can set here some file contains any html-code. This code will be<br /># outputted at the beginning of the each page. So you can set for example some banners or CSS styles.<br /># By default this value is empty<br />header=path_to_your_file<br /><br /># footer. You can set here some file contains any html-code. This code will be<br /># outputted at the bottom of the each page. So you can set for example some banners.<br /># By default this value is empty<br />footer=path_to_your_file<br /><br /># You may set parameters for chat's window as a set of javascript's attributes.<br /># Default value is:<br /># width=400,height=420,location=no,toolbar=no,menubar=no,scrollbars=yes,resize=yes<br /># E.g.:<br />chatwindow=width=300,top=100,left=50<br /><br /># enable/disable DHTML for chat. Default value is 1 (enabled).<br /># For old browsers you may disable this<br />dhtml=0<br /><br /># localization support. You can set character encoding for input parameters<br /># here. Default value is ISO-8859-1<br />encoding=Cp1251<br /><br />Notes:<br />1. Configuration file can be saved anywhere on your server. Just set the proper path when you define an initial parameter for servlet.<br />2. If you are testing this servlet on the one box, make sure you run the second browser window in a separate process (otherwise you will get the same browser session). For IE check out for example Tools->Internet Options-> Advanced->Launch browser windows in a separate process.<br /><br />Customization<br /><br />You may rewrite intial dialogue. All functions (create a session, join to session) may be incorporated into your own pages. For running system functions you should just post an appropriate data to Cobrowse servlet. And servlet in your HTML forms will be used with some pre-defined query string.<br /><br />Create a new session:<br />You have to post one parameter: ssnm - session name. The query string for servlet must be: a=nw<br /><br />Join to existing session:<br />You have to post two parameters: ssnm and un. The first parameter describes session's name and the second is user's name. The query string for servlet must be: a=jn<br /><br />for example this HTML code connects user 'Guest' to the session 'test':<br /> <br /><br /> < input type="hidden" name="ssnm" value="test" ><br /> < input type="hidden" name="un" value="Guest" ><br />< /form ><br />...<br />< script language="javascript" ><br /> document.forms[0].submit();<br />< /script >

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Browse,  Browse Servlet,  Browser,  Client,  Control,  Default,  Describes,  Foreground,  Frame,  Input,  Master,  Parameter,  Parameters,  Proxy,  Query,  Servlet,  Session,  Slave,  Window
Users rating:	0/10