MDL-51261 config-dist: clarify setting description a little
[moodle.git] / admin / settings / courses.php
1 <?php
2 // This file is part of Moodle - http://moodle.org/
3 //
4 // Moodle is free software: you can redistribute it and/or modify
5 // it under the terms of the GNU General Public License as published by
6 // the Free Software Foundation, either version 3 of the License, or
7 // (at your option) any later version.
8 //
9 // Moodle is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12 // GNU General Public License for more details.
13 //
14 // You should have received a copy of the GNU General Public License
15 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
17 /**
18  * This file defines settingpages and externalpages under the "courses" category
19  *
20  * @package core
21  * @copyright 2002 onwards Martin Dougiamas (http://dougiamas.com)
22  * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
23  */
25 $capabilities = array(
26     'moodle/backup:backupcourse',
27     'moodle/category:manage',
28     'moodle/course:create',
29     'moodle/site:approvecourse',
30     'moodle/restore:restorecourse'
31 );
32 if ($hassiteconfig or has_any_capability($capabilities, $systemcontext)) {
33     // Speedup for non-admins, add all caps used on this page.
34     $ADMIN->add('courses',
35         new admin_externalpage('coursemgmt', new lang_string('coursemgmt', 'admin'),
36             $CFG->wwwroot . '/course/management.php',
37             array('moodle/category:manage', 'moodle/course:create')
38         )
39     );
40     $ADMIN->add('courses',
41         new admin_externalpage('addcategory', new lang_string('addcategory', 'admin'),
42             new moodle_url('/course/editcategory.php', array('parent' => 0)),
43             array('moodle/category:manage')
44         )
45     );
46     $ADMIN->add('courses',
47         new admin_externalpage('restorecourse', new lang_string('restorecourse', 'admin'),
48             new moodle_url('/backup/restorefile.php', array('contextid' => context_system::instance()->id)),
49             array('moodle/restore:restorecourse')
50         )
51     );
53     // Course Default Settings Page.
54     // NOTE: these settings must be applied after all other settings because they depend on them.
56     // Main course settings.
57     $temp = new admin_settingpage('coursesettings', new lang_string('coursesettings'));
58     require_once($CFG->dirroot.'/course/lib.php');
60     $choices = array();
61     $choices['0'] = new lang_string('hide');
62     $choices['1'] = new lang_string('show');
63     $temp->add(new admin_setting_configselect('moodlecourse/visible', new lang_string('visible'), new lang_string('visible_help'),
64         1, $choices));
66     // Course format.
67     $temp->add(new admin_setting_heading('courseformathdr', new lang_string('type_format', 'plugin'), ''));
69     $courseformats = get_sorted_course_formats(true);
70     $formcourseformats = array();
71     foreach ($courseformats as $courseformat) {
72         $formcourseformats[$courseformat] = new lang_string('pluginname', "format_$courseformat");
73     }
74     $temp->add(new admin_setting_configselect('moodlecourse/format', new lang_string('format'), new lang_string('coursehelpformat'),
75         'weeks',$formcourseformats));
77     $temp->add(new admin_setting_configtext('moodlecourse/maxsections', new lang_string('maxnumberweeks'),
78         new lang_string('maxnumberweeks_desc'), 52));
80     $temp->add(new admin_settings_num_course_sections('moodlecourse/numsections', new lang_string('numberweeks'),
81         new lang_string('coursehelpnumberweeks'), 10));
83     $choices = array();
84     $choices['0'] = new lang_string('hiddensectionscollapsed');
85     $choices['1'] = new lang_string('hiddensectionsinvisible');
86     $temp->add(new admin_setting_configselect('moodlecourse/hiddensections', new lang_string('hiddensections'),
87         new lang_string('coursehelphiddensections'), 0, $choices));
89     $choices = array();
90     $choices[COURSE_DISPLAY_SINGLEPAGE] = new lang_string('coursedisplay_single');
91     $choices[COURSE_DISPLAY_MULTIPAGE] = new lang_string('coursedisplay_multi');
92     $temp->add(new admin_setting_configselect('moodlecourse/coursedisplay', new lang_string('coursedisplay'),
93         new lang_string('coursedisplay_help'), COURSE_DISPLAY_SINGLEPAGE, $choices));
95     // Appearance.
96     $temp->add(new admin_setting_heading('appearancehdr', new lang_string('appearance'), ''));
98     $languages = array();
99     $languages[''] = new lang_string('forceno');
100     $languages += get_string_manager()->get_list_of_translations();
101     $temp->add(new admin_setting_configselect('moodlecourse/lang', new lang_string('forcelanguage'), '', key($languages),
102         $languages));
104     $options = range(0, 10);
105     $temp->add(new admin_setting_configselect('moodlecourse/newsitems', new lang_string('newsitemsnumber'),
106         new lang_string('coursehelpnewsitemsnumber'), 5, $options));
107     $temp->add(new admin_setting_configselect('moodlecourse/showgrades', new lang_string('showgrades'),
108         new lang_string('coursehelpshowgrades'), 1, array(0 => new lang_string('no'), 1 => new lang_string('yes'))));
109     $temp->add(new admin_setting_configselect('moodlecourse/showreports', new lang_string('showreports'), '', 0,
110         array(0 => new lang_string('no'), 1 => new lang_string('yes'))));
112     // Files and uploads.
113     $temp->add(new admin_setting_heading('filesanduploadshdr', new lang_string('filesanduploads'), ''));
115     if (!empty($CFG->legacyfilesinnewcourses)) {
116         $choices = array('0'=>new lang_string('no'), '2'=>new lang_string('yes'));
117         $temp->add(new admin_setting_configselect('moodlecourse/legacyfiles', new lang_string('courselegacyfiles'),
118             new lang_string('courselegacyfiles_help'), key($choices), $choices));
119     }
121     $currentmaxbytes = get_config('moodlecourse', 'maxbytes');
122     if (isset($CFG->maxbytes)) {
123         $choices = get_max_upload_sizes($CFG->maxbytes, 0, 0, $currentmaxbytes);
124     } else {
125         $choices = get_max_upload_sizes(0, 0, 0, $currentmaxbytes);
126     }
127     $temp->add(new admin_setting_configselect('moodlecourse/maxbytes', new lang_string('maximumupload'),
128         new lang_string('coursehelpmaximumupload'), key($choices), $choices));
130     // Completion tracking.
131     $temp->add(new admin_setting_heading('progress', new lang_string('completion','completion'), ''));
132     $temp->add(new admin_setting_configselect('moodlecourse/enablecompletion', new lang_string('completion', 'completion'),
133         new lang_string('enablecompletion_help', 'completion'), 0, array(0 => new lang_string('no'), 1 => new lang_string('yes'))));
135     // Groups.
136     $temp->add(new admin_setting_heading('groups', new lang_string('groups', 'group'), ''));
137     $choices = array();
138     $choices[NOGROUPS] = new lang_string('groupsnone', 'group');
139     $choices[SEPARATEGROUPS] = new lang_string('groupsseparate', 'group');
140     $choices[VISIBLEGROUPS] = new lang_string('groupsvisible', 'group');
141     $temp->add(new admin_setting_configselect('moodlecourse/groupmode', new lang_string('groupmode'), '', key($choices),$choices));
142     $temp->add(new admin_setting_configselect('moodlecourse/groupmodeforce', new lang_string('force'), new lang_string('coursehelpforce'), 0,array(0 => new lang_string('no'), 1 => new lang_string('yes'))));
144     $ADMIN->add('courses', $temp);
147     // "courserequests" settingpage.
148     $temp = new admin_settingpage('courserequest', new lang_string('courserequest'));
149     $temp->add(new admin_setting_configcheckbox('enablecourserequests', new lang_string('enablecourserequests', 'admin'), new lang_string('configenablecourserequests', 'admin'), 0));
150     $temp->add(new admin_settings_coursecat_select('defaultrequestcategory', new lang_string('defaultrequestcategory', 'admin'), new lang_string('configdefaultrequestcategory', 'admin'), 1));
151     $temp->add(new admin_setting_configcheckbox('requestcategoryselection', new lang_string('requestcategoryselection', 'admin'), new lang_string('configrequestcategoryselection', 'admin'), 0));
152     $temp->add(new admin_setting_users_with_capability('courserequestnotify', new lang_string('courserequestnotify', 'admin'), new lang_string('configcourserequestnotify2', 'admin'), array(), 'moodle/site:approvecourse'));
153     $ADMIN->add('courses', $temp);
155     // Pending course requests.
156     if (!empty($CFG->enablecourserequests)) {
157         $ADMIN->add('courses', new admin_externalpage('coursespending', new lang_string('pendingrequests'),
158                 $CFG->wwwroot . '/course/pending.php', array('moodle/site:approvecourse')));
159     }
161     // Add a category for backups.
162     $ADMIN->add('courses', new admin_category('backups', new lang_string('backups','admin')));
164     // Create a page for general backups configuration and defaults.
165     $temp = new admin_settingpage('backupgeneralsettings', new lang_string('generalbackdefaults', 'backup'), 'moodle/backup:backupcourse');
167     // General configuration section.
168     $temp->add(new admin_setting_configselect('backup/loglifetime', new lang_string('loglifetime', 'backup'), new lang_string('configloglifetime', 'backup'), 30, array(
169         1   => new lang_string('numdays', '', 1),
170         2   => new lang_string('numdays', '', 2),
171         3   => new lang_string('numdays', '', 3),
172         5   => new lang_string('numdays', '', 5),
173         7   => new lang_string('numdays', '', 7),
174         10  => new lang_string('numdays', '', 10),
175         14  => new lang_string('numdays', '', 14),
176         20  => new lang_string('numdays', '', 20),
177         30  => new lang_string('numdays', '', 30),
178         60  => new lang_string('numdays', '', 60),
179         90  => new lang_string('numdays', '', 90),
180         120 => new lang_string('numdays', '', 120),
181         180 => new lang_string('numdays', '', 180),
182         365 => new lang_string('numdays', '', 365)
183     )));
185     // General defaults section.
186     $temp->add(new admin_setting_heading('generalsettings', new lang_string('generalsettings', 'backup'), ''));
187     $temp->add(new admin_setting_configcheckbox_with_lock('backup/backup_general_users', new lang_string('generalusers','backup'), new lang_string('configgeneralusers','backup'), array('value'=>1, 'locked'=>0)));
188     $temp->add(new admin_setting_configcheckbox_with_lock('backup/backup_general_anonymize', new lang_string('generalanonymize','backup'), new lang_string('configgeneralanonymize','backup'), array('value'=>0, 'locked'=>0)));
189     $temp->add(new admin_setting_configcheckbox_with_lock('backup/backup_general_role_assignments', new lang_string('generalroleassignments','backup'), new lang_string('configgeneralroleassignments','backup'), array('value'=>1, 'locked'=>0)));
190     $temp->add(new admin_setting_configcheckbox_with_lock('backup/backup_general_activities', new lang_string('generalactivities','backup'), new lang_string('configgeneralactivities','backup'), array('value'=>1, 'locked'=>0)));
191     $temp->add(new admin_setting_configcheckbox_with_lock('backup/backup_general_blocks', new lang_string('generalblocks','backup'), new lang_string('configgeneralblocks','backup'), array('value'=>1, 'locked'=>0)));
192     $temp->add(new admin_setting_configcheckbox_with_lock('backup/backup_general_filters', new lang_string('generalfilters','backup'), new lang_string('configgeneralfilters','backup'), array('value'=>1, 'locked'=>0)));
193     $temp->add(new admin_setting_configcheckbox_with_lock('backup/backup_general_comments', new lang_string('generalcomments','backup'), new lang_string('configgeneralcomments','backup'), array('value'=>1, 'locked'=>0)));
194     $temp->add(new admin_setting_configcheckbox_with_lock('backup/backup_general_badges', new lang_string('generalbadges','backup'), new lang_string('configgeneralbadges','backup'), array('value'=>1,'locked'=>0)));
195     $temp->add(new admin_setting_configcheckbox_with_lock('backup/backup_general_userscompletion', new lang_string('generaluserscompletion','backup'), new lang_string('configgeneraluserscompletion','backup'), array('value'=>1, 'locked'=>0)));
196     $temp->add(new admin_setting_configcheckbox_with_lock('backup/backup_general_logs', new lang_string('generallogs','backup'), new lang_string('configgenerallogs','backup'), array('value'=>0, 'locked'=>0)));
197     $temp->add(new admin_setting_configcheckbox_with_lock('backup/backup_general_histories', new lang_string('generalhistories','backup'), new lang_string('configgeneralhistories','backup'), array('value'=>0, 'locked'=>0)));
198     $temp->add(new admin_setting_configcheckbox_with_lock('backup/backup_general_questionbank', new lang_string('generalquestionbank','backup'), new lang_string('configgeneralquestionbank','backup'), array('value'=>1, 'locked'=>0)));
199     $temp->add(new admin_setting_configcheckbox_with_lock('backup/backup_general_groups',
200             new lang_string('generalgroups', 'backup'), new lang_string('configgeneralgroups', 'backup'),
201             array('value' => 1, 'locked' => 0)));
203     $ADMIN->add('backups', $temp);
205     // Create a page for general import configuration and defaults.
206     $temp = new admin_settingpage('importgeneralsettings', new lang_string('importgeneralsettings', 'backup'), 'moodle/backup:backupcourse');
207     $temp->add(new admin_setting_configtext('backup/import_general_maxresults', new lang_string('importgeneralmaxresults', 'backup'), new lang_string('importgeneralmaxresults_desc', 'backup'), 10));
208     $ADMIN->add('backups', $temp);
210     // Create a page for automated backups configuration and defaults.
211     $temp = new admin_settingpage('automated', new lang_string('automatedsetup','backup'), 'moodle/backup:backupcourse');
213     // Automated configuration section.
214     $temp->add(new admin_setting_configselect('backup/backup_auto_active', new lang_string('active'),  new lang_string('autoactivedescription', 'backup'), 0, array(
215         0 => new lang_string('autoactivedisabled', 'backup'),
216         1 => new lang_string('autoactiveenabled', 'backup'),
217         2 => new lang_string('autoactivemanual', 'backup')
218     )));
219     $temp->add(new admin_setting_special_backupdays());
220     $temp->add(new admin_setting_configtime('backup/backup_auto_hour', 'backup_auto_minute', new lang_string('executeat'),
221             new lang_string('backupexecuteathelp'), array('h' => 0, 'm' => 0)));
222     $storageoptions = array(
223         0 => new lang_string('storagecourseonly', 'backup'),
224         1 => new lang_string('storageexternalonly', 'backup'),
225         2 => new lang_string('storagecourseandexternal', 'backup')
226     );
227     $temp->add(new admin_setting_configselect('backup/backup_auto_storage', new lang_string('automatedstorage', 'backup'), new lang_string('automatedstoragehelp', 'backup'), 0, $storageoptions));
228     $temp->add(new admin_setting_special_backup_auto_destination());
229     $keepoptoins = array(
230         0 => new lang_string('all'), 1 => '1',
231         2 => '2',
232         5 => '5',
233         10 => '10',
234         20 => '20',
235         30 => '30',
236         40 => '40',
237         50 => '50',
238         100 => '100',
239         200 => '200',
240         300 => '300',
241         400 => '400',
242         500 => '500');
243     $temp->add(new admin_setting_configselect('backup/backup_auto_keep', new lang_string('keep'), new lang_string('backupkeephelp'), 1, $keepoptoins));
244     $temp->add(new admin_setting_configcheckbox('backup/backup_shortname', new lang_string('backup_shortname', 'admin'), new lang_string('backup_shortnamehelp', 'admin'), 0));
245     $temp->add(new admin_setting_configcheckbox('backup/backup_auto_skip_hidden', new lang_string('skiphidden', 'backup'), new lang_string('skiphiddenhelp', 'backup'), 1));
246     $temp->add(new admin_setting_configselect('backup/backup_auto_skip_modif_days', new lang_string('skipmodifdays', 'backup'), new lang_string('skipmodifdayshelp', 'backup'), 30, array(
247         0 => new lang_string('never'),
248         1 => new lang_string('numdays', '', 1),
249         2 => new lang_string('numdays', '', 2),
250         3 => new lang_string('numdays', '', 3),
251         5 => new lang_string('numdays', '', 5),
252         7 => new lang_string('numdays', '', 7),
253         10 => new lang_string('numdays', '', 10),
254         14 => new lang_string('numdays', '', 14),
255         20 => new lang_string('numdays', '', 20),
256         30 => new lang_string('numdays', '', 30),
257         60 => new lang_string('numdays', '', 60),
258         90 => new lang_string('numdays', '', 90),
259         120 => new lang_string('numdays', '', 120),
260         180 => new lang_string('numdays', '', 180),
261         365 => new lang_string('numdays', '', 365)
262     )));
263     $temp->add(new admin_setting_configcheckbox('backup/backup_auto_skip_modif_prev', new lang_string('skipmodifprev', 'backup'), new lang_string('skipmodifprevhelp', 'backup'), 0));
265     // Automated defaults section.
266     $temp->add(new admin_setting_heading('automatedsettings', new lang_string('automatedsettings','backup'), ''));
267     $temp->add(new admin_setting_configcheckbox('backup/backup_auto_users', new lang_string('generalusers', 'backup'), new lang_string('configgeneralusers', 'backup'), 1));
268     $temp->add(new admin_setting_configcheckbox('backup/backup_auto_role_assignments', new lang_string('generalroleassignments','backup'), new lang_string('configgeneralroleassignments','backup'), 1));
269     $temp->add(new admin_setting_configcheckbox('backup/backup_auto_activities', new lang_string('generalactivities','backup'), new lang_string('configgeneralactivities','backup'), 1));
270     $temp->add(new admin_setting_configcheckbox('backup/backup_auto_blocks', new lang_string('generalblocks','backup'), new lang_string('configgeneralblocks','backup'), 1));
271     $temp->add(new admin_setting_configcheckbox('backup/backup_auto_filters', new lang_string('generalfilters','backup'), new lang_string('configgeneralfilters','backup'), 1));
272     $temp->add(new admin_setting_configcheckbox('backup/backup_auto_comments', new lang_string('generalcomments','backup'), new lang_string('configgeneralcomments','backup'), 1));
273     $temp->add(new admin_setting_configcheckbox('backup/backup_auto_badges', new lang_string('generalbadges','backup'), new lang_string('configgeneralbadges','backup'), 1));
274     $temp->add(new admin_setting_configcheckbox('backup/backup_auto_userscompletion', new lang_string('generaluserscompletion','backup'), new lang_string('configgeneraluserscompletion','backup'), 1));
275     $temp->add(new admin_setting_configcheckbox('backup/backup_auto_logs', new lang_string('generallogs', 'backup'), new lang_string('configgenerallogs', 'backup'), 0));
276     $temp->add(new admin_setting_configcheckbox('backup/backup_auto_histories', new lang_string('generalhistories','backup'), new lang_string('configgeneralhistories','backup'), 0));
277     $temp->add(new admin_setting_configcheckbox('backup/backup_auto_questionbank', new lang_string('generalquestionbank','backup'), new lang_string('configgeneralquestionbank','backup'), 1));
278     $temp->add(new admin_setting_configcheckbox('backup/backup_auto_groups', new lang_string('generalgroups', 'backup'),
279             new lang_string('configgeneralgroups', 'backup'), 1));
281     //$temp->add(new admin_setting_configcheckbox('backup/backup_auto_messages', new lang_string('messages', 'message'), new lang_string('backupmessageshelp','message'), 0));
282     //$temp->add(new admin_setting_configcheckbox('backup/backup_auto_blogs', new lang_string('blogs', 'blog'), new lang_string('backupblogshelp','blog'), 0));
284     $ADMIN->add('backups', $temp);