xF1 Add-on Brivium - Rate Threads with Stars 1.0.2

This mod will add an advanced star thread rating system to your forum.
Star ratings are as follow:

1 star = Terrible
2 stars = Poor
3 stars = Average
4 stars = Good
5 stars = Excellent

Ratings can be set so they can be given anonymously as well for users with permissions to rate anonymously. You can also leave a comment as well to go with your rating point(s). The comments can be required or optional. Staff will be excluded from this restriction.

After ratings, users have also the option to remove it. This is group permission based. Users whose rating(s) will be removed will receive an alert informing them of that fact. Receiving of rating deletion alerts can be enabled/disabled at users profiles->Alert Preferences->Deletes your reputation.

Deletion of ratings is time based (minutes). By default it is set to 0 minutes. Meaning users will not be able to delete their ratings at all. If you want to change that then at the 0 field enter the number of minutes that you want your users to wait before they will be able to delete their own ratings. If you do not want to have a limit at all for rating deletion, set it to Unlimited.

You can set that a thread that receives a certain amount of star ratings can be sticky.

Thread starters will be notified through an alert whenever their threads have been rated. If an user and/or users do not want to receive an alert they can disable them at their profiles->Alert Preferences.

You can set it to show the most positive rated threads at the sidebar of your forum. The invisible threads will not show up. Also the group/groups that does/have not permissions to view a forum, will not be able to see the top rated threads from the forum/forums that they are not allowed to view.

You can also choose a forum and/or forums to exclude its/their top rated threads from showing up at the sidebar. To choose more that one forum, separate their ids with commas(,).

Note: Do not use comma after the last forum id! If there is only one forum that you want to exclude, then enter its id number only, without a comma after. If there are several forums that you want to exclude, then separate them with commas but don''t place a comma after the last forum id.

Star ratings can be disabled in certain forum(s) of your choice.

You can also sort threads by Ratings. You can set the Ratings option to sort threads by default on a forum per forum basis under the Forum Options tab at the Default Sort Order.

You can also set Ratings as default option to sort all threads in all forums in one fell swoop at the Acp->Options->Thread Rating System->Forum Thread Sorting Order!


An overall overview of all thread ratings in your forum can be seen at Acp->Tools->Thread Rating Log. There is also the Recount And Rebuild tool. Running this tool will delete ratings left and received in deleted threads and by deleted users. Note that this may take a while in big forums with large numbers of ratings. You can delete the rating entries as well and you can also search for ratings left by users. You can also clear all the ratings.

And as last but not least, you can delete all the ratings given by an user to a thread(s) in one fell swoop. To do that, when editing an user, under the Action drop down tab there is a new option added called: Delete All Thread Ratings. Click it and run it.

After you install the mod go to the group(s) that you want to use the Thread Rating System and when editing that group permissions, all the way to the bottom you will see a new permission setting added: Thread Rating. It has 10 permissions.

1) Can view star ratings in threads:
If this is set to No then all the below permissions are not relevant.

2) Can rate threads:

3) Daily rating limit. Leave 0 for no limit:

4) View ratings for own threads only:

5) View ratings for all threads:

6) Can rate anonymously:

7) Can view anonymous ratings for own threads only:

8) Can view anonymous ratings for all threads:

9) Can delete own ratings:

10) Time limit on deleting own ratings (minutes):

Set them accordingly and save the changes.

The mod settings can be found at Acp->Options->Thread Rating System. There you can:

1) Exclude Forums from rating threads.

2) Thread List Rating Display!

3) Rating Comment Required!

4) Threads Sorting Order!

5) Stick threads automatically if they have received x amount of rating stars.

6) Most Positive Rated Threads Sidebar!

7) Sidebar Threads Limit!

8) Excluded Forums!

Set them accordingly and save the changes.

A converter is also available to import the ratings from the latest current versions of vb 3.8&4.2 and MyBB 1.6&1.8. forums.

You may use one copy per forum. If you wish to purchase multiple licenses please let me know so we can work out a discount.

For more info please check the attached screenshots.