A JAVA web application for chatting with website visitors over the icq network

news | download | screenshot | documentation

News:



June 07, 2006: web2icq v 0.3 released

Cleaned up code and included jcq2k in the archive. You may skip step 3 in the installtion process.

June 02, 2003: web2icq v 0.2 released

This is the first beta release. I've been using this on my site for the last few months without any problems.
If you find any bugs or just want to say hi, please send me a note at icq# 18771000 or bryan@bryanhiggins.net.



Documentation:



Installation

  1. Install Apache Tomcat (or any servlet container). http://jakarta.apache.org/tomcat/index.html

  2. Unpack the web2icq archive into the webapps directory.

  3. Download the jcq2k library from http://sourceforge.net/projects/jcq2k
    Unpack the archive.
    Move classes/org to webapps/web2icq/WEB-INF/classes/.
    Move src/org/jcq2k/icq2k/ICQ2KMessagingNetwork.properties to webapps/web2icq/WEB-INF/classes/org/jcq2k/icq2k/
    Move lib/log4j.jar to webapps/web2icq/WEB-INF/lib/

  4. Configure webapps/web2icq/WEB-INF/classes/org/jcq2k/icq2k/ICQ2KMessagingNetwork.properties
    The default settings should be fine in most cases.

  5. Use an icq client to create a new account for this application.
    Add your regular account to its contact list and vice versa, ensuring both are authorized.

  6. Configure webapps/web2icq/WEB-INF/web2icq.conf
    loginid -> icq# you created
    password -> password you assigned to the new account
    clientloginid -> icq# of your regular account
    clientnick -> screen name for conversations
    codebase -> change if you rename the web2icq directory
    title -> title for the applet
    bgcolor -> 9 digits representing the RGB background color (RRRGGGBBB)
    color -> 9 digits representing the RBB foreground color (RRRGGGBBB)

  7. Deploy the application.
    Refer to the Apache Tomcat (or other servlet container) documentation for details.

  8. Add a link. I use the following JavaScript code to open a window:

    <SCRIPT Language='JavaScript'>
    <!--
    function openwindow() {
    window.open('/icq/','icq','resizable=yes,scrollbars=auto,width=520,height=220');
    }
    document.write('<a href='JavaScript:openwindow()'>Launch IM Applet</a>');
    -->
    </SCRIPT>


  9. To add a status image to your webpage use: <img src='/web2icq/servlet/ICQMessageHandler?image=true'>

Useage
  • When an applet has started, a sign-in message should be sent to your icq account.
  • A sign off message is sent when an applet closes.
  • Any messages recieved from an applet will be sent to your icq account.
  • When you change your status, all applets are automatically updated.
The following commands are available by sending a message to the applications's account (using any icq client):
  • screenname message -> sends a message to the user identified as screenname
  • r message -> replys to the last person to send you a message
  • l -> lists the screen names of all users online



SourceForge.net Logo

Copyright (c) 2003 by Bryan Higgins <bryan@bryanhiggins.net>.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License. See LICENSE for details.
web2icq is NOT endorsed by or affiliated with AOL Time Warner