NAME
POE::Component::IRC::Qnet - a fully event-driven IRC client module for Quakenet.
SYNOPSIS
use POE::Component::IRC::Qnet;
# Do this when you create your sessions. 'my client' is just a
# kernel alias to christen the new IRC connection with.
my ($object) = POE::Component::IRC::Qnet->new('my client') or die "Oh noooo! $!";
# Do stuff like this from within your sessions. This line tells the
# connection named "my client" to send your session the following
# events when they happen.
$kernel->post('my client', 'register', qw(connected msg public cdcc cping));
# You can guess what this line does.
$kernel->post('my client', 'connect',
{ Nick => 'Boolahman',
Server => 'irc-w.primenet.com',
Port => 6669,
Username => 'quetzal',
Ircname => 'Ask me about my colon!', } );DESCRIPTION
POE::Component::IRC::Qnet is an extension to POE::Component::IRC specifically for use on Quakenet http://www.quakenet.org/. See the documentation for POE::Component::IRC for general usage. This document covers the extensions.
The module provides a number of additional commands for communicating with the Quakenet service bots, Q and L.
METHODS
- service_bots
-
The component will query Q and L using their default names on Quakenet. If you wish to override these settings, use this method to configure them.
$self->service_bots( QBOT => 'W@blah.network.net', LBOT => 'Z@blah.network.net' );
In most cases you shouldn't need to mess with these >;o)
INPUT
The Quakenet service bots accept input as PRIVMSG. This module provides a wrapper around the POE::Component::IRC "privmsg" command.
- qbot_*
-
Send commands to the Q bot. Pass additional command parameters as arguments to the event.
$kernel->post ( 'my client' => qbot_auth => $q_user => $q_pass );
- lbot_*
-
Send commands to the L bot. Pass additional command parameters as arguments to the event.
$kernel->post ( 'my client' => lbot_chanlev => $channel );
OUTPUT
All output from the Quakenet service bots is sent as NOTICEs. Use 'irc_notice' to trap these.
- irc_whois
-
Has all the same hash keys in ARG1 as POE::Component::IRC, with the addition of 'account', which contains the name of their Q auth account, if they have authed, or undef if they haven't.
BUGS
A few have turned up in the past and they are sure to again. Please use http://rt.cpan.org/ to report any. Alternatively, email the current maintainer.
AUTHOR
Chris 'BinGOs' Williams <chris@bingosnet.co.uk>
Based on the original POE::Component::IRC by:
Dennis Taylor, <dennis@funkplanet.com>