Extension:Admin Links/Hooks/AdminLinks
AdminLinks | |
---|---|
Available from version ??? |
|
Define function: | public static function onAdminLinks( array( &$admin_links_tree ) ) { ... }
|
Attach hook: | $wgHooks['AdminLinks'][] = 'MyExtensionHooks::onAdminLinks';
|
Called from: | File(s): AdminLinks / includes/AdminLinks.php Function(s): execute |
For more information about attaching hooks, see Manual:Hooks .
For examples of other extensions using this hook, see Category:AdminLinks extensions.
In order for an extension to add links and sections to the Admin Links page, it must define a new function, and register it with the "AdminLinks" hook. The registration should look like:
$wgHooks['AdminLinks'][] = 'my-function';
And the header of the function should look like:
function my-function(&$admin_links_tree)
The "tree" passed in to the function is of type ALTree. Each ALTree holds a group of sections, of type ALSection. A section is comprised of a group of rows, of type ALRow. A row, finally, holds a group of links or other text, each of type ALItem. The relevant methods for each are:
ALTree:
getSection($section_header)
- retrieves the section of the tree that has this headeraddSection($section, $next_section_header = null)
- adds a section to this tree, before the section with the specified header, if one is specified
ALSection:
getRow($row_name)
- retrieves the row from this section that has this headeraddRow($row, $next_row_name = null)
- adds a row to this section, before the row with the specified name, if one is specified
ALRow:
addItem($item, $next_item_label = null)
- adds an item to this row, before the item with the specified label, if one is specified
ALItem:
newFromPage($page_name_or_title, $description = null, $params = null)
- creates a new ALItem object that links to a wiki page, with the ability to specify a description and parameters; the first argument can be either a page name or a Title objectnewFromSpecialPage($page_name)
- creates a new ALItem object that links to a special pagenewFromEditLink($page_name, $description)
- creates a new ALItem object that links to the 'edit' action of a wiki page, with the specified text descriptionnewFromExternalLink($url, $label)
- creates a new ALItem object that links to a URL, with a specified text label