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(555123456);
  print "My ICQ number is ";
  if ($Online==1) { print "<span style=\"color: green;\">555123456
</span>.\n"; }
  else { print "555123456.\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.11.0 (20100315): Update for new ICQ GIF image.
Version 1.10.8 (20060628): Minor documentation update.
Version 1.10.7 (20060528): Minor code update for new GIF and minor documentation update.
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.11.0 (20100315)

COPYRIGHT

Code is copyright (c)2005-2010 Pro Frequency.  ICQ is
copyright (c)1998-2010 ICQ Inc..

AUTHOR INFORMATION

Net::ICQ::On was created Pro Frequency (http://profrequency.com),
Professional Computing Products.  A division of frequency
(http://aboutf.com).  This Perl module is free software and may be
freely redistributed unchanged.