Semester overview

Blocks ::: block_semester_sortierung
Maintained by AMC Academic Moodle Cooperation
In the semsort block (blocks/semester_sortierung), courses are grouped by their starting dates in a semester view on the MyMoodle page.

Semester overview v3.6.1

Moodle 3.6
Released: Saturday, May 18, 2019, 9:40 PM

semester_sortierung Block

This file is part of the block_semester_sortierung plugin for Moodle - http://moodle.org/

Author: Simeon Naydenov, Katarzyna Potocka

Copyright: 2018 Academic Moodle Cooperation

License: GNU GPL v3 or later

Description

In the semester_sortierung block courses are grouped by their starting dates in a semester view on the MyMoodle page.

The semester_sortierung block also displays all MyMoodle information regarding the course activities of the individual courses.

The module will also feature a "My favourites" area, for which courses from different semesters can be selected and they will then be listed at the top of the favourites area.

Example

Use the semester_sortierung module to display the winter and summer semesters with all your courses, and the favourites area for quick access.

Requirements

The plugin is available for Moodle 2.5+. This version is for Moodle 3.6.

Installation

  • Copy the module code directly to the blocks/semester_sortierung directory.

  • Log into Moodle as administrator.

  • Open the administration area (http://your-moodle-site/admin) to start the installation automatically.

Admin Settings

As an administrator you can set the default values instance-wide on the settings page for administrators in the semester_sortierung block:

  • Sort courses by semesters (checkbox) - controls whether courses are sorted at all
  • Winter semester months (checkbox) - select which months should apply for the winter semester
  • Show favourites (checkbox) - controls whether favourites on
  • Archive (number) - group semesters that are older than the specified value
  • Autocollapse courses (number) - always show courses older than the specified number of months as collapse (only if there are performance issues)
  • Skip older events (number) - don't load events older than the specified number of months (only if there are performance issues)

Privacy API

The semester_sortierung block fully implements the Moodle Privacy API.

Web Service

The semester_sortierung block provides the following web service functions.

  • Authentication - via token

    Token can be obtained in two ways:

    • manually from Moodle at $CFG->wwwroot/admin/settings.php?section=webservicetokens
    • by calling $CFG->wwwroot/login/token.php?username=USERNAME&password=PASSWORD&service=SERVICENAME (here SERVICENAME is semester_sortierung Web service)
  • Requests

    Get courses - get all enrolled and active courses for a student

    • URL: $CFG->wwwroot/webservice/rest/server.php?moodlewsrestformat=json&wsfunction=block_semester_sortierung_get_courses&wstoken={token}&userid={userid}
    • Method: GET
    • Produces: application/json
    • Sample output: [ {"coursename": "COURSE NAME", "semestercode": "2016S", "description": "COURSE DESCRIPTION", "coursenumber": "015709-2016S", "courseid": 1234567} ]

    Get course details - get the course metadata

    • URL: $CFG->wwwroot/webservice/rest/server.php?moodlewsrestformat=json&wsfunction=block_semester_sortierung_get_modules&wstoken={token}&userid={userid}&courseid={courseid}
    • Method: GET
    • Produces: application/json
    • Sample output: [ {"modname": "MODULE_NAME", "modinfo": "HTML_INFORMATION"} ]

    Get modules - get all active modules

    • URL: $CFG->wwwroot/webservice/rest/server.php?moodlewsrestformat=json&wsfunction=block_semester_sortierung_get_modules&wstoken={token}
    • Method: GET
    • Produces: application/json
    • Image format: base64 png
    • Sample output: [ {"modname": "MODULE NAME - UNIQUE ID", "title_en": "Module title in English", "title_de": "Module title in German", "image": "base64EncodedImage"} ]

Bug Reports / Support

We try our best to deliver bug-free plugins, but we can not test the plugin for every platform, database, PHP and Moodle version. If you find any bug please report it on GitHub. Please provide a detailed bug description, including the plugin and Moodle version and, if applicable, a screenshot.

You may also file a request for enhancement on GitHub. If we consider the request generally useful and if it can be implemented with reasonable effort we might implement it in a future version.

You may also post general questions on the plugin on GitHub, but note that we do not have the resources to provide detailed support.

License

This plugin 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.

The plugin 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 with Moodle. If not, see http://www.gnu.org/licenses/.

Good luck and have fun!

Version information

Version build number
2018121001
Version release name
v3.6.1
Can be updated from
v3.5.0 (2018050800), v3.6.0
Can be updated to
v3.7.0, v3.7.1 (2019052001)
Maturity
Stable version
MD5 Sum
7354aa009a9d15a9e18a838ad1763ab0
Supported software
Moodle 3.6
  • Latest release for Moodle 3.6

Version control information

Version control system (VCS)
GIT
VCS repository URL
VCS branch
MOODLE_36_STABLE
VCS tag
v3.6.1

Default installation instructions for plugins of the type Blocks

  1. Make sure you have all the required versions.
  2. Download and unpack the block folder.
  3. Place the folder (eg "myblock") in the "blocks" subdirectory.
  4. Visit http://yoursite.com/admin to complete the installation
  5. Turn editing on in any home or course page.
  6. Add the block to the page
  7. Visit the config link in the block for more options.