Views service. More...

Public Member Functions
	__construct (EventsService $events, HttpRequest $request)
	Constructor. More...

	setViewtype (string $viewtype= '')
	Set the viewtype. More...

	getViewtype ()
	Get the viewtype. More...

	clampViewtypeToPopulatedViews ()
	If the current viewtype has no views, reset it to "default". More...

	isValidViewtype (string $viewtype)
	Checks if $viewtype is a string suitable for use as a viewtype name. More...

	autoregisterViews (string $view_base, string $folder, string $viewtype)
	Auto-registers views from a location. More...

	findViewFile (string $view, string $viewtype)
	Find the view file. More...

	setViewDir (string $view, string $location, string $viewtype= '')
	Set an alternative base location for a view. More...

	registerViewtypeFallback (string $viewtype)
	Register a viewtype to fall back to a default view if a view isn't found for that viewtype. More...

	doesViewtypeFallback (string $viewtype)
	Checks if a viewtype falls back to default. More...

	renderDeprecatedView (string $view, array $vars, string $suggestion, string $version)
	Display a view with a deprecation notice. More...

	getViewList (string $view)
	Get the views, including extensions, used to render a view. More...

	renderView (string $view, array $vars=[], string $viewtype= '', bool $issue_missing_notice=true, array $extensions_tree=[])
	Renders a view. More...

	viewExists (string $view, string $viewtype= '', bool $recurse=true)
	Returns whether the specified view exists. More...

	extendView (string $view, string $view_extension, int $priority=501)
	Extends a view with another view. More...

	unextendView (string $view, string $view_extension)
	Unextends a view. More...

	registerCacheableView (string $view)
	Register a view a cacheable. More...

	isCacheableView (string $view)
	Is the view cacheable. More...

	registerPluginViews (string $path)
	Register a plugin's views. More...

	mergeViewsSpec (array $spec)
	Merge a specification of absolute view paths. More...

	listViews (string $viewtype= 'default')
	List all views in a viewtype. More...

	getInspectorData ()
	Get inspector data. More...

	configureFromCache (SystemCache $cache)
	Configure locations from the cache. More...

	cacheConfiguration (SystemCache $cache)
	Cache the configuration. More...

Static Public Member Functions
static	canonicalizeViewName (string $alias)
	Takes a view name and returns the canonical name for that view. More...

Public Attributes
const	VIEW_HOOK = 'view'

const	VIEW_VARS_HOOK = 'view_vars'

const	OUTPUT_KEY = '__view_output'

const	BASE_VIEW_PRIORITY = 500

Protected Member Functions
	fileExists (string $path)
	Wrapper for file_exists() that caches false results (the stat cache only caches true results). More...

Protected Attributes
	$file_exists_cache = []

Detailed Description

Views service.

Definition at line 18 of file ViewsService.php.

Constructor & Destructor Documentation

Elgg\ViewsService::__construct	(	EventsService	$events,
		HttpRequest	$request
	)

Constructor.

Parameters

EventsService	$events	Events service
\Elgg\Http\Request	$request	Http Request

Definition at line 92 of file ViewsService.php.

Member Function Documentation

Elgg\ViewsService::autoregisterViews	(	string	$view_base,
		string	$folder,
		string	$viewtype
	)

Auto-registers views from a location.

Parameters

string	$view_base	Optional The base of the view name without the view type.
string	$folder	Required The folder to begin looking in
string	$viewtype	The type of view we're looking at (default, rss, etc)

Returns: bool returns false if folder can't be read

Definition at line 223 of file ViewsService.php.

Elgg\ViewsService::cacheConfiguration ( SystemCache $cache )

Cache the configuration.

Parameters

SystemCache $cache The system cache

Returns: void

Definition at line 812 of file ViewsService.php.

static Elgg\ViewsService::canonicalizeViewName ( string $alias )

static

Takes a view name and returns the canonical name for that view.

Parameters

string $alias The possibly non-canonical view name.

Returns: string The canonical view name.

Definition at line 192 of file ViewsService.php.

Elgg\ViewsService::clampViewtypeToPopulatedViews ( )

If the current viewtype has no views, reset it to "default".

Returns: void

Definition at line 138 of file ViewsService.php.

Elgg\ViewsService::configureFromCache ( SystemCache $cache )

Configure locations from the cache.

Parameters

SystemCache $cache The system cache

Returns: bool

Definition at line 788 of file ViewsService.php.

Elgg\ViewsService::doesViewtypeFallback ( string $viewtype )

Checks if a viewtype falls back to default.

Parameters

string $viewtype Viewtype

Returns: bool

Definition at line 335 of file ViewsService.php.

Elgg\ViewsService::extendView	(	string	$view,
		string	$view_extension,
		int	$priority = `501`
	)

Extends a view with another view.

Parameters

string	$view	The view to extend.
string	$view_extension	This view is added to $view
int	$priority	The priority, from 0 to 1000, to add at (lowest numbers displayed first)

Returns: void

See also: elgg_extend_view()

Definition at line 570 of file ViewsService.php.

Elgg\ViewsService::fileExists ( string $path )

protected

Wrapper for file_exists() that caches false results (the stat cache only caches true results).

This saves us from many unneeded file stat calls when a common view uses a fallback.

Parameters

string $path Path to the file

Returns: bool

Definition at line 466 of file ViewsService.php.

Elgg\ViewsService::findViewFile	(	string	$view,
		string	$viewtype
	)

Find the view file.

Parameters

string	$view	View name
string	$viewtype	Viewtype

Returns: string Empty string if not found

Definition at line 274 of file ViewsService.php.

Elgg\ViewsService::getInspectorData ( )

Get inspector data.

Returns: array

Definition at line 763 of file ViewsService.php.

Elgg\ViewsService::getViewList ( string $view )

Get the views, including extensions, used to render a view.

Keys returned are view priorities. View existence is not checked.

Parameters

string $view View name

Returns: string[]

Definition at line 371 of file ViewsService.php.

Elgg\ViewsService::getViewtype ( )

Get the viewtype.

Returns: string

Definition at line 125 of file ViewsService.php.

Elgg\ViewsService::isCacheableView ( string $view )

Is the view cacheable.

Parameters

string $view the view name

Returns: bool

Definition at line 643 of file ViewsService.php.

Elgg\ViewsService::isValidViewtype ( string $viewtype )

Checks if $viewtype is a string suitable for use as a viewtype name.

Parameters

string $viewtype Potential viewtype name. Alphanumeric chars plus _ allowed.

Returns: bool

Definition at line 173 of file ViewsService.php.

Elgg\ViewsService::listViews ( string $viewtype = 'default' )

List all views in a viewtype.

Parameters

string $viewtype Viewtype

Returns: string[]

Definition at line 750 of file ViewsService.php.

Elgg\ViewsService::mergeViewsSpec ( array $spec )

Merge a specification of absolute view paths.

Parameters

array $spec Specification viewtype => [ view_name => path or array of paths ]

Returns: void

Definition at line 719 of file ViewsService.php.

Elgg\ViewsService::registerCacheableView ( string $view )

Register a view a cacheable.

Parameters

string $view the view name

Returns: void

Definition at line 630 of file ViewsService.php.

Elgg\ViewsService::registerPluginViews ( string $path )

Register a plugin's views.

Parameters

string $path Base path of the plugin

Returns: bool

Definition at line 679 of file ViewsService.php.

Elgg\ViewsService::registerViewtypeFallback ( string $viewtype )

Register a viewtype to fall back to a default view if a view isn't found for that viewtype.

Parameters

string $viewtype The viewtype to register

Returns: void

See also: elgg_register_viewtype_fallback()

Definition at line 324 of file ViewsService.php.

Elgg\ViewsService::renderDeprecatedView	(	string	$view,
		array	$vars,
		string	$suggestion,
		string	$version
	)

Display a view with a deprecation notice.

No missing view NOTICE is logged

Parameters

string	$view	The name and location of the view to use
array	$vars	Variables to pass to the view
string	$suggestion	Suggestion with the deprecation message
string	$version	Human-readable release version: 1.7, 1.8, ...

Returns: string The parsed view

See also: elgg_view()

Definition at line 351 of file ViewsService.php.

Elgg\ViewsService::renderView	(	string	$view,
		array	$vars = `[]`,
		string	$viewtype = `''`,
		bool	$issue_missing_notice = `true`,
		array	$extensions_tree = `[]`
	)

Renders a view.

Parameters

string	$view	Name of the view
array	$vars	Variables to pass to the view
string	$viewtype	Viewtype to use
bool	$issue_missing_notice	Should a missing notice be issued
array	$extensions_tree	Array of views that are before the current view in the extension path

Returns: string

See also: elgg_view()

Definition at line 388 of file ViewsService.php.

Elgg\ViewsService::setViewDir	(	string	$view,
		string	$location,
		string	$viewtype = `''`
	)

Set an alternative base location for a view.

Parameters

string	$view	Name of the view
string	$location	Full path to the view file
string	$viewtype	The viewtype to register this under

Returns: void

See also: elgg_set_view_location()

Definition at line 298 of file ViewsService.php.

Elgg\ViewsService::setViewtype ( string $viewtype = '' )

Set the viewtype.

Parameters

string $viewtype Viewtype

Returns: bool

Definition at line 104 of file ViewsService.php.

Elgg\ViewsService::unextendView	(	string	$view,
		string	$view_extension
	)

Unextends a view.

Parameters

string	$view	The view that was extended.
string	$view_extension	This view that was added to $view

Returns: bool

See also: elgg_unextend_view()

Definition at line 602 of file ViewsService.php.

Elgg\ViewsService::viewExists	(	string	$view,
		string	$viewtype = `''`,
		bool	$recurse = `true`
	)

Returns whether the specified view exists.

Parameters

string	$view	The view name
string	$viewtype	If set, forces the viewtype
bool	$recurse	If false, do not check extensions

Returns: bool

See also: elgg_view_exists()

Definition at line 522 of file ViewsService.php.

Member Data Documentation

Elgg\ViewsService::$file_exists_cache = []

protected

Definition at line 31 of file ViewsService.php.

const Elgg\ViewsService::BASE_VIEW_PRIORITY = 500

Definition at line 25 of file ViewsService.php.

const Elgg\ViewsService::OUTPUT_KEY = '__view_output'

Definition at line 24 of file ViewsService.php.

const Elgg\ViewsService::VIEW_HOOK = 'view'

Definition at line 22 of file ViewsService.php.

const Elgg\ViewsService::VIEW_VARS_HOOK = 'view_vars'

Definition at line 23 of file ViewsService.php.

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

engine/classes/Elgg/ViewsService.php

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation