Lock Grades (local_lockgrades)

Description

local_lockgrades is a Moodle plugin that allows administrators to recursively lock or unlock a grade category (grade items) along with all its subcategories and associated items, using an idnumber field as the identifier. Additionally, you can optionally filter which courses to affect by specifying a substring that must appear in the course shortname.

Features

• Recursive locking: Lock a parent category and all its subcategories, updating the locked, timemodified, and locktime fields in the mdl_grade_items table.


• Recursive unlocking: Unlock the same items by resetting locked and locktime to 0 while preserving the modification timestamp (timemodified).


• Course filtering: Optionally enter a pattern to only (un)lock grades in courses whose shortname contains that pattern.


• Action scheduling: New! Schedule locking or unlocking actions for a specific date and time. The task will be executed automatically by Moodle's cron.


• Task overview and management: New! See a table of all scheduled (pending) lock/unlock actions, with execution time and action type. Each scheduled task can be modified, duplicated or deleted from the interface before execution.


• Previsualization ("dry-run"): New! Preview the list of courses that would be affected by a lock/unlock action before applying or scheduling it.


• Ancestral lock inheritance: New! Automatically applies locking rules to any newly created or updated grade item or category when at least one ancestor category is already locked. Ensures that inheritance-based locks propagate through deep category hierarchies without manual intervention.


• Unlock constraints: You cannot unlock a subcategory if any of its ancestor categories remain locked; to unlock a subcategory, all its parent categories must first be unlocked.


• Simple interface**: An admin form lets you enter the category idnumber, an optional course shortname filter, select the date and time for scheduling, and choose the action (lock, unlock, schedule lock, schedule unlock, or preview).


• Unified history log: New!

• All actions (executed or scheduled) are listed in a single table, with a status badge (green = executed, grey = scheduled).


• Sort, filter, and search on every column (id, shortname, action, dates, status…).


• Expandable details for each operation (showing impacted items).


• Edit, duplicate, or delete actions for scheduled tasks directly from the table.

• Security: Access is restricted to users with the local/lockgrades:manage capability (by default administrators).


• Data integrity: Uses database transactions to ensure consistent updates.

Requirements

• Moodle 3.5 or higher


• SSH or FTP access to copy files to the server


• Administrator rights on the Moodle platform

Installation

1. 
   

   Copy the files

   
   

   Place the lockgrades folder inside the local/ directory of your Moodle installation, so the full path is:

   
   

   moodle/local/lockgrades/
   
   

   
   


2. 
   

   Check permissions

   
   

   Make sure files and directories have appropriate permissions (readable by the web server):

   
   

   chown -R www-data:www-data moodle/local/lockgrades
   
   chmod -R 755 moodle/local/lockgrades
   
   

   
   


3. 
   

   Database update

   
   

   Log in as an administrator on your Moodle site. Moodle will automatically detect the new plugin and prompt you to update the database.

   
   


4. 
   

   Verification

   
   

   Go to Site administration > Plugins > Local plugins and check that Lock Grades appears in the list.

   
   

Usage

1. 
   

   Log in with an account that has the local/lockgrades:manage capability.

   
   


2. 
   

   Navigate to:

   
   

   https://your-moodle-site.local/local/lockgrades/index.php
   
   

   
   


3. 
   

   Fill in the Category ID number of the grade item you wish to (un)lock (e.g., totPeriode_1).

   
   


4. 
   

   Optionally fill in the Course shortname filter. Leave empty to affect all courses.

   
   


5. 
   

   Preview the impact using the "Preview" button, which will list all impacted courses before you proceed.

   
   


6. 
   

   To lock or unlock immediately, click Lock grades or Unlock grades.

   
   


7. 
   

   To schedule a lock or unlock at a future date and time, fill the date/time field and click Schedule Lock or Schedule Unlock.
   Scheduled actions will be executed automatically by Moodle's cron.

   
   


8. 
   

   Review and manage scheduled tasks at the bottom of the page, where you will see a table of all pending actions with their details (category, filter, type, execution time). You can delete any pending task before it is executed.

   
   


9. 
   

   After any action, a notification will confirm the success, and an informational box will explain the "Recalculate anyway" behavior in the gradebook UI.

   
   

Customization

• Adjust capabilities: To restrict access to other roles, modify require_capability('local/lockgrades:manage', ...) in index.php and adjust access.php accordingly.


• Edit messages: Modify the language strings in lang/en/local_lockgrades.php or lang/fr/local_lockgrades.php.


• Default behavior: The course filter is optional—leaving it empty will (un)lock all matching idnumber items across all courses.

License

This plugin is distributed under the GNU GPL v3 license. See the LICENSE file for details.

Authors and Support

• Author: Miguël Dhyne


• Contact: miguel.dhyne@gmail.com

For questions or contributions, please open an issue or submit a pull request on the project’s GitHub repository.

Lock Grades (local_lockgrades)

Description

local_lockgrades is a Moodle plugin that allows administrators to recursively lock or unlock a grade category (grade items) along with all its subcategories and associated items, using an idnumber field as the identifier. Additionally, you can optionally filter which courses to affect by specifying a substring that must appear in the course shortname.

Features

• Recursive locking: Lock a parent category and all its subcategories, updating the locked, timemodified, and locktime fields in the mdl_grade_items table.


• Recursive unlocking: Unlock the same items by resetting locked and locktime to 0 while preserving the modification timestamp (timemodified).


• Course filtering: Optionally enter a pattern to only (un)lock grades in courses whose shortname contains that pattern.


• Action scheduling: New! Schedule locking or unlocking actions for a specific date and time. The task will be executed automatically by Moodle's cron.


• Task overview and management: New! See a table of all scheduled (pending) lock/unlock actions, with execution time and action type. Each scheduled task can be modified, duplicated or deleted from the interface before execution.


• Previsualization ("dry-run"): New! Preview the list of courses that would be affected by a lock/unlock action before applying or scheduling it.


• Ancestral lock inheritance: New! Automatically applies locking rules to any newly created or updated grade item or category when at least one ancestor category is already locked. Ensures that inheritance-based locks propagate through deep category hierarchies without manual intervention.


• Unlock constraints: You cannot unlock a subcategory if any of its ancestor categories remain locked; to unlock a subcategory, all its parent categories must first be unlocked.


• Simple interface**: An admin form lets you enter the category idnumber, an optional course shortname filter, select the date and time for scheduling, and choose the action (lock, unlock, schedule lock, schedule unlock, or preview).


• Unified history log: New!

• All actions (executed or scheduled) are listed in a single table, with a status badge (green = executed, grey = scheduled).


• Sort, filter, and search on every column (id, shortname, action, dates, status…).


• Expandable details for each operation (showing impacted items).


• Edit, duplicate, or delete actions for scheduled tasks directly from the table.

• Security: Access is restricted to users with the local/lockgrades:manage capability (by default administrators).


• Data integrity: Uses database transactions to ensure consistent updates.

Requirements

• Moodle 3.5 or higher


• SSH or FTP access to copy files to the server


• Administrator rights on the Moodle platform

Installation

1. 
   

   Copy the files

   
   

   Place the lockgrades folder inside the local/ directory of your Moodle installation, so the full path is:

   
   

   moodle/local/lockgrades/
   
   

   
   


2. 
   

   Check permissions

   
   

   Make sure files and directories have appropriate permissions (readable by the web server):

   
   

   chown -R www-data:www-data moodle/local/lockgrades
   
   chmod -R 755 moodle/local/lockgrades
   
   

   
   


3. 
   

   Database update

   
   

   Log in as an administrator on your Moodle site. Moodle will automatically detect the new plugin and prompt you to update the database.

   
   


4. 
   

   Verification

   
   

   Go to Site administration > Plugins > Local plugins and check that Lock Grades appears in the list.

   
   

Usage

1. 
   

   Log in with an account that has the local/lockgrades:manage capability.

   
   


2. 
   

   Navigate to:

   
   

   https://your-moodle-site.local/local/lockgrades/index.php
   
   

   
   


3. 
   

   Fill in the Category ID number of the grade item you wish to (un)lock (e.g., totPeriode_1).

   
   


4. 
   

   Optionally fill in the Course shortname filter. Leave empty to affect all courses.

   
   


5. 
   

   Preview the impact using the "Preview" button, which will list all impacted courses before you proceed.

   
   


6. 
   

   To lock or unlock immediately, click Lock grades or Unlock grades.

   
   


7. 
   

   To schedule a lock or unlock at a future date and time, fill the date/time field and click Schedule Lock or Schedule Unlock.
   Scheduled actions will be executed automatically by Moodle's cron.

   
   


8. 
   

   Review and manage scheduled tasks at the bottom of the page, where you will see a table of all pending actions with their details (category, filter, type, execution time). You can delete any pending task before it is executed.

   
   


9. 
   

   After any action, a notification will confirm the success, and an informational box will explain the "Recalculate anyway" behavior in the gradebook UI.

   
   

Customization

• Adjust capabilities: To restrict access to other roles, modify require_capability('local/lockgrades:manage', ...) in index.php and adjust access.php accordingly.


• Edit messages: Modify the language strings in lang/en/local_lockgrades.php or lang/fr/local_lockgrades.php.


• Default behavior: The course filter is optional—leaving it empty will (un)lock all matching idnumber items across all courses.

License

This plugin is distributed under the GNU GPL v3 license. See the LICENSE file for details.

Authors and Support

• Author: Miguël Dhyne


• Contact: miguel.dhyne@gmail.com

For questions or contributions, please open an issue or submit a pull request on the project’s GitHub repository.

Release Notes — Lock Grades (local_lockgrades)

Overview

Lock Grades is a Moodle plugin that enables administrators to recursively lock or unlock a grade category (including all its subcategories and items) using the idnumber field as an identifier. The plugin also allows filtering by course shortname and offers advanced scheduling and management features.

New in This Release

• Action Scheduling: Schedule locking or unlocking for a specific date and time. Actions are executed automatically by Moodle’s cron.


• Dry-run Preview: Preview the list of courses that would be affected before applying or scheduling an action.


• Advanced Task Management: View, edit, duplicate, or delete scheduled actions in a unified table before execution.


• Ancestral Lock Inheritance: New grade items or categories automatically inherit the locked status if any ancestor category is locked.


• Unified Action History: All actions (immediate or scheduled) are shown in a single sortable, filterable table with expandable details.


• Enhanced Security: Access restricted to users with the local/lockgrades:manage capability.

Key Features

• Recursive Lock/Unlock: Automatically updates the locked status of all child grade items and subcategories, using database transactions for data integrity.


• Course Filtering: Optionally limit actions to courses whose shortname contains a specific substring.


• Unlock Constraints: A subcategory cannot be unlocked if any of its ancestor categories remains locked.


• Simple Interface: Admin form for entering the category idnumber, optional course filter, selecting the date/time, and choosing the action (lock, unlock, schedule, preview).


• Detailed Logging: All actions (executed or scheduled) are recorded, with status, filters, dates, and affected items visible.


• Transactional Integrity: All changes use database transactions to guarantee consistency.

Requirements

• Moodle 4.2 or higher


• SSH or FTP access to copy files to the server


• Administrator rights on the Moodle platform

Installation

1. 
   

   Copy the files:
   Place the lockgrades folder inside the local/ directory of your Moodle installation.

   
   


2. 
   

   Check permissions:
   Ensure the files and folders are readable by the web server user (usually www-data).

   
   


3. 
   

   Database update:
   Log in as a Moodle administrator. Moodle will detect the new plugin and prompt you to update the database.

   
   


4. 
   

   Verification:
   Go to Site administration > Plugins > Local plugins to check that Lock Grades appears in the list.

   
   

Usage

1. Log in with a user account that has the local/lockgrades:manage capability.


2. Go to /local/lockgrades/index.php on your Moodle site.


3. Enter the category ID number of the grade item to (un)lock (e.g., totPeriode_1).


4. Optionally, enter a course shortname filter (leave blank to affect all courses).


5. Use the Preview button to see which courses would be affected before proceeding.


6. To lock or unlock immediately, click Lock grades or Unlock grades.


7. To schedule a lock or unlock, select the desired date and time, then click Schedule Lock or Schedule Unlock. Actions will be executed by Moodle’s cron.


8. Review and manage all scheduled actions at the bottom of the page. You can edit, duplicate, or delete any pending task before execution.


9. After each action, a confirmation and an informational message will be displayed.

Customization

• Adjust capabilities:
  To restrict access to other roles, modify the capability requirement in the plugin code and adjust access.php.


• Edit messages:
  Modify language strings in lang/en/local_lockgrades.php or lang/fr/local_lockgrades.php.


• Default behavior:
  The course filter is optional. If left blank, actions affect all courses containing the matching idnumber.

License

This plugin is distributed under the GNU GPL v3 license. See the LICENSE file for details.

Author and Support

• Author: Miguël Dhyne


• Contact: miguel.dhyne@gmail.com

For questions or contributions, please open an issue or submit a pull request on the project’s GitHub repository.

Lock Grades (local_lockgrades)

Description

local_lockgrades is a Moodle plugin that allows administrators to recursively lock or unlock a grade category (grade items) along with all its subcategories and associated items, using an idnumber field as the identifier.

Features

• Recursive locking: Locks a parent category and all its subcategories, updating the locked, timemodified, and locktime fields in the mdl_grade_items table.


• Recursive unlocking: Unlocks the same items by resetting locked and locktime to 0 while preserving the modification timestamp (timemodified).


• Simple interface: A form is available in the Moodle administration to enter the idnumber and choose the action (lock or unlock).


• Security: Access is restricted to users with the moodle/site:config capability (administrators).


• Data integrity: Uses transactions to ensure consistent updates.

Requirements

• Moodle 3.5 or higher


• SSH or FTP access to copy files to the server


• Administrator rights on the Moodle platform

Installation

1. 
   

   Copy the files

   
   

   Place the lockgrades folder inside the local/ directory of your Moodle installation, so the full path is:

   
   

   moodle/local/lockgrades/
   
   

   
   


2. 
   

   Check permissions

   
   

   Make sure files and directories have appropriate permissions (readable by the web server):

   
   

   chown -R www-data:www-data moodle/local/lockgrades
   
   chmod -R 755 moodle/local/lockgrades
   
   

   
   


3. 
   

   Database update

   
   

   Log in as an administrator on your Moodle site. Moodle will automatically detect the new plugin and prompt you to update the database.

   
   

Usage

1. 
   

   Log in with an administrator account (with moodle/site:config capability).

   
   


2. 
   

   In your browser, open the URL:

   
   

   https://your-moodle-site.local/local/lockgrades/index.php
   
   

   
   


3. 
   

   Enter the idnumber of the main category whose grades you want to lock or unlock (e.g., totPeriode_1).

   
   


4. 
   

   Click on Lock grades or Unlock grades.

   
   


5. 
   

   A notification will confirm the success of the operation.

   
   

Customization

• Adjust capabilities: To restrict access to other roles, modify the capability used in index.php (moodle/site:config).


• Edit messages: Modify the language strings in lang/en/local_lockgrades.php.

License

This plugin is distributed under the GNU GPL v3 license. See the LICENSE file for details.

Authors and support

• Author name: Miguël Dhyne


• Contact: miguel.dhyne@gmail.com

For any questions or contributions, please open an issue or submit a pull request on the project’s GitHub repository.

Lock Grades (local_lockgrades)

Description

local_lockgrades is a Moodle plugin that allows administrators to recursively lock or unlock a grade category (grade items) along with all its subcategories and associated items, using an idnumber field as the identifier.

Features

• Recursive locking: Locks a parent category and all its subcategories, updating the locked, timemodified, and locktime fields in the mdl_grade_items table.


• Recursive unlocking: Unlocks the same items by resetting locked and locktime to 0 while preserving the modification timestamp (timemodified).


• Simple interface: A form is available in the Moodle administration to enter the idnumber and choose the action (lock or unlock).


• Security: Access is restricted to users with the moodle/site:config capability (administrators).


• Data integrity: Uses transactions to ensure consistent updates.

Requirements

• Moodle 3.5 or higher


• SSH or FTP access to copy files to the server


• Administrator rights on the Moodle platform

Installation

1. 
   

   Copy the files

   
   

   Place the lockgrades folder inside the local/ directory of your Moodle installation, so the full path is:

   
   

   moodle/local/lockgrades/
   
   

   
   


2. 
   

   Check permissions

   
   

   Make sure files and directories have appropriate permissions (readable by the web server):

   
   

   chown -R www-data:www-data moodle/local/lockgrades
   
   chmod -R 755 moodle/local/lockgrades
   
   

   
   


3. 
   

   Database update

   
   

   Log in as an administrator on your Moodle site. Moodle will automatically detect the new plugin and prompt you to update the database.

   
   

Usage

1. 
   

   Log in with an administrator account (with moodle/site:config capability).

   
   


2. 
   

   In your browser, open the URL:

   
   

   https://your-moodle-site.local/local/lockgrades/index.php
   
   

   
   


3. 
   

   Enter the idnumber of the main category whose grades you want to lock or unlock (e.g., totPeriode_1).

   
   


4. 
   

   Click on Lock grades or Unlock grades.

   
   


5. 
   

   A notification will confirm the success of the operation.

   
   

Customization

• Adjust capabilities: To restrict access to other roles, modify the capability used in index.php (moodle/site:config).


• Edit messages: Modify the language strings in lang/en/local_lockgrades.php.

License

This plugin is distributed under the GNU GPL v3 license. See the LICENSE file for details.

Authors and support

• Author name: Miguël Dhyne


• Contact: miguel.dhyne@gmail.com

For any questions or contributions, please open an issue or submit a pull request on the project’s GitHub repository.

Lock Grades (local_lockgrades)

Description

local_lockgrades is a Moodle plugin that allows administrators to recursively lock or unlock a grade category (grade items) along with all its subcategories and associated items, using an idnumber field as the identifier.

Features

• Recursive locking: Locks a parent category and all its subcategories, updating the locked, timemodified, and locktime fields in the mdl_grade_items table.


• Recursive unlocking: Unlocks the same items by resetting locked and locktime to 0 while preserving the modification timestamp (timemodified).


• Simple interface: A form is available in the Moodle administration to enter the idnumber and choose the action (lock or unlock).


• Security: Access is restricted to users with the moodle/site:config capability (administrators).


• Data integrity: Uses transactions to ensure consistent updates.

Requirements

• Moodle 3.5 or higher


• SSH or FTP access to copy files to the server


• Administrator rights on the Moodle platform

Installation

1. 
   

   Copy the files

   
   

   Place the lockgrades folder inside the local/ directory of your Moodle installation, so the full path is:

   
   

   moodle/local/lockgrades/
   
   

   
   


2. 
   

   Check permissions

   
   

   Make sure files and directories have appropriate permissions (readable by the web server):

   
   

   chown -R www-data:www-data moodle/local/lockgrades
   
   chmod -R 755 moodle/local/lockgrades
   
   

   
   


3. 
   

   Database update

   
   

   Log in as an administrator on your Moodle site. Moodle will automatically detect the new plugin and prompt you to update the database.

   
   


4. 
   

   Verification

   
   

   Go to Site administration > Plugins > Local plugins and check that Lock Grades appears in the list.

   
   

Usage

1. 
   

   Log in with an administrator account (with moodle/site:config capability).

   
   


2. 
   

   In your browser, open the URL:

   
   

   https://your-moodle-site.local/local/lockgrades/index.php
   
   

   
   


3. 
   

   Enter the idnumber of the main category whose grades you want to lock or unlock (e.g., totPeriode_1).

   
   


4. 
   

   Click on Lock grades or Unlock grades.

   
   


5. 
   

   A notification will confirm the success of the operation.

   
   

Customization

• Adjust capabilities: To restrict access to other roles, modify the capability used in index.php (moodle/site:config).


• Edit messages: Modify the language strings in lang/en/local_lockgrades.php.

License

This plugin is distributed under the GNU GPL v3 license. See the LICENSE file for details.

Authors and support

• Author name: Miguël Dhyne


• Contact: miguel.dhyne@gmail.com

For any questions or contributions, please open an issue or submit a pull request on the project’s GitHub repository.

Lock Grades (local_lockgrades)

Description

local_lockgrades is a Moodle plugin that allows administrators to recursively lock or unlock a grade category (grade items) along with all its subcategories and associated items, using an idnumber field as the identifier.

Features

• Recursive locking: Locks a parent category and all its subcategories, updating the locked, timemodified, and locktime fields in the mdl_grade_items table.


• Recursive unlocking: Unlocks the same items by resetting locked and locktime to 0 while preserving the modification timestamp (timemodified).


• Simple interface: A form is available in the Moodle administration to enter the idnumber and choose the action (lock or unlock).


• Security: Access is restricted to users with the moodle/site:config capability (administrators).


• Data integrity: Uses transactions to ensure consistent updates.

Requirements

• Moodle 3.5 or higher


• SSH or FTP access to copy files to the server


• Administrator rights on the Moodle platform

Installation

1. 
   

   Copy the files

   
   

   Place the lockgrades folder inside the local/ directory of your Moodle installation, so the full path is:

   
   

   moodle/local/lockgrades/
   
   

   
   


2. 
   

   Check permissions

   
   

   Make sure files and directories have appropriate permissions (readable by the web server):

   
   

   chown -R www-data:www-data moodle/local/lockgrades
   
   chmod -R 755 moodle/local/lockgrades
   
   

   
   


3. 
   

   Database update

   
   

   Log in as an administrator on your Moodle site. Moodle will automatically detect the new plugin and prompt you to update the database.

   
   


4. 
   

   Verification

   
   

   Go to Site administration > Plugins > Local plugins and check that Lock Grades appears in the list.

   
   

Usage

1. 
   

   Log in with an administrator account (with moodle/site:config capability).

   
   


2. 
   

   In your browser, open the URL:

   
   

   https://your-moodle-site.local/local/lockgrades/index.php
   
   

   
   


3. 
   

   Enter the idnumber of the main category whose grades you want to lock or unlock (e.g., totPeriode_1).

   
   


4. 
   

   Click on Lock grades or Unlock grades.

   
   


5. 
   

   A notification will confirm the success of the operation.

   
   

Customization

• Adjust capabilities: To restrict access to other roles, modify the capability used in index.php (moodle/site:config).


• Edit messages: Modify the language strings in lang/en/local_lockgrades.php.

License

This plugin is distributed under the GNU GPL v3 license. See the LICENSE file for details.

Authors and support

• Author name: Miguël Dhyne


• Contact: miguel.dhyne@gmail.com

For any questions or contributions, please open an issue or submit a pull request on the project’s GitHub repository.