Merge branch 'main' into css_snippets

Author: Menrath

CHANGES.md

@@ -4,6 +4,12 @@ moodle-theme_boost_union
 Changes
 -------
 
+### Unreleased
+
+* 2025-02-22 - Feature: Add some styling to the category listings on site home and on the category index pages, resolves #840.
+* 2025-02-16 - Feature: Show the course listing on site home and on the category index pages as (proper) list, resolves #573.
+* 2025-02-07 - Feature: Show the course listing on site home and on the category index pages as cards, resolves #558.
+
 ### v4.5-r8
 
 * 2025-02-17 - Bugfix: Remove the possibility to set the activity purpose for subsections to avoid that activities within subsections get tinted with the wrong color, resolves #823.

README.md

@@ -225,6 +225,16 @@ With this setting, you can control whether the course image is visible inside th
 
 With this setting, you can control whether the course completion progress is visible inside the course overview block or not.
 
+#### Tab "Category index / Site home"
+
+##### Course listing
+
+In this section, you can modify the look & feel of the course listing on the category index pages and on site home. As an alternative to the way how Moodle core presents them, you can present the course listing as course cards (similar to the course cards on the 'My courses' page) or course list  (similar to the course list on the 'My courses' page). And, of course, you can configure the look of the course cards or rows with multiple dependent settings.
+
+##### Category listing
+
+With this setting, you can modify the look & feel of the category listing on the category index pages and on site home. As an alternative to the way how Moodle core presents them, you can present the category listing as a refreshed list of boxes.
+
 #### Tab "Blocks"
 
 ##### Timeline block
@@ -905,6 +915,7 @@ This theme is a collaboration result of multiple organisations.
 Moodle an Hochschulen e.V. would like to thank these main contributors (in alphabetical order of the institutions) for their work:
 
 * Academic Moodle Cooperation (AMC): Ideating, Code
+* Adapta, Daniel Neis Araujo: Code
 * Baden-Württemberg Cooperative State University (DHBW), Katja Neubehler: Code
 * bdecent GmbH, Stefan Scholz: Code, Ideating, Funding
 * Bern University of Applied Sciences (BFH), Luca Bösch: Code, Peer Review, Ideating

amd/build/courselistingdetailsmodal.min.js

@@ -0,0 +1,82 @@
+// 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/>.
+
+/**
+ * Theme Boost Union - JS code for course listing details modal.
+ *
+ * @module     theme_boost_union/courselistingdetailsmodal
+ * @copyright  2025 Alexander Bias, ssystems GmbH <[email protected]>
+ *             based on core_admin/themeselector/preview_modal by David Woloszyn <[email protected]>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+import ModalCancel from 'core/modal_cancel';
+import Notification from 'core/notification';
+import Templates from 'core/templates';
+import {getString} from 'core/str';
+
+const SELECTORS = {
+    DETAILS: '[data-action="courselisting-details"]',
+};
+
+/**
+ * Entrypoint of the js.
+ *
+ * @method init
+ */
+export const init = () => {
+    registerListenerEvents();
+};
+
+/**
+ * Register snippet related event listeners.
+ *
+ * @method registerListenerEvents
+ */
+const registerListenerEvents = () => {
+    document.addEventListener('click', (e) => {
+        const details = e.target.closest(SELECTORS.DETAILS);
+        if (details) {
+            buildModal(details).catch(Notification.exception);
+        }
+    });
+};
+
+/**
+ * Build the modal with the provided data.
+ *
+ * @method buildModal
+ * @param {object} element
+ */
+const buildModal = async(element) => {
+
+    // Prepare data for modal.
+    const data = {
+        title: element.getAttribute('data-title'),
+        summary: element.getAttribute('data-summary'),
+        coursecontacts: element.getAttribute('data-coursecontacts'),
+        customfields: element.getAttribute('data-customfields'),
+    };
+
+    await ModalCancel.create({
+        title: data.title,
+        body: Templates.render('theme_boost_union/courselistingdetailsmodal', data),
+        large: true,
+        buttons: {
+            'cancel': getString('closebuttontitle', 'moodle'),
+        },
+        show: true,
+    });
+};