source: moodle/trunk/fuentes/admin/settings/grades.php

Last change on this file was 1331, checked in by jrpelegrina, 3 years ago

Updated to moodle 3.0.3

File size: 15.3 KB
Line 
1<?php
2
3// This file defines settingpages and externalpages under the "grades" section
4
5if (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 => new lang_string('real', 'grades'),
10                           GRADE_DISPLAY_TYPE_PERCENTAGE => new lang_string('percentage', 'grades'),
11                           GRADE_DISPLAY_TYPE_LETTER => new lang_string('letter', 'grades'),
12                           GRADE_DISPLAY_TYPE_REAL_PERCENTAGE => new lang_string('realpercentage', 'grades'),
13                           GRADE_DISPLAY_TYPE_REAL_LETTER => new lang_string('realletter', 'grades'),
14                           GRADE_DISPLAY_TYPE_LETTER_REAL => new lang_string('letterreal', 'grades'),
15                           GRADE_DISPLAY_TYPE_LETTER_PERCENTAGE => new lang_string('letterpercentage', 'grades'),
16                           GRADE_DISPLAY_TYPE_PERCENTAGE_LETTER => new lang_string('percentageletter', 'grades'),
17                           GRADE_DISPLAY_TYPE_PERCENTAGE_REAL => new lang_string('percentagereal', 'grades')
18                           );
19    asort($display_types);
20
21    // General settings
22
23    $temp = new admin_settingpage('gradessettings', new lang_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 now in subsystems area
30
31        $temp->add(new admin_setting_grade_profilereport());
32
33        $temp->add(new admin_setting_configselect('grade_aggregationposition', new lang_string('aggregationposition', 'grades'),
34                                                  new lang_string('aggregationposition_help', 'grades'), GRADE_REPORT_AGGREGATION_POSITION_LAST,
35                                                  array(GRADE_REPORT_AGGREGATION_POSITION_FIRST => new lang_string('positionfirst', 'grades'),
36                                                        GRADE_REPORT_AGGREGATION_POSITION_LAST => new lang_string('positionlast', 'grades'))));
37
38        $temp->add(new admin_setting_regradingcheckbox('grade_includescalesinaggregation', new lang_string('includescalesinaggregation', 'grades'), new lang_string('includescalesinaggregation_help', 'grades'), 1));
39
40        $temp->add(new admin_setting_configcheckbox('grade_hiddenasdate', new lang_string('hiddenasdate', 'grades'), new lang_string('hiddenasdate_help', 'grades'), 0));
41
42        // enable publishing in exports/imports
43        $temp->add(new admin_setting_configcheckbox('gradepublishing', new lang_string('gradepublishing', 'grades'), new lang_string('gradepublishing_help', 'grades'), 0));
44
45        $temp->add(new admin_setting_configselect('grade_export_displaytype', new lang_string('gradeexportdisplaytype', 'grades'),
46                                                  new lang_string('gradeexportdisplaytype_desc', 'grades'), GRADE_DISPLAY_TYPE_REAL, $display_types));
47
48        $temp->add(new admin_setting_configselect('grade_export_decimalpoints', new lang_string('gradeexportdecimalpoints', 'grades'),
49                                                  new lang_string('gradeexportdecimalpoints_desc', 'grades'), 2,
50                                                  array( '0' => '0',
51                                                         '1' => '1',
52                                                         '2' => '2',
53                                                         '3' => '3',
54                                                         '4' => '4',
55                                                         '5' => '5')));
56        $temp->add(new admin_setting_configselect('grade_navmethod', new lang_string('navmethod', 'grades'), null, 0,
57                                                  array(GRADE_NAVMETHOD_DROPDOWN => new lang_string('dropdown', 'grades'),
58                                                        GRADE_NAVMETHOD_TABS => new lang_string('tabs', 'grades'),
59                                                        GRADE_NAVMETHOD_COMBO => new lang_string('combo', 'grades'))));
60
61        $temp->add(new admin_setting_configtext('grade_export_userprofilefields', new lang_string('gradeexportuserprofilefields', 'grades'), new lang_string('gradeexportuserprofilefields_desc', 'grades'), 'firstname,lastname,idnumber,institution,department,email', PARAM_TEXT));
62
63        $temp->add(new admin_setting_configtext('grade_export_customprofilefields', new lang_string('gradeexportcustomprofilefields', 'grades'), new lang_string('gradeexportcustomprofilefields_desc', 'grades'), '', PARAM_TEXT));
64
65        $temp->add(new admin_setting_configcheckbox('recovergradesdefault', new lang_string('recovergradesdefault', 'grades'), new lang_string('recovergradesdefault_help', 'grades'), 0));
66
67        $temp->add(new admin_setting_special_gradeexport());
68
69        $temp->add(new admin_setting_special_gradelimiting());
70
71        $temp->add(new admin_setting_configcheckbox('grade_report_showmin',
72                                                    get_string('minimum_show', 'grades'),
73                                                    get_string('minimum_show_help', 'grades'), '1'));
74
75        $temp->add(new admin_setting_special_gradepointmax());
76
77        $temp->add(new admin_setting_special_gradepointdefault());
78
79        $temp->add(new admin_setting_special_grademinmaxtouse());
80
81        $temp->add(new admin_setting_my_grades_report());
82
83        $temp->add(new admin_setting_configtext('gradereport_mygradeurl', new lang_string('externalurl', 'grades'),
84                new lang_string('externalurl_desc', 'grades'), ''));
85    }
86    $ADMIN->add('grades', $temp);
87
88    /// Grade category settings
89    $temp = new admin_settingpage('gradecategorysettings', new lang_string('gradecategorysettings', 'grades'), 'moodle/grade:manage');
90    if ($ADMIN->fulltree) {
91        $temp->add(new admin_setting_configcheckbox('grade_hideforcedsettings', new lang_string('hideforcedsettings', 'grades'), new lang_string('hideforcedsettings_help', 'grades'), '1'));
92
93        $strnoforce = new lang_string('noforce', 'grades');
94
95        // Aggregation type
96        $options = array(GRADE_AGGREGATE_MEAN            =>new lang_string('aggregatemean', 'grades'),
97                         GRADE_AGGREGATE_WEIGHTED_MEAN   =>new lang_string('aggregateweightedmean', 'grades'),
98                         GRADE_AGGREGATE_WEIGHTED_MEAN2  =>new lang_string('aggregateweightedmean2', 'grades'),
99                         GRADE_AGGREGATE_EXTRACREDIT_MEAN=>new lang_string('aggregateextracreditmean', 'grades'),
100                         GRADE_AGGREGATE_MEDIAN          =>new lang_string('aggregatemedian', 'grades'),
101                         GRADE_AGGREGATE_MIN             =>new lang_string('aggregatemin', 'grades'),
102                         GRADE_AGGREGATE_MAX             =>new lang_string('aggregatemax', 'grades'),
103                         GRADE_AGGREGATE_MODE            =>new lang_string('aggregatemode', 'grades'),
104                         GRADE_AGGREGATE_SUM             =>new lang_string('aggregatesum', 'grades'));
105
106        $defaultvisible = array(GRADE_AGGREGATE_SUM);
107
108        $defaults = array('value' => GRADE_AGGREGATE_SUM, 'forced' => false, 'adv' => false);
109        $temp->add(new admin_setting_gradecat_combo('grade_aggregation', new lang_string('aggregation', 'grades'), new lang_string('aggregation_help', 'grades'), $defaults, $options));
110
111        $temp->add(new admin_setting_configmultiselect('grade_aggregations_visible', new lang_string('aggregationsvisible', 'grades'),
112                                                       new lang_string('aggregationsvisiblehelp', 'grades'), $defaultvisible, $options));
113
114        $options = array(0 => new lang_string('no'), 1 => new lang_string('yes'));
115
116        $defaults = array('value'=>1, 'forced'=>false, 'adv'=>true);
117        $temp->add(new admin_setting_gradecat_combo('grade_aggregateonlygraded', new lang_string('aggregateonlygraded', 'grades'),
118                    new lang_string('aggregateonlygraded_help', 'grades'), $defaults, $options));
119        $defaults = array('value'=>0, 'forced'=>false, 'adv'=>true);
120        $temp->add(new admin_setting_gradecat_combo('grade_aggregateoutcomes', new lang_string('aggregateoutcomes', 'grades'),
121                    new lang_string('aggregateoutcomes_help', 'grades'), $defaults, $options));
122
123        $options = array(0 => new lang_string('none'));
124        for ($i=1; $i<=20; $i++) {
125            $options[$i] = $i;
126        }
127
128        $defaults['value'] = 0;
129        $defaults['forced'] = true;
130        $temp->add(new admin_setting_gradecat_combo('grade_keephigh', new lang_string('keephigh', 'grades'),
131                    new lang_string('keephigh_help', 'grades'), $defaults, $options));
132        $defaults['forced'] = false;
133        $temp->add(new admin_setting_gradecat_combo('grade_droplow', new lang_string('droplow', 'grades'),
134                    new lang_string('droplow_help', 'grades'), $defaults, $options));
135
136        $temp->add(new admin_setting_configcheckbox('grade_overridecat', new lang_string('overridecat', 'grades'),
137                   new lang_string('overridecat_help', 'grades'), 1));
138    }
139    $ADMIN->add('grades', $temp);
140
141
142    /// Grade item settings
143    $temp = new admin_settingpage('gradeitemsettings', new lang_string('gradeitemsettings', 'grades'), 'moodle/grade:manage');
144    if ($ADMIN->fulltree) {
145        $temp->add(new admin_setting_configselect('grade_displaytype', new lang_string('gradedisplaytype', 'grades'),
146                                                  new lang_string('gradedisplaytype_help', 'grades'), GRADE_DISPLAY_TYPE_REAL, $display_types));
147
148        $temp->add(new admin_setting_configselect('grade_decimalpoints', new lang_string('decimalpoints', 'grades'),
149                                                  new lang_string('decimalpoints_help', 'grades'), 2,
150                                                  array( '0' => '0',
151                                                         '1' => '1',
152                                                         '2' => '2',
153                                                         '3' => '3',
154                                                         '4' => '4',
155                                                         '5' => '5')));
156
157        $temp->add(new admin_setting_configmultiselect('grade_item_advanced', new lang_string('gradeitemadvanced', 'grades'), new lang_string('gradeitemadvanced_help', 'grades'),
158                                                       array('iteminfo', 'idnumber', 'gradepass', 'plusfactor', 'multfactor', 'display', 'decimals', 'hiddenuntil', 'locktime'),
159                                                       array('iteminfo' => new lang_string('iteminfo', 'grades'),
160                                                             'idnumber' => new lang_string('idnumbermod'),
161                                                             'gradetype' => new lang_string('gradetype', 'grades'),
162                                                             'scaleid' => new lang_string('scale'),
163                                                             'grademin' => new lang_string('grademin', 'grades'),
164                                                             'grademax' => new lang_string('grademax', 'grades'),
165                                                             'gradepass' => new lang_string('gradepass', 'grades'),
166                                                             'plusfactor' => new lang_string('plusfactor', 'grades'),
167                                                             'multfactor' => new lang_string('multfactor', 'grades'),
168                                                             'display' => new lang_string('gradedisplaytype', 'grades'),
169                                                             'decimals' => new lang_string('decimalpoints', 'grades'),
170                                                             'hidden' => new lang_string('hidden', 'grades'),
171                                                             'hiddenuntil' => new lang_string('hiddenuntil', 'grades'),
172                                                             'locked' => new lang_string('locked', 'grades'),
173                                                             'locktime' => new lang_string('locktime', 'grades'),
174                                                             'aggregationcoef' => new lang_string('aggregationcoef', 'grades'),
175                                                             'parentcategory' => new lang_string('parentcategory', 'grades'))));
176    }
177    $ADMIN->add('grades', $temp);
178
179
180    /// Scales and outcomes
181
182    $scales = new admin_externalpage('scales', new lang_string('scales'), $CFG->wwwroot.'/grade/edit/scale/index.php', 'moodle/grade:manage');
183    $ADMIN->add('grades', $scales);
184    if (!empty($CFG->enableoutcomes)) {
185        $outcomes = new admin_externalpage('outcomes', new lang_string('outcomes', 'grades'), $CFG->wwwroot.'/grade/edit/outcome/index.php', 'moodle/grade:manage');
186        $ADMIN->add('grades', $outcomes);
187    }
188    $letters = new admin_externalpage('letters', new lang_string('letters', 'grades'), $CFG->wwwroot.'/grade/edit/letter/index.php', 'moodle/grade:manageletters');
189    $ADMIN->add('grades', $letters);
190
191    // The plugins must implement a settings.php file that adds their admin settings to the $settings object
192
193    // Reports
194    $ADMIN->add('grades', new admin_category('gradereports', new lang_string('reportsettings', 'grades')));
195    foreach (core_component::get_plugin_list('gradereport') as $plugin => $plugindir) {
196     // Include all the settings commands for this plugin if there are any
197        if (file_exists($plugindir.'/settings.php')) {
198            $settings = new admin_settingpage('gradereport'.$plugin, new lang_string('pluginname', 'gradereport_'.$plugin), 'moodle/grade:manage');
199            include($plugindir.'/settings.php');
200            if ($settings) {
201                $ADMIN->add('gradereports', $settings);
202            }
203        }
204    }
205
206    // Imports
207    $ADMIN->add('grades', new admin_category('gradeimports', new lang_string('importsettings', 'grades')));
208    foreach (core_component::get_plugin_list('gradeimport') as $plugin => $plugindir) {
209
210     // Include all the settings commands for this plugin if there are any
211        if (file_exists($plugindir.'/settings.php')) {
212            $settings = new admin_settingpage('gradeimport'.$plugin, new lang_string('pluginname', 'gradeimport_'.$plugin), 'moodle/grade:manage');
213            include($plugindir.'/settings.php');
214            if ($settings) {
215                $ADMIN->add('gradeimports', $settings);
216            }
217        }
218    }
219
220
221    // Exports
222    $ADMIN->add('grades', new admin_category('gradeexports', new lang_string('exportsettings', 'grades')));
223    foreach (core_component::get_plugin_list('gradeexport') as $plugin => $plugindir) {
224     // Include all the settings commands for this plugin if there are any
225        if (file_exists($plugindir.'/settings.php')) {
226            $settings = new admin_settingpage('gradeexport'.$plugin, new lang_string('pluginname', 'gradeexport_'.$plugin), 'moodle/grade:manage');
227            include($plugindir.'/settings.php');
228            if ($settings) {
229                $ADMIN->add('gradeexports', $settings);
230            }
231        }
232    }
233
234} // end of speedup
235
Note: See TracBrowser for help on using the repository browser.