Elgg
Version 6.0
|
Manages a global stack of strings for sharing information about the current execution context. More...
Public Member Functions | |
__construct (HttpRequest $request) | |
Initialize the context from the request. More... | |
peek () | |
Get the most recently pushed context value. More... | |
push (string $context) | |
Push a context onto the top of the stack. More... | |
pop () | |
Removes and returns the top context string from the stack. More... | |
set (string $context) | |
Sets the page context. More... | |
contains (string $context) | |
Check if this context exists anywhere in the stack. More... | |
toArray () | |
Get the entire context stack as an array (e.g. More... | |
fromArray (array $stack) | |
Overwrite the entire context stack from an array of strings. More... | |
Manages a global stack of strings for sharing information about the current execution context.
Views can modify their output based on the local context. You may want to display a list of blogs on a blog page or in a small widget. The rendered output could be different for those two contexts ('blog' vs 'widget').
Pages that pass through the page handling system set the context to the first string after the root url. Example: http://example.org/elgg/bookmarks/ results in the initial context being set to 'bookmarks'.
The context is a stack so that for a widget on a profile, the context stack may contain first 'profile' and then 'widget'.
Definition at line 27 of file Context.php.
Elgg\Context::__construct | ( | HttpRequest | $request | ) |
Initialize the context from the request.
HttpRequest | $request | Elgg request |
Definition at line 36 of file Context.php.
Elgg\Context::contains | ( | string | $context | ) |
Check if this context exists anywhere in the stack.
This is useful for situations with more than one element in the stack. For example, a widget has a context of 'widget'. If a widget view needs to render itself differently based on being on the dashboard or profile pages, it can check the stack.
string | $context | The context string to check for |
Definition at line 109 of file Context.php.
Elgg\Context::fromArray | ( | array | $stack | ) |
Overwrite the entire context stack from an array of strings.
string[] | $stack All contexts to be placed on the stack |
Definition at line 128 of file Context.php.
Elgg\Context::peek | ( | ) |
Get the most recently pushed context value.
Definition at line 53 of file Context.php.
Elgg\Context::pop | ( | ) |
Removes and returns the top context string from the stack.
Definition at line 73 of file Context.php.
Elgg\Context::push | ( | string | $context | ) |
Push a context onto the top of the stack.
string | $context | The context string to add to the context stack |
Definition at line 64 of file Context.php.
Elgg\Context::set | ( | string | $context | ) |
Sets the page context.
string | $context | The context of the page |
Definition at line 83 of file Context.php.
Elgg\Context::toArray | ( | ) |
Get the entire context stack as an array (e.g.
for backing it up)
Definition at line 118 of file Context.php.