X-Git-Url: https://git.netwichtig.de/gitweb/?a=blobdiff_plain;f=src%2Fmodules%2Fm_helpop.cpp;h=f1f26a5eeb9c40d7b95594bdfeaaa02bfee08f0d;hb=HEAD;hp=d8a5440391dc2ee0dbacc30dd8398f9e5ea813b0;hpb=3d8ec5dbd9cfde34fcbc63ad7b9b1369866f0a33;p=user%2Fhenk%2Fcode%2Finspircd.git diff --git a/src/modules/m_helpop.cpp b/src/modules/m_helpop.cpp index d8a544039..f1f26a5ee 100644 --- a/src/modules/m_helpop.cpp +++ b/src/modules/m_helpop.cpp @@ -1,187 +1,191 @@ -/* +------------------------------------+ - * | Inspire Internet Relay Chat Daemon | - * +------------------------------------+ +/* + * InspIRCd -- Internet Relay Chat Daemon * - * InspIRCd: (C) 2002-2009 InspIRCd Development Team - * See: http://wiki.inspircd.org/Credits + * Copyright (C) 2013, 2017-2018, 2020 Sadie Powell + * Copyright (C) 2013, 2015 Attila Molnar + * Copyright (C) 2012 Robby + * Copyright (C) 2009-2010 Daniel De Graaf + * Copyright (C) 2009 Uli Schlachter + * Copyright (C) 2007 Robin Burchell + * Copyright (C) 2007 Dennis Friis + * Copyright (C) 2006 Craig Edwards * - * This program is free but copyrighted software; see - * the file COPYING for details. + * 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 . */ + #include "inspircd.h" +#include "modules/whois.h" -/* $ModDesc: /helpop Command, Works like Unreal helpop */ -static std::map helpop_map; +enum +{ + // From UnrealIRCd. + RPL_WHOISHELPOP = 310, + + // From ircd-ratbox. + ERR_HELPNOTFOUND = 524, + RPL_HELPSTART = 704, + RPL_HELPTXT = 705, + RPL_ENDOFHELP = 706 +}; +typedef std::vector HelpMessage; -/** Handles user mode +h - */ -class Helpop : public ModeHandler +struct HelpTopic { - public: - Helpop(InspIRCd* Instance, Module* Creator) : ModeHandler(Instance, Creator, 'h', 0, 0, false, MODETYPE_USER, true) { } + // The body of the help topic. + const HelpMessage body; - ModeAction OnModeChange(User* source, User* dest, Channel* channel, std::string ¶meter, bool adding) - { - if (adding) - { - if (!dest->IsModeSet('h')) - { - dest->SetMode('h',true); - return MODEACTION_ALLOW; - } - } - else - { - if (dest->IsModeSet('h')) - { - dest->SetMode('h',false); - return MODEACTION_ALLOW; - } - } + // The title of the help topic. + const std::string title; - return MODEACTION_DENY; + HelpTopic(const HelpMessage& Body, const std::string& Title) + : body(Body) + , title(Title) + { } }; -/** Handles /HELPOP - */ +typedef std::map HelpMap; + class CommandHelpop : public Command { + private: + const std::string startkey; + public: - CommandHelpop (InspIRCd* Instance, Module* Creator) : Command(Instance, Creator, "HELPOP", 0, 0) + HelpMap help; + std::string nohelp; + + CommandHelpop(Module* Creator) + : Command(Creator, "HELPOP", 0) + , startkey("start") { syntax = ""; } - CmdResult Handle (const std::vector ¶meters, User *user) + CmdResult Handle(User* user, const Params& parameters) CXX11_OVERRIDE { - irc::string parameter("start"); - if (parameters.size() > 0) - parameter = parameters[0].c_str(); - - if (parameter == "index") - { - /* iterate over all helpop items */ - user->WriteServ("290 %s :HELPOP topic index", user->nick.c_str()); - for (std::map::iterator iter = helpop_map.begin(); iter != helpop_map.end(); iter++) - { - user->WriteServ("292 %s : %s", user->nick.c_str(), iter->first.c_str()); - } - user->WriteServ("292 %s :*** End of HELPOP topic index", user->nick.c_str()); - } - else + const std::string& topic = parameters.empty() ? startkey : parameters[0]; + HelpMap::const_iterator titer = help.find(topic); + if (titer == help.end()) { - user->WriteServ("290 %s :*** HELPOP for %s", user->nick.c_str(), parameter.c_str()); - user->WriteServ("292 %s : -", user->nick.c_str()); - - std::map::iterator iter = helpop_map.find(parameter); - - if (iter == helpop_map.end()) - { - iter = helpop_map.find("nohelp"); - } - - std::string value = iter->second; - irc::sepstream stream(value, '\n'); - std::string token = "*"; - - while (stream.GetToken(token)) - { - // Writing a blank line will not work with some clients - if (token.empty()) - user->WriteServ("292 %s : ", user->nick.c_str()); - else - user->WriteServ("292 %s :%s", user->nick.c_str(), token.c_str()); - } - - user->WriteServ("292 %s : -", user->nick.c_str()); - user->WriteServ("292 %s :*** End of HELPOP", user->nick.c_str()); + user->WriteNumeric(ERR_HELPNOTFOUND, topic, nohelp); + return CMD_FAILURE; } - /* We dont want these going out over the network, return CMD_FAILURE - * to make sure the protocol module thinks theyre not worth sending. - */ - return CMD_FAILURE; + const HelpTopic& entry = titer->second; + user->WriteNumeric(RPL_HELPSTART, topic, entry.title); + for (HelpMessage::const_iterator liter = entry.body.begin(); liter != entry.body.end(); ++liter) + user->WriteNumeric(RPL_HELPTXT, topic, *liter); + user->WriteNumeric(RPL_ENDOFHELP, topic, "End of /HELPOP."); + return CMD_SUCCESS; } }; -class ModuleHelpop : public Module +class ModuleHelpop + : public Module + , public Whois::EventListener { - private: - std::string h_file; + private: CommandHelpop cmd; - Helpop ho; + SimpleUserModeHandler ho; public: - ModuleHelpop(InspIRCd* Me) - : Module(Me), cmd(Me, this), ho(Me, this) + ModuleHelpop() + : Whois::EventListener(this) + , cmd(this) + , ho(this, "helpop", 'h', true) { - ReadConfig(); - if (!ServerInstance->Modes->AddMode(&ho)) - throw ModuleException("Could not add new modes!"); - ServerInstance->AddCommand(&cmd); - Implementation eventlist[] = { I_OnRehash, I_OnWhois }; - ServerInstance->Modules->Attach(eventlist, this, 2); } - virtual void ReadConfig() + void ReadConfig(ConfigStatus& status) CXX11_OVERRIDE { - ConfigReader MyConf(ServerInstance); + size_t longestkey = 0; - helpop_map.clear(); + HelpMap newhelp; + ConfigTagList tags = ServerInstance->Config->ConfTags("helpop"); + if (tags.first == tags.second) + throw ModuleException("You have loaded the helpop module but not configured any help topics!"); - for (int i = 0; i < MyConf.Enumerate("helpop"); i++) + for (ConfigIter i = tags.first; i != tags.second; ++i) { - irc::string key = assign(MyConf.ReadValue("helpop", "key", i)); - std::string value = MyConf.ReadValue("helpop", "value", i, true); /* Linefeeds allowed! */ - - if (key == "index") + ConfigTag* tag = i->second; + + // Attempt to read the help key. + const std::string key = tag->getString("key"); + if (key.empty()) + throw ModuleException(InspIRCd::Format(" is empty at %s", tag->getTagLocation().c_str())); + else if (irc::equals(key, "index")) + throw ModuleException(InspIRCd::Format(" is set to \"index\" which is reserved at %s", tag->getTagLocation().c_str())); + else if (key.length() > longestkey) + longestkey = key.length(); + + // Attempt to read the help value. + std::string value; + if (!tag->readString("value", value, true) || value.empty()) + throw ModuleException(InspIRCd::Format(" is empty at %s", tag->getTagLocation().c_str())); + + // Parse the help body. Empty lines are replaced with a single + // space because some clients are unable to show blank lines. + HelpMessage helpmsg; + irc::sepstream linestream(value, '\n', true); + for (std::string line; linestream.GetToken(line); ) + helpmsg.push_back(line.empty() ? " " : line); + + // Read the help title and store the topic. + const std::string title = tag->getString("title", InspIRCd::Format("*** Help for %s", key.c_str()), 1); + if (!newhelp.insert(std::make_pair(key, HelpTopic(helpmsg, title))).second) { - throw ModuleException("m_helpop: The key 'index' is reserved for internal purposes. Please remove it."); + throw ModuleException(InspIRCd::Format(" tag with duplicate key '%s' at %s", + key.c_str(), tag->getTagLocation().c_str())); } - - helpop_map[key] = value; } - if (helpop_map.find("start") == helpop_map.end()) - { - // error! - throw ModuleException("m_helpop: Helpop file is missing important entries. Please check the example conf."); - } - else if (helpop_map.find("nohelp") == helpop_map.end()) + // The number of items we can fit on a page. + HelpMessage indexmsg; + size_t maxcolumns = 80 / (longestkey + 2); + for (HelpMap::iterator iter = newhelp.begin(); iter != newhelp.end(); ) { - // error! - throw ModuleException("m_helpop: Helpop file is missing important entries. Please check the example conf."); - } - - } - - - virtual void OnRehash(User* user) - { - ReadConfig(); - } + std::string indexline; + for (size_t column = 0; column != maxcolumns; ) + { + if (iter == newhelp.end()) + break; - virtual void OnWhois(User* src, User* dst) - { - if (dst->IsModeSet('h')) - { - ServerInstance->SendWhoisLine(src, dst, 310, std::string(src->nick)+" "+std::string(dst->nick)+" :is available for help."); + indexline.append(iter->first); + if (++column != maxcolumns) + indexline.append(longestkey - iter->first.length() + 2, ' '); + iter++; + } + indexmsg.push_back(indexline); } + newhelp.insert(std::make_pair("index", HelpTopic(indexmsg, "List of help topics"))); + cmd.help.swap(newhelp); + + ConfigTag* tag = ServerInstance->Config->ConfValue("helpmsg"); + cmd.nohelp = tag->getString("nohelp", "There is no help for the topic you searched for. Please try again.", 1); } - virtual ~ModuleHelpop() + void OnWhois(Whois::Context& whois) CXX11_OVERRIDE { - ServerInstance->Modes->DelMode(&ho); + if (whois.GetTarget()->IsModeSet(ho)) + whois.SendLine(RPL_WHOISHELPOP, "is available for help."); } - virtual Version GetVersion() + Version GetVersion() CXX11_OVERRIDE { - return Version("$Id$", VF_COMMON | VF_VENDOR, API_VERSION); + return Version("Adds the /HELPOP command which allows users to view help on various topics and user mode h (helpop) which marks a server operator as being available for help.", VF_VENDOR); } };