User Story: Moderation Queue

[nautbot]

This user story is intended to cover functionality of the submission/comment reporting system and their interaction with the moderation queue in more detail. This will cover both the general user-facing report function, as well as the moderator-facing moderation queue.

---

User

When a user encounters an offending post or comment, they have the option to flag the item for moderator review using the [report] link:

Submission:

Comment:

Since CSS is patently not fun, we'll go ahead and report that comment. The process for flagging submissions and comments works the same and yields the same result in the moderation queue.

In either case, a dialog will open for the user to select a reason for flagging the item:

Since we could say the offending comment fits any of these categories, we'll see what "Other Issues" entails:

Not as many applicable choices there, so we'll go back and just mark that the comment violates the forum's rules:

This leads to another prompt where we have the option to add a free-text comment to the report:

We add our custom message, and hit [Submit] to send it! Once the report is sent, we are given an additional option to block the submission/comment's author:

---

Moderator

Moderators have special page called the "moderation queue" where all of the flagged items appear. These queues exist both for each individual forum the user moderates, as well as an aggregate queue that gathers flagged items from all of the forums the user moderates.

Individual forum moderation queue:

Aggregate multi-forum moderation queue:

The moderator can also see flagged submissions and comments inline with the existing forum and comment forests.

Example of flagged submission in forum:

From either the moderation queues or inline with forum submissions or comment forests, the moderator is given several buttons for getting more information or performing moderation actions on the reported items:

Clicking the [reports] button will expand a list of the reports/reasons underneath the offending item:

The remainder of the buttons each perform a different moderation action:

• [spam] - Removes the offending item, and adds it to the spam filter's definitions (some form of fancy machine learning thing);

• [remove] - Removes the offending item;

• [approve] - In the case an item has been removed (i.e. by auto moderation rules) this will reinstate it;

• [ignore reports] - This will stop the acknowledgement of additional reports from triggering any auto moderation rules.

Further to the right is an ever-present [rts] link (always displayed on submissions/comments for moderators, regardless of having reports), another moderation tool that immediately marks the author as a spammer.

---

Auto-Moderation

Another piece that interacts with the report system and moderation queue is the auto moderator, a bot that can be customized by the forum's moderators to help address submissions and comments that have been flagged. This bot has a basic scripting language, and the rule sets can be defined/edited from a text field accessible from the forum settings:

In the example configuration above, once the offending item has received three reports, the bot will send a message to modmail with a link to the item with notice to review:

Per the same rule configuration, once an offending item reaches five reports, it is automatically removed:

[psineur]

This needs to be minimized into MVP task:

1. report button
2. mod queue
3. approve/remove/spam buttons
   anything else?

[psineur]

Also: https://github.com/TheRealGD/therealgd/wiki/Core-Product-Feature-List

[nautbot]

"Spam" is an entire other can of worms. I'd say right now we need:

1. Report button on posts/comments

2. Mod queue

3. Approve/remove mod action buttons

[psineur]

@tstiegler do we close this or are there any other things to be done?

[psineur]

Merging #86 here, #170 is related

Ability for users to report posts/comments that violate site/sub rules. Add "Report" button on posts/comments:

"Report" currently dumps items into a single feed known as the moderation queue:

Later implementation could include user selecting specific rule violation, but for now just dumping > into mod/admin forums (as implemented in #61) as new post linking back to offending item should >suffice.

Currently there is UI for Reporting a submission with some typos in the UI.
Posting a report works, for both comment and submission. However they looks strange in /moderation_queue

Comment has voting, but doesn't show comment itself
Submission doesn't have voting buttons.

Approving /removing also affects whole submission, and never just comment - this needs just a bit more testing and fixes