added bind and unbind functions & added the simple ExampleBot. (doesn't run right...
authorpk910 <philipp@zoelle1.de>
Wed, 27 Jul 2011 11:05:48 +0000 (13:05 +0200)
committerpk910 <philipp@zoelle1.de>
Wed, 27 Jul 2011 11:05:48 +0000 (13:05 +0200)
Bots/ExampleBot.class.php [new file with mode: 0644]
ModCMD/Binding.class.php
ModCMD/ModCMD.class.php
Uplink/Uplink.class.php

diff --git a/Bots/ExampleBot.class.php b/Bots/ExampleBot.class.php
new file mode 100644 (file)
index 0000000..b9f685d
--- /dev/null
@@ -0,0 +1,101 @@
+<?php
+/********************************* PHP-P10 ******************************
+ *    P10 uplink class by pk910   (c)2011 pk910                         *
+ ************************************************************************
+ *                          Version 2 (OOP)                             *
+ *                                                                      *
+ * PHP-P10 is free software; you can redistribute it and/or modify      *
+ * it under the terms of the GNU General Public License as published by *
+ * the Free Software Foundation; either version 2 of the License, or    *
+ * (at your option) any later version.                                  *
+ *                                                                      *
+ * This program 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 General Public License for more details.                         *
+ *                                                                      *
+ * You should have received a copy of the GNU General Public License    *
+ * along with PHP-P10; if not, write to the Free Software Foundation,   *
+ * Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA.       *
+ *                                                                      *
+ ************************************************************************
+ * 
+ *  Bots/ExampleBot.class.php
+ *
+ * a simple example bot...
+ *
+ */
+
+class {$_NAME} extends Bot {  // {$_NAME} will be replaced by our script later ;)
+       private $uplink;
+       private $example_bot;
+       public function load($uplink, $old = false) { //load is called when the module gets included
+               $this->uplink = $uplink; //Reference to the P10 Uplink
+               
+               //$old is only set, if the module is rehashed. It contains the return value of unload();
+               
+               if(!$old) {
+                       
+                       //Here you can define startup actions
+                       //We'll add an user to the Server
+                       // newuser($localid,$nick,$ident,$host,$realname,$uptime,$modes)   returns an array with the result
+                       // $localid  is just an id you can set (whatever you want) - maybe you'll use it to identify the bot/user later?
+                       
+                       $nick = "ExampleBot"; // Please note: If this user already exists on another Server it will be killed!
+                       $ident = "Example";
+                       $host = "Example.Bot";
+                       $realname = "Thats an example Bot :)";
+                       $modes = "i"; //we don't need a leading + (that will be added automatically)
+                       
+                       $this->example_bot = $this->uplink->addUser($nick,$ident,$host,$realname,$uptime,$modes); //addUser($nick, $ident, $host, $ip, $modes, $realname)
+                       if(is_a($this->example_bot, "P10_User")) { // A new user was created :)
+                               //ok  let's join a channel
+                               $this->uplink->join($this->example_bot, "#test");
+                               //now we want to say something...
+                               //but note: thats the startup procedure! the p10 server is not connected to an uplink, yet - so noone would recive our message (only the other bots on this server)
+                       }   
+               } else {
+                       $this->example_bot = $old; //We've saved out Bot reference in $old so we can simply use it again...
+               }
+               
+               //OK  send something to the Server is easy...
+               //How to recive something from the IRC Server?
+               
+               //I've copied the eggdrop way to do that - bind
+               ModCMD::bind($this, BIND_PRIVMSG, "recive_privmsg");
+               ModCMD::bind($this, BIND_QUIT, "recive_quit");
+       }
+       
+       public function loop() { //this function is triggered as often as possible (at least one time per second!). Maybe you need it to do timed events
+               //please don't trigger any blocking functions here... that would cause an extreme lagg!
+       }
+       
+       public function recive_privmsg($user, $channel, $message) {
+               //We've got a privmsg...
+               $exp=explode(" ",$message);
+               if($exp[0] == "hi") {
+                       $this->uplink->privmsg($this->example_bot, $channel, "Hallo ".$user->getNick()); // We send a message back - documentation is following
+               }
+               if($exp[0] == "-users") {
+                       $user_str = "";
+                       foreach($channel->getUsers() as $chan_user) {
+                               $extra="";
+                               $privs = $channel->getUserPrivs($chan_user);
+                               if(($privs & P10_Channel::USERPRIV_VOICE)) $extra= '+'; 
+                               if(($privs & P10_Channel::USERPRIV_OPED)) $extra= '@'; 
+                               $user_str .= " " . $extra . $chan_user->getNick();
+                       }
+                       $this->uplink->notice($this->example_bot, $user, "User in ".$channel->getName().":".$user_str);
+               }
+       }
+       
+       function recive_quit($user, $reason) {
+               if($user === $this->example_bot) { //maybe we got killed???
+                       $this->load($this->uplink);
+               }
+       }
+       
+}
+
+?>
\ No newline at end of file
index dfb247ffb7d4731626c9ce9b76cf5995b4967209..143b35ef2487e1c203a41b29a68ed2fe1f96bba6 100644 (file)
  */
 
 class Binding {
+       private $bot;
+       private $method;
        
-       public function trigger() {
-               
+       public function __construct($bot, $method) {
+               $this->bot = $bot;
+               $this->method = $method;
+       }
+       
+       public function trigger($params) {
+               call_user_func_array(array($this->bot, $this->method), $params);
+       }
+       
+       public function match($bot, $method) {
+               return ($bot === $this->bot && strtolower($this->method) == strtolower($method));
        }
        
 }
index cbd65111e94435b233c5428e6e738a1bbf9b819c..6c735a6bb28fcd90063559897bfcdf2f5d95c669 100644 (file)
@@ -60,6 +60,44 @@ class ModCMD implements EventHandler {
                return self::$eventHandler;
        }
        
+       public static function bind($bot, $type, $method) {
+               if(is_a($bot, "Bot") && method_exists($bot, $method)) {
+                       if(array_key_exists($type, self::$bindings)) {
+                               foreach(self::$bindings[$type] as $binding) {
+                                       if($binding->match($bot, $method))
+                                               return;
+                               }
+                       } else 
+                               self::$bindings[$type] = array();
+                       self::$bindings[$type][] = new Binding($bot, $method);
+               }
+       }
+       
+       public static function unbind($bot, $type, $method) {
+               if(is_a($bot, "Bot")) {
+                       if(array_key_exists($type, self::$bindings)) {
+                               foreach(self::$bindings[$type] as $id => $binding) {
+                                       if($binding->match($bot, $method)) {
+                                               unset(self::$bindings[$type][$id]);
+                                               break;
+                                       }
+                               }
+                       }
+               }
+       }
+       
+       public static function unbindBot($bot) {
+               if(is_a($bot, "Bot")) {
+                       foreach(self::$bindings as $type => $bindings) {
+                               foreach($bindings as $id => $binding) {
+                                       if($binding->match($bot, null)) {
+                                               unset(self::$bindings[$type][$id]);
+                                       }
+                               }
+                       }
+               }
+       }
+       
        /********************************************************************************************
         *                                       EVENT HANDLER                                      *
         ********************************************************************************************/
@@ -85,7 +123,7 @@ class ModCMD implements EventHandler {
        private function event($type, $parameters) {
                if(array_key_exists($type, self::$bindings)) {
                        foreach(self::$bindings as $binding) {
-                               $binding->trigger();
+                               $binding->trigger($parameters);
                        }
                }
        }
index 7f0e0af661225ec233468b11bf35f8b4f0c0e0cd..037d4633170c904026ee89f5f144e87294f52c94 100644 (file)
@@ -605,10 +605,10 @@ class Uplink {
                                        $cmodes = $channel->getModes();
                                        $privs = $channel->getUserPrivs($user);
                                        if($cmodes->hasMode("s") && !$fromUser->isOnChannel($channel) && $from != $user->getNumeric()) continue;
-                                       if($cmodes->hasMode("u") && ($privs & (P10_Channel::USERPRIV_OPPED | P10_Channel::USERPRIV_VOICE)) == 0 && $from != $user->getNumeric()) continue;
+                                       if($cmodes->hasMode("u") && ($privs & (P10_Channel::USERPRIV_OPED | P10_Channel::USERPRIV_VOICE)) == 0 && $from != $user->getNumeric()) continue;
                                        $chanstr = ($channels == "" ? "" : " ");
                                        $prefix = "";
-                                       if(($privs & P10_Channel::USERPRIV_OPPED)) {
+                                       if(($privs & P10_Channel::USERPRIV_OPED)) {
                                                $prefix = "@";
                                        } else if(($privs & P10_Channel::USERPRIV_VOICE)) {
                                                $prefix = "+";