Net::ICQ::On - ICQ Online Tester - Net::ICQ::On - ICQ Online Tester v1.10.7 (20060528) - Registered at CPAN



SYNOPSIS



use ICQOn;



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.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.

Versions 1.9.1, 1.9.0, 1.7, 1.6, 1.5, 1.4, 1.3: Previous versions.



VERSION



v1.10.7 (20060528)



COPYRIGHT



Code is copyright (c)2005-6 Jerome McKean, Dream Frequency. ICQ is copyright (c)1998-2005 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.