moderate forum posts

[Cecilia Vela Gurovic]

Add setting to forum to allow moderators to approve or deny new posts or replies

Thanks to Recording Arts Canada for sponsoring this feature.

[Steven (stevens-q)]

The acceptance criteria has been identified as follows

Acceptance Criteria
-----------------------
1. All forums created will have the new field Moderate new posts drop down selections = None, Posts, Replys, Posts & replys visible to Site admin, Group admin and forum moderators

2. Site admin, Group admin and forum moderators will recieve notification of posts that are in the queue and require moderation

3. New notification type "Forum moderation" is created so notifications can be filtered

4. Posts awaiting approval are highlighted in yellow and receive a button for giving approval or denying approval.

5. If the denial button is clicked, the moderator needs to provide a reason for the denial (like for pending registrations; only that the reason is mandatory).

6. If a post / reply is approved, it will be sent out with the next cron run for forum notifications.

[Steven (stevens-q)]

Preconditions
===============

Group settings
-------------------------
Associate with institution = No Institution
Open = Yes
Roles = Standard
Create and edit = All group members
Publicly viewable group = Yes
Auto-add users = Yes
Shared page notifications = All group members
Comment notifications = All group members
Send forum posts immediately = Yes

Group admins = Admin User, Alice User1 (only people allowed to create forums)
Group Members = Bob User2, Carol User3, Dan User4, Earl User5, Fred User6 (All users can create forum topics)
Forum Moderators - Admin Forum - Moderation testing = Bob User2
Forum Moderators - Alice User1 Forum - Moderation testing = Bob User2

Forum settings
-------------------------
1. Moderation testing (Posts and replys)

Test Script
============

1. User3 (group member) logs in and creates a new topic (called User3 New topic) in "Forum1"

2. Verify User3 (author) sees topic highlighted in yellow and a note "Awaiting approval" when submitted
--- a. Verify topic title and first 50 chars are displayed on Main Forum page (yellow highlight) ✘
--- b. Verify topic title and first 100 chars are displayed on About group page (yellow highlight) ✘
3. User4 (Group member) logs in and browses to the "Forum1"

4. Verify that User4 cannot see the newly created Topic (Includes topic title and any text message) ✘

5. User2 (Group admin) logs in and browses to the "Forum1"

6. Verify that User2 can see the Newly created topic with a yellow background (indication approval needed)
--- a. Verify topic title and first 50 chars are displayed on Main Forum page (yellow highlight) ✘
--- b. Verify topic title and first 100 chars are displayed on About group page (yellow highlight) ✘

7. Verify that Site admin, Group admin and forum moderators recieves notification ✔

8. Verify New notification type "Forum moderation" is displayed in the email filter dropdown ✔

[Steven (stevens-q)]

Re-Test Script
----------------------
1. User3 (group member) logs in and creates a new topic (called User3 New topic) in "Forum1"
2. Verify User3 (author) sees topic highlighted in yellow and a note "Awaiting approval" when submitted
--- a. Verify the newly created post is not displayed on Main Forum page or About group page untill it has been moderated by either Group admin or Group moderator ✔
3. User4 (Group member) logs in and browses to the "Forum1"
4. Verify that User4 cannot see the newly created Topic (Includes topic title and any text message) ✔
5. User2 (Group admin) logs in and browses to the "Forum1"
6. Verify that User2 can see the Newly created topic with a yellow background (indication approval needed)
--- a. Verify the newly created post is not displayed on Main Forum page or About group page untill it has been moderated by either Group admin or Group moderator ✔
7. Verify that Site admin, Group admin and forum moderators receives notification ✔
8. Verify New notification type "Forum moderation" is displayed in the email filter dropdown ✔
9. Verify post / reply if approved is displayed in the following places
a. Verify topic title and first 50 chars are displayed on Main Forum page (with no highlight) ✔
b. Verify topic title and first 100 chars are displayed on About group page (with no highlight) ✔
10. Verify post / reply if Rejected by Site admin Group admin or Group moderator that the following happens
--- a. verify moderator is required to enter a reason into a text field ✔
--- b. verify moderator can then click the Notify Author or cancel action ✔
--- c. If Notify Author button is clicked verify the following
------ i. The post is deleted ✔
------ ii. The author receives an email saying post was rejected with the reason, the original post text and a link to the forums page ✔

[Steven (stevens-q)]

Environment tested: Master
Browser tested: Chrome

Preconditions
----------------------------
1) the following users exist
--- a. Group Members = SIte admin, User1, User2, User3, User4, User5, User6
--- b. Group admins = User1
--- c. Forum Moderators - User2

2) Group exists with the following settings set:
--- a. Associate with institution = No Institution
--- b. Open = Yes
--- c. Roles = Standard
--- d. Create and edit = All group members
--- e. Publicly viewable group = Yes
--- f. Auto-add users = Yes
--- g. Shared page notifications = All group members
--- h. Comment notifications = All group members
--- i. Send forum posts immediately = Yes

3) Forum exists with the following settings
--- a. Moderate new posts = Posts and replies

Test Script
----------------------

1. Login as Group member (User3) and creates a topic
2. Verify User (User3) sees topic highlighted in yellow and a note "Awaiting approval" when submitted ✔
3. Verify the newly created post is not displayed on the following pages
 a. Main Forum page ✔
 b. About group page ✔
 c. Portfolio page that has a Recent forum post block ✔
4. Log out
5. Login as another group member (User4)
6. Verify that user cannot see the newly created Topic (by User3) in the following places
 a. Main Forum page ✔
 b. About group page ✔
 c. A page with a Recent forum post block ✔
7. Log out
8. Login as Group admin (User1)
9. Verify that Group admin can see the Newly created topic with a yellow background (indication approval needed)
10. Verify that user cannot see the newly created Topic (by User3) in the following places
 a. Main Forum page ✔
 b. About group page ✔
 c. A page with a Recent forum post block ✔
11. Verify that Group admin and moderator of group forum receives an email as follows
 a. Subject: Mahara: New post needs moderation in forum <forum name>
 ✔
 b. Email bod text:
 ✔
   You have been sent a notification from Mahara. Message follows:
   ------------------------------------------------------------------------

   Subject: New post needs moderation in forum "Bug 1803912 moderate forum posts"

   Fred User6 has posted in forum "Bug 1803912 moderate forum posts" and is
   awaiting for moderation.

   The post content is:
   <post message>

   See
   <Forum Link>
   ------------------------------------------------------------------------

   This is an auto-generated notification from Mahara. To update your notification
   preferences, visit
   http://mahara.stevens-lp.dynamic.wgtn.cat-it.co.nz/account/activity/preferences/index.php

   Please do not reply to this message.

12. As the group admin, reject the post message.
13. Verify that group admin must enter a reason in the Reason field that they are redirected to
 ✔
14. Click the Verify author button to send an email notifying author of the decision
15. Verify the author receives an email saying post was rejected with the reason, the original post text and a link to the forums page ✔
 a. Subject: Mahara: Forum post rejected on forum<forum name> ✔
 b. Email bod text:
 ✔
 You have been sent a notification from Mahara. Message follows:
 ---------------------------------------------------------------...

[Mahara Bot (dev-mahara)]

Reviewed: https://reviews.mahara.org/9309
Committed: https://git.mahara.org/mahara/mahara/commit/415c814342babdeadd71afa63e43ad090dd44570
Submitter: Cecilia Vela Gurovic (<email address hidden>)
Branch: master

commit 415c814342babdeadd71afa63e43ad090dd44570
Author: Cecilia Vela Gurovic <email address hidden>
Date: Tue Nov 13 15:11:10 2018 +1300

Bug 1803912: Moderate forum posts and replies

behatnotneeded

Change-Id: Ic40f573044b16a96272413d6b7742d369982a8a2