/[drupal]/contributions/modules/gradebook/README.txt
ViewVC logotype

Diff of /contributions/modules/gradebook/README.txt

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph | View Patch Patch

revision 1.1.2.1.2.1, Thu Jan 8 23:37:02 2009 UTC revision 1.1.2.1.2.2, Sun Feb 1 05:11:47 2009 UTC
# Line 16  define gradebook categories (taxonomy te Line 16  define gradebook categories (taxonomy te
16  Gradebook assignments can be created using one or more content types. Custom content  Gradebook assignments can be created using one or more content types. Custom content
17  types using CCK, or types supplied by other modules (such as Webform and others) that  types using CCK, or types supplied by other modules (such as Webform and others) that
18  will only be used as gradebook assignments are good choices. Additional fields are added  will only be used as gradebook assignments are good choices. Additional fields are added
19  to assignment content types to allow the teacher to select the gradebook category and  to assignment content types to allow the teacher to select the gradebook category,
20  possible number of points for the assignment. Gradebook provides a gradebook page that  the possible number of points for the assignment, the due date for the assignment, and
21    the date to publish the assignment. Gradebook provides a gradebook page that
22  lists all assignments that have been published, and tabulates grades by student. Teachers  lists all assignments that have been published, and tabulates grades by student. Teachers
23  enter grades into the gradebook by clicking on cells within this table. This brings up an  enter grades into the gradebook by clicking on cells within this table. This brings up an
24  add grade form that also allows the teachers to leave a text note for the student, or exempt  add grade form that also allows the teachers to leave a text note, attach one or more files
25    (a critiqued paper, or graded assignment to be returned to the student), or exempt
26  a student from an assignment. The assignment titles in the gradebook page are linked to  a student from an assignment. The assignment titles in the gradebook page are linked to
27  the assignment node, so by clicking on the title, students and teachers can view the  the assignment node, so by clicking on the title, students and teachers can view the
28  assignments.  Students are also able to access the gradebook page, where they can view  assignments.  Students are also able to access the gradebook page where they can view
29  (but not edit!) their own grades and the notes left by their teachers.  (but not edit!) their own grades, notes left by their teachers, and download any attached
30    files. There is also an option to allow students to attach their own files (assignments to
31    be graded, responses to grading, revisions). Finally, each gradebook can be exported and
32    saved to a text or spreadsheet file.
33    
34  This module is under active development, so feature requests are still possible and would be  This module is under active development, so feature requests are still possible and would be
35  appreciated.  appreciated.
# Line 56  gradebook administrator can take over, i Line 61  gradebook administrator can take over, i
61     and students who will be using the gradebook. This is done through the Drupal     and students who will be using the gradebook. This is done through the Drupal
62     administration menu (User Management >> Roles)     administration menu (User Management >> Roles)
63    
64     a. The Gradebook module provides 'admin gradebook' permissions. This permission is     a. The Gradebook module provides 'admin gradebook', 'access gradebook', and 'attach files
65          to gradebook'  permissions. The 'admin gradebook' permission is
66        necessary to allow a user to add, edit, and view gradebooks from the administration        necessary to allow a user to add, edit, and view gradebooks from the administration
67        page (admin/gradebook/gradebook). Its also needed for assigning gradebook students        page (admin/gradebook/gradebook). Its also needed for assigning gradebook students
68        and teachers to the available Drupal roles, as well as for general gradebook settings.        and teachers to the available Drupal roles, as well as for general gradebook settings.
69          'access gradebook' is needed to allow any user to view the gradebook. This can be used
70          to keep the gradebook hidden from anonymous, for example.  Finally, the 'attach files...'
71          permission allows specific Drupal roles permission to attach files, whether they are
72          teachers, administrators, students or whatever you like. Note that for teachers and
73          students, its more convenient to grant this permission from the Gradebook Settings page
74          at Administer >> Gradebook >> Gradebooks >> Settings  (admin/gradebook/gradebook/settings).
75    
76     b. The Gradebook API modeule provides 'admin gradebook api' permissions. This permissions     b. The Gradebook API modeule provides 'admin gradebook api' permissions. This permissions
77        allows the user to configure the gradebook module, determining what content types are        allows the user to configure the gradebook module, determining what content types are
# Line 72  gradebook administrator can take over, i Line 84  gradebook administrator can take over, i
84            3. Node Module:   create assignment content types            3. Node Module:   create assignment content types
85            4. 'admin gradebook'            4. 'admin gradebook'
86        ii. Teachers:        ii. Teachers:
87            1. Create and access content . at least the assignment types            1. 'create ...' - at least the assignment types.
88            2. The module will permit them to set up, modify, and add to gradebooks created by            2. 'access gradebook'
89               the Gradebook administrator.            3. The module will permit them to set up, modify, and add to gradebooks created by
90                 the Gradebook administrator according to their role.
91       iii. Students:       iii. Students:
92            1. No additional permissions needed            1. 'access gradebook'
93            2. The module will make sure they can only see their own grades.            2. The module will make sure they can only see their own grades and files intended for them.
94      d. As usual, the system administrator with User Id = 1 can do anything  
95       d. As usual, the system administrator with User Id = 1 can do anything
96  2. Go to Gradebook >> Settings and check the roles that will be used for Teachers and  
97     Students. On the same page you can designate the text to be used for an ungraded assignment  2. Go to Administer >> Gradebook >> Gradebooks >> Settings  (admin/gradebook/gradebook/settings) and check
98    (default is --), as well as the number of gradebooks to display on the page (default is 25).     the roles that will be used for Teachers and Students. You can also designate general gradebook
99       settings, including permissions for students and teachers to attach files to grades, the text to be
100       used for an ungraded assignment (default is --), as well as the number of gradebooks to display on
101       the gradebook list page (default is 25), and the number of grades to display on the gradebook page.
102    
103  3. If you haven't already set up a new content type for assignments, you probably will want  3. If you haven't already set up a new content type for assignments, you probably will want
104     to do that next. The Gradebook module will add two fields to these assignment pages (One     to do that next. The Gradebook module will add two fields to these assignment pages (One
# Line 97  gradebook administrator can take over, i Line 113  gradebook administrator can take over, i
113     assignments. Checking these boxes will enable the form elements described in 1 on these     assignments. Checking these boxes will enable the form elements described in 1 on these
114     assignments, so only select assignment content types.     assignments, so only select assignment content types.
115    
116    5. On the same page, choose an appropriate default time between creation of assignment node and
117       due date. The actual due date will be selected on the assignment form, but its easier to work
118       with if the select form starts at a reasonable date.
119    
120  III.  Usage (for students and teachers)  III.  Usage (for students and teachers)
121  ----------------  ----------------
122    
# Line 114  III. Usage (for students and teachers) Line 134  III. Usage (for students and teachers)
134           another (so Quiz >> type1,  Quiz >> type2, etc.  are possible).           another (so Quiz >> type1,  Quiz >> type2, etc.  are possible).
135     b. View individual assignments by clicking on the assignment name     b. View individual assignments by clicking on the assignment name
136     c. Edit a student's grades (by clicking on the 'ungraded' text (--) in the grade list.     c. Edit a student's grades (by clicking on the 'ungraded' text (--) in the grade list.
137        [Note that sometimes it's not clear that this is a link.]        [Note that, depending on your theme, sometimes it's hard to tell that this is a link.]
138        ii. Assign a value for the student's score        ii. Assign a value for the student's score
139        iii. Add a note that the student will be able to see when viewing their grades        iii. Add a note that the student will be able to see when viewing their grades
140        iv. Exempt a student from the assignment, by checking the box. When this box is checked,        iv. Exempt a student from the assignment, by checking the box. When this box is checked,
141            the scores for the assignment are not used to calculate the student's grade.            the scores for the assignment are not used to calculate the student's grade.
142  4. If as student clicks on their grade, they are brought to a grade summary page, which         v. Attach a file for the student to view.
143     includes the assignment data as well as any note entered by the teacher. There is a link        vi. Click 'Save All' to save the grade and return to the gradebook page.
144     at the bottom of this page to bring the student back to the gradebook.  4. If a student clicks on their grade, they are brought to a grade summary page, which
145       includes the assignment data as well as the note and linked files, provided by the teacher.
146       With proper permission, students will also be able to attach files to their grade. A button
147       at the bottom of this page brings the student back to the gradebook.
148    
149    5. The teacher will also see [edit-all] in the table header under each assignment. This link brings
150       up a grade entry form listing each student's grade data for the assignment. To attach a file to
151       one of the grades, first select the grade by clicking on the radio button in the left column.
152       Note that if there is only one student, radio buttons will not appear. Then, browse to find the
153       file and finally press the attach button to add the file to the grade record. Changes will not
154       be committed until the 'Save All' button is pressed. A button is also provided to return to the
155       gradebook page without saving.
156    
157    6. The teacher can also view or edit all grade information for a particular student by clicking on
158       the student's name.  This link brings up a grade entry form like that discussed in 5. Follow the
159       same procedures to update all grade data for the student.
160    
161  IV. Developer notes  IV. Developer notes
162  -----------------------  -----------------------
# Line 131  IV. Developer notes Line 166  IV. Developer notes
166  3. Discussion and Development on Drupal Groups at http://groups.drupal.org/soc-gradebook  3. Discussion and Development on Drupal Groups at http://groups.drupal.org/soc-gradebook
167  4. Drupal in Education on Drupal Groups at http://groups.drupal.org/drupal-education  4. Drupal in Education on Drupal Groups at http://groups.drupal.org/drupal-education
168  5. Drupal in Education discussion of Gradebook at http://groups.drupal.org/node/6447  5. Drupal in Education discussion of Gradebook at http://groups.drupal.org/node/6447
169  6. Others?  6. The gradebook display can be modified from gradebook.css.
170    
171  V.  Authors  V.  Authors
172  --------------  --------------
Legend:
Removed from v.1.1.2.1.2.1  
changed lines
  Added in v.1.1.2.1.2.2
  ViewVC Help
Powered by ViewVC 1.1.2