.. _plugin-Praise: Praise ====== Purpose ------- Hand out praise to IRC denizens with this plugin. Usage ----- Praise is a plugin for ... well, praising things. Feel free to add your own flavor to it by customizing what praises it gives. Use "praise add " to add new ones, making sure to include "$who" in where you want to insert the thing being praised. Example: * If you add ``hugs $who`` * Someone says ``@praise ChanServ``. * ``* bot hugs ChanServ`` .. _commands-Praise: Commands -------- .. _command-praise-add: add [] Adds to the praise database for . is only necessary if the message isn't sent in the channel itself. .. _command-praise-change: change [] Changes the praise with id according to the regular expression . is only necessary if the message isn't sent in the channel itself. .. _command-praise-get: get [] Gets the praise with id from the praise database for . is only necessary if the message isn't sent in the channel itself. .. _command-praise-praise: praise [] [] [for ] Praises (for , if given). If is given, uses that specific praise. is only necessary if the message isn't sent in the channel itself. .. _command-praise-remove: remove [] Removes the praise with id from the praise database for . is only necessary if the message isn't sent in the channel itself. .. _command-praise-search: search [] [--{regexp,by} ] [] Searches for praises matching the criteria given. .. _command-praise-stats: stats [] Returns the number of praises in the database for . is only necessary if the message isn't sent in the channel itself. .. _conf-Praise: Configuration ------------- .. _conf-supybot.plugins.Praise.public: supybot.plugins.Praise.public This config variable defaults to "True", is not network-specific, and is not channel-specific. Determines whether this plugin is publicly visible. .. _conf-supybot.plugins.Praise.showIds: supybot.plugins.Praise.showIds This config variable defaults to "False", is network-specific, and is channel-specific. Determines whether the bot will show the ids of a praise when the praise is given.