admin/settings/grades.php

   1 <?php // $Id$
   2
   3 // This file defines settingpages and externalpages under the "grades" section
   4
   5 if (has_capability('moodle/grade:manage', $systemcontext)
   6  or has_capability('moodle/grade:manageletters', $systemcontext)) { // speedup for non-admins, add all caps used on this page
   7
   8     require_once $CFG->libdir.'/grade/constants.php';
   9     $display_types = array(GRADE_DISPLAY_TYPE_REAL => get_string('real', 'grades'),
  10                            GRADE_DISPLAY_TYPE_PERCENTAGE => get_string('percentage', 'grades'),
  11                            GRADE_DISPLAY_TYPE_LETTER => get_string('letter', 'grades'),
  12                            GRADE_DISPLAY_TYPE_REAL_PERCENTAGE => get_string('realpercentage', 'grades'),
  13                            GRADE_DISPLAY_TYPE_REAL_LETTER => get_string('realletter', 'grades'),
  14                            GRADE_DISPLAY_TYPE_LETTER_REAL => get_string('letterreal', 'grades'),
  15                            GRADE_DISPLAY_TYPE_LETTER_PERCENTAGE => get_string('letterpercentage', 'grades'),
  16                            GRADE_DISPLAY_TYPE_PERCENTAGE_LETTER => get_string('percentageletter', 'grades'),
  17                            GRADE_DISPLAY_TYPE_PERCENTAGE_REAL => get_string('percentagereal', 'grades')
  18                            );
  19     asort($display_types);
  20
  21     // General settings
  22
  23     $temp = new admin_settingpage('gradessettings', get_string('generalsettings', 'grades'), 'moodle/grade:manage');
  24     if ($ADMIN->fulltree) {
  25
  26         // new CFG variable for gradebook (what roles to display)
  27         $temp->add(new admin_setting_special_gradebookroles());
  28
  29         // enable outcomes checkbox
  30         $temp->add(new admin_setting_configcheckbox('enableoutcomes', get_string('enableoutcomes', 'grades'), get_string('configenableoutcomes', 'grades'), 0, PARAM_INT));
  31
  32         $temp->add(new admin_setting_grade_profilereport());
  33
  34         $temp->add(new admin_setting_configselect('grade_aggregationposition', get_string('aggregationposition', 'grades'),
  35                                                   get_string('configaggregationposition', 'grades'), GRADE_REPORT_AGGREGATION_POSITION_LAST,
  36                                                   array(GRADE_REPORT_AGGREGATION_POSITION_FIRST => get_string('positionfirst', 'grades'),
  37                                                         GRADE_REPORT_AGGREGATION_POSITION_LAST => get_string('positionlast', 'grades'))));
  38
  39         $temp->add(new admin_setting_regradingcheckbox('grade_includescalesinaggregation', get_string('includescalesinaggregation', 'grades'), get_string('configincludescalesinaggregation', 'grades'), 1));
  40
  41         $temp->add(new admin_setting_configcheckbox('grade_hiddenasdate', get_string('hiddenasdate', 'grades'), get_string('confighiddenasdate', 'grades'), 0));
  42
  43         // enable publishing in exports/imports
  44         $temp->add(new admin_setting_configcheckbox('gradepublishing', get_string('gradepublishing', 'grades'), get_string('configgradepublishing', 'grades'), 0));
  45
  46         $temp->add(new admin_setting_configselect('grade_export_displaytype', get_string('gradeexportdisplaytype', 'grades'),
  47                                                   get_string('configgradeexportdisplaytype', 'grades'), GRADE_DISPLAY_TYPE_REAL, $display_types));
  48
  49         $temp->add(new admin_setting_configselect('grade_export_decimalpoints', get_string('gradeexportdecimalpoints', 'grades'),
  50                                                   get_string('configexportdecimalpoints', 'grades'), 2,
  51                                                   array( '0' => '0',
  52                                                          '1' => '1',
  53                                                          '2' => '2',
  54                                                          '3' => '3',
  55                                                          '4' => '4',
  56                                                          '5' => '5')));
  57         $temp->add(new admin_setting_configselect('grade_navmethod', get_string('navmethod', 'grades'), null, 0,
  58                                                   array(GRADE_NAVMETHOD_DROPDOWN => get_string('dropdown', 'grades'),
  59                                                         GRADE_NAVMETHOD_TABS => get_string('tabs', 'grades'),
  60                                                         GRADE_NAVMETHOD_COMBO => get_string('combo', 'grades'))));
  61
  62         $temp->add(new admin_setting_special_gradeexport());
  63
  64         $temp->add(new admin_setting_special_gradelimiting());
  65     }
  66     $ADMIN->add('grades', $temp);
  67
  68     /// Grade category settings
  69     $temp = new admin_settingpage('gradecategorysettings', get_string('gradecategorysettings', 'grades'), 'moodle/grade:manage');
  70     if ($ADMIN->fulltree) {
  71         $temp->add(new admin_setting_configcheckbox('grade_hideforcedsettings', get_string('hideforcedsettings', 'grades'), get_string('confighideforcedsettings', 'grades'), '1'));
  72
  73         $strnoforce = get_string('noforce', 'grades');
  74
  75         // Aggregation type
  76         $options = array(GRADE_AGGREGATE_MEAN            =>get_string('aggregatemean', 'grades'),
  77                          GRADE_AGGREGATE_WEIGHTED_MEAN   =>get_string('aggregateweightedmean', 'grades'),
  78                          GRADE_AGGREGATE_WEIGHTED_MEAN2  =>get_string('aggregateweightedmean2', 'grades'),
  79                          GRADE_AGGREGATE_EXTRACREDIT_MEAN=>get_string('aggregateextracreditmean', 'grades'),
  80                          GRADE_AGGREGATE_MEDIAN          =>get_string('aggregatemedian', 'grades'),
  81                          GRADE_AGGREGATE_MIN             =>get_string('aggregatemin', 'grades'),
  82                          GRADE_AGGREGATE_MAX             =>get_string('aggregatemax', 'grades'),
  83                          GRADE_AGGREGATE_MODE            =>get_string('aggregatemode', 'grades'),
  84                          GRADE_AGGREGATE_SUM             =>get_string('aggregatesum', 'grades'));
  85
  86         $defaultvisible = array(GRADE_AGGREGATE_MEAN, GRADE_AGGREGATE_WEIGHTED_MEAN, GRADE_AGGREGATE_WEIGHTED_MEAN2,
  87                                 GRADE_AGGREGATE_EXTRACREDIT_MEAN, GRADE_AGGREGATE_MEDIAN, GRADE_AGGREGATE_MIN,
  88                                 GRADE_AGGREGATE_MAX, GRADE_AGGREGATE_MODE, GRADE_AGGREGATE_SUM);
  89
  90         $defaults = array('value'=>GRADE_AGGREGATE_WEIGHTED_MEAN2, 'forced'=>false, 'adv'=>false);
  91         $temp->add(new admin_setting_gradecat_combo('grade_aggregation', get_string('aggregation', 'grades'), get_string('aggregationhelp', 'grades'), $defaults, $options));
  92
  93         $temp->add(new admin_setting_configmultiselect('grade_aggregations_visible', get_string('aggregationsvisible', 'grades'),
  94                                                        get_string('aggregationsvisiblehelp', 'grades'), $defaultvisible, $options));
  95
  96         $options = array(0 => get_string('no'), 1 => get_string('yes'));
  97
  98         $defaults = array('value'=>1, 'forced'=>false, 'adv'=>true);
  99         $temp->add(new admin_setting_gradecat_combo('grade_aggregateonlygraded', get_string('aggregateonlygraded', 'grades'),
 100                     get_string('aggregateonlygradedhelp', 'grades'), $defaults, $options));
 101         $defaults = array('value'=>0, 'forced'=>false, 'adv'=>true);
 102         $temp->add(new admin_setting_gradecat_combo('grade_aggregateoutcomes', get_string('aggregateoutcomes', 'grades'),
 103                     get_string('aggregateoutcomeshelp', 'grades'), $defaults, $options));
 104         $temp->add(new admin_setting_gradecat_combo('grade_aggregatesubcats', get_string('aggregatesubcats', 'grades'),
 105                     get_string('aggregatesubcatshelp', 'grades'), $defaults, $options));
 106
 107         $options = array(0 => get_string('none'));
 108         for ($i=1; $i<=20; $i++) {
 109             $options[$i] = $i;
 110         }
 111
 112         $defaults['value'] = 0;
 113         $defaults['forced'] = true;
 114         $temp->add(new admin_setting_gradecat_combo('grade_keephigh', get_string('keephigh', 'grades'),
 115                     get_string('keephighhelp', 'grades'), $defaults, $options));
 116         $defaults['forced'] = false;
 117         $temp->add(new admin_setting_gradecat_combo('grade_droplow', get_string('droplow', 'grades'),
 118                     get_string('droplowhelp', 'grades'), $defaults, $options));
 119     }
 120     $ADMIN->add('grades', $temp);
 121
 122
 123     /// Grade item settings
 124     $temp = new admin_settingpage('gradeitemsettings', get_string('gradeitemsettings', 'grades'), 'moodle/grade:manage');
 125     if ($ADMIN->fulltree) {
 126         $temp->add(new admin_setting_configselect('grade_displaytype', get_string('gradedisplaytype', 'grades'),
 127                                                   get_string('configgradedisplaytype', 'grades'), GRADE_DISPLAY_TYPE_REAL, $display_types));
 128
 129         $temp->add(new admin_setting_configselect('grade_decimalpoints', get_string('decimalpoints', 'grades'),
 130                                                   get_string('configdecimalpoints', 'grades'), 2,
 131                                                   array( '0' => '0',
 132                                                          '1' => '1',
 133                                                          '2' => '2',
 134                                                          '3' => '3',
 135                                                          '4' => '4',
 136                                                          '5' => '5')));
 137
 138         $temp->add(new admin_setting_configmultiselect('grade_item_advanced', get_string('gradeitemadvanced', 'grades'), get_string('configgradeitemadvanced', 'grades'),
 139                                                        array('iteminfo', 'idnumber', 'gradepass', 'plusfactor', 'multfactor', 'display', 'decimals', 'hiddenuntil', 'locktime'),
 140                                                        array('iteminfo' => get_string('iteminfo', 'grades'),
 141                                                              'idnumber' => get_string('idnumbermod'),
 142                                                              'gradetype' => get_string('gradetype', 'grades'),
 143                                                              'scaleid' => get_string('scale'),
 144                                                              'grademin' => get_string('grademin', 'grades'),
 145                                                              'grademax' => get_string('grademax', 'grades'),
 146                                                              'gradepass' => get_string('gradepass', 'grades'),
 147                                                              'plusfactor' => get_string('plusfactor', 'grades'),
 148                                                              'multfactor' => get_string('multfactor', 'grades'),
 149                                                              'display' => get_string('gradedisplaytype', 'grades'),
 150                                                              'decimals' => get_string('decimalpoints', 'grades'),
 151                                                              'hidden' => get_string('hidden', 'grades'),
 152                                                              'hiddenuntil' => get_string('hiddenuntil', 'grades'),
 153                                                              'locked' => get_string('locked', 'grades'),
 154                                                              'locktime' => get_string('locktime', 'grades'),
 155                                                              'aggregationcoef' => get_string('aggregationcoef', 'grades'),
 156                                                              'parentcategory' => get_string('parentcategory', 'grades'))));
 157     }
 158     $ADMIN->add('grades', $temp);
 159
 160
 161     /// Scales and outcomes
 162
 163     $scales = new admin_externalpage('scales', get_string('scales'), $CFG->wwwroot.'/grade/edit/scale/index.php', 'moodle/grade:manage');
 164     $ADMIN->add('grades', $scales);
 165     if (!empty($CFG->enableoutcomes)) {
 166         $outcomes = new admin_externalpage('outcomes', get_string('outcomes', 'grades'), $CFG->wwwroot.'/grade/edit/outcome/index.php', 'moodle/grade:manage');
 167         $ADMIN->add('grades', $outcomes);
 168     }
 169     $letters = new admin_externalpage('letters', get_string('letters', 'grades'), $CFG->wwwroot.'/grade/edit/letter/edit.php', 'moodle/grade:manageletters');
 170     $ADMIN->add('grades', $letters);
 171
 172     // The plugins must implement a settings.php file that adds their admin settings to the $settings object
 173
 174     // Reports
 175     $ADMIN->add('grades', new admin_category('gradereports', get_string('reportsettings', 'grades')));
 176     foreach (get_list_of_plugins('grade/report') as $plugin) {
 177      // Include all the settings commands for this plugin if there are any
 178         if (file_exists($CFG->dirroot.'/grade/report/'.$plugin.'/settings.php')) {
 179             $settings = new admin_settingpage('gradereport'.$plugin, get_string('modulename', 'gradereport_'.$plugin), 'moodle/grade:manage');
 180             if ($ADMIN->fulltree) {
 181                 include($CFG->dirroot.'/grade/report/'.$plugin.'/settings.php');
 182             }
 183             $ADMIN->add('gradereports', $settings);
 184         }
 185     }
 186
 187     // Imports
 188     $ADMIN->add('grades', new admin_category('gradeimports', get_string('importsettings', 'grades')));
 189     foreach (get_list_of_plugins('grade/import') as $plugin) {
 190
 191      // Include all the settings commands for this plugin if there are any
 192         if (file_exists($CFG->dirroot.'/grade/import/'.$plugin.'/settings.php')) {
 193             $settings = new admin_settingpage('gradeimport'.$plugin, get_string('modulename', 'gradeimport_'.$plugin), 'moodle/grade:manage');
 194             if ($ADMIN->fulltree) {
 195                 include($CFG->dirroot.'/grade/import/'.$plugin.'/settings.php');
 196             }
 197             $ADMIN->add('gradeimports', $settings);
 198         }
 199     }
 200
 201
 202     // Exports
 203     $ADMIN->add('grades', new admin_category('gradeexports', get_string('exportsettings', 'grades')));
 204     foreach (get_list_of_plugins('grade/export') as $plugin) {
 205      // Include all the settings commands for this plugin if there are any
 206         if (file_exists($CFG->dirroot.'/grade/export/'.$plugin.'/settings.php')) {
 207             $settings = new admin_settingpage('gradeexport'.$plugin, get_string('modulename', 'gradeexport_'.$plugin), 'moodle/grade:manage');
 208             if ($ADMIN->fulltree) {
 209                 include($CFG->dirroot.'/grade/export/'.$plugin.'/settings.php');
 210             }
 211             $ADMIN->add('gradeexports', $settings);
 212         }
 213     }
 214
 215 } // end of speedup
 216
 217 ?>