summaryrefslogtreecommitdiff
path: root/yaksh/documentation/moderator_docs/creating_quiz.rst
blob: 3968a648e015d0aaad1bd1eab377d2391a650020 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
.. _creating_quiz:

=======
Quizzes
=======

Quizzes are intrinsically associated with a course, hence to view and/or edit a quiz, we need to navigate to the courses page.

Clicking on Add/View Quizzes from courses page will open the page as shown below

.. image:: ../images/view_quizzes.jpg

This page shows all the quizzes and exercise created.

Creating a Quiz
---------------	

	Click on **Add New Quiz** button to add a quiz.

	.. image:: ../images/add_quiz.jpg
	
	.. note :: It is important to have created or uploaded questions before creating a quiz. 

	* **Start Date and Time of quiz** - The date and time after which the quiz can be taken.
	* **End Date and Time of quiz** - The date and time after which the quiz is deactivated and cannot be attempted.
	* **Duration** - Duration of quiz to be written in minutes.
	* **Active** - Check the checkbox to activate/deactivate quiz.
	* **Description** - Description or name of the quiz.
	* **Passing Percentage** - Minimum percentage required to pass the test.
	* **Attempts allowed** - Number of attempts that a student can take of the current quiz.
	* **Time Between Quiz Attempts in hours** - For a quiz with multiple attempts this value can be set so that student can attempt again after the specified time.
	* **Instructions for students** - Additional instructions for students can be added. Some default instructions are already provided.
	* **Allow student to view answer paper** - Click on this checkbox to allow student to view their answer paper.
	* **Allow student to skip questions** - Click on this checkbox to allow/disallow student to skip questions for a quiz. Value defaults to allow skipping questions.
	* **Weightage** - Every quiz will have weightage depending on which grades will be calculated.

	Once a quiz parameters have been set click on **Save** button to save the quiz.

To create a Question paper, Click on **Add** link located besides the created quiz.

Creating a Exercise
-------------------	

	Click on **Add New Exercise** button to add a exercise.

	.. image:: ../images/add_exercise.jpg

	Exercise is similar to quiz with a difference that exercise has infinite attempts and 
	infinite time. It also does not allow a student to skip the question.
	Each question in an exercise can be timed i.e. time to solve a particular question.
	Once the question time expires question solution is shown to the student.

	All the parameters are set by default only below parameters can be changed.

	* **Description** - Description or name of the exercise.
	* **Allow student to view answer paper** - Click on this checkbox to allow student to view their answer paper.
	* **Active** - Select the checkbox to activate/deactivate exercise. Default value is active.


Designing Question Paper
------------------------

	.. image:: ../images/design_questionpaper.jpg

	A quiz/exercise can have fixed as well as random questions. Fixed questions are those question that are bound to appear for every student taking the quiz. In random questions a pool of questions is given and number of questions to be picked from the pool is set. Hence for different students, different questions from the pool will appear.

	To add questions to a questionpaper

	* Select Question type and marks and a list of questions will be displayed will be in the **select questions to add** section. Do this for both fixed questions and random questions.
	* After adding questions click on **Next** button to go to **Step 3 Finish**.
	* Select shuffle paper if you want to jumble up the question sequence for every student and for every attempt.
	* Click on save question paper to save it or preview question paper to preview it.


Editing a Quiz/Exercise
-----------------------

	Click on the quiz/exercise link to edit, change the parameters and click on Save.


Editing a QuestionPaper
-----------------------


	Click on the Question Paper for a <Quiz-name/Exercise-name> besides Quiz/Exercise and follow steps from Design Question Paper.

	If the questions are already added to a Question Paper then they are shown in the 
	**Fixed Questions currently in the paper** section.