modules/quiz/INSTALL.txt

$Id: INSTALL.txt,v 1.15 2009/08/13 16:37:12 sivaji Exp $

Installation
------------

1. Copy the entire quiz/ folder into your modules directory.

2. Log in to your site as an administrator, and go to the Administer >> Site building >> Modules
   section. Enable both the Quiz module and at least one question type module
   (for example, Multichoice).

3. You can optionally install quiz views module for an enhanced UI

   **NOTE: The permissions for views are handled seperately, each view must be configured for the
   appropriate level of permission. 


Configuration
-------------

1. Create a user role with "create quiz" and "administer <question_type>"
   permissions. The role can be created under Administer >> User management >> Roles and the rights can be assigned to the role under Administer >> User management >> Access control.
   Assigning users to this role allows users other than the administrator to 
   create questions and quizzes.
   
2. Add the "access quiz" permission to roles under Administer >> User management >> Access control that should be allowed to take the quizzes.


How to create a quiz
--------------------

1. Begin by creating a series of questions that you would like to include in 
   the quiz. Go to Create content >> <question type> (for example, Multichoice).
   
2. Next, create a basic quiz by going to Create content >> Quiz. You will have 
   the opportunity to set numerous options such as the number of questions, 
   whether or not to shuffle question order, etc. When finished, click "Submit."
   
3. Finally, add questions to the quiz by clicking the "Manage questions" tab. 


FAQ
---
Q. I'm getting tons of errors when I try and install this module! Why?
A. Make sure you've installed this module with PHP 5.x and Drupal 6.x. 

1	$Id: INSTALL.txt,v 1.15 2009/08/13 16:37:12 sivaji Exp $
2
3	Installation
4	------------
5
6	1. Copy the entire quiz/ folder into your modules directory.
7
8	2. Log in to your site as an administrator, and go to the Administer >> Site building >> Modules
9	section. Enable both the Quiz module and at least one question type module
10	(for example, Multichoice).
11
12	3. You can optionally install quiz views module for an enhanced UI
13
14	**NOTE: The permissions for views are handled seperately, each view must be configured for the
15	appropriate level of permission.
16
17
18	Configuration
19	-------------
20
21	1. Create a user role with "create quiz" and "administer <question_type>"
22	permissions. The role can be created under Administer >> User management >> Roles and the rights can be assigned to the role under Administer >> User management >> Access control.
23	Assigning users to this role allows users other than the administrator to
24	create questions and quizzes.
25
26	2. Add the "access quiz" permission to roles under Administer >> User management >> Access control that should be allowed to take the quizzes.
27
28
29	How to create a quiz
30	--------------------
31
32	1. Begin by creating a series of questions that you would like to include in
33	the quiz. Go to Create content >> <question type> (for example, Multichoice).
34
35	2. Next, create a basic quiz by going to Create content >> Quiz. You will have
36	the opportunity to set numerous options such as the number of questions,
37	whether or not to shuffle question order, etc. When finished, click "Submit."
38
39	3. Finally, add questions to the quiz by clicking the "Manage questions" tab.
40
41
42	FAQ
43	---
44	Q. I'm getting tons of errors when I try and install this module! Why?
45	A. Make sure you've installed this module with PHP 5.x and Drupal 6.x.
46