Web component 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. 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).
There is no need to download and preinstall any plug-ins. It works
through HTTP and will be Ok with your corporate firewall.
How to use it: a) copy cobrowsePackage.jar into WEB-INF/lib directory b) describe servlet in web.xml file. You must set an initial parameter for this servlet describes interface settings. Parameter name is config. So for your web.xml you need to add some like this:
<servlet> <servlet-name>Cobrowse</servlet-name> <servlet-class>com.jsos.cobrowse.CobrowseServlet</servlet-class> <init-param> <param-name>config</param-name> <param-value>path_to_your_configuration_file</param-value> </init-param> </servlet> c) describe a mapping for this servlet in web.xml file. E.g.:
<servlet-mapping> <servlet-name>Cobrowse</servlet-name> <url-pattern>/servlet/Cobrowse</url-pattern> </servlet-mapping> d) run servlet: http://your_host/servlet/Cobrowse
Configuration file is a text file, each line describes one parameter in the form of param=value Empty lines and any line starts with # or // are ignored. Current version supports the following list of parameters: # working directory (cache) on your server. This parameter is mandatory
# cookie support: 1 - enabled, 0 - disabled
# background for main frame (master and slave mode). Default value is
#FFFFFF
# proxy settings. If your host needs proxy for access
# foreground for main frame (master and slave mode). Default value is
#000000
# background for control frame (master mode). Default value is #FFFFF
# foreground for control frame (master mode). Default value is #000000
# background for control frame (slave mode). Default value is #D3D3D3
# foreground for control frame (slave mode). Default value is #000000
# font size (by default is current browser's font)
#font face (by default is current browser's font settings)
# title. Default value is 'Coldbeans's co-browsing'
# header. You can set here some file contains any html-code. This code
will be
# footer. You can set here some file contains any html-code. This code
will be
# enable/disable chat on slave sessions. Default value is 1 (chat is enabled)
# define a list of sites available for cobrowsing. By default is empty (any site is available)
# You may set parameters for chat's window as a set of JavaScript's attributes.
# enable/disable DHTML for chat. Default value is 1 (enabled).
# localization support. You can set character encoding for input parameters
Notes:
Customization 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. Create a new session:
Join to existing session:
for example this HTML code connects user 'Guest' to the session 'test':
<form method="post" action="http://your_host/servlet/Cobrowse?a=jn"> <input type="hidden" name="ssnm" value="test"> <input type="hidden" name="un" value="Guest"> </form> ... <script language="JavaScript"> document.forms[0].submit(); </script> For downloading: cobrowsePackage.jar See also JSOS - the largest collection of servlets and filters.
|
Also in Coldtags:
|