Elgg\Ajax\Service Class Reference

Models the Ajax API service. More...

Public Member Functions
	__construct (EventsService $events, SystemMessagesService $msgs, Request $request, Config $amdConfig)
	Constructor. More...
	isAjax2Request ()
	Did the request come from the elgg/Ajax module? More...
	isReady ()
	Is the service ready to respond to the request? More...
	decodeJson ($string)
	Attempt to JSON decode the given string. More...
	respondFromOutput ($output, string $event_type= '', bool $try_decode=true)
	Send a JSON HTTP response with the given output. More...
	respondFromApiResponse (AjaxResponse $api_response, string $event_type= '')
	Send a JSON HTTP response based on the given API response. More...
	respondWithError (string $msg= '', int $status=400)
	Send a JSON HTTP 400 response. More...
	prepareResponse (\Elgg\Event $event)
	Prepare the response with additional metadata, like system messages and required AMD modules. More...
	registerView (string $view)
	Register a view to be available for ajax calls. More...
	unregisterView (string $view)
	Unregister a view for ajax calls. More...
	getViews ()
	Returns an array of views allowed for ajax calls. More...

Detailed Description

Models the Ajax API service.

Since

1.12.0

Definition at line 19 of file Service.php.

Constructor & Destructor Documentation

Elgg\Ajax\Service::__construct	(	EventsService	$events,
		SystemMessagesService	$msgs,
		Request	$request,
		Config	$amdConfig
	)

Constructor.

Parameters

EventsService	$events	Events service
SystemMessagesService	$msgs	System messages service
Request	$request	Http Request
Config	$amdConfig	AMD config

Definition at line 59 of file Service.php.

Member Function Documentation

Elgg\Ajax\Service::decodeJson

(

$string

)

Attempt to JSON decode the given string.

Parameters

mixed

$string

Output string

Returns

mixed

Definition at line 99 of file Service.php.

Elgg\Ajax\Service::getViews

(

)

Returns an array of views allowed for ajax calls.

Returns

string[]

Definition at line 283 of file Service.php.

Elgg\Ajax\Service::isAjax2Request

(

)

Did the request come from the elgg/Ajax module?

Returns

bool

Definition at line 74 of file Service.php.

Elgg\Ajax\Service::isReady

(

)

Is the service ready to respond to the request?

Some code paths involve multiple layers of handling (e.g. router calls actions/ajax views) so we must check whether the response has already been sent to avoid sending it twice. We can't use headers_sent() because Router needs to use output buffering.

Returns

bool

Definition at line 88 of file Service.php.

Elgg\Ajax\Service::prepareResponse

(

\Elgg\Event

$event

)

Prepare the response with additional metadata, like system messages and required AMD modules.

Parameters

\Elgg\Event

$event

"ajax_response", "all"

Returns

AjaxResponse

Definition at line 232 of file Service.php.

Elgg\Ajax\Service::registerView

(

string

$view

)

Register a view to be available for ajax calls.

Parameters

string

$view

The view name

Returns

void

Definition at line 263 of file Service.php.

Elgg\Ajax\Service::respondFromApiResponse	(	AjaxResponse	$api_response,
		string	$event_type = ''
	)

Send a JSON HTTP response based on the given API response.

Parameters

AjaxResponse	$api_response	API response
string	$event_type	The event type. If given, the response will be filtered by event

Returns

JsonResponse|false

Definition at line 146 of file Service.php.

Elgg\Ajax\Service::respondFromOutput	(		$output,
		string	$event_type = '',
		bool	$try_decode = true
	)

Send a JSON HTTP response with the given output.

Parameters

mixed	$output	Output from a page/action handler
string	$event_type	The event type. If given, the response will be filtered by event
bool	$try_decode	Try to convert a JSON string back to an abject

Returns

JsonResponse|false

Definition at line 117 of file Service.php.

Elgg\Ajax\Service::respondWithError	(	string	$msg = '',
		int	$status = 400
	)

Send a JSON HTTP 400 response.

Parameters

string	$msg	The error message (not displayed to the user)
int	$status	The HTTP status code

Returns

JsonResponse|false

Definition at line 162 of file Service.php.

Elgg\Ajax\Service::unregisterView

(

string

$view

)

Unregister a view for ajax calls.

Parameters

string

$view

The view name

Returns

void

Definition at line 274 of file Service.php.

---

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

• engine/classes/Elgg/Ajax/Service.php