first commit

blocks/course_list/block_course_list.php

@@ -0,0 +1,203 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle 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 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle 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 Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+/**
+ * Course list block.
+ *
+ * @package    block_course_list
+ * @copyright  1999 onwards Martin Dougiamas (http://dougiamas.com)
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+include_once($CFG->dirroot . '/course/lib.php');
+
+class block_course_list extends block_list {
+    function init() {
+        $this->title = get_string('pluginname', 'block_course_list');
+    }
+
+    function has_config() {
+        return true;
+    }
+
+    function get_content() {
+        global $CFG, $USER, $DB, $OUTPUT;
+
+        if($this->content !== NULL) {
+            return $this->content;
+        }
+
+        $this->content = new stdClass;
+        $this->content->items = array();
+        $this->content->icons = array();
+        $this->content->footer = '';
+
+        $icon = $OUTPUT->pix_icon('i/course', get_string('course'));
+
+        $adminseesall = true;
+        if (isset($CFG->block_course_list_adminview)) {
+           if ( $CFG->block_course_list_adminview == 'own'){
+               $adminseesall = false;
+           }
+        }
+
+        $allcourselink =
+            (has_capability('moodle/course:update', context_system::instance())
+            || empty($CFG->block_course_list_hideallcourseslink)) &&
+            core_course_category::user_top();
+
+        if (empty($CFG->disablemycourses) and isloggedin() and !isguestuser() and
+          !(has_capability('moodle/course:update', context_system::instance()) and $adminseesall)) {    // Just print My Courses
+            if ($courses = enrol_get_my_courses()) {
+                foreach ($courses as $course) {
+                    $coursecontext = context_course::instance($course->id);
+                    $linkcss = $course->visible ? "" : " class=\"dimmed\" ";
+                    $this->content->items[]="<a $linkcss title=\"" . format_string($course->shortname, true, array('context' => $coursecontext)) . "\" ".
+                               "href=\"$CFG->wwwroot/course/view.php?id=$course->id\">".$icon.format_string(get_course_display_name_for_list($course)). "</a>";
+                }
+                $this->title = get_string('mycourses');
+            /// If we can update any course of the view all isn't hidden, show the view all courses link
+                if ($allcourselink) {
+                    $this->content->footer = "<a href=\"$CFG->wwwroot/course/index.php\">".get_string("fulllistofcourses")."</a> ...";
+                }
+            }
+            $this->get_remote_courses();
+            if ($this->content->items) { // make sure we don't return an empty list
+                return $this->content;
+            }
+        }
+
+        // User is not enrolled in any courses, show list of available categories or courses (if there is only one category).
+        $topcategory = core_course_category::top();
+        if ($topcategory->is_uservisible() && ($categories = $topcategory->get_children())) { // Check we have categories.
+            if (count($categories) > 1 || (count($categories) == 1 && $DB->count_records('course') > 200)) {     // Just print top level category links
+                foreach ($categories as $category) {
+                    $categoryname = $category->get_formatted_name();
+                    $linkcss = $category->visible ? "" : " class=\"dimmed\" ";
+                    $this->content->items[]="<a $linkcss href=\"$CFG->wwwroot/course/index.php?categoryid=$category->id\">".$icon . $categoryname . "</a>";
+                }
+            /// If we can update any course of the view all isn't hidden, show the view all courses link
+                if ($allcourselink) {
+                    $this->content->footer .= "<a href=\"$CFG->wwwroot/course/index.php\">".get_string('fulllistofcourses').'</a> ...';
+                }
+                $this->title = get_string('categories');
+            } else {                          // Just print course names of single category
+                $category = array_shift($categories);
+                $courses = $category->get_courses();
+
+                if ($courses) {
+                    foreach ($courses as $course) {
+                        $coursecontext = context_course::instance($course->id);
+                        $linkcss = $course->visible ? "" : " class=\"dimmed\" ";
+
+                        $this->content->items[]="<a $linkcss title=\""
+                                   . s($course->get_formatted_shortname())."\" ".
+                                   "href=\"$CFG->wwwroot/course/view.php?id=$course->id\">"
+                                   .$icon. $course->get_formatted_name() . "</a>";
+                    }
+                /// If we can update any course of the view all isn't hidden, show the view all courses link
+                    if ($allcourselink) {
+                        $this->content->footer .= "<a href=\"$CFG->wwwroot/course/index.php\">".get_string('fulllistofcourses').'</a> ...';
+                    }
+                    $this->get_remote_courses();
+                } else {
+
+                    $this->content->icons[] = '';
+                    $this->content->items[] = get_string('nocoursesyet');
+                    if (has_capability('moodle/course:create', context_coursecat::instance($category->id))) {
+                        $this->content->footer = '<a href="'.$CFG->wwwroot.'/course/edit.php?category='.$category->id.'">'.get_string("addnewcourse").'</a> ...';
+                    }
+                    $this->get_remote_courses();
+                }
+                $this->title = get_string('courses');
+            }
+        }
+
+        return $this->content;
+    }
+
+    function get_remote_courses() {
+        global $CFG, $USER, $OUTPUT;
+
+        if (!is_enabled_auth('mnet')) {
+            // no need to query anything remote related
+            return;
+        }
+
+        $icon = $OUTPUT->pix_icon('i/mnethost', get_string('host', 'mnet'));
+
+        // shortcut - the rest is only for logged in users!
+        if (!isloggedin() || isguestuser()) {
+            return false;
+        }
+
+        if ($courses = get_my_remotecourses()) {
+            $this->content->items[] = get_string('remotecourses','mnet');
+            $this->content->icons[] = '';
+            foreach ($courses as $course) {
+                $this->content->items[]="<a title=\"" . format_string($course->shortname, true) . "\" ".
+                    "href=\"{$CFG->wwwroot}/auth/mnet/jump.php?hostid={$course->hostid}&amp;wantsurl=/course/view.php?id={$course->remoteid}\">"
+                    .$icon. format_string(get_course_display_name_for_list($course)) . "</a>";
+            }
+            // if we listed courses, we are done
+            return true;
+        }
+
+        if ($hosts = get_my_remotehosts()) {
+            $this->content->items[] = get_string('remotehosts', 'mnet');
+            $this->content->icons[] = '';
+            foreach($USER->mnet_foreign_host_array as $somehost) {
+                $this->content->items[] = $somehost['count'].get_string('courseson','mnet').'<a title="'.$somehost['name'].'" href="'.$somehost['url'].'">'.$icon.$somehost['name'].'</a>';
+            }
+            // if we listed hosts, done
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Returns the role that best describes the course list block.
+     *
+     * @return string
+     */
+    public function get_aria_role() {
+        return 'navigation';
+    }
+
+    /**
+     * Return the plugin config settings for external functions.
+     *
+     * @return stdClass the configs for both the block instance and plugin
+     * @since Moodle 3.8
+     */
+    public function get_config_for_external() {
+        global $CFG;
+
+        // Return all settings for all users since it is safe (no private keys, etc..).
+        $configs = (object) [
+            'adminview' => $CFG->block_course_list_adminview,
+            'hideallcourseslink' => $CFG->block_course_list_hideallcourseslink
+        ];
+
+        return (object) [
+            'instance' => new stdClass(),
+            'plugin' => $configs,
+        ];
+    }
+}
+
+

blocks/course_list/classes/privacy/provider.php

@@ -0,0 +1,46 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle 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 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle 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 Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+/**
+ * Privacy Subsystem implementation for block_course_list.
+ *
+ * @package    block_course_list
+ * @copyright  2018 Zig Tan <zig@moodle.com>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+namespace block_course_list\privacy;
+
+defined('MOODLE_INTERNAL') || die();
+
+/**
+ * Privacy Subsystem for block_course_list implementing null_provider.
+ *
+ * @copyright  2018 Zig Tan <zig@moodle.com>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class provider implements \core_privacy\local\metadata\null_provider {
+
+    /**
+     * Get the language string identifier with the component's language
+     * file to explain why this plugin stores no data.
+     *
+     * @return  string
+     */
+    public static function get_reason(): string {
+        return 'privacy:metadata';
+    }
+}

blocks/course_list/db/access.php

@@ -0,0 +1,51 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle 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 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle 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 Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+/**
+ * Course list block caps.
+ *
+ * @package    block_course_list
+ * @copyright  Mark Nelson <markn@moodle.com>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+defined('MOODLE_INTERNAL') || die();
+
+$capabilities = array(
+
+    'block/course_list:myaddinstance' => array(
+        'captype' => 'write',
+        'contextlevel' => CONTEXT_SYSTEM,
+        'archetypes' => array(
+            'user' => CAP_ALLOW
+        ),
+
+        'clonepermissionsfrom' => 'moodle/my:manageblocks'
+    ),
+
+    'block/course_list:addinstance' => array(
+        'riskbitmask' => RISK_SPAM | RISK_XSS,
+
+        'captype' => 'write',
+        'contextlevel' => CONTEXT_BLOCK,
+        'archetypes' => array(
+            'editingteacher' => CAP_ALLOW,
+            'manager' => CAP_ALLOW
+        ),
+
+        'clonepermissionsfrom' => 'moodle/site:manageblocks'
+    ),
+);

blocks/course_list/lang/en/block_course_list.php

@@ -0,0 +1,34 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle 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 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle 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 Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+/**
+ * Strings for component 'block_course_list', language 'en', branch 'MOODLE_20_STABLE'
+ *
+ * @package   block_course_list
+ * @copyright 1999 onwards Martin Dougiamas  {@link http://moodle.com}
+ * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+$string['adminview'] = 'Admin view';
+$string['allcourses'] = 'Admin user sees all courses';
+$string['configadminview'] = 'Whether to display all courses in the Courses block, or only courses that the admin is enrolled in.';
+$string['confighideallcourseslink'] = 'Remove the \'All courses\' link under the list of courses. (This setting does not affect the admin view.)';
+$string['course_list:addinstance'] = 'Add a new courses block';
+$string['course_list:myaddinstance'] = 'Add a new courses block to Dashboard';
+$string['hideallcourseslink'] = 'Hide \'All courses\' link';
+$string['owncourses'] = 'Admin user sees own courses';
+$string['pluginname'] = 'Courses';
+$string['privacy:metadata'] = 'The Courses block only shows data about courses and does not store any data itself.';

blocks/course_list/settings.php

@@ -0,0 +1,37 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle 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 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle 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 Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+/**
+ * Course list block settings
+ *
+ * @package    block_course_list
+ * @copyright  2007 Petr Skoda
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+defined('MOODLE_INTERNAL') || die;
+
+if ($ADMIN->fulltree) {
+    $options = array('all'=>get_string('allcourses', 'block_course_list'), 'own'=>get_string('owncourses', 'block_course_list'));
+
+    $settings->add(new admin_setting_configselect('block_course_list_adminview', get_string('adminview', 'block_course_list'),
+                       get_string('configadminview', 'block_course_list'), 'all', $options));
+
+    $settings->add(new admin_setting_configcheckbox('block_course_list_hideallcourseslink', get_string('hideallcourseslink', 'block_course_list'),
+                       get_string('confighideallcourseslink', 'block_course_list'), 0));
+}
+
+

blocks/course_list/styles.css

@@ -0,0 +1,7 @@
+.block_course_list .footer {
+    margin-top: 5px;
+}
+
+.block_course_list .content li {
+    margin-bottom: .3em;
+}

blocks/course_list/tests/behat/block_course_list_category.feature

@@ -0,0 +1,84 @@
+@block @block_course_list
+Feature: Enable the course_list block on a category page and view it's contents
+  In order to enable the course list block on a category page
+  As an admin
+  I can add the course list block to a category page
+
+  Background:
+    Given the following "categories" exist:
+      | name        | category | idnumber |
+      | Category A  | 0        | CATA     |
+      | Category B  | 0        | CATB     |
+      | Category C  | CATB     | CATC     |
+    And the following "courses" exist:
+      | fullname | shortname | category |
+      | Course 1 | C1        | 0        |
+      | Course 2 | C2        | CATA     |
+      | Course 3 | C3        | CATB     |
+      | Course 4 | C4        | CATC     |
+    And the following "users" exist:
+      | username | firstname | lastname | email                |
+      | teacher1 | Teacher   | First    | teacher1@example.com |
+    And the following "course enrolments" exist:
+      | user | course | role           |
+      | teacher1 | C1 | editingteacher |
+      | teacher1 | C2 | editingteacher |
+      | teacher1 | C3 | editingteacher |
+
+  Scenario: Add the course list block on category page and navigate to the course listing
+    Given I log in as "admin"
+    And I am on site homepage
+    And I turn editing mode on
+    And I am on course index
+    And I follow "Category 1"
+    And the following config values are set as admin:
+      | unaddableblocks | | theme_boost|
+    And I add the "Courses" block
+    And I log out
+    When I log in as "teacher1"
+    And I am on course index
+    And I follow "Category 1"
+    Then I should see "Course 1" in the "My courses" "block"
+    And I should see "Course 2" in the "My courses" "block"
+    And I should see "Course 3" in the "My courses" "block"
+    And I should not see "Course 4" in the "My courses" "block"
+    And I follow "All courses"
+    And I should see "Category 1"
+
+  Scenario: Add the course list block on category page and navigate to another course
+    Given I log in as "admin"
+    And I am on site homepage
+    And I turn editing mode on
+    And I am on course index
+    And I follow "Category 1"
+    And the following config values are set as admin:
+      | unaddableblocks | | theme_boost|
+    And I add the "Courses" block
+    And I log out
+    When I log in as "teacher1"
+    And I am on course index
+    And I follow "Category 1"
+    Then I should see "Course 1" in the "My courses" "block"
+    And I should see "Course 2" in the "My courses" "block"
+    And I should see "Course 3" in the "My courses" "block"
+    And I should not see "Course 4" in the "My courses" "block"
+    And I am on "Course 3" course homepage
+    And I should see "Course 3"
+
+  Scenario: Add the course list block on category page and view as an admin
+    Given I log in as "admin"
+    And I am on site homepage
+    And I turn editing mode on
+    And I am on course index
+    And I follow "Category 1"
+    And the following config values are set as admin:
+      | unaddableblocks | | theme_boost|
+    When I add the "Courses" block
+    Then I should see "Category 1" in the "Course categories" "block"
+    And I should see "Category A" in the "Course categories" "block"
+    And I should see "Category B" in the "Course categories" "block"
+    And I should not see "Category C" in the "Course categories" "block"
+    And I should not see "Course 1" in the "Course categories" "block"
+    And I should not see "Course 2" in the "Course categories" "block"
+    And I follow "All courses"
+    And I should see "Category 1"

blocks/course_list/tests/behat/block_course_list_course.feature

@@ -0,0 +1,95 @@
+@block @block_course_list
+Feature: Enable the course_list block on a course page and view it's contents
+  In order to enable the course list block on an course page
+  As a teacher
+  I can add the course list block to a course page
+
+  Background:
+    Given the following "categories" exist:
+      | name        | category | idnumber |
+      | Category A  | 0        | CATA     |
+      | Category B  | 0        | CATB     |
+      | Category C  | CATB     | CATC     |
+    And the following "courses" exist:
+      | fullname | shortname | category |
+      | Course 1 | C1        | 0        |
+      | Course 2 | C2        | CATA     |
+      | Course 3 | C3        | CATB     |
+      | Course 4 | C4        | CATC     |
+    And the following "users" exist:
+      | username | firstname | lastname | email                |
+      | teacher1 | Teacher   | First    | teacher1@example.com |
+    And the following "course enrolments" exist:
+      | user | course | role           |
+      | teacher1 | C1 | editingteacher |
+      | teacher1 | C2 | editingteacher |
+      | teacher1 | C3 | editingteacher |
+
+  Scenario: Add the course list block on course page and navigate to the course listing
+    Given I log in as "teacher1"
+    And I am on "Course 1" course homepage with editing mode on
+    And the following config values are set as admin:
+      | unaddableblocks | | theme_boost|
+    When I add the "Courses" block
+    Then I should see "Course 1" in the "My courses" "block"
+    And I should see "Course 2" in the "My courses" "block"
+    And I should see "Course 3" in the "My courses" "block"
+    And I should not see "Course 4" in the "My courses" "block"
+    And I follow "All courses"
+    And I should see "Category 1"
+
+  Scenario: Add the course list block on course page and navigate to another course
+    Given I log in as "teacher1"
+    And I am on "Course 1" course homepage with editing mode on
+    And the following config values are set as admin:
+      | unaddableblocks | | theme_boost|
+    When I add the "Courses" block
+    Then I should see "Course 1" in the "My courses" "block"
+    And I should see "Course 2" in the "My courses" "block"
+    And I should see "Course 3" in the "My courses" "block"
+    And I should not see "Course 4" in the "My courses" "block"
+    And I am on "Course 3" course homepage
+    And I should see "Course 3"
+
+  Scenario: Add the course list block on course page and view as an admin
+    Given I log in as "admin"
+    And I am on "Course 1" course homepage with editing mode on
+    And the following config values are set as admin:
+      | unaddableblocks | | theme_boost|
+    When I add the "Courses" block
+    Then I should see "Category 1" in the "Course categories" "block"
+    And I should see "Category A" in the "Course categories" "block"
+    And I should see "Category B" in the "Course categories" "block"
+    And I should not see "Category C" in the "Course categories" "block"
+    And I should not see "Course 1" in the "Course categories" "block"
+    And I should not see "Course 2" in the "Course categories" "block"
+    And I follow "All courses"
+    And I should see "Category 1"
+
+  Scenario: View the course list block on course page with hide all courses link enabled
+    Given the following config values are set as admin:
+      | block_course_list_hideallcourseslink | 1 |            |
+      | unaddableblocks                      |   | theme_boost|
+    And I log in as "teacher1"
+    And I am on "Course 1" course homepage with editing mode on
+    When I add the "Courses" block
+    Then I should not see "All courses" in the "My courses" "block"
+
+  Scenario: View the course list block on course page with admin sees own course enabled
+    Given the following config values are set as admin:
+      | block_course_list_adminview | own |            |
+      | unaddableblocks             |     | theme_boost|
+    And the following "course enrolments" exist:
+      | user | course | role           |
+      | admin | C1 | editingteacher |
+    And I log in as "admin"
+    And I am on "Course 1" course homepage with editing mode on
+    When I add the "Courses" block
+    Then I should not see "Category 1" in the "My courses" "block"
+    And I should not see "Category A" in the "My courses" "block"
+    And I should not see "Category B" in the "My courses" "block"
+    And I should not see "Category C" in the "My courses" "block"
+    And I should see "Course 1" in the "My courses" "block"
+    And I should not see "Course 2" in the "My courses" "block"
+    And I follow "All courses"
+    And I should see "Category 1"

blocks/course_list/tests/behat/block_course_list_dashboard.feature

@@ -0,0 +1,67 @@
+@block @block_course_list
+Feature: Enable the course_list block on the dashboard and view it's contents
+  In order to enable the course list block on the dashboard
+  As a user
+  I can add the course list block to the dashboard
+
+  Background:
+    Given the following "categories" exist:
+      | name        | category | idnumber |
+      | Category A  | 0        | CATA     |
+      | Category B  | 0        | CATB     |
+      | Category C  | CATB     | CATC     |
+    And the following "courses" exist:
+      | fullname | shortname | category |
+      | Course 1 | C1        | 0        |
+      | Course 2 | C2        | CATA     |
+      | Course 3 | C3        | CATB     |
+      | Course 4 | C4        | CATC     |
+    And the following "users" exist:
+      | username | firstname | lastname | email                |
+      | teacher1 | Teacher   | First    | teacher1@example.com |
+    And the following "course enrolments" exist:
+      | user | course | role           |
+      | teacher1 | C1 | editingteacher |
+      | teacher1 | C2 | editingteacher |
+      | teacher1 | C3 | editingteacher |
+
+  Scenario: Add the course list block on the dashboard and navigate to the course listing
+    Given I log in as "teacher1"
+    And I turn editing mode on
+    And the following config values are set as admin:
+      | unaddableblocks | | theme_boost|
+    When I add the "Courses" block
+    Then I should see "Course 1" in the "My courses" "block"
+    And I should see "Course 2" in the "My courses" "block"
+    And I should see "Course 3" in the "My courses" "block"
+    And I should not see "Course 4" in the "My courses" "block"
+    And I follow "All courses"
+    And I should see "Category 1"
+
+  Scenario: Add the course list block on the dashboard and navigate to another course
+    Given I log in as "teacher1"
+    And I turn editing mode on
+    And the following config values are set as admin:
+      | unaddableblocks | | theme_boost|
+    When I add the "Courses" block
+    Then I should see "Course 1" in the "My courses" "block"
+    And I should see "Course 2" in the "My courses" "block"
+    And I should see "Course 3" in the "My courses" "block"
+    And I should not see "Course 4" in the "My courses" "block"
+    And I am on "Course 3" course homepage
+    And I should see "Course 3"
+
+  Scenario: Add the course list block on the dashboard and view as an admin
+    Given I log in as "admin"
+    And I turn editing mode on
+    And the following config values are set as admin:
+      | unaddableblocks | | theme_boost|
+    When I add the "Courses" block
+    Then I should see "Category 1" in the "Course categories" "block"
+    And I should see "Category A" in the "Course categories" "block"
+    And I should see "Category B" in the "Course categories" "block"
+    And I should not see "Category C" in the "Course categories" "block"
+    And I should not see "Course 1" in the "Course categories" "block"
+    And I should not see "Course 2" in the "Course categories" "block"
+    And I follow "All courses"
+    And I should see "Category 1"

blocks/course_list/tests/behat/block_course_list_frontpage.feature

@@ -0,0 +1,94 @@
+@block @block_course_list
+Feature: Enable the course_list block on the frontpage and view it's contents
+  In order to enable the course list block on the frontpage
+  As an admin
+  I can add the course list block to the frontpage
+
+  Background:
+    Given the following "categories" exist:
+      | name        | category | idnumber |
+      | Category A  | 0        | CATA     |
+      | Category B  | 0        | CATB     |
+      | Category C  | CATB     | CATC     |
+    And the following "courses" exist:
+      | fullname | shortname | category |
+      | Course 1 | C1        | 0        |
+      | Course 2 | C2        | CATA     |
+      | Course 3 | C3        | CATB     |
+      | Course 4 | C4        | CATC     |
+    And the following "users" exist:
+      | username | firstname | lastname | email                |
+      | teacher1 | Teacher   | First    | teacher1@example.com |
+    And the following "course enrolments" exist:
+      | user | course | role           |
+      | teacher1 | C1 | editingteacher |
+      | teacher1 | C2 | editingteacher |
+      | teacher1 | C3 | editingteacher |
+
+  Scenario: Add the course list block on the frontpage and navigate to the course listing
+    Given I log in as "admin"
+    And I am on site homepage
+    And I turn editing mode on
+    And the following config values are set as admin:
+      | unaddableblocks | | theme_boost|
+    And I add the "Courses" block
+    And I log out
+    When I log in as "teacher1"
+    And I am on site homepage
+    Then I should see "Course 1" in the "My courses" "block"
+    And I should see "Course 2" in the "My courses" "block"
+    And I should see "Course 3" in the "My courses" "block"
+    And I should not see "Course 4" in the "My courses" "block"
+    And I follow "All courses"
+    And I should see "Category 1"
+
+  Scenario: Add the course list block on the frontpage page and navigate to another course
+    Given I log in as "admin"
+    And I am on site homepage
+    And I turn editing mode on
+    And the following config values are set as admin:
+      | unaddableblocks | | theme_boost|
+    And I add the "Courses" block
+    And I log out
+    When I log in as "teacher1"
+    And I am on site homepage
+    Then I should see "Course 1" in the "My courses" "block"
+    And I should see "Course 2" in the "My courses" "block"
+    And I should see "Course 3" in the "My courses" "block"
+    And I should not see "Course 4" in the "My courses" "block"
+    And I am on "Course 3" course homepage
+    And I should see "Course 3"
+
+  Scenario: Add the course list block on the frontpage page and view as an admin
+    Given I log in as "admin"
+    And I am on site homepage
+    And I turn editing mode on
+    And the following config values are set as admin:
+      | unaddableblocks | | theme_boost|
+    When I add the "Courses" block
+    Then I should see "Category 1" in the "Course categories" "block"
+    And I should see "Category A" in the "Course categories" "block"
+    And I should see "Category B" in the "Course categories" "block"
+    And I should not see "Category C" in the "Course categories" "block"
+    And I should not see "Course 1" in the "Course categories" "block"
+    And I should not see "Course 2" in the "Course categories" "block"
+    And I follow "All courses"
+    And I should see "Category 1"
+
+  Scenario: Add the course list block on the frontpage page and view as a guest
+    Given I log in as "admin"
+    And I am on site homepage
+    And I turn editing mode on
+    And the following config values are set as admin:
+      | unaddableblocks | | theme_boost|
+    And I add the "Courses" block
+    And I log out
+    When I log in as "guest"
+    Then I should see "Category 1" in the "Course categories" "block"
+    And I should see "Category A" in the "Course categories" "block"
+    And I should see "Category B" in the "Course categories" "block"
+    And I should not see "Category C" in the "Course categories" "block"
+    And I should not see "Course 1" in the "Course categories" "block"
+    And I should not see "Course 2" in the "Course categories" "block"
+    And I follow "All courses"
+    And I should see "Category 1"

blocks/course_list/version.php

@@ -0,0 +1,29 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle 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 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle 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 Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+/**
+ * Version details
+ *
+ * @package    block_course_list
+ * @copyright  1999 onwards Martin Dougiamas (http://dougiamas.com)
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+defined('MOODLE_INTERNAL') || die();
+
+$plugin->version   = 2024042200;        // The current plugin version (Date: YYYYMMDDXX).
+$plugin->requires  = 2024041600;        // Requires this Moodle version.
+$plugin->component = 'block_course_list'; // Full name of the plugin (used for diagnostics)