Annotation of loncom/interface/lonquickgrades.pm, revision 1.64
1.1 bowersj2 1: # The LearningOnline Network with CAPA
2: # Quick Student Grades Display
3: #
1.64 ! www 4: # $Id: lonquickgrades.pm,v 1.63 2011/01/17 00:19:38 www Exp $
1.1 bowersj2 5: #
6: # Copyright Michigan State University Board of Trustees
7: #
8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
9: #
10: # LON-CAPA is free software; you can redistribute it and/or modify
11: # it under the terms of the GNU General Public License as published by
12: # the Free Software Foundation; either version 2 of the License, or
13: # (at your option) any later version.
14: #
15: # LON-CAPA is distributed in the hope that it will be useful,
16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18: # GNU General Public License for more details.
19: #
20: # You should have received a copy of the GNU General Public License
21: # along with LON-CAPA; if not, write to the Free Software
22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23: #
24: # /home/httpd/html/adm/gpl.txt
25: #
26: # http://www.lon-capa.org/
27: #
28:
29: package Apache::lonquickgrades;
30:
31: use strict;
32: use Apache::Constants qw(:common :http);
1.5 bowersj2 33: use POSIX;
1.25 www 34: use Apache::loncommon;
35: use Apache::lonlocal;
1.36 albertel 36: use Apache::lonnet;
1.38 bowersj2 37: use Apache::grades;
1.1 bowersj2 38:
39: sub handler {
40: my $r = shift;
1.5 bowersj2 41: return real_handler($r);
42: }
43:
44: sub real_handler {
45: my $r = shift;
1.1 bowersj2 46:
47: &Apache::loncommon::get_unprocessed_cgi($ENV{QUERY_STRING});
48:
49: # Handle header-only request
1.40 albertel 50: if ($env{'browser.mathml'}) {
51: &Apache::loncommon::content_type($r,'text/xml');
52: } else {
53: &Apache::loncommon::content_type($r,'text/html');
54: }
1.1 bowersj2 55: if ($r->header_only) {
1.40 albertel 56: $r->send_http_header;
1.1 bowersj2 57: return OK;
58: }
59:
60: # Send header, don't cache this page
61: &Apache::loncommon::no_cache($r);
62: $r->send_http_header;
63:
1.55 www 64: my $showPoints =
1.36 albertel 65: $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'standard';
1.55 www 66: my $notshowSPRSlink =
1.49 www 67: (($env{'course.'.$env{'request.course.id'}.'.grading'} eq 'external')
68: || ($env{'course.'.$env{'request.course.id'}.'.grading'} eq 'externalnototals'));
69: my $notshowTotals=
70: $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'externalnototals';
1.50 www 71: my $showCategories=
72: $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'categories';
73:
1.17 bowersj2 74:
1.47 schafran 75: my $title = "Grading and Statistics";#$showPoints ? "Points Display" : "Completed Problems Display";
1.46 raeburn 76: my $brcrum = [{href=>"/adm/quickgrades",text => "Points Display"}];
77: $r->print(&Apache::loncommon::start_page($title,undef,
78: {'bread_crumbs' => $brcrum})
79: );
1.1 bowersj2 80:
1.55 www 81: &startGradeScreen($r,'quick');
1.17 bowersj2 82:
83: $r->rflush();
1.53 www 84:
1.54 www 85: # my $uname='korte';
86: # my $udom='gerd';
87:
88: my $uname;
89: my $udom;
1.53 www 90:
91: my ($navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted)=
92: &getData($showPoints,$uname,$udom);
93:
94: if ($showCategories) {
95: &outputCategories($r,$showPoints,$notshowTotals,
96: $navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted);
97: } else {
98: &outputTable($r,$showPoints,$notshowTotals,
1.51 www 99: $navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted);
1.53 www 100: }
1.55 www 101: &endGradeScreen($r);
1.51 www 102: return OK;
103:
104: }
1.2 bowersj2 105:
1.55 www 106: sub startGradeScreen {
107: my ($r,$mode)=@_;
108:
109: my $showPoints =
110: $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'standard';
111: my $notshowSPRSlink =
112: (($env{'course.'.$env{'request.course.id'}.'.grading'} eq 'external')
113: || ($env{'course.'.$env{'request.course.id'}.'.grading'} eq 'externalnototals')
114: || ($env{'course.'.$env{'request.course.id'}.'.grading'} eq 'categories'));
115: my $notshowTotals=
116: $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'externalnototals';
117: my $showCategories=
118: $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'categories';
119:
120: my $allowed_to_view = &Apache::lonnet::allowed('vgr',$env{'request.course.id'});
121: my $allowed_to_edit = &Apache::lonnet::allowed('mgr',$env{'request.course.id'});
122:
123: if ($allowed_to_view) {
1.61 raeburn 124: my @notes;
125: push(@notes,&mt('Students do not see total points.')) if ($notshowTotals);
126: push(@notes,&mt('Students do not see link to spreadsheet.')) if ($notshowSPRSlink);
127: push(@notes,&mt('Students will see points based on problem weights.')) if ($showPoints);
128: push(@notes,&mt('Students will see points based on categories.')) if ($showCategories);
129: push(@notes, &Apache::lonhtmlcommon::coursepreflink(&mt('Grade display settings'),'grading'));
130: $r->print(&Apache::loncommon::head_subbox(join(' ',@notes)));
1.55 www 131: }
132:
133:
1.56 www 134: $r->print("\n".'<ul class="LC_TabContentBigger" id="main">');
1.57 www 135: $r->print("\n".'<li'.($mode eq 'quick'?' class="active"':'').'><a href="/adm/quickgrades"><b> '.
1.62 www 136: ($showPoints?&mt('Individual Points Overview'):($showCategories?&mt('Grades Overview'):&mt('Completion Overview'))).
1.57 www 137: ' </b></a></li>');
1.55 www 138:
139: if (!($showPoints || $notshowSPRSlink) || ($allowed_to_view)) {
1.56 www 140: $r->print("\n".'<li'.($mode eq 'spreadsheet'?' class="active"':'').'><a href="/adm/'.($allowed_to_view?'classcalc':'studentcalc').'"><b>'.
1.57 www 141: &mt('Spreadsheet (Detailed)').'</b></a></li>');
1.55 www 142: }
1.58 www 143: if ($allowed_to_view) {
1.63 www 144: $r->print("\n".'<li'.($mode eq 'statistics'?' class="active"':'').'><a href="/adm/statistics"><b>'.
145: &mt('Statistics and Reports').'</b></a></li>');
146:
1.58 www 147: $r->print("\n".'<li'.($mode eq 'chart'?' class="active"':'').'><a href="/adm/statistics?reportSelected=student_assessment"><b>'.
148: &mt('Assessment Overview Chart').'</b></a></li>');
149:
150: }
1.59 www 151: if ($allowed_to_edit) {
152: $r->print("\n".'<li'.($mode eq 'grading'?' class="active"':'').'><a href="/adm/grades"><b> '.
153: &mt('Problem Grading').' </b></a></li>');
154: }
1.56 www 155: $r->print("\n".'</ul>'."\n");
1.55 www 156: $r->print('<div class="LC_Box" style="clear:both;margin:0;"><div id="maincoursedoc" style="margin:0 0;padding:0 0;"><div class="LC_ContentBox" id="mainCourseDocuments" style="display: block;">');
157: }
158:
159: sub endGradeScreen {
160: my ($r)=@_;
161: $r->print('</div></div></div>');
162: }
163:
164:
1.51 www 165: sub getData {
166:
1.53 www 167: my ($showPoints,$uname,$udom)=@_;
168:
169: &Apache::lonnet::logthis("About to call with $uname $udom");
1.51 www 170:
171: # Create the nav map
1.53 www 172: my $navmap = Apache::lonnavmaps::navmap->new($uname,$udom);
1.51 www 173:
174: my $res = $navmap->firstResource(); # temp resource to access constants
1.1 bowersj2 175:
176: my $iterator = $navmap->getIterator(undef, undef, undef, 1);
177: my $depth = 1;
178: $iterator->next(); # ignore first BEGIN_MAP
179: my $curRes = $iterator->next();
1.4 bowersj2 180:
1.5 bowersj2 181: # General overview of the following: Walk along the course resources.
182: # For every problem in the resource, tell its parent maps how many
183: # parts and how many parts correct it has. After that, each map will
184: # have a count of the total parts underneath it, correct and otherwise.
185: # After that, we will walk through the course again and read off
186: # maps in order, with their data.
187: # (If in the future people decide not to be cumulative, only add
188: # the counts to the parent map.)
1.17 bowersj2 189: # For convenience, "totalParts" is also "totalPoints" when we're looking
190: # at points; I can't come up with a variable name that makes sense
191: # equally for both cases.
1.5 bowersj2 192:
193: my $totalParts = 0; my $totalPossible = 0; my $totalRight = 0;
1.28 bowersj2 194: my $totalAttempted = 0;
1.14 bowersj2 195: my $now = time();
1.28 bowersj2 196: my $topLevelParts = 0; my $topLevelRight = 0; my $topLevelAttempted = 0;
1.5 bowersj2 197:
198: # Pre-run: Count parts correct
1.1 bowersj2 199: while ( $depth > 0 ) {
200: if ($curRes == $iterator->BEGIN_MAP()) {$depth++;}
201: if ($curRes == $iterator->END_MAP()) { $depth--; }
202:
1.7 bowersj2 203: if (ref($curRes) && $curRes->is_problem() && !$curRes->randomout)
1.5 bowersj2 204: {
205: # Get number of correct, incorrect parts
206: my $parts = $curRes->parts();
207: my $partsRight = 0;
1.17 bowersj2 208: my $partsCount = 0;
1.28 bowersj2 209: my $partsAttempted = 0;
1.5 bowersj2 210: my $stack = $iterator->getStack();
211:
212: for my $part (@{$parts}) {
1.28 bowersj2 213: my $completionStatus = $curRes->getCompletionStatus($part);
214: my $dateStatus = $curRes->getDateStatus($part);
215:
216: if ($completionStatus == $curRes->EXCUSED()) {
1.21 matthew 217: next;
218: }
1.17 bowersj2 219: if ($showPoints) {
1.28 bowersj2 220: my $score = 0;
221: # If we're not telling status and the answer date isn't passed yet,
222: # it's an "attempted" point
1.42 raeburn 223: if ((($curRes->problemstatus($part) eq 'no') ||
224: ($curRes->problemstatus($part) eq 'no_feedback_ever')) &&
1.28 bowersj2 225: ($dateStatus != $curRes->ANSWER_OPEN)) {
1.31 albertel 226: my $status = $curRes->simpleStatus($part);
227: if ($status == $curRes->ATTEMPTED) {
228: $partsAttempted += $curRes->weight($part);
229: $totalAttempted += $partsAttempted;
230: }
1.28 bowersj2 231: } else {
1.39 albertel 232: $score = &Apache::grades::compute_points($curRes->weight($part), $curRes->awarded($part));
1.28 bowersj2 233: }
1.17 bowersj2 234: $partsRight += $score;
235: $totalRight += $score;
1.19 bowersj2 236: $partsCount += $curRes->weight($part);
1.18 bowersj2 237:
1.17 bowersj2 238: if ($curRes->opendate($part) < $now) {
1.20 bowersj2 239: $totalPossible += $curRes->weight($part);
1.17 bowersj2 240: }
1.19 bowersj2 241: $totalParts += $curRes->weight($part);
1.17 bowersj2 242: } else {
1.27 bowersj2 243: my $status = $curRes->simpleStatus($part);
1.17 bowersj2 244: my $thisright = 0;
245: $partsCount++;
1.37 albertel 246: if ($status == $curRes->CORRECT ||
247: $status == $curRes->PARTIALLY_CORRECT ) {
1.17 bowersj2 248: $partsRight++;
249: $totalRight++;
250: $thisright = 1;
251: }
1.28 bowersj2 252:
253: if ($status == $curRes->ATTEMPTED) {
254: $partsAttempted++;
255: $totalAttempted++;
256: }
1.17 bowersj2 257:
258: my $dateStatus = $curRes->getDateStatus($part);
1.19 bowersj2 259: $totalParts++;
1.17 bowersj2 260: if ($curRes->opendate($part) < $now) {
261: $totalPossible++;
262: }
263: }
1.5 bowersj2 264: }
1.15 bowersj2 265:
266: if ($depth == 1) { # in top-level only
1.19 bowersj2 267: $topLevelParts += $partsCount;
1.15 bowersj2 268: $topLevelRight += $partsRight;
1.28 bowersj2 269: $topLevelAttempted += $partsAttempted;
1.15 bowersj2 270: }
271:
1.5 bowersj2 272: # Crawl down stack and record parts correct and total
273: for my $res (@{$stack}) {
274: if (ref($res) && $res->is_map()) {
275: if (!defined($res->{DATA}->{CHILD_PARTS})) {
276: $res->{DATA}->{CHILD_PARTS} = 0;
277: $res->{DATA}->{CHILD_CORRECT} = 0;
1.28 bowersj2 278: $res->{DATA}->{CHILD_ATTEMPTED} = 0;
1.5 bowersj2 279: }
280:
1.17 bowersj2 281: $res->{DATA}->{CHILD_PARTS} += $partsCount;
1.5 bowersj2 282: $res->{DATA}->{CHILD_CORRECT} += $partsRight;
1.28 bowersj2 283: $res->{DATA}->{CHILD_ATTEMPTED} += $partsAttempted;
1.5 bowersj2 284: }
285: }
286: }
287: $curRes = $iterator->next();
288: }
1.51 www 289: return ($navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted);
290: }
291:
292: #
293: # Outputting everything.
294: #
295:
296: sub outputTable {
1.5 bowersj2 297:
1.51 www 298: my ($r,$showPoints,$notshowTotals,
299: $navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted)=@_;
1.5 bowersj2 300:
1.7 bowersj2 301: my @start = (255, 255, 192);
1.5 bowersj2 302: my @end = (0, 192, 0);
303:
304: my $indentString = ' ';
305:
306: # Second pass: Print the maps.
1.43 bisitz 307: $r->print(&Apache::loncommon::start_data_table()
308: .&Apache::loncommon::start_data_table_header_row()
309: .'<th>'.&mt('Folder').'</th>');
1.51 www 310: my $title = &mt($showPoints ? "Points Scored" : "Done");
1.28 bowersj2 311: if ($totalAttempted) {
1.51 www 312: $title .= " / " . &mt("Attempted");
1.28 bowersj2 313: }
1.49 www 314: $r->print("<th>$title".($notshowTotals?'':" / ".&mt('Total')).'</th>'
1.43 bisitz 315: .&Apache::loncommon::end_data_table_header_row());
1.51 www 316: #
317: # Output of folder scores
318: #
319:
320: my $iterator = $navmap->getIterator(undef, undef, undef, 1);
321: my $depth = 1;
322: $iterator->next(); # ignore first BEGIN_MAP
323: my $curRes = $iterator->next();
324:
1.5 bowersj2 325: while ($depth > 0) {
326: if ($curRes == $iterator->BEGIN_MAP()) {$depth++;}
327: if ($curRes == $iterator->END_MAP()) { $depth--; }
328:
329: if (ref($curRes) && $curRes->is_map()) {
330: my $title = $curRes->compTitle();
331:
332: my $correct = $curRes->{DATA}->{CHILD_CORRECT};
333: my $total = $curRes->{DATA}->{CHILD_PARTS};
1.28 bowersj2 334: my $attempted = $curRes->{DATA}->{CHILD_ATTEMPTED};
1.5 bowersj2 335:
1.6 bowersj2 336: if ($total > 0) {
337: my $ratio;
338: $ratio = $correct / $total;
1.51 www 339: my $color = &mixColors(\@start, \@end, $ratio);
1.43 bisitz 340: $r->print(&Apache::loncommon::start_data_table_row()
341: .'<td style="background-color:'.$color.';">');
1.6 bowersj2 342:
1.15 bowersj2 343: my $thisIndent = '';
344: for (my $i = 1; $i < $depth; $i++) { $thisIndent .= $indentString; }
1.6 bowersj2 345:
1.15 bowersj2 346: $r->print("$thisIndent$title</td>");
1.28 bowersj2 347: if ($totalAttempted) {
1.45 bisitz 348: $r->print('<td valign="top">'
349: .$thisIndent
350: .'<span class="LC_nobreak">'
1.49 www 351: .$correct.' / '.$attempted.($notshowTotals?'':' / '.$total)
1.45 bisitz 352: .'</span></td>'
353: .&Apache::loncommon::end_data_table_row()
354: );
1.28 bowersj2 355: } else {
1.45 bisitz 356: $r->print('<td valign="top">'
357: .$thisIndent
358: .'<span class="LC_nobreak">'
1.49 www 359: .$correct.($notshowTotals?'':' / '.$total)
1.45 bisitz 360: .'</span></td>'
1.43 bisitz 361: .&Apache::loncommon::end_data_table_row());
1.28 bowersj2 362: }
1.6 bowersj2 363: }
1.5 bowersj2 364: }
1.4 bowersj2 365:
1.5 bowersj2 366: $curRes = $iterator->next();
367: }
1.4 bowersj2 368:
1.6 bowersj2 369: # If there were any problems at the top level, print an extra "catchall"
1.15 bowersj2 370: if ($topLevelParts > 0) {
371: my $ratio = $topLevelRight / $topLevelParts;
1.6 bowersj2 372: my $color = mixColors(\@start, \@end, $ratio);
1.43 bisitz 373: $r->print(&Apache::loncommon::start_data_table_row()
374: .'<td style="background-color:'.$color.';">');
1.25 www 375: $r->print(&mt("Problems Not Contained In A Folder")."</td><td>");
1.43 bisitz 376: $r->print("$topLevelRight / $topLevelParts</td>"
377: .&Apache::loncommon::end_data_table_row());
1.6 bowersj2 378: }
1.4 bowersj2 379:
1.51 www 380: #
381: # show totals (if applicable), close table
382: #
1.35 albertel 383: if ($showPoints) {
1.51 www 384: my $maxHelpLink = Apache::loncommon::help_open_topic("Quick_Grades_Possibly_Correct");
1.2 bowersj2 385:
1.51 www 386: $title = $showPoints ? "Points" : "Parts Done";
387: my $totaltitle = $showPoints ? &mt("Awarded Total Points") : &mt("Total Parts Done");
388: $r->print(&Apache::loncommon::start_data_table_row()
1.48 bisitz 389: .'<td colspan="2" align="right">'.$totaltitle.': <b>'.$totalRight.'</b><br />');
1.51 www 390: $r->print(&mt('Max Possible To Date')." $maxHelpLink: <b>$totalPossible</b><br />");
391: $title = $showPoints ? "Points" : "Parts";
392: $r->print(&mt("Total $title In Course").': <b>'.$totalParts.'</b></td>'
1.43 bisitz 393: .&Apache::loncommon::end_data_table_row());
1.34 www 394: }
1.1 bowersj2 395:
1.43 bisitz 396: $r->print(&Apache::loncommon::end_data_table()
397: .&Apache::loncommon::end_page());
1.1 bowersj2 398:
1.5 bowersj2 399: }
400:
1.53 www 401: #
402: # Outputting category-based grades.
403: #
404:
405: sub outputCategories {
406:
407: my ($r,$showPoints,$notshowTotals,
408: $navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted)=@_;
1.62 www 409: # Take care of storing and retrieving categories
410:
1.64 ! www 411: my $cangrade=&Apache::lonnet::allowed('mgr');
! 412:
1.62 www 413: my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
414: my $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
1.64 ! www 415: my %categories=();
! 416: # Storing
! 417: if (($cangrade) && ($env{'form.storechanges'})) {
1.62 www 418:
1.64 ! www 419: # Actually store
! 420: &Apache::lonnet::put('grading_categories',\%categories,$cdom,$cnum);
! 421: } else {
! 422: # Loading
! 423: %categories=&Apache::lonnet::dump('grading_categories',$cdom,$cnum);
! 424: }
1.62 www 425: # categories loaded now
1.64 ! www 426: # Form only generated if user can change the grading categories
! 427: if ($cangrade) {
! 428: $r->print('<form method="post">');
! 429: }
! 430: #
! 431: # Business logic here
! 432: #
! 433: if ($cangrade) {
! 434: $r->print('<input type="submit" name="storechanges" value="'.&mt("Save changes to grading categories").'" /></form>');
! 435: }
1.53 www 436: }
437:
1.5 bowersj2 438: # Pass this two refs to arrays for the start and end color, and a number
439: # from 0 to 1 for how much of the latter you want to mix in. It will
440: # return a string ready to show ("#FFC309");
1.51 www 441:
1.5 bowersj2 442: sub mixColors {
443: my $start = shift;
444: my $end = shift;
445: my $ratio = shift;
446:
1.9 matthew 447: my ($a,$b);
1.5 bowersj2 448: my $final = "";
1.9 matthew 449: $a = $start->[0]; $b = $end->[0];
1.5 bowersj2 450: my $mix1 = POSIX::floor((1-$ratio)*$a + $ratio*$b);
1.9 matthew 451: $a = $start->[1]; $b = $end->[1];
1.5 bowersj2 452: my $mix2 = POSIX::floor((1-$ratio)*$a + $ratio*$b);
1.9 matthew 453: $a = $start->[2]; $b = $end->[2];
1.5 bowersj2 454: my $mix3 = POSIX::floor((1-$ratio)*$a + $ratio*$b);
455:
1.16 bowersj2 456: $final = sprintf "%02x%02x%02x", $mix1, $mix2, $mix3;
1.5 bowersj2 457: return "#" . $final;
1.1 bowersj2 458: }
459:
460: 1;
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>