parentable_part_of_admin_tree Interface Reference

Interface implemented by any part_of_admin_tree that has children. More...

Inheritance diagram for parentable_part_of_admin_tree:

Public Member Functions
	add ($destinationname, $something, $beforesibling=null)
	Adds a part_of_admin_tree object to the admin tree.
	check_access ()
	Verifies current user's access to this part_of_admin_tree.
	is_hidden ()
	Mostly useful for removing of some parts of the tree in admin tree block.
	locate ($name)
	Finds a named part_of_admin_tree.
	prune ($name)
	Removes named part_of_admin_tree.
	search ($query)
	Search using query.
	show_save ()
	Show we display Save button at the page bottom?

Detailed Description

Interface implemented by any part_of_admin_tree that has children.

The interface implemented by any part_of_admin_tree that can be a parent to other part_of_admin_tree's. (For now, this only includes admin_category.) Apart from ensuring part_of_admin_tree compliancy, it also ensures inheriting methods include an add method for adding other part_of_admin_tree objects as children.

License

http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Member Function Documentation

add()

parentable_part_of_admin_tree::add	(		$destinationname,
			$something,
			$beforesibling = null )

Adds a part_of_admin_tree object to the admin tree.

Used to add a part_of_admin_tree object to this object or a child of this object. $something should only be added if $destinationname matches $this->name. If it doesn't, add should be called on child objects that are also parentable_part_of_admin_tree's.

$something should be appended as the last child in the $destinationname. If the $beforesibling is specified, $something should be prepended to it. If the given sibling is not found, $something should be appended to the end of $destinationname and a developer debugging message should be displayed.

Parameters

string	$destinationname	The internal name of the new parent for $something.
part_of_admin_tree	$something	The object to be added.

Return values

bool	True on success, false on failure.

Implemented in admin_category.

check_access()

part_of_admin_tree::check_access ( )

inherited

Verifies current user's access to this part_of_admin_tree.

Used to check if the current user has access to this part of the admin tree or not. If a class only inherits part_of_admin_tree and not parentable_part_of_admin_tree, then this method is usually just a call to has_capability() in the site context.

If a class inherits parentable_part_of_admin_tree, this method should return the logical OR of the return of check_access() on all child objects.

Return values

bool	True if the user has access, false if she doesn't.

Implemented in admin_category, admin_externalpage, admin_settingpage, and core_admin\local\externalpage\accesscallback.

is_hidden()

part_of_admin_tree::is_hidden ( )

inherited

Mostly useful for removing of some parts of the tree in admin tree block.

Return values

True	is hidden from normal list view

Implemented in admin_category, admin_externalpage, and admin_settingpage.

locate()

part_of_admin_tree::locate ( $name )

inherited

Finds a named part_of_admin_tree.

Used to find a part_of_admin_tree. If a class only inherits part_of_admin_tree and not parentable_part_of_admin_tree, then this function should only check if $this->name matches $name. If it does, it should return a reference to $this, otherwise, it should return a reference to NULL.

If a class inherits parentable_part_of_admin_tree, this method should be called recursively on all child objects (assuming, of course, the parent object's name doesn't match the search criterion).

Parameters

string

$name

The internal name of the part_of_admin_tree we're searching for.

Return values

mixed

An object reference or a NULL reference.

prune()

part_of_admin_tree::prune ( $name )

inherited

Removes named part_of_admin_tree.

Parameters

string

$name

The internal name of the part_of_admin_tree we want to remove.

Return values

bool

success.

Implemented in admin_category, admin_externalpage, and admin_settingpage.

search()

part_of_admin_tree::search ( $query )

inherited

Search using query.

Parameters

string

$query

Return values

mixed

array-object structure of found settings and pages

Implemented in admin_category, admin_externalpage, admin_page_manageblocks, admin_page_managefilters, admin_page_managemessageoutputs, admin_page_managemods, admin_page_manageportfolios, admin_page_manageqbehaviours, admin_page_manageqtypes, admin_page_managerepositories, admin_settingpage, and assign_admin_page_manage_assign_plugins.

show_save()

part_of_admin_tree::show_save ( )

inherited

Show we display Save button at the page bottom?

Return values

bool

Implemented in admin_category, admin_externalpage, and admin_settingpage.

---

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

• lib/adminlib.php