Functions
	elgg_format_html ($html, array $options=[])
	Output functions Processing text for output such as pulling out URLs and extracting excerpts. More...

	parse_urls ($text)
	Takes a string and turns any URLs into formatted links. More...

	elgg_parse_emails ($text)
	Takes a string and turns any email addresses into formatted links. More...

	elgg_autop ($string)
	Create paragraphs from text with line spacing. More...

	elgg_get_excerpt ($text, $num_chars=250)
	Returns an excerpt. More...

	elgg_format_bytes ($size, $precision=2)
	Format bytes to a human readable format. More...

	elgg_format_element ($tag_name, array $attributes=[], $text= '', array $options=[])
	Format an HTML element. More...

	elgg_normalize_url ($url)

	elgg_normalize_site_url ($unsafe_url)
	From untrusted input, get a site URL safe for forwarding. More...

	elgg_get_friendly_title ($title)
	When given a title, returns a version suitable for inclusion in a URL. More...

	elgg_get_friendly_time ($time, $current_time=null)
	Formats a UNIX timestamp in a friendly way (eg "less than a minute ago") More...

	elgg_get_friendly_upload_error ($error_code)
	Returns a human-readable message for PHP's upload error codes. More...

	elgg_strip_tags ($string, $allowable_tags=null)
	Strip tags and offer plugins the chance. More...

	elgg_html_decode ($string)
	Decode HTML markup into a raw text string. More...

	_elgg_get_display_query ($string)
	Prepares query string for output to prevent CSRF attacks. More...

	_elgg_sane_validate_url ($url)
	Use a "fixed" filter_var() with FILTER_VALIDATE_URL that handles multi-byte chars. More...

Function Documentation

_elgg_get_display_query ( $string )

Prepares query string for output to prevent CSRF attacks.

Parameters

string $string string to prepare

Returns: string

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

Definition at line 403 of file output.php.

_elgg_sane_validate_url ( $url )

Use a "fixed" filter_var() with FILTER_VALIDATE_URL that handles multi-byte chars.

Parameters

string $url URL to validate

Returns: string|false

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

Definition at line 426 of file output.php.

elgg_autop ( $string )

Create paragraphs from text with line spacing.

Parameters

string $string The string

Returns: string

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

Definition at line 55 of file output.php.

elgg_format_bytes	(	$size,
		$precision = `2`
	)

Format bytes to a human readable format.

Parameters

int	$size	File size in bytes to format
int	$precision	Precision to round formatting bytes to

Returns: false|string

Since: 1.9.0

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

Definition at line 91 of file output.php.

elgg_format_element	(		$tag_name,
		array	$attributes = `[]`,
			$text = `''`,
		array	$options = `[]`
	)

Format an HTML element.

Parameters

string \| array	$tag_name	The element tagName. e.g. "div". This will not be validated. All function arguments can be given as a single array: The array will be used as $attributes, except for the keys "#tag_name", "#text", and "#options", which will be extracted as the other arguments.
array	$attributes	The element attributes.
string	$text	The contents of the element. Assumed to be HTML unless encode_text is true.
array	$options	Options array with keys: encode_text => (bool, default false) If true, $text will be HTML-escaped. Already-escaped entities will not be double-escaped. double_encode => (bool, default false) If true, the $text HTML escaping will be allowed to double encode HTML entities: '×' will become '×' is_void => (bool) If given, this determines whether the function will return just the open tag. Otherwise this will be determined by the tag name according to this list: http://www.w3.org/html/wg/drafts/html/master/single-page.html#void-elements is_xml => (bool, default false) If true, void elements will be formatted like "<tag />"

Returns: string

Exceptions

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

Definition at line 134 of file output.php.

elgg_format_html	(		$html,
		array	$options = `[]`
	)

Output functions Processing text for output such as pulling out URLs and extracting excerpts.

Prepare HTML output

Parameters

string	$html	HTML string
array	$options	Formatting options

bool $parse_urls Replace URLs with anchor tags bool $parse_emails Replace email addresses with anchor tags bool $sanitize Sanitize HTML tags bool $autop Add paragraphs instead of new lines

Returns: string

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

Definition at line 20 of file output.php.

elgg_get_excerpt	(	$text,
		$num_chars = `250`
	)

Returns an excerpt.

Will return up to n chars stopping at the nearest space. If no spaces are found (like in Japanese) will crop off at the n char mark. Adds ... if any text was chopped.

Parameters

string	$text	The full text to excerpt
int	$num_chars	Return a string up to $num_chars long

Returns: string

Since: 1.7.2

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

Definition at line 71 of file output.php.

elgg_get_friendly_time	(	$time,
		$current_time = `null`
	)

Formats a UNIX timestamp in a friendly way (eg "less than a minute ago")

See also: elgg_view_friendly_time()

Parameters

int	$time	A UNIX epoch timestamp
int	$current_time	Current UNIX epoch timestamp (optional)

Returns: string The friendly time string

Since: 1.7.2

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

Definition at line 258 of file output.php.

elgg_get_friendly_title ( $title )

When given a title, returns a version suitable for inclusion in a URL.

Parameters

string $title The title

Returns: string The optimized title

Since: 1.7.2

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

Definition at line 229 of file output.php.

elgg_get_friendly_upload_error ( $error_code )

Returns a human-readable message for PHP's upload error codes.

Parameters

int $error_code The code as stored in $_FILES['name']['error']

Returns: string

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

Definition at line 308 of file output.php.

elgg_html_decode ( $string )

Decode HTML markup into a raw text string.

This applies html_entity_decode() to a string while re-entitising HTML special char entities to prevent them from being decoded back to their unsafe original forms.

This relies on html_entity_decode() not translating entities when doing so leaves behind another entity, e.g. > if decoded would create > which is another entity itself. This seems to escape the usual behaviour where any two paired entities creating a HTML tag are usually decoded, i.e. a lone > is not decoded, but <foo> would be decoded to <foo> since it creates a full tag.

Note: html_entity_decode() is poorly explained in the manual - which is really bad given its potential for misuse on user input already escaped elsewhere. Stackoverflow is littered with advice to use this function in the precise way that would lead to user input being capable of injecting arbitrary HTML.

Parameters

string $string Encoded HTML

Returns: string

Author: Pádraic Brady

Copyright: Copyright (c) 2010 Pádraic Brady (http://blog.astrumfutura.com) Released under dual-license GPL2/MIT by explicit permission of Pádraic Brady