Grid format updated from V405.0.3 to V405.1.0 for Moodle 4.5

Grid format updated from V405.0.3 to V405.1.0 for Moodle 4.5

by Gareth J Barnard -
Number of replies: 0
Picture of Core developers Picture of Particularly helpful Moodlers Picture of Plugin developers

Hello,

I've released an updated 'stable' version of the Grid course format for Moodle 4.5 as follows:

Release 405.1.0 for Moodle 4.5 version 2024100700.00 (Build: 20241007) and above within the MOODLE_405_STABLE branch until the next release:

with:

  1. Remove 'gnumsections' from database if any exist and update Behat tests to use initial 'numsections'.
  2. Add sub-subsection completion with the ability to show / hide at both the section and sub-section level.
  3. Adjust completion percentage font size when 100%.

Two and three give:

Section completion

Which can be disabled in the section settings:

Set the section completion

Important:

Because of 'Subsection support' which has been incredibly difficult to support to the extent that I've had to wave a 'white flag' and remove the 'gnumsections' setting.  The course format API has been broken apart into so many interconnected small pieces (each tending to have separate PHP, JS and Mustache files), https://moodledev.io/docs/4.5/apis/plugintypes/format#format-output-classes-and-templates and https://moodledev.io/docs/4.5/apis/plugintypes/format#the-course-editor-structure, that it is difficult at times to understand and keep in working memory what is going on and where a given element of functionality is implemented to the extent where it can be overridden and changed.  Thus the format will now operate as 'Topics' does in terms of number of sections management.  Tracker issues of interest for this are: MDL-84038, MDL-84291 and MDL-84874.

Because of the removal of 'gnumsections', this has an impact on backup and restore, which I've tested.  However with such a change brings risk and a greater chance of error, thus I cannot stress enough that you MUST test and be sure that the format works as expected before it goes anywhere near a production server.  I found with this format that once 'numsections' was removed that it was tricky to go back, and therefore it would be unlikely even with the flexibility I like of being able to set the number of sections both as a course setting and add / remove in the course itself.

Note: Always install on a test server to confirm that the format does what you want it to do before updating or installing on a production server!  And as this release could contain bugs and so I strongly recommend that you check on a test server first!  Not sure how to set one up?  Then look at the 'Installer packages' on https://download.moodle.org/releases/latest/. Ensure that you have multiple backups of all data before using.  Please report any issues. i.e. 'bugs' with this release ONLY here.  Before doing so please read 'Reporting issues' on the 'Information' tab on the course format 'Settings' under 'Site administration' -> 'Plugins' -> 'Course formats' -> 'Grid'.

If you find this post useful, then please mark it so.

Thank you,

Gareth

Average of ratings:Useful (1)