README
------

NAME

Net::ICQ::On - ICQ Online Tester

SYNOPSIS

  use Net::ICQ::On;

  my $Online=Net::ICQ::On->Test(<ICQ No./>);

  my $Online=Net::ICQ::On->Test(204913808);
  print "My ICQ number is ";
  if ($Online==1) { print "<span style=\"color: green;\">204913808
</span>.\n"; }
  else { print "204913808.\n"; }

DESCRIPTION

This module tests the online state of any ICQ user and returns 1 for
online or 0 for offline.  It downloads the smallest ICQ online gif and
analyses it to determine the online state of the user.  No ICQ account is
necessary.  No ICQ server login is necessary.  This makes it quick to
return a result.

It was designed to replace the trademark large ICQ flower GIF that ICQ
promotes as a form of online test suitable for webpages because it didn't
fit into the footer of my website.  This was coded initially for my
website and then developed into a useful Perl module registered at CPAN.

Example uses:

* In xhtml, see above example, on a homepage to display your ICQ number
in green if you're online or in the default colour if you're offline.

* As an interface for ICQ cam live support.  Provide the option to
connect via ICQ if you are online else display an email link.

* To redirect email to ICQ if the recipient is online.

UPDATED

Version 1.10.6 (20060407): Minor documentation update.
Version 1.10.5 (20060404): Minor documentation update.
Version 1.10.4 (20060324): Minor code update.
Version 1.10.3 (20060321): Updated distribution.
Version 1.10.2 (20060320): Changed name of function.  Minor code
updates.  Updated documentation.
Version 1.9.4: Changed to HTTP::Request::Common for simplicity and
optimisation.

VERSION

v1.10.7 (20060528)

COPYRIGHT

Code is copyright (c)2005-6 Jerome McKean, Dream Frequency.  ICQ is
copyright (c)1998-2006 ICQ Inc..

AUTHOR INFORMATION

Net::ICQ::On was created by Jerome McKean (jerome@dreamfrequency.com),
owner of Dream Frequency (http://dreamfrequency.com), Useful Windows
Software and Adult Frequency (http://adultfrequency.com), Adult
Windows Software.  This Perl module is free software and may be freely
redistributed unchanged.