Developer Documentation
- Bug fixes for general core bugs in 4.0.x will end 8 May 2023 (12 months).
- Bug fixes for security issues in 4.0.x will end 13 November 2023 (18 months).
- PHP version: minimum PHP 7.3.0 Note: the minimum PHP version has increased since Moodle 3.10. PHP 7.4.x is also supported.
Differences Between: [Versions 310 and 400] [Versions 311 and 400] [Versions 39 and 400] [Versions 400 and 402] [Versions 400 and 403]
External course participation api. This api is mostly read only, the actual enrol and unenrol support is in each enrol plugin.
| Copyright: | 2010 Jerome Mouneyrac |
| License: | http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later |
| File Size: | 1330 lines (65 kb) |
| Included or required: | 0 times |
| Referenced: | 13 times |
| Includes or requires: | 0 files |
Defines 3 classes
core_enrol_external:: (15 methods):
get_enrolled_users_with_capability_parameters()
get_enrolled_users_with_capability()
get_enrolled_users_with_capability_returns()
get_users_courses_parameters()
get_users_courses()
get_users_courses_returns()
get_potential_users_parameters()
get_potential_users()
get_potential_users_returns()
search_users_parameters()
search_users()
search_users_returns()
get_enrolled_users_parameters()
get_enrolled_users()
get_enrolled_users_returns()
in:: (9 methods):
get_course_enrolment_methods_parameters()
get_course_enrolment_methods()
get_course_enrolment_methods_returns()
submit_user_enrolment_form_parameters()
submit_user_enrolment_form()
submit_user_enrolment_form_returns()
unenrol_user_enrolment_parameters()
unenrol_user_enrolment()
unenrol_user_enrolment_returns()
core_role_external:: (6 methods):
assign_roles_parameters()
assign_roles()
assign_roles_returns()
unassign_roles_parameters()
unassign_roles()
unassign_roles_returns()
Class: core_enrol_external - X-Ref
Enrol external functions| get_enrolled_users_with_capability_parameters() X-Ref |
| Returns description of method parameters return: external_function_parameters |
| get_enrolled_users_with_capability($coursecapabilities, $options) X-Ref |
| Return users that have the capabilities for each course specified. For each course and capability specified, a list of the users that are enrolled in the course and have that capability are returned. return: array An array of arrays describing users for each associated courseid and capability param: array $coursecapabilities array of course ids and associated capability names {courseid, {capabilities}} |
| get_enrolled_users_with_capability_returns() X-Ref |
| Returns description of method result value return: external_multiple_structure |
| get_users_courses_parameters() X-Ref |
| Returns description of method parameters return: external_function_parameters |
| get_users_courses($userid, $returnusercount = true) X-Ref |
| Get list of courses user is enrolled in (only active enrolments are returned). Please note the current user must be able to access the course, otherwise the course is not included. return: array of courses param: int $userid param: bool $returnusercount |
| get_users_courses_returns() X-Ref |
| No description |
| get_potential_users_parameters() X-Ref |
| Returns description of method parameters value return: external_description |
| get_potential_users($courseid, $enrolid, $search, $searchanywhere, $page, $perpage) X-Ref |
| Get potential users. return: array An array of users param: int $courseid Course id param: int $enrolid Enrolment id param: string $search The query param: boolean $searchanywhere Match anywhere in the string param: int $page Page number param: int $perpage Max per page |
| get_potential_users_returns() X-Ref |
| Returns description of method result value return: external_description |
| search_users_parameters() X-Ref |
| Returns description of method parameters return: external_function_parameters |
| search_users(int $courseid, string $search, bool $searchanywhere, int $page, int $perpage) X-Ref |
| Search course participants. return: array An array of users param: int $courseid Course id param: string $search The query param: bool $searchanywhere Match anywhere in the string param: int $page Page number param: int $perpage Max per page |
| search_users_returns() X-Ref |
| Returns description of method result value return: external_multiple_structure |
| get_enrolled_users_parameters() X-Ref |
| Returns description of method parameters return: external_function_parameters |
| get_enrolled_users($courseid, $options = []) X-Ref |
| Get course participants details return: array An array of users param: int $courseid course id param: array $options options { |
| get_enrolled_users_returns() X-Ref |
| Returns description of method result value return: external_description |
| get_course_enrolment_methods_parameters() X-Ref |
| Returns description of get_course_enrolment_methods() parameters return: external_function_parameters |
| get_course_enrolment_methods($courseid) X-Ref |
| Get list of active course enrolment methods for current user. return: array of course enrolment methods param: int $courseid |
| get_course_enrolment_methods_returns() X-Ref |
| Returns description of get_course_enrolment_methods() result value return: external_description |
| submit_user_enrolment_form_parameters() X-Ref |
| Returns description of submit_user_enrolment_form parameters. return: external_function_parameters. |
| submit_user_enrolment_form($formdata) X-Ref |
| External function that handles the user enrolment form submission. return: array An array consisting of the processing result and error flag, if available param: string $formdata The user enrolment form data in s URI encoded param string |
| submit_user_enrolment_form_returns() X-Ref |
| Returns description of submit_user_enrolment_form() result value return: external_description |
| unenrol_user_enrolment_parameters() X-Ref |
| Returns description of unenrol_user_enrolment() parameters return: external_function_parameters |
| unenrol_user_enrolment($ueid) X-Ref |
| External function that unenrols a given user enrolment. return: array An array consisting of the processing result, errors. param: int $ueid The user enrolment ID. |
| unenrol_user_enrolment_returns() X-Ref |
| Returns description of unenrol_user_enrolment() result value return: external_description |
Class: core_role_external - X-Ref
Role external functions| assign_roles_parameters() X-Ref |
| Returns description of method parameters return: external_function_parameters |
| assign_roles($assignments) X-Ref |
| Manual role assignments to users param: array $assignments An array of manual role assignment |
| assign_roles_returns() X-Ref |
| Returns description of method result value return: null |
| unassign_roles_parameters() X-Ref |
| Returns description of method parameters return: external_function_parameters |
| unassign_roles($unassignments) X-Ref |
| Unassign roles from users param: array $unassignments An array of unassignment |
| unassign_roles_returns() X-Ref |
| Returns description of method result value return: null |
