Skip to content

iTBH/moodle-block_occompletionprogress

Repository files navigation

Moodle Block Course Completion Progress by Section (occompletionprogress)

German version below | Deutsche Version unten

Course Completion Progress (occompletionprogress) is a block plugin for Moodle that provides learners with an overview of their course progress based on course sections. Instructors receive an overview of the course progress of all learners.

The basis of the progress display in the progress bar are the course sections. This differentiates the plugin from the Moodle plugin Completion Progress, which is based on activities. Due to the section-wise display, Course Completion Progress (occompletionprogress) is particularly suitable for extensive courses with many activities.

This version of the plugin has been tested with Moodle 4.5 (LTS). Further development is currently not ongoing. An adaptation for Moodle 5.3 (LTS), if necessary, is planned.

Features

  • Displays course progress based on completed course sections: The bar element for a section is shown as completed when all activities in the section are completed.

    Compactv view of progress bar without section details

  • On mouseover, the bar elements each show all activities of the corresponding section as well as their completion status.

    View of progress bar with section details

  • The colors for the individual states (completed, uncompleted, none) are configurable.

  • The course progress of all course participants is summarized on a separate overview page (Teacher).

Installation

  1. Clone the repository into the /block/occompletionprogress directory of the Moodle installation.
  2. Open Site administration → Notifications to start the installation or run admin/cli/upgrade.php.

Requirements

  • None, not dependent on other plugins

Configuration

After installation, the plugin can be configured as follows:
Site administration → Plugins → Blocks → Course Completion Progress

Settings:

  • completedcolor: Color for completed sections
  • uncompletedcolor: Color for uncompleted sections
  • notrackingcolor: Color for sections without activities with completion tracking
  • showinactive: Show inactive learners in the overview
  • showlastincourse: Show learners’ last course access in the overview

Usage

  1. Navigate to a Moodle course.
  2. Add the block "Course Completion Progress".

Permissions

This plugin defines the following capabilities:

Capability name Description Default
block/occompletionprogress:addinstance Allows the user to add the plugin block editingteacher, teacher, manager
block/occompletionprogress:overview Allows the user to view the overview page editingteacher, teacher, manager

Cron jobs

This plugin does not define any cron jobs.

Web Services

This plugin does not provide any web service functions.

License

This plugin is licensed under the GNU General Public License v3.0.

Credits

Author: Markus Strehling (markus.strehling@oncampus.de)

Inspired by / thanks to: (Completion Progress), Jonathon Fowler

The plugin was developed in 2024/2025 as part of the project SDG Campus / Open T-Shape for Sustainable Development, funded by the Stiftung Innovation in der Hochschullehre.

German | Deutsch

Course Completion Progress (occompletionprogress) ist ein Block-Plugin für Moodle, welches Lernenden eine Übersicht über ihren Kursfortschritt auf Basis der Kursabschnitte gibt. Lehrende erhalten eine Übersicht über den Kurs-Fortschritt aller Lernenden.

Grundlage der Fortschrittsanzeige im Fortschrittsbalken sind die Kursabschnitte. Dadurch unterscheidet sich das Plugin vom Moodle-Plugin Completion Progress, dessen Anzeige auf den Aktivitäten basiert. Durch die abschnittsweise Darstellung ist Course Completion Progress (occompletionprogress) besonders gut für umfangreiche Kurse mit vielen Aktivitäten geeignet.

Diese Version des Plugins wurde mit Moodle 4.5 (LTS) getestet. Eine Weiterentwicklung findet im Moment nicht statt. Für Moodle 5.3 (LTS) ist eine Anpassung, falls erforderlich, geplant.

Features

  • Stellt den Kursfortschritt auf Basis erledigter Kursabschnitte dar: Das Balkenelement für einen Abschnitt wird als erledigt angezeigt, wenn alle Aktivitäten des Abschnitts erledigt wurden.

    Compactv view of progress bar without section details

  • Bei Mouseover zeigen die Balkenelemente jeweils alle Aktivitäten des zugehörigen Abschnitts sowie deren Bearbeitungsstand an.

    View of progress bar with section details

  • Die Farben der einzelnen Zustände (abgeschlossen, unvollendet, kein) sind konfigurierbar

  • Der Kursfortschritt aller Kursteilnehmenden wird auf einer separaten Übersichtsseite zusammengefasst (Teacher-Rolle)

Installation

  1. Clone das Repository in das /block/occompletionprogress-Verzeichnis der Moodle-Installation.
  2. Ruf' Website-Administration → Systemnachrichten auf, um die Installation anzustoßen oder führe admin/cli/upgrade.php aus.

Voraussetzungen

  • Keine, nicht abhängig von anderen Plugins

Konfiguration

Nach Installation kann das Plugin auf folgenden Weg konfiguriert werden:
Website-Administration → Plugins → Blöcke → Kurs-Fortschrittsbalken

Einstellungen:

  • completedcolor: Farbe für abgeschlossene Abschnitte
  • uncompletedcolor: Farbe für unvollendete Abschnitte
  • notrackingcolor: Farbe für Abschnitte ohne Aktivitäten mit Abschlussverfolgung
  • showinactive: Inaktive Lernende in der Übersicht anzeigen
  • showlastincourse: Letzter Kurszugriff der Lernenden in der Übersicht anzeigen

Nutzung

  1. Navigiere in einen Moodlekurs.
  2. Füge den Block "Kurs-Fortschrittsbalken" hinzu

Rechte

Dieses Plugin definiert folgende Rechte:

Name des Rechts Beschreibung Standardrolle
block/occompletionprogress:addinstance Erlaubt es dem Nutzer, die Pluginseite aufzurufen editingteacher, teacher, manager
block/occompletionprogress:overview Erlaubt es dem Nutzer, die Übersichtseite anzuzeigen editingteacher, teacher, manager

Cronjobs

Dieses Plugin definiert keine Cronjobs.

Web Services

Dieses Plugin stellt keine Webservice-Funktionen zur Verfügung.

Lizenz

Dieses Plugin ist lizensiert unter GNU General Public License v3.0.

Credits

Autor: Markus Strehling (markus.strehling@oncampus.de)

Inspired by / thanks to: (Completion Progress), Jonathon Fowler

Das Plugin wurde 2024/2025 im Rahmen des Projekts SDG Campus/Open T-Shape for Sustainable Development entwickelt, das von der Stiftung Innovation in der Hochschulelehre gefördert wird.

About

Moodle-Plugin to track progress in a course by section

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors