Manual:Hooks/PersonalUrls
If using MediaWiki >= 1.36, consider using Manual:Hooks/SkinTemplateNavigation::Universal instead, which will give you more flexibility about positioning of your menus while retaining backwards compatibility with older skins. |
This feature was removed from MediaWiki core in version 1.41.0 (after being deprecated in 1.39). Please see SkinTemplateNavigation::Universal for an alternative way to use this feature. |
PersonalUrls | |
---|---|
Available from version 1.7.0 (r14138, codereview) Removed in version 1.41.0 (Gerrit change 959839) Called after the personal URLs have been set up, before they are shown. | |
Define function: | public static function onPersonalUrls( array &$personal_urls, Title $title, SkinTemplate $skin ) { ... }
|
Attach hook: | In extension.json:
{
"Hooks": {
"PersonalUrls": "MediaWiki\\Extension\\MyExtension\\Hooks::onPersonalUrls"
}
}
|
Called from: | File(s): skins/SkinTemplate.php |
Interface: | PersonalUrlsHook.php |
For more information about attaching hooks, see Manual:Hooks .
For examples of extensions using this hook, see Category:PersonalUrls extensions.
Details
edit- $personal_urls: the array of URLs set up so far
- $title: the Title object of the current article
- $skin: SkinTemplate object providing context (e.g. to check if the user is logged in, etc.) - since 1.23 (gerrit:95776)
personal_urls items format
edit- Each line of the array is composed from an array, containing 4 items:
Key | Description |
---|---|
text | The link text |
href | The link URL |
active | Determines if this link is the active page |
class | Custom CSS class for the link (e.g. new if the page doesn't exist) |
icon | Icon identifier, for use in skins which support it, e.g. Vector (2022) |
Only text and href are mandatory.
List of PersonalUrls
editIn a vanilla MediaWiki install, the $personal_urls contains the following entries:
Key | Description | Target page sample |
---|---|---|
userpage & anonuserpage | The user page | User:John Doe |
mytalk & anontalk | The user talk page | User talk:John Doe |
preferences | The preferences special page | Special:Preferences |
watchlist | The user watchlist | Special:Watchlist |
mycontris | The user contributions page | Special:Contributions/John Doe |
logout | The logout page | Special:UserLogout |
createaccount | The registration page | Special:Createaccount |
login & anonlogin | The login page | Special:UserLogin |