Changelog

All notable changes to this project will be documented in this file.

[2.2] - 2026-06-11

• Fixed Moodle 4.2 compatibility on the manage applications page by removing the missing core/modal_types AMD dependency and using the default modal type exposed by core/modal_factory.


• Fixed applicant-facing attachment display after the application file itemid migration, and added an upgrade step to move legacy attachment records to application-id itemids.

[2.1] - 2026-06-02

• Added check to make sure the users who were set to receive application notifications are still enrolled in the course before sending them the notification.


• Applied format_text to the application text.


• Added restriction to application attachment (only application owner and enrol_gapply:manage capability can view).


• Added support for format_mtube (MooTube) to display and process applications directly from the MooTube interface.

[2.0] - 2026-05-07

🔄 Architectural Shift: AJAX to Web Services

• Removed ajax.php: The legacy AJAX handler has been completely replaced.


• New External API: classes/external.php and db/services.php have been added, implementing a robust Web Service layer. This handles all application lifecycle actions (approve, reject, waitlist, delete, withdraw) with better security and structured JSON responses.

-️ UI/UX Overhaul (Native Moodle Modals)

• Migration to core/modal: The custom modal logic has been replaced with native Moodle Modals for better accessibility and theme compatibility.


• Dual-Pane Detail View: New Mustache templates (modal_body.mustache, modal_header.mustache) implement a side-by-side layout for simultaneous document preview and application data management.


• Record Navigation: Added "Next" and "Previous" buttons within the modal, allowing admins to cycle through applications without closing and reopening the view.


• Custom messages for approval/rejection/waitlist and withdrawal.


• Search and launch application by application ID (aid).


• Notification now links to the specific application.

' Participants Page Integration

• Automated Helper: Added amd/src/participants_helper.js, which automatically initializes on the course participants page.


• Group Management: Improved "Add to Group" and "Remove from Group" functionality directly within the participants' interface.

📂 Critical Fix: File Storage Logic

• Standardized itemid: Changed the file storage logic to use the application's unique ID (appid) as the itemid. Previously, it used a concatenated string of $instanceid . $userid, which caused issues with multiple applications.


• Withdrawal Reason: The withdrawal workflow now captures a mandatory reason, which is included in the admin notification.

📈 Versioning & Compatibility

• Moodle 5.2 Support: Updated compatibility to support Moodle 5.2 ($plugin->supported = [401, 502]).

🚀 Optimized Performance

• Batch Database Updates: Refactored bulk actions (approve/reject) to use optimized SQL JOINs and UPDATE ... WHERE IN (...) statements, eliminating N+1 query performance bottlenecks.

[1.0.11] - 2025-04-22

• Support for Moodle 5.0

[1.0.9] - 2024-10-08

Added

• Ability for admin to set the default role assignment


• Ability for user with enrol/gapply:config capability to set the default role for new approved users


• Ability for user with enrol/gapply:manage capability to select the specific role for a specific user when approving the application


• Ability for user with enrol/gapply:manage capability to set enrollment dates for a specific user when approving the application


• Ability for applicant to withdraw their application if application is not yet processed

Changed

• Change can_add_instance method to make sure only one application instance is allowed.


• Remove before_footer callback because it is no longer supported in 4.5.


• Remove $PAGE->set_context() on enrol_form because changing context from 40 to 10 is no longer allowed in 5.0.


• Include all user profile fields in user object before calling to $OUTPUT->user_picture as required in 4.5.

Fixed

• Relative links caused issues in Moodle instances installed on sub-folder.

Changelog

All notable changes to this project will be documented in this file.

[2.1] - 2026-06-02

• Added check to make sure the users who were set to receive application notifications are still enrolled in the course before sending them the notification.


• Applied format_text to the application text.


• Added restriction to application attachment (only application owner and enrol_gapply:manage capability can view).


• Added support for format_mtube (MooTube) to display and process applications directly from the MooTube interface.

[2.0] - 2026-05-07

🔄 Architectural Shift: AJAX to Web Services

• Removed ajax.php: The legacy AJAX handler has been completely replaced.


• New External API: classes/external.php and db/services.php have been added, implementing a robust Web Service layer. This handles all application lifecycle actions (approve, reject, waitlist, delete, withdraw) with better security and structured JSON responses.

-️ UI/UX Overhaul (Native Moodle Modals)

• Migration to core/modal: The custom modal logic has been replaced with native Moodle Modals for better accessibility and theme compatibility.


• Dual-Pane Detail View: New Mustache templates (modal_body.mustache, modal_header.mustache) implement a side-by-side layout for simultaneous document preview and application data management.


• Record Navigation: Added "Next" and "Previous" buttons within the modal, allowing admins to cycle through applications without closing and reopening the view.


• Custom messages for approval/rejection/waitlist and withdrawal.


• Search and launch application by application ID (aid).


• Notification now links to the specific application.

' Participants Page Integration

• Automated Helper: Added amd/src/participants_helper.js, which automatically initializes on the course participants page.


• Group Management: Improved "Add to Group" and "Remove from Group" functionality directly within the participants' interface.

📂 Critical Fix: File Storage Logic

• Standardized itemid: Changed the file storage logic to use the application's unique ID (appid) as the itemid. Previously, it used a concatenated string of $instanceid . $userid, which caused issues with multiple applications.


• Withdrawal Reason: The withdrawal workflow now captures a mandatory reason, which is included in the admin notification.

📈 Versioning & Compatibility

• Moodle 5.2 Support: Updated compatibility to support Moodle 5.2 ($plugin->supported = [401, 502]).

🚀 Optimized Performance

• Batch Database Updates: Refactored bulk actions (approve/reject) to use optimized SQL JOINs and UPDATE ... WHERE IN (...) statements, eliminating N+1 query performance bottlenecks.

[1.0.11] - 2025-04-22

• Support for Moodle 5.0

[1.0.9] - 2024-10-08

Added

• Ability for admin to set the default role assignment


• Ability for user with enrol/gapply:config capability to set the default role for new approved users


• Ability for user with enrol/gapply:manage capability to select the specific role for a specific user when approving the application


• Ability for user with enrol/gapply:manage capability to set enrollment dates for a specific user when approving the application


• Ability for applicant to withdraw their application if application is not yet processed

Changed

• Change can_add_instance method to make sure only one application instance is allowed.


• Remove before_footer callback because it is no longer supported in 4.5.


• Remove $PAGE->set_context() on enrol_form because changing context from 40 to 10 is no longer allowed in 5.0.


• Include all user profile fields in user object before calling to $OUTPUT->user_picture as required in 4.5.

Fixed

• Relative links caused issues in Moodle instances installed on sub-folder.

Changelog

All notable changes to this project will be documented in this file.

[2.0] - 2026-05-07

🔄 Architectural Shift: AJAX to Web Services

• Removed ajax.php: The legacy AJAX handler has been completely replaced.


• New External API: classes/external.php and db/services.php have been added, implementing a robust Web Service layer. This handles all application lifecycle actions (approve, reject, waitlist, delete, withdraw) with better security and structured JSON responses.

-️ UI/UX Overhaul (Native Moodle Modals)

• Migration to core/modal: The custom modal logic has been replaced with native Moodle Modals for better accessibility and theme compatibility.


• Dual-Pane Detail View: New Mustache templates (modal_body.mustache, modal_header.mustache) implement a side-by-side layout for simultaneous document preview and application data management.


• Record Navigation: Added "Next" and "Previous" buttons within the modal, allowing admins to cycle through applications without closing and reopening the view.


• Custom messages for approval/rejection/waitlist and withdrawal.


• Search and launch application by application ID (aid).


• Notification now links to the specific application.

' Participants Page Integration

• Automated Helper: Added amd/src/participants_helper.js, which automatically initializes on the course participants page.


• Group Management: Improved "Add to Group" and "Remove from Group" functionality directly within the participants' interface.

📂 Critical Fix: File Storage Logic

• Standardized itemid: Changed the file storage logic to use the application's unique ID (appid) as the itemid. Previously, it used a concatenated string of $instanceid . $userid, which caused issues with multiple applications.


• Withdrawal Reason: The withdrawal workflow now captures a mandatory reason, which is included in the admin notification.

📈 Versioning & Compatibility

• Moodle 5.2 Support: Updated compatibility to support Moodle 5.2 ($plugin->supported = [401, 502]).

🚀 Optimized Performance

• Batch Database Updates: Refactored bulk actions (approve/reject) to use optimized SQL JOINs and UPDATE ... WHERE IN (...) statements, eliminating N+1 query performance bottlenecks.

[1.0.11] - 2025-04-22

• Support for Moodle 5.0

[1.0.9] - 2024-10-08

Added

• Ability for admin to set the default role assignment


• Ability for user with enrol/gapply:config capability to set the default role for new approved users


• Ability for user with enrol/gapply:manage capability to select the specific role for a specific user when approving the application


• Ability for user with enrol/gapply:manage capability to set enrollment dates for a specific user when approving the application


• Ability for applicant to withdraw their application if application is not yet processed

Changed

• Change can_add_instance method to make sure only one application instance is allowed.


• Remove before_footer callback because it is no longer supported in 4.5.


• Remove $PAGE->set_context() on enrol_form because changing context from 40 to 10 is no longer allowed in 5.0.


• Include all user profile fields in user object before calling to $OUTPUT->user_picture as required in 4.5.

Fixed

• Relative links caused issues in Moodle instances installed on sub-folder.

Changelog

All notable changes to this project will be documented in this file.

[1.0.12] - 2026-01-15

• Support for Moodle 5.1


• Resolved #22


• Allowing selection of users to receive application notifications on the instance edit form

[1.0.11] - 2025-04-22

• Support for Moodle 5.0

[1.0.9] - 2024-10-08

Added

• Ability for admin to set the default role assignment


• Ability for user with enrol/gapply:config capability to set the default role for new approved users


• Ability for user with enrol/gapply:manage capability to select the specific role for a specific user when approving the application


• Ability for user with enrol/gapply:manage capability to set enrollment dates for a specific user when approving the application


• Ability for applicant to withdraw their application if application is not yet processed

Changed

• Change can_add_instance method to make sure only one application instance is allowed.


• Remove before_footer callback because it is no longer supported in 4.5.


• Remove $PAGE->set_context() on enrol_form because changing context from 40 to 10 is no longer allowed in 5.0.


• Include all user profile fields in user object before calling to $OUTPUT->user_picture as required in 4.5.

Fixed

• Relative links caused issues in Moodle instances installed on sub-folder.

Changelog

All notable changes to this project will be documented in this file.

[1.0.11] - 2025-04-22

• Support for Moodle 5.0

[1.0.9] - 2024-10-08

Added

• Ability for admin to set the default role assignment


• Ability for user with enrol/gapply:config capability to set the default role for new approved users


• Ability for user with enrol/gapply:manage capability to select the specific role for a specific user when approving the application


• Ability for user with enrol/gapply:manage capability to set enrollment dates for a specific user when approving the application


• Ability for applicant to withdraw their application if application is not yet processed

Changed

• Change can_add_instance method to make sure only one application instance is allowed.


• Remove before_footer callback because it is no longer supported in 4.5.


• Remove $PAGE->set_context() on enrol_form because changing context from 40 to 10 is no longer allowed in 5.0.


• Include all user profile fields in user object before calling to $OUTPUT->user_picture as required in 4.5.

Fixed

• Relative links caused issues in Moodle instances installed on sub-folder.

Changelog

All notable changes to this project will be documented in this file.

[1.0.10] - 2025-03-13

Fixed

• Application notifications were sent to site managers even when they were not enrolled in the course. This fix first checks if users with enrol/gapply:manage is enrolled in the course before sending the notifications.

[1.0.9] - 2024-10-08

Added

• Ability for admin to set the default role assignment


• Ability for user with enrol/gapply:config capability to set the default role for new approved users


• Ability for user with enrol/gapply:manage capability to select the specific role for a specific user when approving the application


• Ability for user with enrol/gapply:manage capability to set enrollment dates for a specific user when approving the application


• Ability for applicant to withdraw their application if application is not yet processed

Changed

• Change can_add_instance method to make sure only one application instance is allowed.


• Remove before_footer callback because it is no longer supported in 4.5.


• Remove $PAGE->set_context() on enrol_form because changing context from 40 to 10 is no longer allowed in 5.0.


• Include all user profile fields in user object before calling to $OUTPUT->user_picture as required in 4.5.

Fixed

• Relative links caused issues in Moodle instances installed on sub-folder.

Changelog

All notable changes to this project will be documented in this file.

[1.0.9] - 2024-10-08

Added

• Ability for admin to set the default role assignment


• Ability for user with enrol/gapply:config capability to set the default role for new approved users


• Ability for user with enrol/gapply:manage capability to select the specific role for a specific user when approving the application


• Ability for user with enrol/gapply:manage capability to set enrollment dates for a specific user when approving the application


• Ability for applicant to withdraw their application if application is not yet processed

Changed

• Change can_add_instance method to make sure only one application instance is allowed.


• Remove before_footer callback because it is no longer supported in 4.5.


• Remove $PAGE->set_context() on enrol_form because changing context from 40 to 10 is no longer allowed in 5.0.


• Include all user profile fields in user object before calling to $OUTPUT->user_picture as required in 4.5.

Fixed

• Relative links caused issues in Moodle instances installed on sub-folder.

Changelog

All notable changes to this project will be documented in this file.

[1.0.9] - 2024-10-08

Added

• Ability for admin to set the default role assignment


• Ability for user with enrol/gapply:config capability to set the default role for new approved users


• Ability for user with enrol/gapply:manage capability to select the specific role for a specific user when approving the application


• Ability for user with enrol/gapply:manage capability to set enrollment dates for a specific user when approving the application


• Ability for applicant to withdraw their application if application is not yet processed

Changed

• Change can_add_instance method to make sure only one application instance is allowed.


• Remove before_footer callback because it is no longer supported in 4.5.


• Remove $PAGE->set_context() on enrol_form because changing context from 40 to 10 is no longer allowed in 5.0.


• Include all user profile fields in user object before calling to $OUTPUT->user_picture as required in 4.5.

Fixed

• Relative links caused issues in Moodle instances installed on sub-folder.

Version 1.0.8

• Add a site setting to enable sending notifications in the recipient's language


• Set attachment file size to 1MB, attachment accepted file types to .doc .docx .pdf web_image for the default enrolment instance


• Change default user identities to ID number, Department, Institution on plugin installation

Add error handling for when identity fields in the site settings are not set.

• Fixed a bug with site preset #14


• Added ability to enable enrolment instance by default for new courses #12


• Improved error handlings

• Add support for Moodle 4.4


• Improve Font Awesome support for Moodle 4.1


• Change the setting for "enrol/gapply:config" to allow "editingteacher" to configure the enrolment instance form by default (apply to new installations only).

V1.0.5

• Bug fix for when user identity fields are not selected.

V1.0.4

• Ability to set seat limit

Apply

This plugin is another enrollment method that allows learners to apply for a course using application text and/or application file(s). Teachers will receive notifications when there are new applications. Application outcomes include Approved, Rejected, Waitisted, and Deleted. Outcome notifications will be sent to the applicants.

Features:

• Display flexible application instructions


• Determine the number of files, max size, and accepted file types for the application attachments


• Set application start date and end date to restrict the application period


• Require users to complete their profile before applying


• Support groups

Installing via uploaded ZIP file

1. Log in to your Moodle site as an admin and go to Site administration >
   Plugins > Install plugins.


2. Upload the ZIP file with the plugin code. You should only be prompted to add
   extra details if your plugin type is not automatically detected.


3. Check the plugin validation report and finish the installation.

Installing manually

The plugin can be also installed by putting the contents of this directory to

{your/moodle/dirroot}/enrol/gapply

Afterwards, log in to your Moodle site as an admin and go to Site administration >
Notifications to complete the installation.

Alternatively, you can run

$ php admin/cli/upgrade.php

to complete the installation from the command line.

License

2023 Sokunthearith Makara sokunthearithmakara@gmail.com

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 https://www.gnu.org/licenses/.