Elgg\Ajax\Service Class Reference

Models the Ajax API service. More...

Public Member Functions
	__construct (PluginHooksService $hooks, SystemMessagesService $msgs, Input $input, 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, $hook_type= '', $try_decode=true)
	Send a JSON HTTP response with the given output. More...
	respondFromApiResponse (AjaxResponse $api_response, $hook_type= '')
	Send a JSON HTTP response based on the given API response. More...
	respondWithError ($msg= '', $status=400)
	Send a JSON HTTP 400 response. More...
	appendMessages ($hook, $type, $response, $params)
	Send system messages back with the response. More...
	appendDeps ($hook, $type, $response, $params)
	Send required AMD modules list back with the response. More...
	registerView ($view)
	Register a view to be available for ajax calls. More...
	unregisterView ($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 private

Definition at line 20 of file Service.php.

Constructor & Destructor Documentation

Elgg\Ajax\Service::__construct	(	PluginHooksService	$hooks,
		SystemMessagesService	$msgs,
		Input	$input,
		Config	$amdConfig
	)

Constructor.

Parameters

PluginHooksService	$hooks	Hooks service
SystemMessagesService	$msgs	System messages service
Input	$input	Input service
Config	$amdConfig	AMD config

Definition at line 60 of file Service.php.

Member Function Documentation

Elgg\Ajax\Service::appendDeps	(		$hook,
			$type,
			$response,
			$params
	)

Send required AMD modules list back with the response.

Parameters

string	$hook	"ajax_response"
string	$type	"all"
AjaxResponse	$response	Ajax response
array	$params	Hook params

Returns

AjaxResponse private

Definition at line 262 of file Service.php.

Elgg\Ajax\Service::appendMessages	(		$hook,
			$type,
			$response,
			$params
	)

Send system messages back with the response.

Parameters

string	$hook	"ajax_response"
string	$type	"all"
AjaxResponse	$response	Ajax response
array	$params	Hook params

Returns

AjaxResponse private

Definition at line 242 of file Service.php.

Elgg\Ajax\Service::decodeJson

(

$string

)

Attempt to JSON decode the given string.

Parameters

mixed

$string

Output string

Returns

mixed

Definition at line 106 of file Service.php.

Elgg\Ajax\Service::getViews

(

)

Returns an array of views allowed for ajax calls.

Returns

string[]

Definition at line 294 of file Service.php.

Elgg\Ajax\Service::isAjax2Request

(

)

Did the request come from the elgg/Ajax module?

Returns

bool

Definition at line 82 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 96 of file Service.php.

Elgg\Ajax\Service::registerView

(

$view

)

Register a view to be available for ajax calls.

Parameters

string

$view

The view name

Returns

void

Definition at line 276 of file Service.php.

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

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

Parameters

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

Returns

JsonResponse

Definition at line 145 of file Service.php.

Elgg\Ajax\Service::respondFromOutput	(		$output,
			$hook_type = '',
			$try_decode = true
	)

Send a JSON HTTP response with the given output.

Parameters

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

Returns

JsonResponse

Definition at line 122 of file Service.php.

Elgg\Ajax\Service::respondWithError	(		$msg = '',
			$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

Definition at line 160 of file Service.php.

Elgg\Ajax\Service::unregisterView

(

$view

)

Unregister a view for ajax calls.

Parameters

string

$view

The view name

Returns

void

Definition at line 286 of file Service.php.

---

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

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