.. _plugin:karma:

=====
KARMA
=====
| 

about
-----
| 

:author:  FeedBackLoop <feedbackloop@gmail.com>
:contact: FREENODE/#fbf
:distribution: core
:license:  

| 

description
-----------
| 

 karma plugin 



| 

commands
--------
| 


    :commands in this plugin: karma-whatdown .. karma-whydown .. karma-get .. karma-whatup .. karma-good .. karma-bad .. karma-whodown .. karma-whyup .. karma-search .. karma-whoup .. karma-del

| 

1) *karma-bad .. [handle_karmabad]*

    :description:  karma-bad .. show 10 most negative karma items 

    :permissions: USER .. WEB .. ANON .. ANONKARMA

    :code: :ref:`fbf.plugs.db.karma_karma-bad_command`.

    :examples:

    ::

        <user> ;karma-bad
        <output> karma void


2) *karma-del .. [handle_karmadel]*

    :description:  karma-del <item> .. delete karma item 

    :permissions: OPER

    :code: :ref:`fbf.plugs.db.karma_karma-del_command`.

    :examples:

    ::

        <user> ;karma-del dunker
        <output> can't delete dunker


3) *karma-get .. [handle_karmaget]*

    :description:  karma-get <item> .. show karma of item 

    :permissions: USER .. WEB .. ANON .. ANONKARMA

    :code: :ref:`fbf.plugs.db.karma_karma-get_command`.

    :examples:

    ::

        <user> ;karma-get dunker
        <output> dunker has no karma yet


4) *karma-good .. [handle_karmagood]*

    :description:  karma-good .. show top 10 karma items 

    :permissions: USER .. WEB .. ANON .. ANONKARMA

    :code: :ref:`fbf.plugs.db.karma_karma-good_command`.

    :examples:

    ::

        <user> ;karma-good
        <output> karma void


5) *karma-search .. [handle_karmasearch]*

    :description:  karma-search <txt> .. search for karma items 

    :permissions: USER .. WEB .. ANON .. ANONKARMA

    :code: :ref:`fbf.plugs.db.karma_karma-search_command`.

    :examples:

    ::

        <user> ;karma-search gozerbot
        <output> no karma items matching gozerbot found


6) *karma-whatdown .. [handle_karmawhatdown]*

    :description:  show what karma items have been lowered by nick 

    :permissions: USER .. WEB .. ANON .. ANONKARMA

    :code: :ref:`fbf.plugs.db.karma_karma-whatdown_command`.

    :examples:

    ::

        <user> ;karma-whatdown dunker
        <output> no karma items downed by dunker


7) *karma-whatup .. [handle_karmawhatup]*

    :description:  show what karma items have been upped by nick 

    :permissions: USER .. WEB .. ANON .. ANONKARMA

    :code: :ref:`fbf.plugs.db.karma_karma-whatup_command`.

    :examples:

    ::

        <user> ;karma-whatup dunker
        <output> no karma items upped by dunker


8) *karma-whodown .. [handle_whokarmadown]*

    :description:  karma-whodown <item> .. show who decreased a karma item 

    :permissions: USER .. WEB .. ANON .. ANONKARMA

    :code: :ref:`fbf.plugs.db.karma_karma-whodown_command`.

    :examples:

    ::

        <user> ;karma-whodown gozerbot
        <output> no whokarmadown data available for gozerbot


9) *karma-whoup .. [handle_whokarmaup]*

    :description:  karma-whoup <item> .. show who increased a karma item 

    :permissions: USER .. WEB .. ANON .. ANONKARMA

    :code: :ref:`fbf.plugs.db.karma_karma-whoup_command`.

    :examples:

    ::

        <user> ;karma-whoup gozerbot
        <output> no whokarmaup data available for gozerbot


10) *karma-whydown .. [handle_whykarmadown]*

    :description:  karma-whydown <item> .. show why karma of item has been decreased 

    :permissions: USER .. WEB .. ANON .. ANONKARMA

    :code: :ref:`fbf.plugs.db.karma_karma-whydown_command`.

    :examples:

    ::

        <user> ;karma-whydown gozerbot
        <output> gozerbot has no reason for karmadown yet


11) *karma-whyup .. [handle_karmawhyup]*

    :description:  karma-whyup <item> .. show why karma of item has been increased 

    :permissions: USER .. WEB .. ANON .. ANONKARMA

    :code: :ref:`fbf.plugs.db.karma_karma-whyup_command`.

    :examples:

    ::

        <user> ;karma-whyup gozerbot
        <output> gozerbot has no reason for karmaup yet