Community Reputation
Last updated
Last updated
Saying thanks and ranking users by how well they engage with your community can be done with Modr8's community reputation module.
With our engine you are able to reward positive reputation for those that are doing good and if you wish you can enable negative reputation to remove rep from those who are not doing so well. On top of this, with Modr8 you can also gamify your chat by utilising additional custom actions to create jackpots, offer random rep and reward user activity. You are able to set levels / ranks which are obtained as reputation points are earned. Your bot will announce new levels being completed and display an image/gif at the same time. All of this is a great way to keep your community users engaged and often leads to friendly competition as they check out who ranks at the top of the reputation ranks
Select "Settings" on your chat profile
Select "Edit" on the "Community Reputation" card
Turn on"Enable Reputation" toggle
The "Reputation Access Control" option provides a way for you to scope who has permissions to give out reputation to users.
Bot Owner - Only the registered owner of the bot can issue reputation
Admins - Only Admins of the chat can issue reputation
Trusted - Only users who have been added to the trusted/whitelist can issue reputation
Member - Chat members can issue reputation to other members
Add in any additional reputation triggers you wish to use outside of the standard /rep commands. For example you may want to give reputation to a user using !rep or + or even an emoji like 👍
Click "Save Changes"
As well as being able to provide positive reputation, you may want to remove reputation from users and allow general negative reputation to be issued. If a user has enough negative reputation their reputation points will go into -ve figures and you can use sub zero based ranks for them.
Select "Settings" on your chat profile
Select "Edit" on the "Community Reputation" card
Turn on"Enable Negative Reputation" toggle
The "Negative Reputation Access Control" option provides a way for you to scope who has permissions to give out negative reputation to users.
Bot Owner - Only the registered owner of the bot can issue negative reputation.
Admins - Only Admins of the chat can issue negative reputation.
Trusted - Only users who have been added to the trusted/whitelist can issue negative reputation.
Member - Chat members can issue negative reputation to other members
Add in any additional negative reputation triggers you wish to use outside of the standard /rep commands. For example you may want to remove reputation using - or even an emoji like 👎 or ⬇️
Click "Save Changes"
Issuing out reputation is great for building trust and confidence in engaging with your community. To ensure the system is not abused by people trying to gain top ranks by giving each other rep points the Modr8 engine utilises methods to limit the amount that can be given. The following settings can be used to constrain the system to suit your needs.
Select "Settings" on your chat profile
Select "Edit" on the "Community Reputation" card
Scroll to the"Reputation Limit Settings" section
Enter a value for the maximum amount of reputation points that can be given out.
Enter a value fro the time limit for this limit to be replenished back to the total value.
State whether you want "Admin users to bypass rep spam limits", meaning only your normal members will need to regenerate reputation every x hours, whereas admins will not have a limit.
Elect to turn on "Allow multi-rep to be given" which allows your users to reply to messages with /rep X where X is the number of points they wish to issue. As an example you could reply to a message with /rep 5 to give 5 reputation points to the user.
Our advanced reputation management settings are reserved for the custom use-cases communities may have. The options you can enable are listed below along with a description of the behavior and usage in your chat.
"Hide Rep Level Up" - When a user reaches a new reputation level the bot will auto-announce their new ranking in the chat. You can disable this feature though by toggling this switch to hide the rep level up messages in your chat.
"Show Rank Images in /myrep" - When a user in your chat wishes to check their rep ranking they will use the /myrep command. This option will also display the associated image with the rank when turned on.
"Hide User Link In Ranks" - By default when running /toprep and displaying the top reputation ranks in the chat a link to the users profile will attempt to be displayed (Dependent on user privacy settings). You can enable this option to disable this functionality and simply display the name as normal text.
"Use Global Reputation" - This will enable global reputation rankings. When running /toprep or /myrep users will see the reputation points total they have gained from all chats your bot is moderating. Find out more in our guide Global & Multi-Chat Features.
"Remove admins from rankings"- Often we find that the admins of a chat gain the more reputation points due to offering help and engaging with the community. You may wish to remove these users from the /toprep rankings so general chat members can take the top ranks.
"Trust users with X or more rep points" - This is a very powerful option which will allow you to automatically trust/whitelist users who gain the number of points specified. The effect this has on the user is that they will then bypass moderation filters. You can utilise this automation with other modules to allow "trusted" users to community moderate or even now be able to give out rep.
If there are changes or settings you want outside of the scope of the options above we can always help out! Using "Actions" we are able to make even more customisations to how reputation works in your community. Feel free to drop by our Telegram Community Chat to ask for help.
Modr8 allows you to export out all of your reputation history as well as a snapshot of the current state of reputation in your chat.
Select "Settings" on your chat profile
Select "Edit" on the "Community Reputation" card
Scroll to the"Data Management" section
The options you will find have the following functionality:
"Export Reputation Snapshot" - Provides a spreasdheet download of the current reputation ranks and values your users have in the chat.
"Export Reputation History" - Provides a spreadsheet download of how reputation has been added of removed by each user within your chat. A really good tool for auditing reputation!
"Reset All User Reputation" - The nuclear option to delete all of your reputation data and start over. Make sure to run exports if you need history!
"Bulk Modify Reputation Template" - Once clicked a CSV template will be downloaded, where you can specify user_id and modification amount to reputation you wish to make. Complete the CSV with changes to rep i.e. adding 10 rep with 10 or removing 10 rep with -10
"Upload Template" - Browse for the CSV file you have edited and select to upload. Once uploaded your changes will be processed and relfect into the reputation scores.
You can use the /resetrep command in reply to a users message or by mentioning the user to set their reputation back to 0.
Giving out reputation becomes even more fun when users get to gain ranks and even have images/gifs or badges given to them. Modr8 supports the ability for you define unlimited numbers of reputation levels to be obtained.
Select "Settings" on your chat profile
Select "Edit" on the "Community Reputation" card
Scroll to the"Set Reputation Rankings" section
You can add a new rank by clicking the "Add New Rank" button or you can edit existing ranks
Set a "Level" value, which is the number of reputation points to be reached
Set a "Rank" which is the name of the ranking that will be used
Set a "Rank Image" if you want to display an image or animation when the rank is reached
We recommend spacing out your rank levels so that there is time between gaining one to the next. Something exponential like 0, 10, 20, 40, 80, 160 etc. This makes it more fun when gaining ranks.
Once you have your module all set up how you want you will be able to let your chat users know they can now give out reputation.
The new standard set of commands that open up when enabling the reputation module are:
/rep - Used to give reputation to a user, either directly or by replying to their message.
/toprep - Displays reputation point rankings, which can be filtered by time or limited numbers.
/myrep - Displays the users current reputation points and how many they have left to give out.
The following new commands become available if negative reputation is enabled:
/remrep - Removes reputation from a user.
In addition to the above, any additional custom rep triggers you made will work too.
When a user types /commands in your chat they will see these reputation commands listed with an explanation of their usage.
