[BACK]Return to lonquickgrades.pm CVS log [TXT] [DIR] Up to [LON-CAPA] / loncom / interface
File:  [LON-CAPA] / loncom / interface / lonquickgrades.pm
Revision 1.70: download - view: text, annotated - select for diffs
Sun Feb 20 23:38:00 2011 UTC (13 years, 2 months ago) by www
Branches: MAIN
CVS tags: HEAD
Weight

# The LearningOnline Network with CAPA
# Quick Student Grades Display
#
# $Id: lonquickgrades.pm,v 1.70 2011/02/20 23:38:00 www Exp $
#
# Copyright Michigan State University Board of Trustees
#
# This file is part of the LearningOnline Network with CAPA (LON-CAPA).
#
# LON-CAPA is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# LON-CAPA is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with LON-CAPA; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
#
# /home/httpd/html/adm/gpl.txt
#
# http://www.lon-capa.org/
#

package Apache::lonquickgrades;

use strict;
use Apache::Constants qw(:common :http);
use POSIX;
use Apache::loncommon;
use Apache::lonlocal;
use Apache::lonnet;
use Apache::grades;

sub handler {
    my $r = shift;
    return real_handler($r);
}

sub real_handler {
    my $r = shift;

    &Apache::loncommon::get_unprocessed_cgi($ENV{QUERY_STRING});

    # Handle header-only request
    if ($env{'browser.mathml'}) {
	&Apache::loncommon::content_type($r,'text/xml');
    } else {
	&Apache::loncommon::content_type($r,'text/html');
    }
    if ($r->header_only) {
	$r->send_http_header;
        return OK;
    }

    # Send header, don't cache this page
    &Apache::loncommon::no_cache($r);
    $r->send_http_header;

    my $showPoints =
        $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'standard';
    my $notshowSPRSlink =
        (($env{'course.'.$env{'request.course.id'}.'.grading'} eq 'external')
      || ($env{'course.'.$env{'request.course.id'}.'.grading'} eq 'externalnototals'));
    my $notshowTotals=
        $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'externalnototals';
    my $showCategories=
        $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'categories';


    my $title = "Grading and Statistics";#$showPoints ? "Points Display" : "Completed Problems Display";
    my $brcrum = [{href=>"/adm/quickgrades",text => "Points Display"}];
    $r->print(&Apache::loncommon::start_page($title,undef,
                                            {'bread_crumbs' => $brcrum})
             );

    &startGradeScreen($r,'quick');

    $r->rflush();

#    my $uname='korte';
#    my $udom='gerd';

    my $uname;
    my $udom;

    my ($navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted)=
       &getData($showPoints,$uname,$udom);

    if ($showCategories) {
       &outputCategories($r,$showPoints,$notshowTotals,
                 $navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted);
    } else {
       &outputTable($r,$showPoints,$notshowTotals,
                 $navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted);
    }
    &endGradeScreen($r);
    return OK;

}

sub startGradeScreen {
    my ($r,$mode)=@_;

    my $showPoints =
        $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'standard';
    my $notshowSPRSlink =
        (($env{'course.'.$env{'request.course.id'}.'.grading'} eq 'external')
      || ($env{'course.'.$env{'request.course.id'}.'.grading'} eq 'externalnototals')
      || ($env{'course.'.$env{'request.course.id'}.'.grading'} eq 'categories'));
    my $notshowTotals=
        $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'externalnototals';
    my $showCategories=
        $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'categories';

    my $allowed_to_view =  &Apache::lonnet::allowed('vgr',$env{'request.course.id'});
    my $allowed_to_edit =  &Apache::lonnet::allowed('mgr',$env{'request.course.id'});

    if ($allowed_to_view) {
       my @notes;
       push(@notes,&mt('Students do not see total points.')) if ($notshowTotals);
       push(@notes,&mt('Students do not see link to spreadsheet.')) if ($notshowSPRSlink);
       push(@notes,&mt('Students will see points based on problem weights.')) if ($showPoints);
       push(@notes,&mt('Students will see points based on categories.')) if ($showCategories);
       push(@notes, &Apache::lonhtmlcommon::coursepreflink(&mt('Grade display settings'),'grading'));
       $r->print(&Apache::loncommon::head_subbox(join('  ',@notes)));
    }


    $r->print("\n".'<ul class="LC_TabContentBigger" id="main">');
    $r->print("\n".'<li'.($mode eq 'quick'?' class="active"':'').'><a href="/adm/quickgrades"><b>&nbsp;&nbsp;&nbsp;&nbsp;'.
                                          ($showPoints?&mt('Individual Points Overview'):($showCategories?&mt('Grades Overview'):&mt('Completion Overview'))).
                                          '&nbsp;&nbsp;&nbsp;&nbsp;</b></a></li>');

    if (!($showPoints || $notshowSPRSlink) || ($allowed_to_view)) {
       $r->print("\n".'<li'.($mode eq 'spreadsheet'?' class="active"':'').'><a href="/adm/'.($allowed_to_view?'classcalc':'studentcalc').'"><b>'.
                                                                 &mt('Spreadsheet (Detailed)').'</b></a></li>');
    }
    if ($allowed_to_view) {
       $r->print("\n".'<li'.($mode eq 'statistics'?' class="active"':'').'><a href="/adm/statistics"><b>'.
                                                                 &mt('Statistics and Reports').'</b></a></li>');

       $r->print("\n".'<li'.($mode eq 'chart'?' class="active"':'').'><a href="/adm/statistics?reportSelected=student_assessment"><b>'.
                                                                 &mt('Assessment Overview Chart').'</b></a></li>');

    }
    if ($allowed_to_edit) {
       $r->print("\n".'<li'.($mode eq 'grading'?' class="active"':'').'><a href="/adm/grades"><b>&nbsp;&nbsp;&nbsp;&nbsp;'.
                                                                 &mt('Content Grading').'&nbsp;&nbsp;&nbsp;&nbsp;</b></a></li>');
       if ($env{'form.symb'}) {
          $r->print("\n".'<li'.($mode eq 'probgrading'?' class="active"':'').'><a href="/adm/grades?symb='.
                                              &Apache::lonhtmlcommon::entity_encode($env{'form.symb'}).
                                              '&command=gradingmenu"><b>&nbsp;&nbsp;&nbsp;&nbsp;'.
                                              &mt('Problem Grading').'&nbsp;&nbsp;&nbsp;&nbsp;</b></a></li>');

       }
    }
    $r->print("\n".'</ul>'."\n");
    $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;">');
}

sub endGradeScreen {
   my ($r)=@_;
   $r->print('</div></div></div>');
}


sub getData {

    my ($showPoints,$uname,$udom)=@_;

    # Create the nav map
    my $navmap = Apache::lonnavmaps::navmap->new($uname,$udom);

    my $res = $navmap->firstResource(); # temp resource to access constants

    my $iterator = $navmap->getIterator(undef, undef, undef, 1);
    my $depth = 1;
    $iterator->next(); # ignore first BEGIN_MAP
    my $curRes = $iterator->next();
    
    # General overview of the following: Walk along the course resources.
    # For every problem in the resource, tell its parent maps how many
    # parts and how many parts correct it has. After that, each map will
    # have a count of the total parts underneath it, correct and otherwise.
    # After that, we will walk through the course again and read off
    # maps in order, with their data. 
    # (If in the future people decide not to be cumulative, only add
    #  the counts to the parent map.)
    # For convenience, "totalParts" is also "totalPoints" when we're looking
    #  at points; I can't come up with a variable name that makes sense
    #  equally for both cases.

    my $totalParts = 0; my $totalPossible = 0; my $totalRight = 0;
    my $totalAttempted = 0;
    my $now = time();
    my $topLevelParts = 0; my $topLevelRight = 0; my $topLevelAttempted = 0;

    # Pre-run: Count parts correct
    while ( $depth > 0 ) {
        if ($curRes == $iterator->BEGIN_MAP()) {$depth++;}
        if ($curRes == $iterator->END_MAP()) { $depth--; }

        if (ref($curRes) && $curRes->is_problem() && !$curRes->randomout)
        {
            # Get number of correct, incorrect parts
            my $parts = $curRes->parts();
            my $partsRight = 0;
	    my $partsCount = 0;
	    my $partsAttempted = 0;
            my $stack = $iterator->getStack();
            
            for my $part (@{$parts}) {
		my $completionStatus = $curRes->getCompletionStatus($part);
		my $dateStatus = $curRes->getDateStatus($part);
		
                if ($completionStatus == $curRes->EXCUSED()) {
                    next;
                }
		if ($showPoints) {
		    my $score = 0;
		    # If we're not telling status and the answer date isn't passed yet, 
		    # it's an "attempted" point
		    if ((($curRes->problemstatus($part) eq 'no') ||
                        ($curRes->problemstatus($part) eq 'no_feedback_ever')) &&
			($dateStatus != $curRes->ANSWER_OPEN)) {
			my $status = $curRes->simpleStatus($part);
			if ($status == $curRes->ATTEMPTED) {
			    $partsAttempted += $curRes->weight($part);
			    $totalAttempted += $partsAttempted;
			}
		    } else {
			$score = &Apache::grades::compute_points($curRes->weight($part), $curRes->awarded($part));
		    }
		    $partsRight += $score;
		    $totalRight += $score;
		    $partsCount += $curRes->weight($part);

		    if ($curRes->opendate($part) < $now) {
			$totalPossible += $curRes->weight($part);
		    }
		    $totalParts += $curRes->weight($part);
		} else {
		    my $status = $curRes->simpleStatus($part);
		    my $thisright = 0;
		    $partsCount++;
		    if ($status == $curRes->CORRECT ||
			$status == $curRes->PARTIALLY_CORRECT ) {
			$partsRight++;
			$totalRight++;
			$thisright = 1;
		    }

		    if ($status == $curRes->ATTEMPTED) {
			$partsAttempted++;
			$totalAttempted++;
		    }
		    
		    my $dateStatus = $curRes->getDateStatus($part);
		    $totalParts++;
		    if ($curRes->opendate($part) < $now) {
			$totalPossible++;
		    }
		}
            }

            if ($depth == 1) { # in top-level only
		$topLevelParts += $partsCount;
		$topLevelRight += $partsRight;
		$topLevelAttempted += $partsAttempted;
	    }

            # Crawl down stack and record parts correct and total
            for my $res (@{$stack}) {
                if (ref($res) && $res->is_map()) {
                    if (!defined($res->{DATA}->{CHILD_PARTS})) {
                        $res->{DATA}->{CHILD_PARTS} = 0;
                        $res->{DATA}->{CHILD_CORRECT} = 0;
			$res->{DATA}->{CHILD_ATTEMPTED} = 0;
                    }
                    
                    $res->{DATA}->{CHILD_PARTS} += $partsCount;
                    $res->{DATA}->{CHILD_CORRECT} += $partsRight;
		    $res->{DATA}->{CHILD_ATTEMPTED} += $partsAttempted;
                }
            }
        }
        $curRes = $iterator->next();
    }
    return ($navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted);
}

#
# Outputting everything.
#

sub outputTable {

    my ($r,$showPoints,$notshowTotals,
           $navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted)=@_;

    my @start = (255, 255, 192);
    my @end   = (0, 192, 0);

    my $indentString = '&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;';

    # Second pass: Print the maps.
    $r->print(&Apache::loncommon::start_data_table()
             .&Apache::loncommon::start_data_table_header_row()
             .'<th>'.&mt('Folder').'</th>');
    my $title = &mt($showPoints ? "Points Scored" : "Done");
    if ($totalAttempted) {
        $title .= " / " . &mt("Attempted");
    }
    $r->print("<th>$title".($notshowTotals?'':" / ".&mt('Total')).'</th>'
             .&Apache::loncommon::end_data_table_header_row());
#
# Output of folder scores
#

    my $iterator = $navmap->getIterator(undef, undef, undef, 1);
    my $depth = 1;
    $iterator->next(); # ignore first BEGIN_MAP
    my $curRes = $iterator->next();

    while ($depth > 0) {
        if ($curRes == $iterator->BEGIN_MAP()) {$depth++;}
        if ($curRes == $iterator->END_MAP()) { $depth--; }

        if (ref($curRes) && $curRes->is_map()) {
            my $title = $curRes->compTitle();
            
            my $correct = $curRes->{DATA}->{CHILD_CORRECT};
            my $total = $curRes->{DATA}->{CHILD_PARTS};
	    my $attempted = $curRes->{DATA}->{CHILD_ATTEMPTED};

            if ($total > 0) {
                my $ratio;
                $ratio = $correct / $total;
                my $color = &mixColors(\@start, \@end, $ratio);
                $r->print(&Apache::loncommon::start_data_table_row()
                         .'<td style="background-color:'.$color.';">');
                
		my $thisIndent = '';
                for (my $i = 1; $i < $depth; $i++) { $thisIndent .= $indentString; }
                
                $r->print("$thisIndent$title</td>");
		if ($totalAttempted) {
		    $r->print('<td valign="top">'
                             .$thisIndent
                             .'<span class="LC_nobreak">'
                             .$correct.' / '.$attempted.($notshowTotals?'':' / '.$total)
                             .'</span></td>'
                             .&Apache::loncommon::end_data_table_row()
                    );
		} else {
		    $r->print('<td valign="top">'
                             .$thisIndent
                             .'<span class="LC_nobreak">'
                             .$correct.($notshowTotals?'':' / '.$total)
                             .'</span></td>'
                             .&Apache::loncommon::end_data_table_row());
		}
            }
        }

        $curRes = $iterator->next();
    }

    # If there were any problems at the top level, print an extra "catchall"
    if ($topLevelParts > 0) {
        my $ratio = $topLevelRight / $topLevelParts;
        my $color = &mixColors(\@start, \@end, $ratio);
        $r->print(&Apache::loncommon::start_data_table_row()
                 .'<td style="background-color:'.$color.';">');
        $r->print(&mt("Problems Not Contained In A Folder")."</td><td>");
        $r->print("$topLevelRight / $topLevelParts</td>"
                 .&Apache::loncommon::end_data_table_row());
    }

#
# show totals (if applicable), close table
#
    if ($showPoints) {
        my $maxHelpLink = &Apache::loncommon::help_open_topic("Quick_Grades_Possibly_Correct");

        $title = $showPoints ? "Points" : "Parts Done";
        my $totaltitle = $showPoints ? &mt("Awarded Total Points") : &mt("Total Parts Done");
        $r->print(&Apache::loncommon::start_data_table_row()
                 .'<td colspan="2" align="right">'.$totaltitle.': <b>'.$totalRight.'</b><br />');
        $r->print(&mt('Max Possible To Date')." $maxHelpLink: <b>$totalPossible</b><br />");
        $title = $showPoints ? "Points" : "Parts";
        $r->print(&mt("Total $title In Course").': <b>'.$totalParts.'</b></td>'
                 .&Apache::loncommon::end_data_table_row());
    }

    $r->print(&Apache::loncommon::end_data_table()
             .&Apache::loncommon::end_page());

}

#
# === Outputting category-based grades.
#
# $category{'order'}: output order of categories by id
# $category{'all'}: complete list of all categories 
# $category{$id.'_name'}: display-name of category
#

sub outputCategories {

    my ($r,$showPoints,$notshowTotals,
           $navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted)=@_;
# Take care of storing and retrieving categories

    my $cangrade=&Apache::lonnet::allowed('mgr');

    my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
    my $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
    my %categories=();
# Loading old categories
    %categories=&Apache::lonnet::dump('grading_categories',$cdom,$cnum);
# Storing
    if (($cangrade) && (($env{'form.storechanges'}) || ($env{'form.storemove'} ne ''))) {
# Process the changes
        %categories=&process_category_edits($r,$cangrade,%categories);
# Actually store
        &Apache::lonnet::logthis("Storing ".$categories{'order'});
        &Apache::lonnet::put('grading_categories',\%categories,$cdom,$cnum);
    }
# new categories loaded now
# Form only generated if user can change the grading categories
    if ($cangrade) {
        $r->print('<form method="post">');
    }
#
    &output_category_table($r,$cangrade,$navmap,%categories);
#
    if ($cangrade) {
        $r->print('<input type="hidden" name="storemove" value="" />'.
                  '<input type="submit" name="storechanges" value="'.&mt("Save changes to grading categories").'" /></form>');
    }
}

#
# Process editing commands, update category hash
#

sub process_category_edits {
    my ($r,$cangrade,%categories)=@_;
    unless ($cangrade) { return %categories; }
    my $cmd=$env{'form.cmd'};
    if ($cmd eq 'createnewcat') {
        %categories=&make_new_category($r,$cangrade,undef,%categories);
    } elsif ($cmd=~/^delcat\_(.+)$/) {
        %categories=&del_category($1,$cangrade,%categories);
    } else {
# Simply store the rest of the stuff
        foreach my $id (split(/\,/,$categories{'order'})) {
            %categories=&set_category_name($cangrade,$id,$env{'form.name_'.$id},%categories);
            %categories=&set_category_weight($cangrade,$id,$env{'form.weighttype_'.$id},$env{'form.weight_'.$id},%categories);
# More changes here
        }
    }
    return %categories;
}

#
# Output the table
#

sub output_category_table {
    my ($r,$cangrade,$navmaps,%categories)=@_;
    my $sum=0;
    my $total=0;
    $r->print(&Apache::loncommon::start_data_table());
#
    &output_category_table_header($r,$cangrade);
#
    my @order=split(/\,/,$categories{'order'});
#
    my $maxpos=$#order;
    for (my $i=0;$i<=$maxpos;$i++) {
        my ($value,$weight)=&output_and_calc_category($r,$cangrade,$navmaps,$order[$i],$i,$maxpos,%categories);
        $sum+=$value*$weight;
        $total+=$weight;
    }
#
    &bottom_line_category($r,$cangrade,$sum,$total);
#
    $r->print(&Apache::loncommon::end_data_table());
    return $sum;
}

sub output_category_table_header {
    my ($r,$cangrade)=@_;
    $r->print(&Apache::loncommon::start_data_table_header_row());
    if ($cangrade) {
        $r->print('<th colspan="2">'.&mt("Move").'</th><th>'.&mt('Action').'</th>');
    }
    $r->print('<th>'.&mt('Category').'</th>'.
              '<th>'.&mt('Contents').'</th>'.
              '<th>'.&mt('Calculation').'</th>'.
              '<th>'.&mt('Weight').'</th>'.
              '<th>'.&mt('Percent Overall').'</th>');
    $r->print(&Apache::loncommon::end_data_table_header_row());
}


#
# Output one category to table
#

sub output_and_calc_category {
    my ($r,$cangrade,$navmaps,$id,$currentpos,$maxpos,%categories)=@_;
    my $value=0;
    my $weight=0;
    my $iconpath = &Apache::loncommon::lonhttpdurl($r->dir_config('lonIconsURL') . "/");
    my %lt=&Apache::lonlocal::texthash(
           'up' => 'Move Up',
           'dw' => 'Move Down');
    $r->print("\n".&Apache::loncommon::start_data_table_row());

    if ($cangrade) {
        $r->print(<<ENDMOVE);
<td>
<div class="LC_docs_entry_move">
  <a href='/adm/quickgrades?cmd=up_$id&storechanges=1'>
    <img src="${iconpath}move_up.gif" alt='$lt{'up'}' class="LC_icon" />
  </a>
</div>
<div class="LC_docs_entry_move">
  <a href='/adm/quickgrades?cmd=down_$id&storechanges=1'>
    <img src="${iconpath}move_down.gif" alt='$lt{'dw'}' class="LC_icon" />
  </a>
</div>
</td>
ENDMOVE
        $r->print("\n<td>\n<select name='newpos_$id' onchange='this.form.storemove.value=\"$id\";this.form.submit()'>");
        for (my $i=0;$i<=$maxpos;$i++) {
            if ($i==$currentpos) {
                $r->print('<option value="" selected="selected">('.$i.')</option>');
            } else {
                $r->print('<option value="'.$i.'">'.$i.'</option>');
            }
        }
        $r->print("\n</select>\n</td>\n");
        $r->print('<td><a href="/adm/quickgrades?cmd=delcat_'.$id.'&storechanges=1">'.&mt('Delete').'</a></td>');
        $r->print('<td><input type="text" name="name_'.$id.
                  '" value="'.&Apache::lonhtmlcommon::entity_encode($categories{$id.'_name'}).'" /></td>');
    } else {
        $r->print('<td>'.$categories{$id.'_name'}.'</td>');
    }
# Content
# FIXME: just placeholders
    if ($cangrade) {
       $r->print("<td>Content Edit</td>");
    } else {
       $r->print("<td>Content</td>");
    }
# Calculation
# FIXME: just placeholders
    if ($cangrade) {
       $r->print("<td>Calculation Edit</td>");
    } else {
       $r->print("<td>Calculation</td>");
    }
# Weight
    if ($cangrade) {
       $r->print('<td>'.
                  '<select name="weighttype_'.$id.'">'.
                  '<option value="default"'.($categories{$id.'_weighttype'} eq 'default'?' selected="selected"':'').'>'.&mt('default').'</option>'.
                  '<option value="typein"'.($categories{$id.'_weighttype'} eq 'typein'?' selected="selected"':'').'>'.&mt('Type-in value').'</option>'.
                  '</select>'.
                  '<input type="text" size="4" name="weight_'.$id.
                  '" value="'.&Apache::lonhtmlcommon::entity_encode($categories{$id.'_weight'}).'" /></td>');
    } else {
        $r->print('<td>'.($categories{$id.'_weighttype'} eq 'default'?&mt('default'):$categories{$id.'_weight'}).'</td>');
    }

    return ($value,$weight);
}

#
# Bottom line with grades
#

sub bottom_line_category {
    my ($r,$cangrade,$sum,$total)=@_;
    $r->print(&Apache::loncommon::start_data_table_row());
    if ($cangrade) {
        $r->print('<td colspan="3"><a href="/adm/quickgrades?cmd=createnewcat&storechanges=1">'.&mt('Create New Category').'</a></td>');
    }
    $r->print('<td colspan="5">'.&mt('Current:').$sum.'<br />'.&mt('Total:').$total.'<br /></td>');
}

#
# Make one new category
#

sub make_new_category {
    my ($r,$cangrade,$ordernum,%categories)=@_;
    unless ($cangrade) { return %categories; }
# Generate new ID
    my $id=time.'_'.$$.'_'.rand(10000);
# Add new ID to list of all IDs ever created in this course
    $categories{'all'}.=','.$id;
    $categories{'all'}=~s/^\,//;
# Add new ID to ordered list of displayed and evaluated categories
    $categories{'order'}.=','.$id;
    $categories{'order'}=~s/^\,//;
# Move it into desired space
    if (defined($ordernum)) {
        %categories=&move_category($id,$cangrade,$ordernum,%categories);
    }
    $categories{$id.'_weighttype'}='default';
    return %categories;
}

#
# Delete category
#

sub del_category {
   my ($id,$cangrade,%categories)=@_; 
   my @neworder=();
   foreach my $currentid (split(/\,/,$categories{'order'})) {
      unless ($currentid eq $id) {
         push(@neworder,$currentid);
      }
   }
   $categories{'order'}=join(',',@neworder);
   return %categories;
}

#
# Move a category to a desired position n the display order
#

sub move_category {
    my ($id,$cangrade,$ordernum,%categories)=@_;
    unless ($cangrade) { return %categories; }
    my @order=split(/\,/,$categories{'order'});
# Where is the index currently?
    my $currentpos=&current_pos_category($id,%categories);
    if (defined($currentpos)) {
        if ($currentpos<$ordernum) {
# This is moving to a higher index
# ....X1234....
# ....1234X....
            for (my $i=$currentpos;$i<$ordernum;$i++) {
                $order[$i]=$order[$i+1];
            }
            $order[$ordernum]=$id;
        }
        if ($currentpos>$ordernum) {
# This is moving to a lower index
# ....1234X....
# ....X1234....
            for (my $i=$currentpos;$i>$ordernum;$i--) {
                $order[$i]=$order[$i-1];
            }
            $order[$ordernum]=$id;
        }
    }
    $categories{'order'}=join(',',@order);
    return %categories;
}

#
#  Find current postion of a category in the order
#

sub current_pos_category {
    my ($id,%categories)=@_;
    my @order=split(/\,/,$categories{'order'});
    for (my $i=0;$i<=$#order;$i++) {
        if ($order[$i] eq $id) { return $i; }
    }
# not found
    return undef;
}

#
# Set name of a category
#
sub set_category_name {
    my ($cangrade,$id,$name,%categories)=@_;
    unless ($cangrade) { return %categories; }
    $categories{$id.'_name'}=$name;
    return %categories;
}

#
# Set weight of a category
#
sub set_category_weight {
    my ($cangrade,$id,$weighttype,$weight,%categories)=@_;
    unless ($cangrade) { return %categories; }
    if (($categories{$id.'_weight'} eq '') && ($weight=~/\d/)) {
        $weighttype='typein';
    }
    $categories{$id.'_weighttype'}=$weighttype;
    if ($weighttype eq 'default') {
        $categories{$id.'_weight'}='';
    } else {
        $weight=~s/\D//gs;
        unless ($weight) { $weight=0; }
        $categories{$id.'_weight'}=$weight;
    }
    return %categories;
}


#
# === end category-related
#
#
# Pass this two refs to arrays for the start and end color, and a number
# from 0 to 1 for how much of the latter you want to mix in. It will
# return a string ready to show ("#FFC309");

sub mixColors {
    my $start = shift;
    my $end = shift;
    my $ratio = shift;
    
    my ($a,$b);
    my $final = "";
    $a = $start->[0]; $b = $end->[0];
    my $mix1 = POSIX::floor((1-$ratio)*$a + $ratio*$b);
    $a = $start->[1]; $b = $end->[1];
    my $mix2 = POSIX::floor((1-$ratio)*$a + $ratio*$b);
    $a = $start->[2]; $b = $end->[2];
    my $mix3 = POSIX::floor((1-$ratio)*$a + $ratio*$b);

    $final = sprintf "%02x%02x%02x", $mix1, $mix2, $mix3;
    return "#" . $final;
}

1;
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>