All the info updated

Antonio Cañas Vargas 2019-12-13 09:10:02 +01:00
parent 70f6c4ebac
commit f7ff04d63d
1 changed files with 24 additions and 7 deletions

@ -39,29 +39,46 @@ To **edit** an existing game, click on the _Edit_ icon (pencil). A form identica
## Matches
Once a game is created, several matches can be played, for example one in each group of the course.
Once a game is created, several matches can be played, for example one in each [group](USERS.Groups.en) of the course.
To **create a new match**, the teacher (or non-editing teacher) has to go to the game by clicking on its title. A _Matches_ box appears, and you have to click on the _New match_ icon (plus sign) in the upper left corner, or on the _New match_ button. A form appears to give a name to the match, which will be shown later as a title on the match screen. The teacher can also select if that match is open to the participation of any student of the course or only to students belonging to certain groups. Finally, you will have to click on the _Play_ icon (play symbol). It is also possible to resume an interrupted or finished match. To do this, the teacher has to click on the _Play_/_Resume_ icon (play / flag symbol) associated to the game.
### New match
To **create a new match**, the teacher (or non-editing teacher) has to go to the game by clicking on its title. A _Matches_ box appears, and you have to click on the _New match_ icon (plus sign) in the upper left corner, or on the _New match_ button. A form appears to give a name to the match, which will be shown later as a title on the match screen. The teacher can also select if that match is open to the participation of any student of the course or only to students belonging to certain [groups](USERS.Groups.en). Finally, you will have to click on the _Play_ icon (play symbol).
A non-editing teacher can create matches, but not games. And he/she can only delete or play the games he/she had created.
When a **teacher** (or a **non-editing teacher**) creates or resumes a match, a new window opens in the browser with the content of the questions and possible answers. At that time the video output should be projected in the classroom to be visible by the students present. The teacher can click on the icons _Backward_, _Pause_/_Resume_ and _Forward_ when deemed appropriate to go through the following states of each question:
It is also possible to resume an interrupted or finished match. To do this, the teacher has to click on the _Play_/_Resume_ icon (play / flag symbol) associated to the game.
### Match operation for teachers
When a **teacher** (or a **non-editing teacher**) creates or resumes a match, a new window opens in the browser with the content of the questions and possible answers. At that time the video output should be projected in the classroom to be visible by the students present.
Teachers can click on the icons:
* _Backward_
* _Pause_/_Resume_
* _Forward_
when deemed appropriate to go through the following states of each question:
1. **Question statement**.
2. **Statement and possible answers** to the question. Students can only answer when the question is in this state and is not in pause mode.
3. **Statement and results** of the question. This status is optional and will only be displayed if the teacher activates the _View results_ toggle.
At all times, the total match time and the current question time are shown on the teacher's screen.
At all times, the total match time and the current question time are shown on the teacher's screen. When the match is not paused, the number of students who have answered the current question and the total number of students who are playing the match are also shown.
**Students** can join a match by selecting it in the game's match list and clicking on the _Play_ icon (play symbol / flag). A student can only join a match if he/she belongs to any of the groups associated with that match. When joining the match, a new window will open in the browser in which the question number and several buttons will appear to select one of the options. These selection buttons are only shown in the second state of the question, when the teacher is projecting the answers.
In principle, there is no time limit in each of the states of the question, since it is the teacher who controls when the change from one state to another. However, the teacher can click on the numbers 60, 30 and 10 next to the _hourglass_ icon to establish a countdown after which the match automatically goes to the next state. If the teacher wishes to cancel the countdown, he/she can click on the _infinite_ symbol.
Each match can be interrupted, paused and resumed at any time. This means that there is no problem if connectivity to the network is lost, if the browser is closed or if there is no time to finish the match at class time. The same applies to students, who can reconnect to the match if they close the browser and re-enter.
### Match operation for students
**Students** can join a match by selecting it in the game's match list and clicking on the _Play_ icon (play symbol / flag). A student can only join a match if he/she belongs to any of the groups associated with that match. When joining the match, a new window will open in the browser in which the question number and several buttons will appear to select one of the options. These selection buttons are only shown in the second state of the question, when the answers are being projected on the classroom screen.
## Results
The results of each student in each match are stored in the database for later use as part of the assessment. Each student can see their results after finishing the match when the teacher decides.
The teacher can activate or deactivate the visibility of the results in the list of matches in a game by pressing the _Hidden result_ icon (strikethrough eye) or _Visible result_ icon (eye) located to the right of each match. By default the results are hidden until the teacher makes them visible.
If you are a **teacher**, you can see the results of each student by clicking on the _Results_ link. Then select the students whose matches you want to see, choose the date range, and click on the _View match results_ button. A list will appear with all the matches made in the selected date range. You can see the details of each match by clicking on the _View match icon_ (on the right side of each row).
If you are a **teacher**, you can see the results of each student by clicking on the icon _Results_ (trophy symbol). Then select the students whose games you want to see, and click on the **See results of matches** button. A first list will appear where you can change the selection of games, and a second list with all the matches made for the selected games. You can see the details of each match by clicking on the icon _See game_ (on the right side of each row).
If you are a **student**, you can see your results by clicking on the _Results_ link. Then choose the date range and click on the _View game results_ button. A list will appear with the matches you played in the selected date range. You can see the details of each match by clicking on the _View match icon_ (on the right side of each row) if the teacher has allowed it.
If you are a **student**, you can see your results by clicking on the icon _Results_ (trophy symbol). A list will appear with the matches you played in the selected games. You can see the details of each match by clicking on the _View match icon_ (on the right side of each row) if the teacher has allowed it.