Summary | This topic component allows you to require fill in the reason for the action when a moderator review | |
Repository | https://github.com/Lhcfl/review-with-reason | |
Install Guide | How to install a theme or theme component | |
New to Discourse Themes? | Beginner’s guide to using Discourse Themes |
Install this theme component
This component allows/requires moderators to fill in the reason for the operation when review, and then log it in a topic.
Note that the topic must be visible to all people who are eligible to review, otherwise the review will fail! Please check the configuration part before installing.
Screenshots
Reviewing
Logger topic
Configuration
IMPORTANT For any settings including “logger_topic_id”:
logger_topic_id is the topic used to log the reason.
- Required: The topic must have write permissions for the reviewers (moderators and category moderators), otherwise the review will fail.
- Strongly recommended: This topic should not be visible to other people, unless
hide_reviewable_user_email
andhide_reviewable_details
are set to true, because it will directly record the email address of the user to be approved, and the reporter of flagged posts.
Settings:
-
logger_topic_id
: Global logger_topic_id -
allow_no_reason
: When on, reviewers can skip providing a reason. Otherwise they must enter a reason. -
max_length_raw
: Maximum length of a quote in the autolog post -
skip_for_categories
: For these categories, skip the requirement to explain reason -
logger_topic_id_override_for_catrgories
andlogger_topic_id_override_for_reviewable_type
: For these cases, override logger_topic_id. For example, as only moderators can review users, you can set up a dedicated logger_topic for this type. -
hide_reviewable_details
: Hide details of reviewable entries in the log, usually are who reported, when, and why. -
hide_reviewable_user_email
: Hide the email of the reviewable user in the log -
hide_reviewable_user_fields
: Names of the user fields to hide for reviewable users in the log