Namespaces
	Elgg\Core
	Activate a plugin or plugins.

Functions
	elgg_register_library ($name, $location)
	Register a PHP file as a library. More...

	elgg_load_library ($name)
	Load a PHP library. More...

	forward ($location="", $reason= 'system')
	Forward to $location. More...

	elgg_register_js ($name, $url, $location= 'head', $priority=null)
	Register a JavaScript file for inclusion. More...

	elgg_define_js ($name, $config)
	Defines a JS lib as an AMD module. More...

	elgg_unregister_js ($name)
	Unregister a JavaScript file. More...

	elgg_load_js ($name)
	Load a JavaScript resource on this page. More...

	elgg_require_js ($name)
	Request that Elgg load an AMD module onto the page. More...

	elgg_get_loaded_js ($location= 'head')
	Get the JavaScript URLs that are loaded. More...

	elgg_register_css ($name, $url, $priority=null)
	Register a CSS file for inclusion in the HTML head. More...

	elgg_unregister_css ($name)
	Unregister a CSS file. More...

	elgg_load_css ($name)
	Load a CSS file for this page. More...

	elgg_get_loaded_css ()
	Get the loaded CSS URLs. More...

	elgg_register_external_file ($type, $name, $url, $location, $priority=500)
	Core registration function for external files. More...

	elgg_unregister_external_file ($type, $name)
	Unregister an external file. More...

	elgg_load_external_file ($type, $name)
	Load an external resource for use on this page. More...

	elgg_get_loaded_external_files ($type, $location)
	Get external resource descriptors. More...

	elgg_get_file_list ($directory, $exceptions=array(), $list=array(), $extensions=null)
	Returns a list of files in $directory. More...

	sanitise_filepath ($path, $append_slash=true)
	Sanitise file paths ensuring that they begin and end with slashes etc. More...

	system_messages ($message=null, $register="success", $count=false)
	Queues a message to be displayed. More...

	count_messages ($register="")
	Counts the number of messages, either globally or in a particular register. More...

	system_message ($message)
	Display a system message on next page load. More...

	register_error ($error)
	Display an error on next page load. More...

	elgg_register_event_handler ($event, $object_type, $callback, $priority=500)

	elgg_unregister_event_handler ($event, $object_type, $callback)
	Unregisters a callback for an event. More...

	elgg_trigger_event ($event, $object_type, $object=null)

	elgg_trigger_before_event ($event, $object_type, $object=null)
	Trigger a "Before event" indicating a process is about to begin. More...

	elgg_trigger_after_event ($event, $object_type, $object=null)
	Trigger an "After event" indicating a process has finished. More...

	elgg_trigger_deprecated_event ($event, $object_type, $object=null, $message, $version)
	Trigger an event normally, but send a notice about deprecated use if any handlers are registered. More...

	elgg_register_plugin_hook_handler ($hook, $type, $callback, $priority=500)

	elgg_unregister_plugin_hook_handler ($hook, $entity_type, $callback)
	Unregister a callback as a plugin hook. More...

	elgg_trigger_plugin_hook ($hook, $type, $params=null, $returnvalue=null)

	_elgg_php_exception_handler ($exception)
	Intercepts, logs, and displays uncaught exceptions. More...

	_elgg_php_error_handler ($errno, $errmsg, $filename, $linenum, $vars)
	Intercepts catchable PHP errors. More...

	elgg_log ($message, $level= 'NOTICE')
	Display or log a message. More...

	elgg_dump ($value, $to_screen=true)
	Logs or displays $value. More...

	elgg_get_version ($human_readable=false)
	Get the current Elgg version information. More...

	elgg_deprecated_notice ($msg, $dep_version, $backtrace_level=1)
	Log a notice about deprecated use of a function, view, etc. More...

	elgg_http_build_url (array $parts, $html_encode=true)
	Builds a URL from the a parts array like one returned by parse_url(). More...

	elgg_add_action_tokens_to_url ($url, $html_encode=false)
	Adds action tokens to URL. More...

	elgg_http_remove_url_query_element ($url, $element)
	Removes an element from a URL's query string. More...

	elgg_http_add_url_query_elements ($url, array $elements)
	Sets elements in a URL's query string. More...

	elgg_http_url_is_identical ($url1, $url2, $ignore_params=array('offset', 'limit'))
	Test if two URLs are functionally identical. More...

	elgg_extract ($key, array $array, $default=null, $strict=true)
	Checks for $array[$key] and returns its value if it exists, else returns $default. More...

	elgg_sort_3d_array_by_value (&$array, $element, $sort_order=SORT_ASC, $sort_type=SORT_LOCALE_STRING)
	Sorts a 3d array by specific element. More...

	ini_get_bool ($ini_get_arg)
	Return the state of a php.ini setting as a bool. More...

	elgg_get_ini_setting_in_bytes ($setting)
	Returns a PHP INI setting in bytes. More...

	is_not_null ($string)
	Returns true is string is not empty, false, or null. More...

	_elgg_normalize_plural_options_array ($options, $singulars)
	Normalise the singular keys in an options array to plural keys. More...

	_elgg_shutdown_hook ()
	Emits a shutdown:system event upon PHP shutdown, but before database connections are dropped. More...

	_elgg_js_page_handler ($page)
	Serve javascript pages. More...

	_elgg_ajax_page_handler ($page)
	Serve individual views for Ajax. More...

	_elgg_css_page_handler ($page)
	Serve CSS. More...

	_elgg_favicon_page_handler ($segments)
	Handle requests for /favicon.ico. More...

	_elgg_cacheable_view_page_handler ($page, $type)
	Serves a JS or CSS view with headers for caching. More...

	_elgg_sql_reverse_order_by_clause ($order_by)
	Reverses the ordering in an ORDER BY clause. More...

	elgg_batch_enable_callback ($object)
	Enable objects with an enable() method. More...

	elgg_batch_disable_callback ($object)
	Disable objects with a disable() method. More...

	elgg_batch_delete_callback ($object)
	Delete objects with a delete() method. More...

	_elgg_is_valid_options_for_batch_operation ($options, $type)
	Checks if there are some constraints on the options array for potentially dangerous operations. More...

	_elgg_walled_garden_index ()
	Intercepts the index page when Walled Garden mode is enabled. More...

	_elgg_walled_garden_ajax_handler ($page)
	Serve walled garden sections. More...

	_elgg_walled_garden_init ()
	Checks the status of the Walled Garden and forwards to a login page if required. More...

	_elgg_walled_garden_remove_public_access ($hook, $type, $accesses)
	Remove public access for walled gardens. More...

	_elgg_engine_boot ()
	Boots the engine. More...

	_elgg_init ()
	Elgg's main init. More...

	_elgg_api_test ($hook, $type, $value, $params)
	Adds unit tests for the general API. More...

Variables
const	ACCESS_DEFAULT -1

const	ACCESS_PRIVATE 0

const	ACCESS_LOGGED_IN 1

const	ACCESS_PUBLIC 2

const	ACCESS_FRIENDS -2

const	ELGG_ENTITIES_ANY_VALUE null

const	ELGG_ENTITIES_NO_VALUE 0

const	REFERRER -1

const	REFERER -1

return	function (\Elgg\EventsService $events,\Elgg\HooksRegistrationService $hooks)

Function Documentation

_elgg_ajax_page_handler ( $page )

Serve individual views for Ajax.

/ajax/view/<name of="" view>="">?<key/value params>

Parameters

array $page Array of URL segements

Returns: bool

See also: elgg_register_ajax_view() ajax private

Definition at line 1463 of file elgglib.php.

_elgg_api_test	(	$hook,
		$type,
		$value,
		$params
	)

Adds unit tests for the general API.

Parameters

string	$hook	unit_test
string	$type	system
array	$value	array of test files
array	$params	empty

unit_tests system

Returns: array private

Definition at line 1936 of file elgglib.php.

_elgg_cacheable_view_page_handler	(	$page,
		$type
	)

Serves a JS or CSS view with headers for caching.

/<css||js>/name/of/view.<last_cache>.<css||js>

Parameters

array	$page	The page array
string	$type	The type: js or css

Returns: bool private

Definition at line 1560 of file elgglib.php.

_elgg_css_page_handler ( $page )

Serve CSS.

Serves CSS from the css views directory with headers for caching control

Parameters

array $page The page array

Returns: bool css private

Definition at line 1518 of file elgglib.php.

_elgg_engine_boot ( )

Boots the engine.

sets error handlers
connects to database
verifies the installation succeeded
loads application configuration
loads i18n data
loads cached autoloader state
loads site configuration

private

Definition at line 1833 of file elgglib.php.

_elgg_favicon_page_handler ( $segments )

Handle requests for /favicon.ico.

Parameters

string[] $segments The URL segments

Returns: bool private

Since: 1.10

Definition at line 1535 of file elgglib.php.

_elgg_init ( )

Elgg's main init.

Handles core actions for comments, the JS pagehandler, and the shutdown function.

init system

Returns: void private

Definition at line 1864 of file elgglib.php.

_elgg_is_valid_options_for_batch_operation	(	$options,
		$type
	)

Checks if there are some constraints on the options array for potentially dangerous operations.

Parameters

array	$options	Options array
string	$type	Options type: metadata or annotation

Returns: bool private

Definition at line 1687 of file elgglib.php.

_elgg_js_page_handler ( $page )

Serve javascript pages.

Searches for views under js/ and outputs them with special headers for caching control.

Parameters

array $page The page array

Returns: bool js private

Definition at line 1447 of file elgglib.php.

_elgg_normalize_plural_options_array	(	$options,
		$singulars
	)

Normalise the singular keys in an options array to plural keys.

Used in elgg_get_entities*() functions to support shortcutting plural names by singular names.

Parameters

array	$options	The options array. $options['keys'] = 'values';
array	$singulars	A list of singular words to pluralize by adding 's'.

Returns: array

Since: 1.7.0 private

Definition at line 1376 of file elgglib.php.

_elgg_php_error_handler	(	$errno,
		$errmsg,
		$filename,
		$linenum,
		$vars
	)

Intercepts catchable PHP errors.

Warning: This function should never be called directly.

Definition at line 883 of file elgglib.php.

_elgg_php_exception_handler ( $exception )

Intercepts, logs, and displays uncaught exceptions.

To use a viewtype other than failsafe, create the views: <viewtype>/messages/exceptions/admin_exception <viewtype>/messages/exceptions/exception See the json viewtype for an example.

Warning: This function should never be called directly.

See also: http://www.php.net/set-exception-handler

Parameters

Exception $exception The exception being handled

Returns: void private

Definition at line 796 of file elgglib.php.

_elgg_shutdown_hook ( )

Emits a shutdown:system event upon PHP shutdown, but before database connections are dropped.

Register for the shutdown:system event to perform functions at the end of page loads.

Warning: Using this event to perform long-running functions is not very useful. Servers will hold pages until processing is done before sending them out to the browser.

See also: http://www.php.net/register-shutdown-function

Returns: void

See also: register_shutdown_hook() private

Definition at line 1414 of file elgglib.php.

_elgg_sql_reverse_order_by_clause ( $order_by )

Reverses the ordering in an ORDER BY clause.

This is achived by replacing asc with desc, or appending desc to the end of the clause.

This is used mostly for elgg_get_entities() and other similar functions.

Parameters

string $order_by An order by clause private

Returns: string private

Definition at line 1619 of file elgglib.php.

_elgg_walled_garden_ajax_handler ( $page )

Serve walled garden sections.

Parameters

array $page Array of URL segments

Returns: string private

Definition at line 1766 of file elgglib.php.

_elgg_walled_garden_index ( )

Intercepts the index page when Walled Garden mode is enabled.

Returns: bool private

Definition at line 1740 of file elgglib.php.

_elgg_walled_garden_init ( )

Checks the status of the Walled Garden and forwards to a login page if required.

If the site is in Walled Garden mode, all page except those registered as plugin pages by { public_pages walled_garden} will redirect to a login page.

Since: 1.8.0 init system

Returns: void private

Definition at line 1790 of file elgglib.php.

_elgg_walled_garden_remove_public_access	(	$hook,
		$type,
		$accesses
	)

Remove public access for walled gardens.

Parameters

string	$hook
string	$type
array	$accesses

Returns: array private

Definition at line 1813 of file elgglib.php.

count_messages ( $register = "" )

Counts the number of messages, either globally or in a particular register.

Parameters

string $register Optionally, the register

Returns: integer The number of messages

Definition at line 429 of file elgglib.php.

elgg_add_action_tokens_to_url	(	$url,
		$html_encode = `false`
	)

Adds action tokens to URL.

As of 1.7.0 action tokens are required on all actions. Use this function to append action tokens to a URL's GET parameters. This will preserve any existing GET parameters.

Note: If you are using { input/form} you don't need to add tokens to the action. The form view automatically handles tokens.

Parameters

string	$url	Full action URL
bool	$html_encode	HTML encode the url? (default: false)

Returns: string URL with action tokens

Since: 1.7.0

Definition at line 1059 of file elgglib.php.

elgg_batch_delete_callback ( $object )

Delete objects with a delete() method.

Used as a callback for .

Parameters

object $object The object to disable

Returns: bool private

Definition at line 1673 of file elgglib.php.

elgg_batch_disable_callback ( $object )

Disable objects with a disable() method.

Used as a callback for .

Parameters

object $object The object to disable

Returns: bool private

Definition at line 1659 of file elgglib.php.

elgg_batch_enable_callback ( $object )

Enable objects with an enable() method.

Used as a callback for .

Parameters

object $object The object to enable

Returns: bool private

Definition at line 1645 of file elgglib.php.

elgg_define_js	(	$name,
		$config
	)

Defines a JS lib as an AMD module.

This is useful for shimming traditional JS or for setting the paths of AMD modules.

Calling multiple times for the same name will:

set the preferred path to the last call setting a path
overwrite the shimmed AMD modules with the last call setting a shimmed module

Use elgg_require_js($name) to load on the current page.

Calling this function is not needed if your JS are in views named like js/module/name.js Instead, simply call elgg_require_js("module/name").

Parameters

string	$name	The module name
array	$config	An array like the following: array 'deps' An array of AMD module dependencies string 'exports' The name of the exported module string 'src' The URL to the JS. Can be relative.

Returns: void

Examples:: /root/Elgg/engine/lib/views.php.

Definition at line 152 of file elgglib.php.

elgg_deprecated_notice	(	$msg,
		$dep_version,
		$backtrace_level = `1`
	)

Log a notice about deprecated use of a function, view, etc.

Parameters

string	$msg	Message to log
string	$dep_version	Human-readable release version: 1.7, 1.8, ...
int	$backtrace_level	How many levels back to display the backtrace. Useful if calling from functions that are called from other places (like elgg_view()). Set to -1 for a full backtrace.

Returns: bool

Since: 1.7.0

Examples:: /root/Elgg/engine/lib/output.php, and /root/Elgg/engine/lib/views.php.

Definition at line 1006 of file elgglib.php.

elgg_dump	(	$value,
		$to_screen = `true`
	)

Logs or displays $value.

If $to_screen is true, $value is displayed to screen. Else, it is handled by PHP's error_log() function.

A { debug log} is called. If a handler returns false, it will stop the default logging method.

Parameters

mixed	$value	The value
bool	$to_screen	Display to screen?

Returns: void

Since: 1.7.0

Definition at line 964 of file elgglib.php.

elgg_extract	(		$key,
		array	$array,
			$default = `null`,
			$strict = `true`
	)

Checks for $array[$key] and returns its value if it exists, else returns $default.

Shorthand for $value = (isset($array['key'])) ? $array['key'] : 'default';

Parameters

string	$key	The key to check.
array	$array	The array to check against.
mixed	$default	Default value to return if nothing is found.
bool	$strict	Return array key if it's set, even if empty. If false, return $default if the array key is unset or empty.

Returns: mixed

Since: 1.8.0

Examples:: /root/Elgg/engine/classes/ElggBatch.php, and /root/Elgg/engine/lib/views.php.

Definition at line 1246 of file elgglib.php.

elgg_get_file_list	(	$directory,
		$exceptions = `array()`,
		$list = `array()`,
		$extensions = `null`
	)

Returns a list of files in $directory.

Only returns files. Does not recurse into subdirs.

Parameters

string	$directory	Directory to look in
array	$exceptions	Array of filenames to ignore
array	$list	Array of files to append to
mixed	$extensions	Array of extensions to allow, null for all. Use a dot: array('.php').

Returns: array Filenames in $directory, in the form $directory/filename.

Definition at line 336 of file elgglib.php.

elgg_get_ini_setting_in_bytes ( $setting )

Returns a PHP INI setting in bytes.

Use this for arithmetic when determining if a file can be uploaded.

Parameters

string $setting The php.ini setting

Returns: int

Since: 1.7.0 http://www.php.net/manual/en/function.ini-get.php

Definition at line 1324 of file elgglib.php.

elgg_get_loaded_css ( )

Get the loaded CSS URLs.

Returns: array

Since: 1.8.0

Definition at line 265 of file elgglib.php.

elgg_get_loaded_external_files	(	$type,
		$location
	)

Get external resource descriptors.

Parameters

string	$type	Type of file: js or css
string	$location	Page location

Returns: array

Since: 1.8.0

Definition at line 320 of file elgglib.php.

elgg_get_loaded_js ( $location = 'head' )

Get the JavaScript URLs that are loaded.

Parameters

string $location 'head' or 'footer'

Returns: array

Since: 1.8.0

Definition at line 214 of file elgglib.php.

elgg_get_version ( $human_readable = false )

Get the current Elgg version information.

Parameters

bool $human_readable Whether to return a human readable version (default: false)

Returns: string|false Depending on success

Since: 1.9

Definition at line 976 of file elgglib.php.

elgg_http_add_url_query_elements	(		$url,
		array	$elements
	)

Sets elements in a URL's query string.

Parameters

string	$url	The URL
array	$elements	Key/value pairs to set in the URL. If the value is null, the element is removed from the URL.

Returns: string The new URL with the query strings added

Since: 1.7.0

Definition at line 1107 of file elgglib.php.

elgg_http_build_url	(	array	$parts,
			$html_encode = `true`
	)

Builds a URL from the a parts array like one returned by parse_url().

Note: If only partial information is passed, a partial URL will be returned.

Parameters

array	$parts	Associative array of URL components like parse_url() returns 'user' and 'pass' parts are ignored because of security reasons
bool	$html_encode	HTML Encode the url?

See also: https://github.com/Elgg/Elgg/pull/8146#issuecomment-91544585

Returns: string Full URL

Since: 1.7.0

Definition at line 1024 of file elgglib.php.

elgg_http_remove_url_query_element	(	$url,
		$element
	)

Removes an element from a URL's query string.

Note: You can send a partial URL string.

Parameters

string	$url	Full URL
string	$element	The element to remove

Returns: string The new URL with the query element removed.

Since: 1.7.0

Definition at line 1093 of file elgglib.php.

elgg_http_url_is_identical	(	$url1,
		$url2,
		$ignore_params = `array('offset', 'limit')`
	)

Test if two URLs are functionally identical.

If $ignore_params is used, neither the name nor its value will be considered when comparing.

The order of GET params doesn't matter.

Parameters

string	$url1	First URL
string	$url2	Second URL
array	$ignore_params	GET params to ignore in the comparison

Returns: bool

Since: 1.8.0

Definition at line 1151 of file elgglib.php.

elgg_load_css ( $name )

Load a CSS file for this page.

This must be called before elgg_view_page(). It can be called before the CSS file is registered. If you do not want a CSS file loaded, unregister it.

Parameters

string $name Identifier of the CSS file

Returns: void

Since: 1.8.0

Examples:: /root/Elgg/engine/lib/views.php.

Definition at line 255 of file elgglib.php.

elgg_load_external_file	(	$type,
		$name
	)

Load an external resource for use on this page.

Parameters

string	$type	Type of file: js or css
string	$name	The identifier for the file

Returns: void

Since: 1.8.0

Definition at line 307 of file elgglib.php.

elgg_load_js ( $name )

Load a JavaScript resource on this page.

This must be called before elgg_view_page(). It can be called before the script is registered. If you do not want a script loaded, unregister it.

Parameters

string $name Identifier of the JavaScript resource

Returns: void

Since: 1.8.0

Examples:: /root/Elgg/engine/lib/views.php.

Definition at line 189 of file elgglib.php.

elgg_load_library ( $name )

Load a PHP library.

See also: elgg_register_library

Parameters

string $name The name of the library

Returns: void

Exceptions

InvalidParameterException

Since: 1.8.0

Definition at line 43 of file elgglib.php.

elgg_log	(	$message,
		$level = `'NOTICE'`
	)

Display or log a message.

If $level is >= to the debug setting in ->debug, the message will be sent to elgg_dump(). Messages with lower priority than ->debug are ignored.

Outputs all levels but NOTICE to screen by default.

Note: No messages will be displayed unless debugging has been enabled.

Parameters

string	$message	User message
string	$level	NOTICE \| WARNING \| ERROR

Returns: bool

Since: 1.7.0

Definition at line 933 of file elgglib.php.

elgg_register_css	(	$name,
		$url,
		$priority = `null`
	)

Register a CSS file for inclusion in the HTML head.

Parameters

string	$name	An identifier for the CSS file
string	$url	URL of the CSS file
int	$priority	Priority of the CSS file (lower numbers load earlier)

Returns: bool

Since: 1.8.0

Examples:: /root/Elgg/engine/lib/views.php.

Definition at line 228 of file elgglib.php.

elgg_register_event_handler	(	$event,
		$object_type,
		$callback,
		$priority = `500`
	)

Definition at line 519 of file elgglib.php.

elgg_register_external_file	(	$type,
		$name,
		$url,
		$location,
		$priority = `500`
	)

Core registration function for external files.

Parameters

string	$type	Type of external resource (js or css)
string	$name	Identifier used as key
string	$url	URL
string	$location	Location in the page to include the file
int	$priority	Loading priority of the file

Returns: bool

Since: 1.8.0

Definition at line 281 of file elgglib.php.

elgg_register_js	(	$name,
		$url,
		$location = `'head'`,
		$priority = `null`
	)

Register a JavaScript file for inclusion.

This function handles adding JavaScript to a web page. If multiple calls are made to register the same JavaScript file based on the $id variable, only the last file is included. This allows a plugin to add JavaScript from a view that may be called more than once. It also handles more than one plugin adding the same JavaScript.

jQuery plugins often have filenames such as jquery.rating.js. A best practice is to base $name on the filename: "jquery.rating". It is recommended to not use version numbers in the name.

The JavaScript files can be local to the server or remote (such as Google's CDN).

Parameters

string	$name	An identifier for the JavaScript library
string	$url	URL of the JavaScript file
string	$location	Page location: head or footer. (default: head)
int	$priority	Priority of the JS file (lower numbers load earlier)

Returns: bool

Since: 1.8.0

Examples:: /root/Elgg/engine/lib/views.php.

Definition at line 127 of file elgglib.php.

elgg_register_library	(	$name,
		$location
	)

Register a PHP file as a library.

See also: elgg_load_library

Parameters

string	$name	The name of the library
string	$location	The location of the file

Returns: void

Since: 1.8.0

Definition at line 21 of file elgglib.php.

elgg_register_plugin_hook_handler	(	$hook,
		$type,
		$callback,
		$priority = `500`
	)

Examples:: /root/Elgg/engine/lib/output.php, and /root/Elgg/engine/lib/views.php.

Definition at line 703 of file elgglib.php.

elgg_require_js ( $name )

Request that Elgg load an AMD module onto the page.

Parameters

string $name The AMD module name.

Returns: void

Since: 1.9.0

Definition at line 201 of file elgglib.php.

elgg_sort_3d_array_by_value	(	&	$array,
			$element,
			$sort_order = `SORT_ASC`,
			$sort_type = `SORT_LOCALE_STRING`
	)

Sorts a 3d array by specific element.

Warning: Will re-index numeric indexes.

Note: This operates the same as the built-in sort functions. It sorts the array and returns a bool for success.

Do this: elgg_sort_3d_array_by_value($my_array); Not this: $my_array = elgg_sort_3d_array_by_value($my_array);

Parameters

array	&$array	Array to sort
string	$element	Element to sort by
int	$sort_order	PHP sort order http://us2.php.net/array_multisort
int	$sort_type	PHP sort type http://us2.php.net/sort

Returns: bool

Definition at line 1278 of file elgglib.php.

elgg_trigger_after_event	(	$event,
		$object_type,
		$object = `null`
	)

Trigger an "After event" indicating a process has finished.

Unlike regular events, all the handlers will be called, their return values ignored.

To register for an after event, append ":after" to the event name when registering.

Parameters

string	$event	The event type. The fired event type will be appended with ":after".
string	$object_type	The object type
string	$object	The object involved in the event

Returns: true

See also: elgg_trigger_before_event

Definition at line 610 of file elgglib.php.

elgg_trigger_before_event	(	$event,
		$object_type,
		$object = `null`
	)

Trigger a "Before event" indicating a process is about to begin.

Like regular events, a handler returning false will cancel the process and false will be returned.

To register for a before event, append ":before" to the event name when registering.

Parameters

string	$event	The event type. The fired event type will be appended with ":before".
string	$object_type	The object type
string	$object	The object involved in the event

Returns: bool False if any handler returned false, otherwise true

See also: elgg_trigger_event; elgg_trigger_after_event

Definition at line 591 of file elgglib.php.

elgg_trigger_deprecated_event	(	$event,
		$object_type,
		$object = `null`,
		$message,
		$version
	)

Trigger an event normally, but send a notice about deprecated use if any handlers are registered.

Parameters

string	$event	The event type
string	$object_type	The object type
string	$object	The object involved in the event
string	$message	The deprecation message
string	$version	Human-readable release version: 1.9, 1.10, ...

Returns: bool

See also: elgg_trigger_event

Definition at line 630 of file elgglib.php.

elgg_trigger_event	(	$event,
		$object_type,
		$object = `null`
	)

Definition at line 570 of file elgglib.php.

elgg_trigger_plugin_hook	(	$hook,
		$type,
		$params = `null`,
		$returnvalue = `null`
	)

Examples:: /root/Elgg/engine/lib/output.php, and /root/Elgg/engine/lib/views.php.

Definition at line 775 of file elgglib.php.

elgg_unregister_css ( $name )

Unregister a CSS file.

Parameters

string $name The identifier for the CSS file

Returns: bool

Since: 1.8.0

Definition at line 240 of file elgglib.php.

elgg_unregister_event_handler	(	$event,
		$object_type,
		$callback
	)

Unregisters a callback for an event.

Parameters

string	$event	The event type
string	$object_type	The object type
string	$callback	The callback

Returns: bool true if a handler was found and removed

Since: 1.7

Definition at line 533 of file elgglib.php.

elgg_unregister_external_file	(	$type,
		$name
	)

Unregister an external file.

Parameters

string	$type	Type of file: js or css
string	$name	The identifier of the file

Returns: bool

Since: 1.8.0

Definition at line 294 of file elgglib.php.

elgg_unregister_js ( $name )

Unregister a JavaScript file.

Parameters

string $name The identifier for the JavaScript library

Returns: bool

Since: 1.8.0

Definition at line 174 of file elgglib.php.

elgg_unregister_plugin_hook_handler	(	$hook,
		$entity_type,
		$callback
	)

Unregister a callback as a plugin hook.

Parameters

string	$hook	The name of the hook
string	$entity_type	The name of the type of entity (eg "user", "object" etc)
callable	$callback	The PHP callback to be removed

Returns: void

Since: 1.8.0

Definition at line 717 of file elgglib.php.

forward	(	$location = `""`,
		$reason = `'system'`
	)

Forward to $location.

Sends a 'Location: $location' header and exists. If headers have already been sent, throws an exception.

Parameters

string	$location	URL to forward to browser to. This can be a path relative to the network's URL.
string	$reason	Short explanation for why we're forwarding. Set to '404' to forward to error page. Default message is 'system'.

Returns: void

Exceptions

SecurityException

Definition at line 80 of file elgglib.php.

ini_get_bool ( $ini_get_arg )

Return the state of a php.ini setting as a bool.

Warning: Using this on ini settings that are not boolean will be inaccurate!

Parameters

string $ini_get_arg The INI setting

Returns: bool Depending on whether it's on or off

Definition at line 1304 of file elgglib.php.

is_not_null ( $string )

Returns true is string is not empty, false, or null.

Function to be used in array_filter which returns true if $string is not null.

Parameters

string $string The string to test

Returns: bool

Definition at line 1355 of file elgglib.php.

register_error ( $error )

Display an error on next page load.

See also: system_messages()

Parameters

string | array $error Error or errors to add

Returns: bool

Definition at line 455 of file elgglib.php.

sanitise_filepath	(	$path,
		$append_slash = `true`
	)

Sanitise file paths ensuring that they begin and end with slashes etc.

Parameters

string	$path	The path
bool	$append_slash	Add tailing slash

Returns: string

Definition at line 368 of file elgglib.php.

system_message ( $message )

Display a system message on next page load.

See also: system_messages()

Parameters

string | array $message Message or messages to add

Returns: bool

Definition at line 442 of file elgglib.php.

system_messages	(	$message = `null`,
		$register = `"success"`,
		$count = `false`
	)

Queues a message to be displayed.

Messages will not be displayed immediately, but are stored in for later display, usually upon next page load.

The method of displaying these messages differs depending upon plugins and viewtypes. The core default viewtype retrieves messages in views/default/page/shells/default.php and displays messages as javascript popups.

Note: Internal: Messages are stored as strings in the Elgg session as ['msg'][$register] array.

Warning: This function is used to both add to and clear the message stack. If $messages is null, $register will be returned and cleared. If $messages is null and $register is empty, all messages will be returned and removed.

Parameters

mixed	$message	Optionally, a single message or array of messages to add, (default: null)
string	$register	Types of message: "error", "success" (default: success)
bool	$count	Count the number of messages (default: false)

Returns: bool|array Either the array of messages, or a response regarding whether the message addition was successful.

Definition at line 412 of file elgglib.php.

Variable Documentation

const ACCESS_DEFAULT -1

Definition at line 1953 of file elgglib.php.

const ACCESS_FRIENDS -2

Definition at line 1957 of file elgglib.php.

const ACCESS_LOGGED_IN 1

Definition at line 1955 of file elgglib.php.

const ACCESS_PRIVATE 0

Definition at line 1954 of file elgglib.php.

const ACCESS_PUBLIC 2

Definition at line 1956 of file elgglib.php.

const ELGG_ENTITIES_ANY_VALUE null

Definition at line 1967 of file elgglib.php.

const ELGG_ENTITIES_NO_VALUE 0

Definition at line 1976 of file elgglib.php.

return function(\Elgg\EventsService $events,\Elgg\HooksRegistrationService $hooks)

Definition at line 1997 of file elgglib.php.

const REFERER -1

Definition at line 1995 of file elgglib.php.

const REFERRER -1

Definition at line 1985 of file elgglib.php.

Namespaces

Functions

Variables

Function Documentation

Variable Documentation