Advanced assessment reporting for the Moodle LMS.
The following maps the plugin version to use depending on your Moodle version.
| Moodle version | Branch |
|---|---|
| Moodle 3.5 to 3.8 | MOODLE_35 |
| Moodle 3.9 | MOODLE_39 |
| Moodle 3.10 | MOODLE_310 |
| Moodle 3.11 | MOODLE_311_STABLE |
| Moodle 4.0 to 4.1 | MOODLE_400_STABLE |
| Moodle 4.2 | MOODLE_402_STABLE |
| Moodle 4.3 and higher | MOODLE_403_STABLE |
The following steps will help you install this plugin into your Moodle instance.
- Clone or copy the code for this repository into your Moodle installation at the following location:
<moodledir>/local/assessfreq - Make sure you have checked-out the correct version of the code, e.g. for Moodle version 3.10:
git checkout MOODLE_39 - Run the upgrade:
sudo -u www-data php admin/cli/upgradeNote: the user may be different to www-data on your system.
Once the plugin is installed, next the Moodle setup needs to be performed.
Note: It is recommended that installation be completed via the command line instead of the Moodle user interface.
TODO: this
2020 Matt Porritt [email protected]
This program 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.
This program 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 this program. If not, see http://www.gnu.org/licenses/.
Post version 2024040300 this plugin was completely refactored to support more reports and modules.
Each report is now a subplugin within the report directory
The subplugins report class should extend from the \local_assessfreq\report_base class
Capability checks were reworked to be relative to the location that they are being loading from. The initial version has the following capabilities:
- local/assessfreq:view
- assessfreqreport/activity_dashboard:view
- assessfreqreport/activities_in_progress:view
- assessfreqreport/heatmap:view
- assessfreqreport/summary_graphs:view
however each future subplugin can define their own access checks by using the abstract has_access method.
Accessing the reports from a course (link now added to the course report screen) will do the capability check at the
course context level, otherwise system level will be used.
The reports themselves should also be restricted based on the $PAGE->course if it is not the SITEID as this is set during the intial load of the index.php file.
Each module is now a subplugin within the source directory
The subplugins source class should extend from the \local_assessfreq\source_base class
Along with general performance improvements additional settings have been added to reduce the load on the reports:
- Assign and quiz sources have a setting called "windowexclusion" which will allow the admin to specify a length of time to exclude long running assessments
- The activity dashboard has "trendlimit" and "trendcount" settings to reduce the number of trend records it attempts to load
- User tables have been update to only return users that have attempt data