Public Member Functions
	__construct (SubscriptionsService $subscriptions, Queue $queue, PluginHooksService $hooks, ElggSession $session, Translator $translator, EntityTable $entities, Logger $logger)
	Constructor. More...

	registerEvent ($type, $subtype, array $actions=array())

	unregisterEvent ($type, $subtype)

	getEvents ()
	@access private More...

	registerMethod ($name)

	unregisterMethod ($name)

	getMethods ()
	@access private More...

	enqueueEvent ($action, $type, $object)
	Add a notification event to the queue. More...

	processQueue ($stopTime, $matrix=false)
	Pull notification events from queue until stop time is reached. More...

	sendInstantNotifications (\ElggEntity $sender, array $recipients=[], array $params=[])
	Notify a user via their preferences. More...

	registerDeprecatedHandler ($method, $handler)
	Register a deprecated notification handler. More...

	getDeprecatedHandler ($method)
	Get a deprecated notification handler callback. More...

	getMethodsAsDeprecatedGlobal ()
	Provides a way to incrementally wean Elgg's notifications code from the global $NOTIFICATION_HANDLERS. More...

	setDeprecatedNotificationSubject ($type, $subtype, $subject)
	Set message subject for deprecated notification code. More...

Public Attributes
const	QUEUE_NAME = 'notifications'

Protected Member Functions
	sendNotifications ($event, $subscriptions, array $params=[])
	Sends the notifications based on subscriptions. More...

	sendNotification (NotificationEvent $event, $guid, $method, array $params=[])
	Send a notification to a subscriber. More...

	getDeprecatedNotificationBody (Notification $notification, NotificationEvent $event, $method)
	Get the notification body using a pre-Elgg 1.9 plugin hook. More...

	getDeprecatedNotificationSubject ($type, $subtype)
	Get the deprecated subject. More...

	existsDeprecatedNotificationOverride (NotificationEvent $event)
	Is someone using the deprecated override. More...

Protected Attributes
	$subscriptions

	$queue

	$hooks

	$session

	$translator

	$entities

	$logger

	$events = array()

	$methods = array()

	$deprHandlers = array()

	$deprSubjects = array()

Detailed Description

Definition at line 26 of file NotificationsService.php.

Constructor & Destructor Documentation

◆ __construct()

Elgg\Notifications\NotificationsService::__construct	(	SubscriptionsService	$subscriptions,
		Queue	$queue,
		PluginHooksService	$hooks,
		ElggSession	$session,
		Translator	$translator,
		EntityTable	$entities,
		Logger	$logger
	)

Constructor.

Parameters

SubscriptionsService	$subscriptions	Subscription service
Queue	$queue	Queue
PluginHooksService	$hooks	Plugin hook service
ElggSession	$session	Session service
Translator	$translator	Translator
EntityTable	$entities	Entity table
Logger	$logger	Logger

Definition at line 74 of file NotificationsService.php.

Member Function Documentation

◆ enqueueEvent()

Elgg\Notifications\NotificationsService::enqueueEvent	(	$action,
		$type,
		$object
	)

Add a notification event to the queue.

Parameters

string	$action	Action name
string	$type	Type of the object of the action
ElggData	$object	The object of the action

Returns: void @access private

Definition at line 170 of file NotificationsService.php.

◆ existsDeprecatedNotificationOverride()

Elgg\Notifications\NotificationsService::existsDeprecatedNotificationOverride ( NotificationEvent $event )

protected

Is someone using the deprecated override.

Parameters

NotificationEvent $event Event

Returns: boolean

Definition at line 750 of file NotificationsService.php.

◆ getDeprecatedHandler()

Elgg\Notifications\NotificationsService::getDeprecatedHandler ( $method )

Get a deprecated notification handler callback.

Parameters

string $method Method name

Returns: callback|null

Definition at line 643 of file NotificationsService.php.

◆ getDeprecatedNotificationBody()

Elgg\Notifications\NotificationsService::getDeprecatedNotificationBody	(	Notification	$notification,
		NotificationEvent	$event,
			$method
	)

protected

Get the notification body using a pre-Elgg 1.9 plugin hook.

Parameters

Notification	$notification	Notification
NotificationEvent	$event	Event
string	$method	Method

Returns: Notification

Definition at line 673 of file NotificationsService.php.

◆ getDeprecatedNotificationSubject()

Elgg\Notifications\NotificationsService::getDeprecatedNotificationSubject	(	$type,
		$subtype
	)

protected

Get the deprecated subject.

Parameters

string	$type	Entity type
string	$subtype	Entity subtype

Returns: string

Definition at line 725 of file NotificationsService.php.

◆ getEvents()

Elgg\Notifications\NotificationsService::getEvents ( )

@access private

Definition at line 130 of file NotificationsService.php.

◆ getMethods()

Elgg\Notifications\NotificationsService::getMethods ( )

@access private

Definition at line 157 of file NotificationsService.php.

◆ getMethodsAsDeprecatedGlobal()

Elgg\Notifications\NotificationsService::getMethodsAsDeprecatedGlobal ( )

Provides a way to incrementally wean Elgg's notifications code from the global $NOTIFICATION_HANDLERS.

Returns: array

Definition at line 657 of file NotificationsService.php.

◆ processQueue()

Elgg\Notifications\NotificationsService::processQueue	(	$stopTime,
		$matrix = `false`
	)

Pull notification events from queue until stop time is reached.

Parameters

int	$stopTime	The Unix time to stop sending notifications
bool	$matrix	If true, will return delivery matrix instead of a notifications event count

Returns: int|array The number of notification events handled, or a delivery matrix @access private

Definition at line 203 of file NotificationsService.php.

◆ registerDeprecatedHandler()

Elgg\Notifications\NotificationsService::registerDeprecatedHandler	(	$method,
		$handler
	)

Register a deprecated notification handler.

Parameters

string	$method	Method name
string	$handler	Handler callback

Returns: void

Definition at line 633 of file NotificationsService.php.

◆ registerEvent()

Elgg\Notifications\NotificationsService::registerEvent	(		$type,
			$subtype,
		array	$actions = `array()`
	)

See also: elgg_register_notification_event() @access private

Definition at line 95 of file NotificationsService.php.

◆ registerMethod()

Elgg\Notifications\NotificationsService::registerMethod ( $name )

See also: elgg_register_notification_method() @access private

Definition at line 138 of file NotificationsService.php.

◆ sendInstantNotifications()

Elgg\Notifications\NotificationsService::sendInstantNotifications	(	\ElggEntity	$sender,
		array	$recipients = `[]`,
		array	$params = `[]`
	)

Notify a user via their preferences.

Returns an array in the form: [ 25 => [ 'email' => true, 'sms' => false, ], 55 => [], ]

Parameters

ElggEntity	$sender	Sender of the notification
ElggUser[]	$recipients	An array of entities to notify
array	$params	Notification parameters

@uses $params['subject'] string Default message subject @uses $params['body'] string Default message body @uses $params['object'] null|\ElggEntity|\ElggAnnotation The object that is triggering the notification. @uses $params['action'] null|string Word that describes the action that is triggering the notification (e.g. "create" or "update"). Defaults to "notify_user" @uses $params['summary'] null|string Summary that notification plugins can use alongside the notification title and body. @uses $params['methods_override'] string|array A string, or an array of strings specifying the delivery methods to use - or leave blank for delivery using the user's chosen delivery methods.

Returns: array @access private

Definition at line 338 of file NotificationsService.php.

◆ sendNotification()

Elgg\Notifications\NotificationsService::sendNotification	(	NotificationEvent	$event,
			$guid,
			$method,
		array	$params = `[]`
	)

protected

Send a notification to a subscriber.

Parameters

NotificationEvent	$event	The notification event
int	$guid	The guid of the subscriber
string	$method	The notification method
array	$params	Default notification params

Returns: bool @access private

Definition at line 416 of file NotificationsService.php.

◆ sendNotifications()

Elgg\Notifications\NotificationsService::sendNotifications	(		$event,
			$subscriptions,
		array	$params = `[]`
	)

protected

Sends the notifications based on subscriptions.

Returns an array in the form: [ 25 => [ 'email' => true, 'sms' => false, ], 55 => [], ]

Parameters

NotificationEvent	$event	Notification event
array	$subscriptions	Subscriptions for this event
array	$params	Default notification parameters

Returns: array @access private

Definition at line 281 of file NotificationsService.php.

◆ setDeprecatedNotificationSubject()

Elgg\Notifications\NotificationsService::setDeprecatedNotificationSubject	(	$type,
		$subtype,
		$subject
	)

Set message subject for deprecated notification code.

Parameters

string	$type	Entity type
string	$subtype	Entity subtype
string	$subject	Subject line

Returns: void

Definition at line 703 of file NotificationsService.php.

◆ unregisterEvent()

Elgg\Notifications\NotificationsService::unregisterEvent	(	$type,
		$subtype
	)

See also: elgg_unregister_notification_event() @access private

Definition at line 116 of file NotificationsService.php.

◆ unregisterMethod()

Elgg\Notifications\NotificationsService::unregisterMethod ( $name )

See also: elgg_unregister_notification_method() @access private

Definition at line 146 of file NotificationsService.php.

Member Data Documentation

◆ $deprHandlers

Elgg\Notifications\NotificationsService::$deprHandlers = array()

protected

Definition at line 58 of file NotificationsService.php.

◆ $deprSubjects

Elgg\Notifications\NotificationsService::$deprSubjects = array()

protected

Definition at line 61 of file NotificationsService.php.

◆ $entities

Elgg\Notifications\NotificationsService::$entities

protected

Definition at line 46 of file NotificationsService.php.

◆ $events

Elgg\Notifications\NotificationsService::$events = array()

protected

Definition at line 52 of file NotificationsService.php.

◆ $hooks

Elgg\Notifications\NotificationsService::$hooks

protected

Definition at line 37 of file NotificationsService.php.

◆ $logger

Elgg\Notifications\NotificationsService::$logger

protected

Definition at line 49 of file NotificationsService.php.

◆ $methods

Elgg\Notifications\NotificationsService::$methods = array()

protected

Definition at line 55 of file NotificationsService.php.

◆ $queue

Elgg\Notifications\NotificationsService::$queue

protected

Definition at line 34 of file NotificationsService.php.

◆ $session

Elgg\Notifications\NotificationsService::$session

protected

Definition at line 40 of file NotificationsService.php.

◆ $subscriptions

Elgg\Notifications\NotificationsService::$subscriptions

protected

Definition at line 31 of file NotificationsService.php.

◆ $translator

Elgg\Notifications\NotificationsService::$translator

protected

Definition at line 43 of file NotificationsService.php.

◆ QUEUE_NAME

const Elgg\Notifications\NotificationsService::QUEUE_NAME = 'notifications'

Definition at line 28 of file NotificationsService.php.

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

engine/classes/Elgg/Notifications/NotificationsService.php

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ enqueueEvent()

◆ existsDeprecatedNotificationOverride()

◆ getDeprecatedHandler()

◆ getDeprecatedNotificationBody()

◆ getDeprecatedNotificationSubject()

◆ getEvents()

◆ getMethods()

◆ getMethodsAsDeprecatedGlobal()

◆ processQueue()

◆ registerDeprecatedHandler()

◆ registerEvent()

◆ registerMethod()

◆ sendInstantNotifications()

◆ sendNotification()

◆ sendNotifications()

◆ setDeprecatedNotificationSubject()

◆ unregisterEvent()

◆ unregisterMethod()

Member Data Documentation

◆ $deprHandlers

◆ $deprSubjects

◆ $entities

◆ $events

◆ $hooks

◆ $logger

◆ $methods

◆ $queue

◆ $session

◆ $subscriptions

◆ $translator

◆ QUEUE_NAME