Tom Insam > Bot-BasicBot-Pluggable > Bot::BasicBot::Pluggable::Module::Karma

Download:
Bot-BasicBot-Pluggable-0.60.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  7
Open  1
View/Report Bugs
Source   Latest Release: Bot-BasicBot-Pluggable-0.98

NAME ^

Bot::BasicBot::Pluggable::Module::Karma - tracks karma for various concepts

IRC USAGE ^

<thing>++ # <comment>

Increases the karma for <thing>.

<thing>-- # <comment>

Decreases the karma for <thing>.

karma <thing>

Replies with the karma rating for <thing>.

explain <thing>

Lists three each good and bad things said about <thing>:

  <user> explain Morbus
  <bot> positive: committing lots of bot documentation; fixing the
        fisher_yates; negative: filling the dev list. overall: 5

METHODS ^

get_karma($username)

Returns either a string representing the total number of karma points for the passed $username or the total number of karma points, an array of good karma comments, and an array of bad comma comments. The number of good/bad comments returned can be configured with num_comments, below.

add_karma($object, $good, $reason, $who)

Adds or subtracts from the passed $object's karma. $good is either 1 (to add a karma point to the $object or 0 (to subtract). $reason is an optional string commenting on the reason for the change, and $who is the person modifying the karma of $object. Nothing is returned.

VARS ^

ignore_selfkarma

Defaults to 1; determines whether to respect selfkarmaing or not.

num_comments

Defaults to 3; number of good and bad comments to display on explanations.

show_givers

Defaults to 1; whether to show who gave good or bad comments on explanations.

AUTHOR ^

Tom Insam <tom@jerakeen.org>

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

syntax highlighting: