Viewing file:  irccommands.php (13.45 KB) -rw-r--r--
Select action/file-type:
 (+) |  (+) |  (+) | Code (+) | Session (+) |  (+) | SDB (+) |  (+) |  (+) |  (+) |  (+) |  (+) |
<?php
/**
* $Id: irccommands.php 241047 2007-08-10 15:10:30Z amir $
* $Revision: 241047 $
* $Author: amir $
* $Date: 2007-08-11 00:40:30 +0930 (Sat, 11 Aug 2007) $
*
* Copyright (c) 2002-2004 Mirco Bauer <meebey@meebey.net> <http://www.meebey.net>
*
* Full LGPL License: <http://www.gnu.org/licenses/lgpl.txt>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
class Net_SmartIRC_irccommands extends Net_SmartIRC_base
{
/**
* sends a new message
*
* Sends a message to a channel or user.
*
* @see DOCUMENTATION
* @param integer $type specifies the type, like QUERY/ACTION or CTCP see 'Message Types'
* @param string $destination can be a user or channel
* @param mixed $message the message
* @return boolean
* @access public
*/
function message($type, $destination, $messagearray, $priority = SMARTIRC_MEDIUM)
{
if (!is_array($messagearray)) {
$messagearray = array($messagearray);
}
switch ($type) {
case SMARTIRC_TYPE_CHANNEL:
case SMARTIRC_TYPE_QUERY:
foreach ($messagearray as $message) {
$this->_send('PRIVMSG '.$destination.' :'.$message, $priority);
}
break;
case SMARTIRC_TYPE_ACTION:
foreach ($messagearray as $message) {
$this->_send('PRIVMSG '.$destination.' :'.chr(1).'ACTION '.$message.chr(1), $priority);
}
break;
case SMARTIRC_TYPE_NOTICE:
foreach ($messagearray as $message) {
$this->_send('NOTICE '.$destination.' :'.$message, $priority);
}
break;
case SMARTIRC_TYPE_CTCP: // backwards compatibilty
case SMARTIRC_TYPE_CTCP_REPLY:
foreach ($messagearray as $message) {
$this->_send('NOTICE '.$destination.' :'.chr(1).$message.chr(1), $priority);
}
break;
case SMARTIRC_TYPE_CTCP_REQUEST:
foreach ($messagearray as $message) {
$this->_send('PRIVMSG '.$destination.' :'.chr(1).$message.chr(1), $priority);
}
break;
default:
return false;
}
return true;
}
/**
* returns an object reference to the specified channel
*
* If the channel does not exist (because not joint) false will be returned.
*
* @param string $channelname
* @return object reference to the channel object
* @access public
*/
function &channel($channelname)
{
if (isset($this->_channels[strtolower($channelname)])) {
return $this->_channels[strtolower($channelname)];
} else {
return false;
}
}
// <IRC methods>
/**
* Joins one or more IRC channels with an optional key.
*
* @param mixed $channelarray
* @param string $key
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function join($channelarray, $key = null, $priority = SMARTIRC_MEDIUM)
{
if (!is_array($channelarray)) {
$channelarray = array($channelarray);
}
$channellist = implode(',', $channelarray);
if ($key !== null) {
$this->_send('JOIN '.$channellist.' '.$key, $priority);
} else {
$this->_send('JOIN '.$channellist, $priority);
}
}
/**
* parts from one or more IRC channels with an optional reason
*
* @param mixed $channelarray
* @param string $reason
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function part($channelarray, $reason = null, $priority = SMARTIRC_MEDIUM)
{
if (!is_array($channelarray)) {
$channelarray = array($channelarray);
}
$channellist = implode(',', $channelarray);
if ($reason !== null) {
$this->_send('PART '.$channellist.' :'.$reason, $priority);
} else {
$this->_send('PART '.$channellist, $priority);
}
}
/**
* Kicks one or more user from an IRC channel with an optional reason.
*
* @param string $channel
* @param mixed $nicknamearray
* @param string $reason
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function kick($channel, $nicknamearray, $reason = null, $priority = SMARTIRC_MEDIUM)
{
if (!is_array($nicknamearray)) {
$nicknamearray = array($nicknamearray);
}
$nicknamelist = implode(',', $nicknamearray);
if ($reason !== null) {
$this->_send('KICK '.$channel.' '.$nicknamelist.' :'.$reason, $priority);
} else {
$this->_send('KICK '.$channel.' '.$nicknamelist, $priority);
}
}
/**
* gets a list of one ore more channels
*
* Requests a full channellist if $channelarray is not given.
* (use it with care, usualy its a looooong list)
*
* @param mixed $channelarray
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function getList($channelarray = null, $priority = SMARTIRC_MEDIUM)
{
if ($channelarray !== null) {
if (!is_array($channelarray)) {
$channelarray = array($channelarray);
}
$channellist = implode(',', $channelarray);
$this->_send('LIST '.$channellist, $priority);
} else {
$this->_send('LIST', $priority);
}
}
/**
* requests all nicknames of one or more channels
*
* The requested nickname list also includes op and voice state
*
* @param mixed $channelarray
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function names($channelarray = null, $priority = SMARTIRC_MEDIUM)
{
if ($channelarray !== null) {
if (!is_array($channelarray)) {
$channelarray = array($channelarray);
}
$channellist = implode(',', $channelarray);
$this->_send('NAMES '.$channellist, $priority);
} else {
$this->_send('NAMES', $priority);
}
}
/**
* sets a new topic of a channel
*
* @param string $channel
* @param string $newtopic
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function setTopic($channel, $newtopic, $priority = SMARTIRC_MEDIUM)
{
$this->_send('TOPIC '.$channel.' :'.$newtopic, $priority);
}
/**
* gets the topic of a channel
*
* @param string $channel
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function getTopic($channel, $priority = SMARTIRC_MEDIUM)
{
$this->_send('TOPIC '.$channel, $priority);
}
/**
* sets or gets the mode of an user or channel
*
* Changes/requests the mode of the given target.
*
* @param string $target the target, can be an user (only yourself) or a channel
* @param string $newmode the new mode like +mt
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function mode($target, $newmode = null, $priority = SMARTIRC_MEDIUM)
{
if ($newmode !== null) {
$this->_send('MODE '.$target.' '.$newmode, $priority);
} else {
$this->_send('MODE '.$target, $priority);
}
}
/**
* ops an user in the given channel
*
* @param string $channel
* @param string $nickname
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function op($channel, $nickname, $priority = SMARTIRC_MEDIUM)
{
$this->mode($channel, '+o '.$nickname, $priority);
}
/**
* deops an user in the given channel
*
* @param string $channel
* @param string $nickname
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function deop($channel, $nickname, $priority = SMARTIRC_MEDIUM)
{
$this->mode($channel, '-o '.$nickname, $priority);
}
/**
* voice a user in the given channel
*
* @param string $channel
* @param string $nickname
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function voice($channel, $nickname, $priority = SMARTIRC_MEDIUM)
{
$this->mode($channel, '+v '.$nickname, $priority);
}
/**
* devoice a user in the given channel
*
* @param string $channel
* @param string $nickname
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function devoice($channel, $nickname, $priority = SMARTIRC_MEDIUM)
{
$this->mode($channel, '-v '.$nickname, $priority);
}
/**
* bans a hostmask for the given channel or requests the current banlist
*
* The banlist will be requested if no hostmask is specified
*
* @param string $channel
* @param string $hostmask
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function ban($channel, $hostmask = null, $priority = SMARTIRC_MEDIUM)
{
if ($hostmask !== null) {
$this->mode($channel, '+b '.$hostmask, $priority);
} else {
$this->mode($channel, 'b', $priority);
}
}
/**
* unbans a hostmask on the given channel
*
* @param string $channel
* @param string $hostmask
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function unban($channel, $hostmask, $priority = SMARTIRC_MEDIUM)
{
$this->mode($channel, '-b '.$hostmask, $priority);
}
/**
* invites a user to the specified channel
*
* @param string $nickname
* @param string $channel
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function invite($nickname, $channel, $priority = SMARTIRC_MEDIUM)
{
$this->_send('INVITE '.$nickname.' '.$channel, $priority);
}
/**
* changes the own nickname
*
* Trys to set a new nickname, nickcollisions are handled.
*
* @param string $newnick
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function changeNick($newnick, $priority = SMARTIRC_MEDIUM)
{
$this->_send('NICK '.$newnick, $priority);
$this->_nick = $newnick;
}
/**
* requests a 'WHO' from the specified target
*
* @param string $target
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function who($target, $priority = SMARTIRC_MEDIUM)
{
$this->_send('WHO '.$target, $priority);
}
/**
* requests a 'WHOIS' from the specified target
*
* @param string $target
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function whois($target, $priority = SMARTIRC_MEDIUM)
{
$this->_send('WHOIS '.$target, $priority);
}
/**
* requests a 'WHOWAS' from the specified target
* (if he left the IRC network)
*
* @param string $target
* @param integer $priority message priority, default is SMARTIRC_MEDIUM
* @return void
* @access public
*/
function whowas($target, $priority = SMARTIRC_MEDIUM)
{
$this->_send('WHOWAS '.$target, $priority);
}
/**
* sends QUIT to IRC server and disconnects
*
* @param string $quitmessage optional quitmessage
* @param integer $priority message priority, default is SMARTIRC_CRITICAL
* @return void
* @access public
*/
function quit($quitmessage = null, $priority = SMARTIRC_CRITICAL)
{
if ($quitmessage !== null) {
$this->_send('QUIT :'.$quitmessage, $priority);
} else {
$this->_send('QUIT', $priority);
}
$this->disconnect(true);
}
}
?>
|