README ------ NAME Net::ICQ::On - ICQ Online Tester SYNOPSIS use Net::ICQ::On; my $Online=Net::ICQ::On->Test(); my $Online=Net::ICQ::On->Test(555123456); print "My ICQ number is "; if ($Online==1) { print "555123456 .\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.