summaryrefslogtreecommitdiff
path: root/plugins/Irc/extlib/phergie/Phergie/Plugin/Ctcp.php
blob: e79fcf13ee35dae3b6ca4eb07f835b7cab6c937a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
<?php
/**
 * Phergie
 *
 * PHP version 5
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.
 * It is also available through the world-wide-web at this URL:
 * http://phergie.org/license
 *
 * @category  Phergie
 * @package   Phergie_Plugin_Ctcp
 * @author    Phergie Development Team <team@phergie.org>
 * @copyright 2008-2010 Phergie Development Team (http://phergie.org)
 * @license   http://phergie.org/license New BSD License
 * @link      http://pear.phergie.org/package/Phergie_Plugin_Ctcp
 */

/**
 * Responds to various CTCP requests sent by the server and users.
 *
 * @category Phergie
 * @package  Phergie_Plugin_Ctcp
 * @author   Phergie Development Team <team@phergie.org>
 * @license  http://phergie.org/license New BSD License
 * @link     http://pear.phergie.org/package/Phergie_Plugin_Ctcp
 * @link     http://www.irchelp.org/irchelp/rfc/ctcpspec.html
 */
class Phergie_Plugin_Ctcp extends Phergie_Plugin_Abstract
{
    /**
     * Responds to a CTCP TIME request from a user with the current local
     * time.
     *
     * @return void
     */
    public function onTime()
    {
        $source = $this->getEvent()->getSource();
        $this->doTime($source, strftime('%c %z'));
    }

    /**
     * Responds to a CTCP VERSION request from a user with the codebase
     * version.
     *
     * @return void
     */
    public function onVersion()
    {
        $source = $this->getEvent()->getSource();
        $msg = 'Phergie ' . Phergie_Bot::VERSION . ' (http://phergie.org)';
        $this->doVersion($source, $msg);
    }

    /**
     * Responds to a CTCP PING request from a user.
     *
     * @return void
     */
    public function onCtcpPing()
    {
        $event = $this->getEvent();
        $source = $event->getSource();
        $handshake = $event->getArgument(1);
        $this->doPing($source, $handshake);
    }

    /**
     * Responds to a CTCP FINGER request from a user.
     *
     * @return void
     */
    public function onFinger()
    {
        $connection = $this->getConnection();
        $name = $connection->getNick();
        $realname = $connection->getRealname();
        $username = $connection->getUsername();

        $finger
            = (empty($realname) ? $realname : $name) .
            ' (' . (!empty($username) ? $username : $name) . ')';

        $this->doFinger($source, $finger);
    }
}
?>