[XB] Thread Ratings 2.1.2

Add five-star thread ratings and written thread reviews to XenForo.

This XenForo thread rating add-on turns normal replies into ratings while also supporting standalone votes and reviews. Administrators can control who may rate topics, require a rating with replies, protect anonymous ratings, and display rating results throughout the forum.

Unlike a basic topic rating system, [XB] Thread Ratings connects scores with the discussion itself. Communities can collect quick star ratings, detailed written reviews, or rating-backed replies through one flexible forum rating system.

Commissioned by @PhineasD

---

Features:​

• Five-Star Thread Ratings: Let users select a one-to-five-star rating while creating a thread or posting a reply.
• Rate Threads without Replying: Allow permitted users to submit a standalone thread rating without posting.
• Written Thread Reviews: Enable optional or required review messages for standalone ratings, with configurable minimum and maximum lengths.
• Anonymous Ratings: Let permitted users submit ratings anonymously while separately controlling who can reveal the author and rating value.
• Multiple Ratings per Thread: Set the maximum number of ratings each user may submit to the same thread.
• Rating Averages and Distribution: Show the average score, rating count, and percentage breakdown for each value from one to five stars.
• Forum and Thread Displays: Show rating stars in thread lists, article previews, posts, thread status areas, and configurable statistics blocks.
• Thread Sorting: Add rating-based sorting to forum thread lists.
• Latest Ratings Widget: Display recent ratings in simple or full layouts, with forum, date, entry-count, and sort controls.
• Member Profiles and Statistics: Provide a profile tab for ratings and optional total and average rating statistics.
• Forum Statistics: Add the total number of submitted thread ratings to the forum statistics widget.
• ACP Rating Log: Search and filter ratings by user, thread, forum, rating value, review status, and date, with batch actions to delete ratings or change their anonymity.
• Moderation Tools: Edit or delete ratings, use inline moderation, record moderator actions, and clean up rating reviews detected as spam.
• Rating-to-Post Association: Optionally attach a user's latest standalone rating to a later reply and rebuild historical associations within a configurable time range.
• Structured Data: Add configurable Schema.org aggregate rating data to rated threads for search engines.
• Rating Importers: Import existing ratings from [XB] Guide Threads and [XB] Tournament Threads through the standard XenForo importer while skipping ratings already imported.

---

Permissions:​

• View Ratings: Separately control access to total scores and the list of users who rated a thread.
• Submit Ratings: Control rating with a post and standalone rating independently for each forum.
• Require a Rating: Require eligible users to select a rating when replying.
• Anonymous Access: Control who may rate anonymously and who may reveal anonymous ratings.
• Per-Thread Limit: Set the maximum number of ratings a user may submit to one thread.
• Edit and Delete: Provide separate permissions for users' own ratings and any rating.
• Inline Moderation: Grant access to rating moderation tools in rating lists.
• Profile Access: Control whether users may view their own or other members' rating history.

---

Requirements:​

• XenForo 2.2.0+

---

Useful for:​

• Suggestions and Feedback: Collect a clear score alongside detailed community feedback.
• Guide and Review Forums: Let readers review tutorials, resources, products, media, or other thread-based content.
• Community Rankings: Sort discussions by rating and highlight the highest-rated threads.
• Questions and Discussions: Add lightweight quality signals without changing the normal reply workflow.
• Moderated Communities: Give staff fine-grained control over visibility, anonymity, editing, and deletion.

---

FAQ:​

• Can members rate a thread without posting a reply?
  Yes. Standalone ratings are available through a separate forum permission and can include a written review.
• Can a written review be required?
  Yes. Reviews can be enabled and required, with configurable minimum and maximum lengths.
• Are anonymous ratings completely hidden?
  They are hidden from regular viewers. A separate forum permission can allow selected users, such as moderators, to reveal anonymous rating details.
• Can a member rate the same thread more than once?
  Yes. A forum permission controls the maximum number of ratings per user and thread.
• Can ratings appear outside the thread page?
  Yes. Ratings can appear in thread lists, article previews, posts, widgets, member profiles, and forum statistics, depending on permissions and style settings.
• Can existing ratings be imported?
  Yes. Importers are included for [XB] Guide Threads and [XB] Tournament Threads, and previously imported ratings are skipped when an import is run again.
• Does the add-on show thread ratings in forum lists?
  Yes. The average star rating and rating count can appear in forum thread lists and article previews, and users can sort threads by rating.

---

Screenshots:​

User Rating Experience​

Forum and Widget Displays​

Permissions and Administration​