poe::component::irc::plugin::nickservid(3pm) [debian man page]

POE::Component::IRC::Plugin::NickServID(3pm)		User Contributed Perl Documentation	      POE::Component::IRC::Plugin::NickServID(3pm)

NAME

       POE::Component::IRC::Plugin::NickServID - A PoCo-IRC plugin which identifies with NickServ when needed

SYNOPSIS

	use POE::Component::IRC::Plugin::NickServID;

	$irc->plugin_add( 'NickServID', POE::Component::IRC::Plugin::NickServID->new(
	    Password => 'opensesame'
	));

DESCRIPTION

       POE::Component::IRC::Plugin::NickServID is a POE::Component::IRC plugin. It identifies with NickServ on connect and when you change your
       nick, if your nickname matches the supplied password.

       Note: If you have a cloak and you don't want to be seen without it, make sure you don't join channels until after you've identified
       yourself. If you use the AutoJoin plugin, it will be taken care of for you.

METHODS

   "new"
       Arguments:

       'Password', the NickServ password.

       Returns a plugin object suitable for feeding to POE::Component::IRC's plugin_add() method.

OUTPUT EVENTS

   "irc_identified"
       This event will be sent when you have identified with NickServ. No arguments are passed with it.

AUTHOR

       Hinrik Oern Sigur`sson, hinrik.sig@gmail.com

perl v5.14.2							    2011-12-07			      POE::Component::IRC::Plugin::NickServID(3pm)

POE::Component::IRC::Plugin::NickReclaim(3pm)		User Contributed Perl Documentation	     POE::Component::IRC::Plugin::NickReclaim(3pm)

NAME

       POE::Component::IRC::Plugin::NickReclaim - A PoCo-IRC plugin for reclaiming your nickname

SYNOPSIS

	use strict;
	use warnings;
	use POE qw(Component::IRC Component::IRC::Plugin::NickReclaim);

	my $nickname = 'Flibble' . $$;
	my $ircname = 'Flibble the Sailor Bot';
	my $ircserver = 'irc.blahblahblah.irc';
	my $port = 6667;

	my $irc = POE::Component::IRC->spawn(
	    nick => $nickname,
	    server => $ircserver,
	    port => $port,
	    ircname => $ircname,
	) or die "Oh noooo! $!";

	POE::Session->create(
	    package_states => [
		main => [ qw(_start) ],
	    ],
	);

	 $poe_kernel->run();

	sub _start {
	    $irc->yield( register => 'all' );

	    # Create and load our NickReclaim plugin, before we connect
	    $irc->plugin_add( 'NickReclaim' =>
		POE::Component::IRC::Plugin::NickReclaim->new( poll => 30 ) );

	    $irc->yield( connect => { } );
	    return;
	}

DESCRIPTION

       POE::Component::IRC::Plugin::NickReclaim - A POE::Component::IRC plugin automagically deals with your bot's nickname being in use and
       reclaims it when it becomes available again.

       It registers and handles 'irc_433' events. On receiving a 433 event it will reset the nickname to the 'nick' specified with "spawn" or
       "connect", appendedwith an underscore, and then poll to try and change it to the original nickname. If someone in your channel who has the
       nickname you're after quits or changes nickname, the plugin will try to reclaim it immediately.

METHODS

   "new"
       Takes one optional argument:

       'poll', the number of seconds between nick change attempts, default is 30;

       Returns a plugin object suitable for feeding to POE::Component::IRC's "plugin_add" method.

AUTHOR

       Chris 'BinGOs' Williams

       With amendments applied by Zoffix Znet

SEE ALSO

       POE::Component::IRC

perl v5.14.2							    2011-12-07			     POE::Component::IRC::Plugin::NickReclaim(3pm)