diff --git a/Changes.md b/Changes.md index 10569502..2ded78cc 100644 --- a/Changes.md +++ b/Changes.md @@ -8,6 +8,7 @@ Version 402.2.4 - In development 3. Use section anchors in links when editing. 4. Add badges to grid - #215. 5. Adjust section titles in grid and move 'title' attribute to cover whole grid box. +6. Add 'sectionzeroingrid' course and 'defaultsectionzeroingrid' site settings to state if section zero should be in the grid. Version 402.2.3 - 08/04/2024 ---------------------------- diff --git a/classes/output/courseformat/content.php b/classes/output/courseformat/content.php index 53744b3b..60de7ff6 100644 --- a/classes/output/courseformat/content.php +++ b/classes/output/courseformat/content.php @@ -89,13 +89,15 @@ public function export_for_template(\renderer_base $output) { $initialsection = ''; $course = $format->get_course(); $currentsectionid = 0; + $coursesettings = $format->get_settings(); + $sectionzeronotingrid = ($coursesettings['sectionzeroingrid'] == 1); if (!empty($sections)) { // Is first entry section 0? if ($sections[0]->num === 0) { - // Most formats uses section 0 as a separate section so we remove from the list. - $initialsection = array_shift($sections); - if (!$singlesection) { + if ((!$singlesectionid) && ($sectionzeronotingrid)) { + // Most formats uses section 0 as a separate section so we remove from the list. + $initialsection = array_shift($sections); $data->initialsection = $initialsection; } } @@ -124,7 +126,6 @@ public function export_for_template(\renderer_base $output) { $data->sectionreturn = $singlesection; $data->maincoursepage = new \moodle_url('/course/view.php', ['id' => $course->id]); } else { - $coursesettings = $format->get_settings(); $toolbox = \format_grid\toolbox::get_instance(); $coursesectionimages = $DB->get_records('format_grid_image', ['courseid' => $course->id]); if (!empty($coursesectionimages)) { @@ -336,9 +337,13 @@ protected function get_grid_sections(\renderer_base $output, $settings): array { $sections = []; $numsections = $format->get_last_section_number(); $sectioninfos = $modinfo->get_section_info_all(); - // Get rid of section 0. - if (!empty($sectioninfos)) { - array_shift($sectioninfos); + $coursesettings = $format->get_settings(); + $sectionzeronotingrid = ($coursesettings['sectionzeroingrid'] == 1); + if ($sectionzeronotingrid) { + // Get rid of section 0. + if (!empty($sectioninfos)) { + array_shift($sectioninfos); + } } foreach ($sectioninfos as $thissection) { // The course/view.php check the section existence but the output can be called from other parts so we need to check it. diff --git a/lang/en/format_grid.php b/lang/en/format_grid.php index e060ff0f..41f1ee02 100644 --- a/lang/en/format_grid.php +++ b/lang/en/format_grid.php @@ -127,6 +127,12 @@ $string['defaultpopup'] = 'Use a popup'; $string['defaultpopup_desc'] = 'Display the section in a popup instead of navigating to a single section page.'; +// Section zero. +$string['sectionzeroingrid'] = 'Section zero in grid'; +$string['sectionzeroingrid_help'] = 'Place section zero in the grid'; +$string['defaultsectionzeroingrid'] = 'Section zero in grid'; +$string['defaultsectionzeroingrid_desc'] = 'Place section zero in the grid.'; + // Completion. $string['showcompletion'] = 'Show completion'; $string['showcompletion_help'] = 'Show the completion of the section on the grid'; diff --git a/lib.php b/lib.php index ea03b1ce..4106272d 100755 --- a/lib.php +++ b/lib.php @@ -422,6 +422,10 @@ public function course_format_options($foreditform = false) { 'default' => 0, 'type' => PARAM_INT, ], + 'sectionzeroingrid' => [ + 'default' => 0, + 'type' => PARAM_INT, + ], 'showcompletion' => [ 'default' => 0, 'type' => PARAM_INT, @@ -536,6 +540,22 @@ public function course_format_options($foreditform = false) { 'element_attributes' => [$imageresizemethodvalues], ]; + $sectionzeroingridvalues = $this->generate_default_entry( + 'sectionzeroingrid', + 0, + [ + 1 => new lang_string('no'), + 2 => new lang_string('yes'), + ], + ); + $courseformatoptionsedit['sectionzeroingrid'] = [ + 'label' => new lang_string('sectionzeroingrid', 'format_grid'), + 'help' => 'sectionzeroingrid', + 'help_component' => 'format_grid', + 'element_type' => 'select', + 'element_attributes' => [$sectionzeroingridvalues], + ]; + $showcompletionvalues = $this->generate_default_entry( 'showcompletion', 0, diff --git a/settings.php b/settings.php index 06574149..5782fcfd 100644 --- a/settings.php +++ b/settings.php @@ -147,6 +147,17 @@ $setting->set_updatedcallback('format_grid::update_displayed_images_callback'); $page->add($setting); + // Section zero in grid. + $name = 'format_grid/defaultsectionzeroingrid'; + $title = get_string('defaultsectionzeroingrid', 'format_grid'); + $description = get_string('defaultsectionzeroingrid_desc', 'format_grid'); + $default = 1; + $choices = [ + 1 => new lang_string('no'), + 2 => new lang_string('yes'), + ]; + $page->add(new admin_setting_configselect($name, $title, $description, $default, $choices)); + // Completion. $name = 'format_grid/defaultshowcompletion'; $title = get_string('defaultshowcompletion', 'format_grid');