Bot::BasicBot::Pluggable::Module::Karma - tracks karma for various concepts
version 0.97
Increases the karma for <thing>.
Responds with the new karma for <thing> unless karma_change_response is set to a false value.
karma_change_response
Decreases the karma for <thing>.
Replies with the karma rating for <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
Returns either a string representing the total number of karma points for the passed $username or the total number of karma points and subroutine reference for good and bad karma comments. These references return the according karma levels when called in scalar context or a array of hash reference. Every hash reference has entries for the timestamp (timestamp), the giver (who) and the explanation string (reason) for its karma action.
$username
Adds or subtracts from the passed $thing's karma. $good is either 1 (to add a karma point to the $thing 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 $thing. Nothing is returned.
$thing
$good
$reason
$who
Defaults to 1; determines whether to respect selfkarmaing or not.
Defaults to 3; number of good and bad comments to display on explanations. Set this variable to 0 if you do not want to list reasons at all.
Defaults to 1; whether to show who gave good or bad comments on explanations.
Defaults to 1; whether to randomize the order of reasons. If set to 0, the reasons are sorted in reversed chronological order.
Defaults to 1; whether to show a response when the karma of a thing is changed. If true, the bot will reply with the new karma. If set to 0, the bot will silently update the karma, without a response.
Mario Domgoergen <mdom@cpan.org>
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
2 POD Errors
The following errors were encountered while parsing the POD:
'=item' outside of any '=over'
You forgot a '=back' before '=head1'
To install Bot::BasicBot::Pluggable, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Bot::BasicBot::Pluggable
CPAN shell
perl -MCPAN -e shell install Bot::BasicBot::Pluggable
For more information on module installation, please visit the detailed CPAN module installation guide.