Commit cb5ef4ee authored by Astor Bizard's avatar Astor Bizard 🐕
Browse files

Updated readme.

parent 4a735cb4
# Random activity
Version: 0.5 (October 2020)
Version: 1.1 (November 2020)
Author: Astor Bizard
......@@ -9,3 +9,56 @@ This software was developped with the support of the following organizations:
- Institut Polytechnique de Grenoble
## Introduction
The "Random activity" activity type is a module that allows teachers to randomly split students among other activities within a course.
Typically, suppose we have two versions of an exercise: a Quiz (named Quiz 1) and an Assignment (named TP 1), along with documentation for each activity.
Now suppose we want to split students randomly among these activities.
We can come up with this:
![Course overview for two linked Random activities (teacher)](metadata/screenshots/course_view_teacher.png)
... which will give one of the following results for each student:
![Course overview for two linked Random activities (student 1)](metadata/screenshots/course_view_student1.png)
![Course overview for two linked Random activities (student 2)](metadata/screenshots/course_view_student2.png)
## Create and setup one or more Random activities
### Prepare your activities pool
You first need to create a pool activities, among which students will be split.
It is recommended to place them in a hidden section of your course, and make them available (this can be done from the course page, or from the settings page of each activity in the "Common module settings" section).
### Create the Random activity
To create a Random activity in your course, simply proceed the same way as other activity types.
To set up the activities pool for your Random activity, click "Save and display" at the end of the editing form, as the activities pool is set up on the view page.
### Activity view page
From here, you can view the current activities pool, and edit it by clicking the "Edit" and "Add activities" buttons.
![Activities pool view](metadata/screenshots/activities_pool_edit.png)
When you are done editing the activities pool, click "Apply changes and re-assign" to apply the changes.
You should then see students enrolled in your course assigned to the activities you added.
**Note:** Students will __not__ see this page when accessing the Rabdom activity. They will be automatically redirected to the activity they are assigned to.
### Seed
Notice the "Seed" field on the bottom right of the view page. This is the seed for the random splitting of students among activities.
This means that a different seed will lead to a different distribution, and an identical seed will lead to an identical distribution\*.
You can thus use an identical seed in several Random activities\*\* to split students among several pool of activities while preserving consistency (eg. our example in Introduction: we had one Random activity "Documentation for exercise 1" and one Random activity "Exercise 1", both with the same seed to ensure a student will always get the correct documentation for his exercise).
\* This is only true if the activities pool has the same size (an activities pool of a different size with the same seed will lead to a different distribution).
\*\* This will only work for Random activities with the same seed and the same number of activities in their pools.
### Activities pool / seed changes consequences
The Random activity acts as a redirection on students side. Please be aware that if you change a seed or the activities pool *after* students have accessed it may lead to students being assigned to a new activity, thus leading to them losing some of their work / grades.
## Grades
Random activities support grades. If a Random activity is graded, the grades are automatically retrieved from the activities the students are assigned to.
To make a graded assignment with a Random activity, a nice way to proceed is:
- Set up grading methods for every activity in the pool,
- Set up a grading method for the Random activity,
- Head to the gradebook and set the weights for activities in the pool to 0.
That way, only the Random activity grade will be accounted in the gradebook, and every student will have exactly one grade for the graded assignment.
## Future Developments
These features are not currently supported but will be added in future releases:
- Group support
- Activity addition by course section
- Due date, appearing in the calendar
- CSV export of student affectation on activities
\ No newline at end of file
......@@ -23,8 +23,8 @@
defined('MOODLE_INTERNAL') || die();
$plugin->version = 2020102601;
$plugin->version = 2020112600;
$plugin->requires = 2018112800;
$plugin->maturity = MATURITY_STABLE;
$plugin->release = '1.0';
$plugin->release = '1.1';
$plugin->component = 'mod_randomactivity';
\ No newline at end of file
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment