Repository files navigation

The Reviews module provides comment and ratings support for media items. Comments and ratings can be added (and deleted) via API requests only; the module is designed to integrate with another website. Adding a rating will also update a custom metadata field with the average rating in order to allow for searches and dynamic selections based on good (or poor) ratings.

Seehttps://docs.openbroadcaster.com/ for general API integration instructions. An appkey is required on a user with the "manage media reviews via api" permission. As this permission gives broad access to add and remove ratings and reviews, any integration should be done server-side to avoid providing end users with access credentials (i.e., in JavaScript source code).

1. Add the module code to /modules/reviews and install the module via the OpenBroadcaster "modules" page.
2. Add a custom metadata field (integer) with the name "reviews_module_rating" to hold the average rating value (0-100).

The following methods are available for the controller "review".

Add a comment to a media item. Multiple comments per user/email are allowed.

Delete a comment.

Get all comments. Note this method is available to any logged in OpenBroadcaster user (or any user via appkeys).

Add a rating to a media item. If a rating already exists for this email address, it will be replaced.

Delete a rating.

Get all ratings. Note this method is available to any logged in OpenBroadcaster user (or any user via appkeys).