Skip to content

Course Reviews and Ratings

The addon adds a star-rating review system to the single course page. Logged-in students can leave a title, a star rating and review text, and the course shows an aggregate rating summary with a per-star breakdown.

Reviews use LifterLMS’s own review settings on each course. The review UI appears only when the course has reviews enabled (_llms_reviews_enabled). The stored list is shown when “display reviews” is on (_llms_display_reviews), and the number of reviews listed follows the course’s review count setting (_llms_num_reviews). These are all standard LifterLMS course settings; the addon reads them and renders the front end.

  • Average Rating panel with the numeric average and the total number of ratings.
  • Detailed Rating panel with a bar per star level (5 down to 1) showing how many reviews gave that rating.
  • A list of individual reviews, each with the author’s avatar, name, date, star rating, title and text.
  • A Write a Review form (for logged-in users) with a review title, an interactive star rating, and a review text field. After a successful submission the new review is appended without a page reload, and repeat reviews are blocked when the course disables multiple reviews (_llms_multiple_reviews_disabled).

The review form posts to the ReignLLMSSubmitReview AJAX action. The handler:

  • Verifies the reign_llms_review_nonce nonce (the form renders only for logged-in users, so there is no logged-out handler).
  • Creates an llms_review post as a child of the course.
  • Stores the star value in the course_rating post meta when a rating was submitted.

The star widget is drawn with the bundled RateYo library, loaded only on course pages.

Filter Purpose
reign_llms_star_review_color Star color. Default #ffb606.
reign_lifterlms_reviews_section_title Heading above the review list. Default “What Others Have Said”.
llms_review_thank_you_text Thank-you message after submitting. Default “Thank you for your review!”.
rlla_llms_course_review_gravatar_size Avatar size in the review list. Default 60.

See Hooks and filters for the full list.