message_output Class Reference

Base message processor class for extension by message processors. More...

Inheritance diagram for message_output:

Public Member Functions
	can_send_to_any_users ()
	Returns true if message can be sent to fake/internal user as well. More...
	config_form ($preferences)
	Create necessary fields in the config form on the messaging preferences page. More...
	force_process_messages ()
	Determines if this processor should process a message regardless of user preferences or site settings. More...
	get_default_messaging_settings ()
	Returns the message processors default settings Should the processor be enabled for logged in users by default? Should the processor be enabled for logged off users by default? Is enabling it disallowed, permitted or forced? More...
	has_message_preferences ()
	Returns true if this processor has configurable message preferences. More...
	is_system_configured ()
	Are the message processor's system settings configured? More...
	is_user_configured ($user=null)
	Are the message processor's user specific settings configured? More...
	load_data (&$preferences, $userid)
	Load the config data from database to put on the config form on the messaging preferences page. More...
	process_form ($form, &$preferences)
	Parse the submitted form and save data into an array of user preferences. More...
	send_message ($message)
	Process a message received by a user. More...

Detailed Description

Base message processor class for extension by message processors.

Copyright

2008 Luis Rodrigues

License

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

Member Function Documentation

can_send_to_any_users()

message_output::can_send_to_any_users

(

)

Returns true if message can be sent to fake/internal user as well.

If message_output support message to be sent to fake user, then it should return true, like email.

Return values

bool

Reimplemented in message_output_email.

config_form()

message_output::config_form (   $preferences )

abstract

Create necessary fields in the config form on the messaging preferences page.

Parameters

array

$preferences

An array of user preferences

Reimplemented in message_output_jabber, message_output_email, and message_output_airnotifier.

force_process_messages()

message_output::force_process_messages

(

)

Determines if this processor should process a message regardless of user preferences or site settings.

Return values

bool

get_default_messaging_settings()

message_output::get_default_messaging_settings

(

)

Returns the message processors default settings Should the processor be enabled for logged in users by default? Should the processor be enabled for logged off users by default? Is enabling it disallowed, permitted or forced?

Return values

int	The Default message output settings expressed as a bit mask MESSAGE_DEFAULT_LOGGEDIN + MESSAGE_DEFAULT_LOGGEDOFF + MESSAGE_DISALLOWED|MESSAGE_PERMITTED|MESSAGE_FORCED

Reimplemented in message_output_email.

has_message_preferences()

message_output::has_message_preferences

(

)

Returns true if this processor has configurable message preferences.

This is distinct from notification preferences.

Return values

bool

is_system_configured()

message_output::is_system_configured

(

)

Are the message processor's system settings configured?

Return values

bool	True if all necessary config settings been entered

Reimplemented in message_output_jabber, and message_output_airnotifier.

is_user_configured()

message_output::is_user_configured

(

$user = null

)

Are the message processor's user specific settings configured?

Parameters

stdClass

$user

the user object, defaults to $USER.

Return values

bool	True if the user has all necessary settings in their messaging preferences

Reimplemented in message_output_jabber.

load_data()

message_output::load_data ( &  $preferences,   $userid  )

abstract

Load the config data from database to put on the config form on the messaging preferences page.

Parameters

array	$preferences	Array of user preferences
int	$userid	The user ID

Reimplemented in message_output_jabber, message_output_email, and message_output_airnotifier.

process_form()

message_output::process_form (   $form, &  $preferences  )

abstract

Parse the submitted form and save data into an array of user preferences.

Parameters

stdClass	$form	preferences form class
array	$preferences	preferences array

Reimplemented in message_output_jabber, message_output_email, and message_output_airnotifier.

send_message()

message_output::send_message (   $message )

abstract

Process a message received by a user.

See also

message_send()

Parameters

stdClass

$message

The event data submitted by the message provider to message_send() plus $eventdata->savedmessageid

Reimplemented in message_output_jabber, message_output_email, and message_output_airnotifier.

---

The documentation for this class was generated from the following file:

• message/output/lib.php