 |
Moodle APIs 4.3
Moodle 4.3.6 (Build: 20240812)
|
|
Moodle APIs 4.3
Moodle 4.3.6 (Build: 20240812)
|
Message external functions. More...
Static Public Member Functions | |
| static | block_user (int $userid, int $blockeduserid) |
| Blocks a user. | |
| static | block_user_parameters () |
| Block user parameters description. | |
| static | block_user_returns () |
| Block user return description. | |
| static | confirm_contact_request (int $userid, int $requesteduserid) |
| Confirm a contact request. | |
| static | confirm_contact_request_parameters () |
| Confirm a contact request parameters description. | |
| static | confirm_contact_request_returns () |
| Confirm a contact request return description. | |
| static | create_contact_request (int $userid, int $requesteduserid) |
| Creates a contact request. | |
| static | create_contact_request_parameters () |
| Creates a contact request parameters description. | |
| static | create_contact_request_returns () |
| Creates a contact request return description. | |
| static | data_for_messagearea_search_messages ($userid, $search, $limitfrom=0, $limitnum=0) |
| Get messagearea search messages results. | |
| static | data_for_messagearea_search_messages_parameters () |
| Get messagearea search messages parameters. | |
| static | data_for_messagearea_search_messages_returns () |
| Get messagearea search messages returns. | |
| static | decline_contact_request (int $userid, int $requesteduserid) |
| Declines a contact request. | |
| static | decline_contact_request_parameters () |
| Declines a contact request parameters description. | |
| static | decline_contact_request_returns () |
| Declines a contact request return description. | |
| static | delete_contacts ($userids, $userid=0) |
| Delete contacts. | |
| static | delete_contacts_parameters () |
| Delete contacts parameters description. | |
| static | delete_contacts_returns () |
| Delete contacts return description. | |
| static | delete_conversations_by_id ($userid, array $conversationids) |
| Deletes a conversation. | |
| static | delete_conversations_by_id_parameters () |
| Returns description of method parameters. | |
| static | delete_conversations_by_id_returns () |
| Returns description of method result value. | |
| static | delete_message ($messageid, $userid, $read=true) |
| Deletes a message. | |
| static | delete_message_for_all_users (int $messageid, int $userid) |
| Deletes a message for all users. | |
| static | delete_message_for_all_users_parameters () |
| Returns description of method parameters. | |
| static | delete_message_for_all_users_returns () |
| Returns description of method result value. | |
| static | delete_message_parameters () |
| Returns description of method parameters. | |
| static | delete_message_returns () |
| Returns description of method result value. | |
| static | get_blocked_users ($userid) |
| Retrieve a list of users blocked. | |
| static | get_blocked_users_parameters () |
| Get blocked users parameters description. | |
| static | get_blocked_users_returns () |
| Get blocked users return description. | |
| static | get_contact_requests (int $userid, int $limitfrom=0, int $limitnum=0) |
| Handles returning the contact requests for a user. | |
| static | get_contact_requests_parameters () |
| Returns contact requests parameters description. | |
| static | get_contact_requests_returns () |
| Returns the contact requests return description. | |
| static | get_conversation (int $userid, int $conversationid, bool $includecontactrequests=false, bool $includeprivacyinfo=false, int $memberlimit=0, int $memberoffset=0, int $messagelimit=0, int $messageoffset=0, bool $newestmessagesfirst=true) |
| Get a single conversation. | |
| static | get_conversation_between_users (int $userid, int $otheruserid, bool $includecontactrequests=false, bool $includeprivacyinfo=false, int $memberlimit=0, int $memberoffset=0, int $messagelimit=0, int $messageoffset=0, bool $newestmessagesfirst=true) |
| Get a single conversation between users. | |
| static | get_conversation_between_users_parameters () |
| Get conversation parameters. | |
| static | get_conversation_between_users_returns () |
| Get conversation returns. | |
| static | get_conversation_counts (int $userid) |
| Returns an array of conversation counts for the various types of conversations, including favourites. | |
| static | get_conversation_counts_parameters () |
| Returns description of method parameters for get_conversation_counts() method. | |
| static | get_conversation_counts_returns () |
| Get conversation counts return description. | |
| static | get_conversation_members (int $userid, int $conversationid, bool $includecontactrequests=false, bool $includeprivacyinfo=false, int $limitfrom=0, int $limitnum=0) |
| Returns a list of conversation members. | |
| static | get_conversation_members_parameters () |
| Returns get conversation members parameters description. | |
| static | get_conversation_members_returns () |
| Returns the get conversation members return description. | |
| static | get_conversation_messages (int $currentuserid, int $convid, int $limitfrom=0, int $limitnum=0, bool $newest=false, int $timefrom=0) |
| Get conversation messages. | |
| static | get_conversation_messages_parameters () |
| The conversation messages parameters. | |
| static | get_conversation_messages_returns () |
| The messagearea messages return structure. | |
| static | get_conversation_parameters () |
| Get conversation parameters. | |
| static | get_conversation_returns () |
| Get conversation returns. | |
| static | get_conversations ($userid, $limitfrom=0, $limitnum=0, int $type=null, bool $favourites=null, bool $mergeself=false) |
| Get the list of conversations for the user. | |
| static | get_conversations_parameters () |
| Get conversations parameters. | |
| static | get_conversations_returns () |
| Get conversations returns. | |
| static | get_member_info (int $referenceuserid, array $userids, bool $includecontactrequests=false, bool $includeprivacyinfo=false) |
| Returns conversation member info for the supplied users, relative to the supplied referenceuserid. | |
| static | get_member_info_parameters () |
| Returns description of method parameters for get_member_info() method. | |
| static | get_member_info_returns () |
| Get member info return description. | |
| static | get_message_processor ($userid, $name) |
| Get a message processor. | |
| static | get_message_processor_parameters () |
| Returns description of method parameters. | |
| static | get_message_processor_returns () |
| Returns description of method result value. | |
| static | get_messages ($useridto, $useridfrom=0, $type='both', $read=MESSAGE_GET_READ, $newestfirst=true, $limitfrom=0, $limitnum=0) |
| Get messages function implementation. | |
| static | get_messages_parameters () |
| Get messages parameters description. | |
| static | get_messages_returns () |
| Get messages return description. | |
| static | get_received_contact_requests_count (int $userid) |
| Returns the number of contact requests the user has received. | |
| static | get_received_contact_requests_count_parameters () |
| Returns the number of contact requests the user has received parameters description. | |
| static | get_received_contact_requests_count_returns () |
| Returns the number of contact requests the user has received return description. | |
| static | get_self_conversation (int $userid, int $messagelimit=0, int $messageoffset=0, bool $newestmessagesfirst=true) |
| Get a single self-conversation. | |
| static | get_self_conversation_parameters () |
| Get self-conversation parameters. | |
| static | get_self_conversation_returns () |
| Get conversation returns. | |
| static | get_unread_conversation_counts (int $userid) |
| Returns an array of unread conversation counts for the various types of conversations, including favourites. | |
| static | get_unread_conversation_counts_parameters () |
| Returns description of method parameters for get_unread_conversation_counts() method. | |
| static | get_unread_conversation_counts_returns () |
| Get unread conversation counts return description. | |
| static | get_unread_conversations_count ($useridto) |
| Get unread messages count function. | |
| static | get_unread_conversations_count_parameters () |
| Get unread conversations count parameters description. | |
| static | get_unread_conversations_count_returns () |
| Get unread conversations count return description. | |
| static | get_user_contacts (int $userid, int $limitfrom=0, int $limitnum=0) |
| Get user contacts. | |
| static | get_user_contacts_parameters () |
| The user contacts return parameters. | |
| static | get_user_contacts_returns () |
| The user contacts return structure. | |
| static | get_user_message_preferences ($userid=0) |
| Get the notification preferences for a given user. | |
| static | get_user_message_preferences_parameters () |
| Returns description of method parameters. | |
| static | get_user_message_preferences_returns () |
| Returns description of method result value. | |
| static | get_user_notification_preferences ($userid=0) |
| Get the notification preferences for a given user. | |
| static | get_user_notification_preferences_parameters () |
| Returns description of method parameters. | |
| static | get_user_notification_preferences_returns () |
| Returns description of method result value. | |
| static | mark_all_conversation_messages_as_read (int $userid, int $conversationid) |
| Mark all conversation messages as read function. | |
| static | mark_all_conversation_messages_as_read_parameters () |
| Mark all conversation messages as read parameters description. | |
| static | mark_all_conversation_messages_as_read_returns () |
| Mark all conversation messages as read return description. | |
| static | mark_all_notifications_as_read ($useridto, $useridfrom, $timecreatedto=0) |
| Mark all notifications as read function. | |
| static | mark_all_notifications_as_read_parameters () |
| Mark all notifications as read parameters description. | |
| static | mark_all_notifications_as_read_returns () |
| Mark all notifications as read return description. | |
| static | mark_message_read ($messageid, $timeread) |
| Mark a single message as read, trigger message_viewed event. | |
| static | mark_message_read_parameters () |
| Returns description of method parameters. | |
| static | mark_message_read_returns () |
| Returns description of method result value. | |
| static | mark_notification_read ($notificationid, $timeread) |
| Mark a single notification as read. | |
| static | mark_notification_read_parameters () |
| Returns description of method parameters. | |
| static | mark_notification_read_returns () |
| Returns description of method result value. | |
| static | message_processor_config_form ($userid, $name, $formvalues) |
| Processes a message processor config form. | |
| static | message_processor_config_form_parameters () |
| Returns description of method parameters. | |
| static | message_processor_config_form_returns () |
| Returns description of method result value. | |
| static | message_search_users ($userid, $search, $limitfrom=0, $limitnum=0) |
| Get search users results. | |
| static | message_search_users_parameters () |
| Get messagearea message search users parameters. | |
| static | message_search_users_returns () |
| Get messagearea message search users returns. | |
| static | mute_conversations (int $userid, array $conversationids) |
| Mutes conversations. | |
| static | mute_conversations_parameters () |
| Mute conversations parameters description. | |
| static | mute_conversations_returns () |
| Mute conversations return description. | |
| static | search_contacts ($searchtext, $onlymycourses=false) |
| Search contacts. | |
| static | search_contacts_parameters () |
| Search contacts parameters description. | |
| static | search_contacts_returns () |
| Search contacts return description. | |
| static | send_instant_messages ($messages=array()) |
| Send private messages from the current USER to other users. | |
| static | send_instant_messages_parameters () |
| Returns description of method parameters. | |
| static | send_instant_messages_returns () |
| Returns description of method result value. | |
| static | send_messages_to_conversation (int $conversationid, array $messages=[]) |
| Send messages from the current USER to a conversation. | |
| static | send_messages_to_conversation_parameters () |
| Returns description of method parameters. | |
| static | send_messages_to_conversation_returns () |
| Returns description of method result value. | |
| static | set_favourite_conversations (int $userid, array $conversationids) |
| Favourite a conversation, or list of conversations for a user. | |
| static | set_favourite_conversations_parameters () |
| Returns description of method parameters for the favourite_conversations() method. | |
| static | set_favourite_conversations_returns () |
| Return a description of the returns for the create_user_favourite_conversations() method. | |
| static | unblock_user (int $userid, int $unblockeduserid) |
| Unblock user. | |
| static | unblock_user_parameters () |
| Unblock user parameters description. | |
| static | unblock_user_returns () |
| Unblock user return description. | |
| static | unmute_conversations (int $userid, array $conversationids) |
| Unmute conversations. | |
| static | unmute_conversations_parameters () |
| Unmute conversations parameters description. | |
| static | unmute_conversations_returns () |
| Unmute conversations return description. | |
| static | unset_favourite_conversations (int $userid, array $conversationids) |
| Unfavourite a conversation, or list of conversations for a user. | |
| static | unset_favourite_conversations_parameters () |
| Returns description of method parameters for unfavourite_conversations() method. | |
| static | unset_favourite_conversations_returns () |
| Unset favourite conversations return description. | |
Static Protected Member Functions | |
| static | get_preferences_structure () |
| Returns a notification or message preference structure. | |
| static | validate_preferences_permissions ($userid) |
| Check that the user has enough permission to retrieve message or notifications preferences. | |
Message external functions.
|
static |
Blocks a user.
| int | $userid | The id of the user who is blocking |
| int | $blockeduserid | The id of the user being blocked |
| core_external\external_description |
|
static |
Block user parameters description.
| external_function_parameters |
|
static |
Block user return description.
| core_external\external_description |
|
static |
Confirm a contact request.
| int | $userid | The id of the user who is creating the contact request |
| int | $requesteduserid | The id of the user being requested |
|
static |
Confirm a contact request parameters description.
| external_function_parameters |
|
static |
Confirm a contact request return description.
| core_external\external_description |
|
static |
Creates a contact request.
| int | $userid | The id of the user who is creating the contact request |
| int | $requesteduserid | The id of the user being requested |
|
static |
Creates a contact request parameters description.
| external_function_parameters |
|
static |
Creates a contact request return description.
| core_external\external_description |
|
static |
Get messagearea search messages results.
| int | $userid | The id of the user who is performing the search |
| string | $search | The string being searched |
| int | $limitfrom | |
| int | $limitnum |
| stdClass |
| moodle_exception |
|
static |
Get messagearea search messages parameters.
| external_function_parameters |
|
static |
Get messagearea search messages returns.
| external_single_structure |
|
static |
Declines a contact request.
| int | $userid | The id of the user who is creating the contact request |
| int | $requesteduserid | The id of the user being requested |
|
static |
Declines a contact request parameters description.
| external_function_parameters |
|
static |
Declines a contact request return description.
| core_external\external_description |
|
static |
Delete contacts.
| array | $userids | array of user IDs. |
| int | $userid | The id of the user we are deleting the contacts for |
| null |
|
static |
Delete contacts parameters description.
| external_function_parameters |
|
static |
Delete contacts return description.
| core_external\external_description |
|
static |
Deletes a conversation.
| int | $userid | The user id of who we want to delete the conversation for |
| int[] | $conversationids | The ids of the conversations |
| array |
| moodle_exception |
|
static |
Returns description of method parameters.
| external_function_parameters |
|
static |
Returns description of method result value.
| core_external\external_description |
|
static |
Deletes a message.
| int | $messageid | the message id |
| int | $userid | the user id of who we want to delete the message for |
| bool | $read | if is a message read (default to true) |
| core_external\external_description |
| moodle_exception |
|
static |
Deletes a message for all users.
| int | $messageid | the message id |
| int | $userid | the user id of who we want to delete the message for all users, is no longer used. |
| core_external\external_description |
| moodle_exception |
|
static |
Returns description of method parameters.
| external_function_parameters |
|
static |
Returns description of method result value.
| core_external\external_description |
|
static |
Returns description of method parameters.
| external_function_parameters |
|
static |
Returns description of method result value.
| core_external\external_description |
|
static |
Retrieve a list of users blocked.
| int | $userid | the user whose blocked users we want to retrieve |
| core_external\external_description |
|
static |
Get blocked users parameters description.
| external_function_parameters |
|
static |
Get blocked users return description.
| external_single_structure |
|
static |
Handles returning the contact requests for a user.
This also includes the user data necessary to display information about the user.
It will not include blocked users.
| int | $userid | The id of the user we want to get the contact requests for |
| int | $limitfrom | |
| int | $limitnum |
|
static |
Returns contact requests parameters description.
| external_function_parameters |
|
static |
Returns the contact requests return description.
| core_external\external_description |
|
static |
Get a single conversation.
| int | $userid | The user id to get the conversation for |
| int | $conversationid | The id of the conversation to fetch |
| bool | $includecontactrequests | Should contact requests be included between members |
| bool | $includeprivacyinfo | Should privacy info be included between members |
| int | $memberlimit | Limit number of members to load |
| int | $memberoffset | Offset members by this amount |
| int | $messagelimit | Limit number of messages to load |
| int | $messageoffset | Offset the messages |
| bool | $newestmessagesfirst | Order messages by newest first |
| stdClass |
| moodle_exception | if the messaging feature is disabled on the site. |
|
static |
Get a single conversation between users.
| int | $userid | The user id to get the conversation for |
| int | $otheruserid | The other user id |
| bool | $includecontactrequests | Should contact requests be included between members |
| bool | $includeprivacyinfo | Should privacy info be included between members |
| int | $memberlimit | Limit number of members to load |
| int | $memberoffset | Offset members by this amount |
| int | $messagelimit | Limit number of messages to load |
| int | $messageoffset | Offset the messages |
| bool | $newestmessagesfirst | Order messages by newest first |
| stdClass |
| moodle_exception | if the messaging feature is disabled on the site. |
|
static |
Get conversation parameters.
| external_function_parameters |
|
static |
Get conversation returns.
| external_single_structure |
|
static |
Returns an array of conversation counts for the various types of conversations, including favourites.
Return format: [ 'favourites' => 0, 'types' => [ core_message\api\MESSAGE_CONVERSATION_TYPE_INDIVIDUAL => 0, core_message\api\MESSAGE_CONVERSATION_TYPE_GROUP => 0 ] ]
| int | $userid | the id of the user whose counts we are fetching. |
| array | the array of conversation counts, indexed by type. |
| moodle_exception | if the current user cannot perform this action. |
|
static |
Returns description of method parameters for get_conversation_counts() method.
| external_function_parameters |
|
static |
Get conversation counts return description.
| core_external\external_description |
|
static |
Returns a list of conversation members.
| int | $userid | The user we are returning the conversation members for, used by helper\get_member_info. |
| int | $conversationid | The id of the conversation |
| bool | $includecontactrequests | Do we want to include contact requests with this data? |
| bool | $includeprivacyinfo | Do we want to include privacy info? |
| int | $limitfrom | |
| int | $limitnum |
| array |
|
static |
Returns get conversation members parameters description.
| external_function_parameters |
|
static |
Returns the get conversation members return description.
| core_external\external_description |
|
static |
Get conversation messages.
| int | $currentuserid | The current user's id. |
| int | $convid | The conversation id. |
| int | $limitfrom | Return a subset of records, starting at this point (optional). |
| int | $limitnum | Return a subset comprising this many records in total (optional, required if $limitfrom is set). |
| bool | $newest | True for getting first newest messages, false otherwise. |
| int | $timefrom | The time from the conversation messages to get. |
| array | The messages and members who have sent some of these messages. |
| moodle_exception |
|
static |
The conversation messages parameters.
| external_function_parameters |
|
static |
The messagearea messages return structure.
| external_single_structure |
|
static |
Get conversation parameters.
| external_function_parameters |
|
static |
Get conversation returns.
| external_single_structure |
|
static |
Get the list of conversations for the user.
| int | $userid | The id of the user who is performing the search |
| int | $limitfrom | |
| int | $limitnum | |
| int | null | $type | |
| bool | null | $favourites | |
| bool | $mergeself | whether to include self-conversations (true) or ONLY private conversations (false) when private conversations are requested. |
| stdClass |
| moodle_exception | if the messaging feature is disabled on the site. |
|
static |
Get conversations parameters.
| external_function_parameters |
|
static |
Get conversations returns.
| external_single_structure |
|
static |
Returns conversation member info for the supplied users, relative to the supplied referenceuserid.
This is the basic structure used when returning members, and includes information about the relationship between each member and the referenceuser, such as a whether the referenceuser has marked the member as a contact, or has blocked them.
| int | $referenceuserid | the id of the user which check contact and blocked status. |
| array | $userids |
| array | the array of objects containing member info. |
| moodle_exception | if messaging is disabled or if the user cannot perform the action. |
|
static |
Returns description of method parameters for get_member_info() method.
| external_function_parameters |
|
static |
Get member info return description.
| core_external\external_description |
|
static |
Get a message processor.
| int | $userid | |
| string | $name | the name of the processor |
| core_external\external_description |
| moodle_exception |
|
static |
Returns description of method parameters.
| external_function_parameters |
|
static |
Returns description of method result value.
| core_external\external_description |
|
static |
Get messages function implementation.
| invalid_parameter_exception | |
| moodle_exception |
| int | $useridto | the user id who received the message |
| int | $useridfrom | the user id who send the message. -10 or -20 for no-reply or support user |
| string | $type | type of message to return, expected values: notifications, conversations and both |
| int | $read | 1 for getting read messages, 0 for unread, 2 for both |
| bool | $newestfirst | true for ordering by newest first, false for oldest first |
| int | $limitfrom | limit from |
| int | $limitnum | limit num |
| core_external\external_description |
|
static |
Get messages parameters description.
| external_function_parameters |
|
static |
Get messages return description.
| external_single_structure |
|
staticprotected |
|
static |
Returns the number of contact requests the user has received.
| int | $userid | The ID of the user we want to return the number of received contact requests for |
| external_value |
|
static |
Returns the number of contact requests the user has received parameters description.
| external_function_parameters |
|
static |
Returns the number of contact requests the user has received return description.
| external_value |
|
static |
Get a single self-conversation.
| int | $userid | The user id to get the self-conversation for |
| int | $messagelimit | Limit number of messages to load |
| int | $messageoffset | Offset the messages |
| bool | $newestmessagesfirst | Order messages by newest first |
| stdClass |
| moodle_exception | if the messaging feature is disabled on the site. |
|
static |
Get self-conversation parameters.
| external_function_parameters |
|
static |
Get conversation returns.
| external_single_structure |
|
static |
Returns an array of unread conversation counts for the various types of conversations, including favourites.
Return format: [ 'favourites' => 0, 'types' => [ core_message\api\MESSAGE_CONVERSATION_TYPE_INDIVIDUAL => 0, core_message\api\MESSAGE_CONVERSATION_TYPE_GROUP => 0 ] ]
| int | $userid | the id of the user whose counts we are fetching. |
| array | the array of unread conversation counts, indexed by type. |
| moodle_exception | if the current user cannot perform this action. |
|
static |
Returns description of method parameters for get_unread_conversation_counts() method.
| external_function_parameters |
|
static |
Get unread conversation counts return description.
| core_external\external_description |
|
static |
Get unread messages count function.
| invalid_parameter_exception | |
| moodle_exception |
| int | $useridto | the user id who received the message |
| core_external\external_description |
|
static |
Get unread conversations count parameters description.
| external_function_parameters |
|
static |
Get unread conversations count return description.
| external_single_structure |
|
static |
Get user contacts.
| int | $userid | The id of the user who we are viewing conversations for |
| int | $limitfrom | |
| int | $limitnum |
| array |
| moodle_exception |
|
static |
The user contacts return parameters.
| external_function_parameters |
|
static |
The user contacts return structure.
| external_multiple_structure |
|
static |
Get the notification preferences for a given user.
| int | $userid | id of the user, 0 for current user |
| core_external\external_description |
| moodle_exception |
|
static |
Returns description of method parameters.
| external_function_parameters |
|
static |
Returns description of method result value.
| core_external\external_description |
|
static |
Get the notification preferences for a given user.
| int | $userid | id of the user, 0 for current user |
| core_external\external_description |
| moodle_exception |
|
static |
Returns description of method parameters.
| external_function_parameters |
|
static |
Returns description of method result value.
| core_external\external_description |
|
static |
Mark all conversation messages as read function.
| int | $userid | The user id of who we want to delete the conversation for |
| int | $conversationid | The id of the conversations |
|
static |
Mark all conversation messages as read parameters description.
| external_function_parameters |
|
static |
Mark all conversation messages as read return description.
| external_warnings |
|
static |
Mark all notifications as read function.
| invalid_parameter_exception | |
| moodle_exception |
| int | $useridto | the user id who received the message |
| int | $useridfrom | the user id who send the message. -10 or -20 for no-reply or support user |
| int | $timecreatedto | mark message created before this time as read, 0 for all messages |
| core_external\external_description |
|
static |
Mark all notifications as read parameters description.
| external_function_parameters |
|
static |
Mark all notifications as read return description.
| external_single_structure |
|
static |
Mark a single message as read, trigger message_viewed event.
| int | $messageid | id of the message (in the message table) |
| int | $timeread | timestamp for when the message should be marked read |
| core_external\external_description |
| invalid_parameter_exception | |
| moodle_exception |
|
static |
Returns description of method parameters.
| external_function_parameters |
|
static |
Returns description of method result value.
| core_external\external_description |
|
static |
Mark a single notification as read.
This will trigger a 'notification_viewed' event.
| int | $notificationid | id of the notification |
| int | $timeread | timestamp for when the notification should be marked read |
| core_external\external_description |
| invalid_parameter_exception | |
| moodle_exception |
|
static |
Returns description of method parameters.
| external_function_parameters |
|
static |
Returns description of method result value.
| core_external\external_description |
|
static |
Processes a message processor config form.
| int | $userid | the user id |
| string | $name | the name of the processor |
| array | $formvalues | the form values |
| core_external\external_description |
| moodle_exception |
|
static |
Returns description of method parameters.
| external_function_parameters |
|
static |
Returns description of method result value.
| core_external\external_description |
|
static |
Get search users results.
| int | $userid | The id of the user who is performing the search |
| string | $search | The string being searched |
| int | $limitfrom | |
| int | $limitnum |
| array |
| moodle_exception |
|
static |
Get messagearea message search users parameters.
| external_function_parameters |
|
static |
Get messagearea message search users returns.
| external_single_structure |
|
static |
Mutes conversations.
| int | $userid | The id of the user who is blocking |
| array | $conversationids | The list of conversations being muted |
| core_external\external_description |
|
static |
Mute conversations parameters description.
| external_function_parameters |
|
static |
Mute conversations return description.
| core_external\external_description |
|
static |
Search contacts.
| string | $searchtext | query string. |
| bool | $onlymycourses | limit the search to the user's courses only. |
| core_external\external_description |
|
static |
Search contacts parameters description.
| external_function_parameters |
|
static |
Search contacts return description.
| core_external\external_description |
|
static |
Send private messages from the current USER to other users.
| array | $messages | An array of message to send. |
| array |
|
static |
Returns description of method parameters.
| external_function_parameters |
|
static |
Returns description of method result value.
| core_external\external_description |
|
static |
Send messages from the current USER to a conversation.
This conversation may be any type of conversation, individual or group.
| int | $conversationid | the id of the conversation to which the messages will be sent. |
| array | $messages | An array of message to send. |
| array | the array of messages which were sent (created). |
|
static |
Returns description of method parameters.
| external_function_parameters |
|
static |
Returns description of method result value.
| core_external\external_description |
|
static |
Favourite a conversation, or list of conversations for a user.
| int | $userid | the id of the user, or 0 for the current user. |
| array | $conversationids | the list of conversations ids to favourite. |
| array |
| moodle_exception | if messaging is disabled or if the user cannot perform the action. |
|
static |
Returns description of method parameters for the favourite_conversations() method.
| external_function_parameters |
|
static |
Return a description of the returns for the create_user_favourite_conversations() method.
| core_external\external_description |
|
static |
Unblock user.
| int | $userid | The id of the user who is unblocking |
| int | $unblockeduserid | The id of the user being unblocked |
|
static |
Unblock user parameters description.
| external_function_parameters |
|
static |
Unblock user return description.
| core_external\external_description |
|
static |
Unmute conversations.
| int | $userid | The id of the user who is unblocking |
| array | $conversationids | The list of conversations being muted |
|
static |
Unmute conversations parameters description.
| external_function_parameters |
|
static |
Unmute conversations return description.
| core_external\external_description |
|
static |
Unfavourite a conversation, or list of conversations for a user.
| int | $userid | the id of the user, or 0 for the current user. |
| array | $conversationids | the list of conversations ids unset as favourites. |
| array |
| moodle_exception | if messaging is disabled or if the user cannot perform the action. |
|
static |
Returns description of method parameters for unfavourite_conversations() method.
| external_function_parameters |
|
static |
Unset favourite conversations return description.
| core_external\external_description |
|
staticprotected |
Check that the user has enough permission to retrieve message or notifications preferences.
| int | $userid | the user id requesting the preferences |
| stdClass | full user object |
| moodle_exception |
1.11.0