This is an exploratory test of a new feature or improvement, so please feel free to try anything you like and not just the test steps!

Setup / basic info

1. The communication experimental feature and associated providers (Matrix and custom link) are enabled by default on https://qa.moodledemo.net/, so no site level admin configurations should be required to test them.
2. Matrix is also enabled on the Matrix Demo 1 course on that site (that course also includes some further information about the Matrix integration on its homepage). The below steps assume you will test with that course, though you can experiment with enabling it yourself on other courses.
3. You can access the Communication settings for a course's home page More dropdown menu.

Custom link provider

This provider allows you to set up a URL for any communication service on a course. No user/room management takes place, it simply makes a link available from the blue communication button at the bottom right of any page in the course (just above the "?" icon).

Matrix

This provider will create and manage the relevant room(s) within the Matrix messaging service for your course, as well as managing who is added/removed from any such room(s) and their per-room access/power level.

Notes:

• Matrix accounts/rooms are accessed via the Element web application, which for the rooms used by the QA site can be found at https://element.in.moodle.com/. Credentials for that site are the same as that user's Moodle QA site credentials (eg u: teacher / p: moodle).
• Most actions (such as managing room membership, creation etc) are performed in the background by ad-hoc tasks. This means those tasks must complete before the action will be completed.

Test Scenario

1. As a teacher, navigate to the Matrix Demo 1 course.
2. Set the group mode to Visible groups.
3. Go to Participants > Groups and create two groups - call them "MDLQA-X Group A" and "MDLQA-X Group B", where X is the number of this QA test, eg: "MDLQA-18913 Group A".
4. Go to More > Communication and check the Provider is set to 'Matrix'. If it is is, skip to the next step. If it is not:
   1. Set the provider to Matrix. You can leave the room name blank or as-is, it will populate with the course name when saved if left blank.
   2. Once saved, teachers will likely see a banner on the course homepage confirming their room is being prepared.
   3. Once reloading the page results in a "room is ready" banner, the background processes have completed and the relevant setup has been performed in Matrix. You will then see the communication icon/button at the bottom right of the course page.
5. Click on the communication icon at the bottom right of the page.
6. You will be redirected to the Matrix (Element) web client. You should now have 2 browser tabs open (one for Moodle and one for Matrix/Element).
7. Log in using your current user's credentials (ie u: teacher p: moodle).
8. CONFIRM two rooms have been created (one for Group A and one for Group B) and that the room names include the groups' names.
9. Back in your Moodle tab, navigate back to the course's participants page (keep the Matrix tab open as well, you will return to it in later steps).
10. As admin, update the role of one student to become a teacher and set another user as a manager.
11. Add one student to Group A and a different student to Group B.
12. Wait a few seconds for the background cron processes to run.
13. Return to the Matrix tab.
14. CONFIRM that you see the expected room memberships and power level updates:
    1. CONFIRM that both your current teacher user and the user you upgraded to a teacher role in Moodle have been added to both groups' rooms, and that their power level is Moderator (aka Custom 51).
    2. CONFIRM that the user you gave the manager role in Moodle has been added to both groups' rooms and their power level is Moderator (aka Custom 51).
    3. CONFIRM that the students in the course have only been added to the room for the group they are the member of, and their power level remains the Default.
15. Go back to the participants page, find the student who you changed to teacher and change their role back to student.
16. Wait a few seconds for the background cron processes to run.
17. Go back to the Matrix browser tab.
18. CONFIRM that user's power level has been changed to Default and the user has been removed from both groups' rooms.
19. Go back to the participants page and change one student's role to manager.
20. Wait a few seconds for the background cron processes to run.
21. Go back to the Matrix browser tab.
22. CONFIRM that the user has been added to both groups' rooms, and their power level is Moderator (aka Custom 51).
23. Go back to the participants page  and enrol the admin user as a student in the course.
24. Wait a few seconds for the background cron processes to run.
25. Go back to the Matrix browser tab.
26. CONFIRM that the site admin has been added to both groups' rooms and their power level is set to Custom 90.
27. Go back to the the course in the Moodle tab.
28. Navigate to More > Communication and change the communication provider from 'Matrix' to 'Custom link'.
29. Leave the room name as-is (it has not functional purpose for custom link), and set the Custom link URL to https://moodle.org/mod/forum/view.php?id=56 and save changes.
30. Wait a few seconds for the background cron processes to run.
31. Refresh the course page and click on the communication icon.
32. CONFIRM a new tab opens which loads the QA testing forum.
33. Go back to the Matrix browser tab.
34. CONFIRM that you (the teacher) have been removed from both groups' rooms (if you have one open or click on them under Historical, you will see a message like "You were removed from <room name>  by Admin User. This indicates that all users have been removed from the room.
35. Edit the course settings, change the group mode to no group and save changes.
36. Navigate to More > Communication and change the provider back to 'Matrix'.
37. Set the Room name if you wish - if you leave it blank the expected behaviour is that after you save, it will be automatically populated by the course name.
38. Set the Room topic if you wish - this is used to describe what the room is for.
39. Save the changes.
40. Wait a few seconds for the background cron processes to run.
41. Go back to the Matrix browser tab.
42. CONFIRM a single course room has been created (or is now available, the room may have already existed for this course), with the room name set in step 46 (or the course name if you did not manually insert a course name).
43. CONFIRM that you see the expected room membership and power levels:
    1. CONFIRM all users enrolled in the course are added to the course room in Matrix.
    2. CONFIRM that any teachers in the course have been given the Moderator power level in the room.
    3. CONFIRM that any managers in the course have been given the Moderator power level in the room.
    4. CONFIRM the site administrator who you enrolled in the course earlier has the power level of Custom 90 in the room.
    5. CONFIRM that all students in the course retain the Default power level.
44. Go back to the the course participants page in the Moodle tab.
45. Change the role of a user from teacher to student and a different student to the role of manager.
46. Wait a few seconds for the background cron processes to run.
47. Go back to the Matrix browser tab.
48. CONFIRM that the user you changed from teacher to student had their power level changed to Default, and that the student you changed to manager's power level upgraded to Moderator.
49. Go back to the the course in the Moodle tab and navigate to More > Communication.
50. Change the communication provider from 'Matrix' to 'None'.
51. Go back to the Matrix browser tab.
52. CONFIRM that you (the teacher) have been removed from the course room (if you have one open or click on them under Historical, you will see a message like "You were removed from  <room name> by Admin User.