Topics
	cache


	external


	message


	privacy


	test

Namespaces
namespace	core\message
	New messaging manager class.

namespace	core\message\inbound
	Incoming Message address manager.

namespace	core_message
	Contains class used to return information to display for the message area.

namespace	core_message\output
	Contains class used to prepare a message processor for display.

namespace	core_message\output\preferences
	Contains message_notification_list class for displaying on message preferences page.

namespace	core_message\search
	Search area base class for messages.

namespace	core_message\task
	Adhoc task handling migrating data to the new messaging table schema.

namespace	core_message\tests
	Contains a helper class providing util methods for testing.

Classes
class	core\message\inbound\address_manager
	Incoming Message address manager. More...

class	core\message\inbound\handler
	Abstract class describing Inbound Message Handlers. More...

class	core\message\inbound\manager
	Variable Envelope Return Path manager class. More...

class	core\message\inbound\private_files_handler
	A Handler to store attachments sent in e-mails as private files. More...

class	core\message\inbound\processing_failed_exception
	Variable Envelope Return Path message processing failure exception. More...

class	core\message\message
	New messaging class. More...

class	core_message\helper
	Helper class for the message area. More...

class	core_message\output\preferences\message_notification_list
	Class to create context for the list of notifications on the message preferences page. More...

class	core_message\output\preferences\message_notification_list_component
	Class to create context for a notification component on the message preferences page. More...

class	core_message\output\preferences\notification_list
	Class to create context for the list of notifications on the message preferences page. More...

class	core_message\output\preferences\notification_list_component
	Class to create context for a notification component on the message preferences page. More...

class	core_message\output\preferences\notification_list_processor
	Class to create context for a notification component on the message preferences page. More...

class	core_message\output\preferences\processor
	Class to create context for one of the message processors settings on the message preferences page. More...

class	core_message\output\processor
	Class to prepare a message processor for display. More...

class	core_message\search\base_message
	Search area base class for messages. More...

class	core_message\search\message_received
	Search area for received messages. More...

class	core_message\search\message_sent
	Search area for sent messages. More...

class	core_message\task\migrate_message_data
	Class handling migrating data to the new messaging table schema. More...

class	core_message\tests\helper
	The helper class providing util methods for testing. More...

class	core_message_renderer
	message Renderer More...

class	message_output
	Contains a base class for extension by message processors. More...

Functions
	core_message_can_edit_message_profile ($user)
	Checks if current user is allowed to edit messaging preferences of another user.

	core_message_standard_after_main_region_html ()
	Render the message drawer to be included in the top of the body of each page.

	core_message_user_preferences ()
	Implements callback user_preferences, lists preferences that users are allowed to update directly.

	get_message_output_default_preferences ()
	Get messaging outputs default (site) preferences.

	get_message_processor ($type)
	Get an instance of the message_output class for one of the output plugins.

	get_message_processors ($ready=false, $reset=false, $resetonly=false)
	Get all message processors, validate corresponding plugin existance and system configuration.

	get_message_providers ()
	Get all message providers, validate their plugin existance and system configuration.

	message_format_contexturl ($message)
	Format a the context url and context url name of a message for display.

	message_format_message ($message, $format='', $keywords='', $class='other')
	Format a message for display in the message history.

	message_get_messages ($useridto, $useridfrom=0, $notifications=-1, $read=MESSAGE_GET_READ, $sort='mr.timecreated DESC', $limitfrom=0, $limitnum=0)
	Get messages sent or/and received by the specified users.

	message_output_fragment_processor_settings ($args=[])
	Handles displaying processor settings in a fragment.

	message_page_type_list (string $pagetype, ?context $parentcontext, ?context $currentcontext)
	Return a list of page types.

	message_post_message ($userfrom, $userto, $message, $format)
	Send a message from one user to another.

	message_search_users ($courseids, $searchtext, $sort='', $exceptions='')
	Search through course users.

	translate_message_default_setting ($plugindefault, $processorname)
	Translate message default settings from binary value to the array of string representing the settings to be stored.

Variables
	$handlers

const	MESSAGE_DEFAULT_ENABLED 0x01

const	MESSAGE_DEFAULT_LOGGEDIN 0x01
	Define contants for messaging default settings population.

const	MESSAGE_DEFAULT_LOGGEDOFF 0x02

const	MESSAGE_DEFAULT_MAX_POLL_IN_SECONDS 2 * MINSECS

const	MESSAGE_DEFAULT_MIN_POLL_IN_SECONDS 10
	Set default values for polling.

const	MESSAGE_DEFAULT_PERMITTED 'permitted'
	Set default value for default outputs permitted setting.

const	MESSAGE_DEFAULT_TIMEOUT_POLL_IN_SECONDS 5 * MINSECS

const	MESSAGE_DISALLOWED 0x04

const	MESSAGE_FORCED 0x0c

const	MESSAGE_GET_READ 1

const	MESSAGE_GET_READ_AND_UNREAD 2

const	MESSAGE_GET_UNREAD 0
	To get only read, unread or both messages or notifications.

const	MESSAGE_HISTORY_ALL 1

const	MESSAGE_PERMITTED 0x08

const	MESSAGE_PERMITTED_MASK 0x0c

const	MESSAGE_SEARCH_MAX_RESULTS 200

const	MESSAGE_SHORTLENGTH 300
	Library functions for messaging.

const	MESSAGE_TYPE_MESSAGE 'message'

const	MESSAGE_TYPE_NOTIFICATION 'notification'

Detailed Description

Function Documentation

◆ core_message_can_edit_message_profile()

core_message_can_edit_message_profile ( $user )

Checks if current user is allowed to edit messaging preferences of another user.

Parameters

stdClass $user user whose preferences we are updating

Return values

bool

◆ core_message_standard_after_main_region_html()

core_message_standard_after_main_region_html ( )

Render the message drawer to be included in the top of the body of each page.

Return values

string HTML

◆ core_message_user_preferences()

core_message_user_preferences ( )

Implements callback user_preferences, lists preferences that users are allowed to update directly.

Used in {

See also: core_user\fill_preferences_cache()}, see also {; useredit_update_user_preference()}

Return values

array

◆ get_message_output_default_preferences()

get_message_output_default_preferences ( )

Get messaging outputs default (site) preferences.

Return values

object\$processors object containing information on message processors

◆ get_message_processor()

get_message_processor ( $type )

Get an instance of the message_output class for one of the output plugins.

Parameters

string $type the message output type. E.g. 'email' or 'jabber'.

Return values

message_output message_output the requested class.

◆ get_message_processors()

get_message_processors	(	$ready = false,
		$reset = false,
		$resetonly = false )

Get all message processors, validate corresponding plugin existance and system configuration.

Parameters

bool	$ready	only return ready-to-use processors
bool	$reset	Reset list of message processors (used in unit tests)
bool	$resetonly	Just reset, then exit

Return values

mixed\$processors array of objects containing information on message processors

◆ get_message_providers()

get_message_providers ( )

Get all message providers, validate their plugin existance and system configuration.

Return values

mixed\$processors array of objects containing information on message processors

◆ message_format_contexturl()

message_format_contexturl ( $message )

Format a the context url and context url name of a message for display.

Parameters

object $message the message object

Return values

string the formatted string

◆ message_format_message()

message_format_message	(	$message,
		$format = '',
		$keywords = '',
		$class = 'other' )

Format a message for display in the message history.

Parameters

object	$message	the message object
string	$format	optional date format
string	$keywords	keywords to highlight
string	$class	CSS class to apply to the div around the message

Return values

string the formatted message

◆ message_get_messages()

message_get_messages	(	$useridto,
		$useridfrom = 0,
		$notifications = -1,
		$read = MESSAGE_GET_READ,
		$sort = 'mr.timecreated DESC',
		$limitfrom = 0,
		$limitnum = 0 )

Get messages sent or/and received by the specified users.

Please note that this function return deleted messages too. Besides, only individual conversation messages are returned to maintain backwards compatibility.

Parameters

int	$useridto	the user id who received the message
int	$useridfrom	the user id who sent the message. -10 or -20 for no-reply or support user
int	$notifications	1 for retrieving notifications, 0 for messages, -1 for both
int	$read	Either MESSAGE_GET_READ, MESSAGE_GET_UNREAD or MESSAGE_GET_READ_AND_UNREAD.
string	$sort	the column name to order by including optionally direction
int	$limitfrom	limit from
int	$limitnum	limit num

Return values

external_description

Since: 2.8

◆ message_output_fragment_processor_settings()

message_output_fragment_processor_settings ( $args = [] )

Handles displaying processor settings in a fragment.

Parameters

array $args

Return values

bool|string

Exceptions

moodle_exception

◆ message_page_type_list()

message_page_type_list	(	string	$pagetype,
		?context	$parentcontext,
		?context	$currentcontext )

Return a list of page types.

Parameters

string	$pagetype	current page type
context \| null	$parentcontext	Block's parent context
context \| null	$currentcontext	Current context of block

Return values

array

◆ message_post_message()

message_post_message	(	$userfrom,
		$userto,
		$message,
		$format )

Send a message from one user to another.

Will be delivered according to the message recipients messaging preferences

Parameters

object	$userfrom	the message sender
object	$userto	the message recipient
string	$message	the message
int	$format	message format such as FORMAT_PLAIN or FORMAT_HTML

Return values

int|false the ID of the new message or false

◆ message_search_users()

message_search_users	(	$courseids,
		$searchtext,
		$sort = '',
		$exceptions = '' )

Search through course users.

If $courseids contains the site course then this function searches through all undeleted and confirmed users.

Parameters

int \| array	$courseids	Course ID or array of course IDs.
string	$searchtext	the text to search for.
string	$sort	the column name to order by.
string \| array	$exceptions	comma separated list or array of user IDs to exclude.

Return values

array An array of $USER records.

◆ translate_message_default_setting()

translate_message_default_setting	(		$plugindefault,
			$processorname )

Translate message default settings from binary value to the array of string representing the settings to be stored.

Also validate the provided value and use default if it is malformed.

Todo: Remove usage of MESSAGE_DEFAULT_LOGGEDOFF on MDL-73284.

Parameters

int	$plugindefault	Default setting suggested by plugin
string	$processorname	The name of processor

Return values

array\$settings array of strings in the order: $locked, $enabled.

Variable Documentation

◆ $handlers

$handlers

Initial value:

= array(
    array(
        'classname' => '\core\message\inbound\private_files_handler',
        'defaultexpiration' => 0,
    ),
)

◆ MESSAGE_DEFAULT_LOGGEDIN

const MESSAGE_DEFAULT_LOGGEDIN 0x01

Define contants for messaging default settings population.

For unambiguity of plugin developer intentions we use 4-bit value (LSB numbering): bit 0 - whether to send message (MESSAGE_DEFAULT_ENABLED) bit 1 - Deprecated: whether to send message (MESSAGE_DEFAULT_LOGGEDOFF). Used to mean only when the user is logged off. bit 2..3 - messaging permission (MESSAGE_DISALLOWED|MESSAGE_PERMITTED|MESSAGE_FORCED)

MESSAGE_PERMITTED_MASK contains the mask we use to distinguish permission setting.

Deprecated: since Moodle 4.0. Use MESSAGE_DEFAULT_ENABLED instead.

Todo: Remove on MDL-73284.

◆ MESSAGE_DEFAULT_LOGGEDOFF

const MESSAGE_DEFAULT_LOGGEDOFF 0x02

Deprecated: since Moodle 4.0 MDL-73284. Use MESSAGE_DEFAULT_ENABLED instead.

Todo: Remove on MDL-73284.

◆ MESSAGE_DEFAULT_PERMITTED

const MESSAGE_DEFAULT_PERMITTED 'permitted'

Set default value for default outputs permitted setting.

Deprecated: since Moodle 4.0 MDL-73284.

Todo: Remove on MDL-73284.

◆ MESSAGE_SHORTLENGTH

const MESSAGE_SHORTLENGTH 300

Library functions for messaging.

License: http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Topics

Namespaces

Classes

Functions

Variables

Detailed Description

Function Documentation

◆ core_message_can_edit_message_profile()

◆ core_message_standard_after_main_region_html()

◆ core_message_user_preferences()

◆ get_message_output_default_preferences()

◆ get_message_processor()

◆ get_message_processors()

◆ get_message_providers()

◆ message_format_contexturl()

◆ message_format_message()

◆ message_get_messages()

◆ message_output_fragment_processor_settings()

◆ message_page_type_list()

◆ message_post_message()

◆ message_search_users()

◆ translate_message_default_setting()

Variable Documentation

◆ $handlers

◆ MESSAGE_DEFAULT_LOGGEDIN

◆ MESSAGE_DEFAULT_LOGGEDOFF

◆ MESSAGE_DEFAULT_PERMITTED

◆ MESSAGE_SHORTLENGTH