]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - src/modules/m_helpop.cpp
Merge pull request #971 from SaberUK/master+numeric-xline
[user/henk/code/inspircd.git] / src / modules / m_helpop.cpp
index 6681d8f66a3c001591577f1f20d14ca8389f62b5..2fe958a71c2c96fa4c7bc71be7e0741a4c667c48 100644 (file)
-/*   +------------------------------------+
- *   | Inspire Internet Relay Chat Daemon |
- *   +------------------------------------+
+/*
+ * InspIRCd -- Internet Relay Chat Daemon
  *
- *  Inspire is copyright (C) 2002-2004 ChatSpike-Dev.
- *   E-mail:
- *<brain@chatspike.net>
- *       <Craig@chatspike.net>
- * 
- * Written by Craig Edwards, Craig McLure, and others.
- * This program is free but copyrighted software; see
- *the file COPYING for details.
+ *   Copyright (C) 2009 Daniel De Graaf <danieldg@inspircd.org>
+ *   Copyright (C) 2005-2009 Robin Burchell <robin+git@viroteck.net>
+ *   Copyright (C) 2004-2006, 2008 Craig Edwards <craigedwards@brainbox.cc>
+ *   Copyright (C) 2007 Dennis Friis <peavey@inspircd.org>
+ *   Copyright (C) 2004-2005 Craig McLure <craig@chatspike.net>
  *
- * ---------------------------------------------------
+ * This file is part of InspIRCd.  InspIRCd 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, version 2.
+ *
+ * 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 this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-using namespace std;
-
-#include "users.h"
-#include "channels.h"
-#include "modules.h"
-#include "helperfuncs.h"
-
-// Global Vars
-/* XXX - should all this be marked static? clear the global namespace, etc. */
-ConfigReader *helpop;
-Server *Srv;
-
-void handle_helpop(char**, int, userrec*);
-bool do_helpop(char**, int, userrec*);
-void sendtohelpop(userrec*, int, char**);
 
+#include "inspircd.h"
 
-/* $ModDesc: /helpop Command, Works like Unreal helpop */
+typedef std::map<std::string, std::string, irc::insensitive_swo> HelpopMap;
+static HelpopMap helpop_map;
 
-void handle_helpop(char **parameters, int pcnt, userrec *user)
+/** Handles user mode +h
+ */
+class Helpop : public SimpleUserModeHandler
 {
-       char a[MAXBUF];
-       std::string output = " ";
-
-       if (!helpop)
-               return;
-
-       if (pcnt < 1)
-       {
-               do_helpop(NULL,pcnt,user);
-               return;
-       }
-
-       if (parameters[0][0] == '!')
-       {
-               // Force send to all +h users
-               sendtohelpop(user, pcnt, parameters);
-       }
-       else if (parameters[0][0] == '?')
-       {
-               // Force to the helpop system with no forward if not found.
-               if (do_helpop(parameters, pcnt, user) == false)
-               {
-                       // Not handled by the Database, Tell the user, and bail.
-                       for (int i = 1; output != ""; i++)
-                       {
-                               snprintf(a,MAXBUF,"line%d",i);
-                               output = helpop->ReadValue("nohelp", std::string(a), 0);
-
-                               if(output != "")
-                               {
-                                       Srv->SendTo(NULL,user,"290 "+std::string(user->nick)+" :"+output);
-                               }
-                       }
-               }
-       }
-       else
+ public:
+       Helpop(Module* Creator) : SimpleUserModeHandler(Creator, "helpop", 'h')
        {
-               // Check with the helpop database, if not found send to +h
-               if (do_helpop(parameters, pcnt, user) == false)
-               {
-                       // Not handled by the Database, Tell the user, and forward.
-                       for (int i = 1; output != ""; i++)
-                       {
-                               snprintf(a,MAXBUF,"line%d",i);
-                               /* "nohelpo" for opers "nohelp" for users */
-                               output = helpop->ReadValue("nohelpo", std::string(a), 0);
-                               if (output != "")
-                               {
-                                       Srv->SendTo(NULL,user,"290 "+std::string(user->nick)+" :"+output);
-                               }
-                       }
-                       // Forward.
-                       sendtohelpop(user, pcnt, parameters);
-               }
+               oper = true;
        }
-}
+};
 
-bool do_helpop(char **parameters, int pcnt, userrec *src)
+/** Handles /HELPOP
+ */
+class CommandHelpop : public Command
 {
-       char *search;
-       std::string output = " "; // a fix bought to you by brain :p
-       char a[MAXBUF];
-       char lower[MAXBUF];
-       int nlines = 0;
-
-       if (!parameters)
-       {
-               search = "start";
-       }
-       else
+       const std::string startkey;
+ public:
+       CommandHelpop(Module* Creator)
+               : Command(Creator, "HELPOP", 0)
+               , startkey("start")
        {
-               search = parameters[0];
-       }
+               syntax = "<any-text>";
+       }
 
-       if (search[0] == '?')
+       CmdResult Handle (const std::vector<std::string> &parameters, User *user)
        {
-               search++;
-       }
-
-       /* XXX - don't we have an strtolower()? if not, might pay to add one.. that works on char *, preferably.. */
-       strlcpy(lower, search, MAXBUF);
-       for (unsigned int t = 0; t < strlen(lower); t++)
-               lower[t] = tolower(lower[t]);
+               const std::string& parameter = (!parameters.empty() ? parameters[0] : startkey);
 
-
-       for (int i = 1; output != ""; i++)
-       {
-               snprintf(a,MAXBUF,"line%d",i);
-               output = helpop->ReadValue(lower, a, 0);
-               if (output != "")
+               if (parameter == "index")
                {
-                       Srv->SendTo(NULL,src,"290 "+std::string(src->nick)+" :"+output);
-                       nlines++;
+                       /* iterate over all helpop items */
+                       user->WriteNumeric(290, ":HELPOP topic index");
+                       for (HelpopMap::const_iterator iter = helpop_map.begin(); iter != helpop_map.end(); iter++)
+                               user->WriteNumeric(292, ":  %s", iter->first.c_str());
+                       user->WriteNumeric(292, ":*** End of HELPOP topic index");
                }
-       }
-       return (nlines>0);
-}
+               else
+               {
+                       user->WriteNumeric(290, ":*** HELPOP for %s", parameter.c_str());
+                       user->WriteNumeric(292, ": -");
 
+                       HelpopMap::const_iterator iter = helpop_map.find(parameter);
 
+                       if (iter == helpop_map.end())
+                       {
+                               iter = helpop_map.find("nohelp");
+                       }
 
-void sendtohelpop(userrec *src, int pcnt, char **params)
-{
-       char* first = params[0];
-       if (*first == '!')
-       {
-               first++;
-       }
+                       const std::string& value = iter->second;
+                       irc::sepstream stream(value, '\n');
+                       std::string token = "*";
 
-       std::string line = "*** HELPOPS - From "+std::string(src->nick)+": "+std::string(first)+" ";
-       for (int i = 1; i < pcnt; i++)
-       {
-               line = line + std::string(params[i]) + " ";
+                       while (stream.GetToken(token))
+                       {
+                               // Writing a blank line will not work with some clients
+                               if (token.empty())
+                                       user->WriteNumeric(292, ": ");
+                               else
+                                       user->WriteNumeric(292, ":%s", token.c_str());
+                       }
+
+                       user->WriteNumeric(292, ": -");
+                       user->WriteNumeric(292, ":*** End of HELPOP");
+               }
+               return CMD_SUCCESS;
        }
-       Srv->SendToModeMask("oh",WM_AND,line);
-}
+};
 
 class ModuleHelpop : public Module
 {
-       private:
-               ConfigReader *conf;
-               std::string  h_file;
+               CommandHelpop cmd;
+               Helpop ho;
 
        public:
                ModuleHelpop()
+                       : cmd(this), ho(this)
                {
-                       Srv  = new Server;
-
-                       ReadConfig();
-                       if (!Srv->AddExtendedMode('h',MT_CLIENT,true,0,0))
-                       {
-                               Srv->Log(DEFAULT,"Unable to claim the +h usermode.");
-                               return;
-                       }
-
-                       Srv->AddCommand("HELPOP",handle_helpop,0,0,"m_helpop.so");
                }
 
-               virtual void ReadConfig()
+               void ReadConfig(ConfigStatus& status) CXX11_OVERRIDE
                {
-                       conf = new ConfigReader;
-                       h_file = conf->ReadValue("helpop", "file", 0);
+                       HelpopMap help;
 
-                       if (h_file == "")
+                       ConfigTagList tags = ServerInstance->Config->ConfTags("helpop");
+                       for(ConfigIter i = tags.first; i != tags.second; ++i)
                        {
-                               helpop = NULL;
-                               log(DEFAULT,"m_helpop: Helpop file not Specified.");
-                               return;
+                               ConfigTag* tag = i->second;
+                               std::string key = tag->getString("key");
+                               std::string value;
+                               tag->readString("value", value, true); /* Linefeeds allowed */
+
+                               if (key == "index")
+                               {
+                                       throw ModuleException("m_helpop: The key 'index' is reserved for internal purposes. Please remove it.");
+                               }
+
+                               help[key] = value;
                        }
 
-                       helpop = new ConfigReader(h_file);
-                       if ((helpop->ReadValue("nohelp",  "line1", 0) == "") ||
-                               (helpop->ReadValue("nohelpo", "line1", 0) == "") ||
-                               (helpop->ReadValue("start",   "line1", 0) == ""))
+                       if (help.find("start") == help.end())
                        {
-                               log(DEFAULT,"m_helpop: Helpop file is missing important entries. Please check the example conf.");
-                               return;
+                               // error!
+                               throw ModuleException("m_helpop: Helpop file is missing important entry 'start'. Please check the example conf.");
                        }
-               }
-
-
-               virtual void OnRehash(std::string parameter)
-               {
-                       delete conf;
-                       if (helpop)
-                               delete helpop;
-
-                       ReadConfig();
-               }
-
-               virtual int OnExtendedMode(userrec* user, void* target, char modechar, int type, bool mode_on, string_list &params)
-               {
-                       if ((modechar == 'h') && (type == MT_CLIENT))
-                       {
-                               return 1;
+                       else if (help.find("nohelp") == help.end())
+                       {
+                               // error!
+                               throw ModuleException("m_helpop: Helpop file is missing important entry 'nohelp'. Please check the example conf.");
                        }
-                       return 0;
+
+                       helpop_map.swap(help);
                }
 
-               virtual void OnWhois(userrec* src, userrec* dst)
+               void OnWhois(User* src, User* dst) CXX11_OVERRIDE
                {
-                       if (strchr(dst->modes,'h'))
+                       if (dst->IsModeSet(ho))
                        {
-                               Srv->SendTo(NULL,src,"310 "+std::string(src->nick)+" "+std::string(dst->nick)+" :is available for help.");
+                               ServerInstance->SendWhoisLine(src, dst, 310, dst->nick+" :is available for help.");
                        }
                }
 
-               virtual ~ModuleHelpop()
-               {
-                       delete Srv;
-                       delete conf;
-                       delete helpop;
-               }
-       
-               virtual Version GetVersion()
+               Version GetVersion() CXX11_OVERRIDE
                {
-                       return Version(1,0,0,1,VF_STATIC|VF_VENDOR);
+                       return Version("Provides the /HELPOP command for useful information", VF_VENDOR);
                }
 };
 
-class ModuleHelpopFactory : public ModuleFactory
-{
- public:
-       ModuleHelpopFactory()
-       {
-       }
-       
-       ~ModuleHelpopFactory()
-       {
-       }
-       
-       virtual Module * CreateModule()
-       {
-               return new ModuleHelpop;
-       }
-       
-};
-
-extern "C" void * init_module( void )
-{
-       return new ModuleHelpopFactory;
-}
+MODULE_INIT(ModuleHelpop)