Course Reviews
The addon turns WordPress comments on the course post type into star-rated
reviews. Students leave a rating, an optional title, and a comment; the course
page shows an average rating, a rating breakdown, and the list of reviews.
Enabling reviews
Section titled “Enabling reviews”Reviews appear only when Review on course is enabled on the General tab. See Configuring settings. With it enabled:
- The single course page gains a Review tab.
- The archive cards and the single course header show the average rating and review count.
The addon also enables comment support on the course post type so the review
form can be shown.
The review form
Section titled “The review form”The review form is a WordPress comment form extended with:
- A star rating widget (1 to 5 stars), backed by a required rating field.
- An optional review title field.
- The standard comment (review text) field.
When a review is submitted:
- If no rating is chosen, submission is blocked with a “Please rate the course” message.
- The rating is validated to be between 1 and 5 and stored as comment meta
(
rating), and the title is stored as comment meta (title). - The visitor is redirected back to the course with the Review tab active.
A nonce (reign-sensei-course-review) protects rating and title storage, so
only submissions from the addon’s own review form save review meta.
Rating breakdown and average
Section titled “Rating breakdown and average”The single course page shows a reviews overview: the average score and a per-star breakdown (5 stars down to 1 star) with a count for each. The average is calculated across the approved reviews on the course.
Display customization
Section titled “Display customization”Each review row is rendered through action hooks so its parts can be rearranged or extended: the avatar, star rating, title, meta, and comment text each fire their own hook. The review templates can also be overridden from your theme. See Templates and Hooks and filters.