Extension:AddPersonalUrls/Configuration

Table of URLs
The additional URLs are defined in the global variable $wgAddPersonalUrlsTable, which you may customize in your LocalSettings.php. A default table is used if you do not provide a custom one. The table is an array where each entry assigns an ID to a (partial) URL or an array and works as follows:


 * Links are inserted after the link to the user's home page, in the order in which they appear in the array.
 * The ID is the name of a system message used to display the link. AddPersonalUrls is shipped with default messages (in the languages de, en, fr and it) for the links in the default $wgAddPersonalUrlsTable.
 * The URL is either an internal link (without brackets) or an external link. A link is recognized as external iff it contains the string '://' - if you have a better idea, please let me know.
 * If an array is specified, the first item is the URL, and the optional second item is append text to append to the URL. It may provide parameters to special pages. The distinction between URL and append text is necessary because otherwise, an existing special page with appended parameters would be recognized as a non-existing page and be displayed as a red link.
 * The string '$username' will be replaced with the current username, in URLs as well as in append text. Note that in LocalSettings.php, you need to write the URL or append text within single quotes to avoid that PHP already interprets $username while processing LocalSettings.php, in which case it would evaluate to an empty string.

The default content of $wgAddPersonalUrlsTable is currently as follows:

Messages

 * addpersonalurls-desc: Description of this extension as shown in Special:Version.
 * addpersonalurls-preload: When a user clicks on a personal URL and the corresponding page does not exist, the result is a create-page screen with this text preloaded.
 * addpersonalurls-userpages: Description of the link which displays the subpages of User:$username where $username is the user currently logged in.
 * addpersonalurls-home: Description of the link which displays the subpage User:$username/Home where $username is the user currently logged in.
 * addpersonalurls-home-preload: When a user clicks on the addpersonalurls-home link and the corresponding page does not exist, the result is a create-page screen with the text of the addpersonalurls-preload message plus this text preloaded.
 * addpersonalurls-favorites: Description of the link which displays the subpage User:$username/Favorites where $username is the user currently logged in.
 * addpersonalurls-favorites-preload: When a user clicks on the addpersonalurls-favorites link and the corresponding page does not exist, the result is a create-page screen with the text of the addpersonalurls-preload message plus this text preloaded.
 * addpersonalurls-sandbox: Description of the link which displays the subpage User:$username/Sandbox where $username is the user currently logged in.
 * addpersonalurls-sandbox-preload: When a user clicks on the addpersonalurls-sandbox link and the corresponding page does not exist, the result is a create-page screen with the text of the addpersonalurls-preload message plus this text preloaded.
 * addpersonalurls-notes: Description of the link which displays the subpage User:$username/Notes where $username is the user currently logged in.
 * addpersonalurls-notes-preload: When a user clicks on the addpersonalurls-notes link and the corresponding page does not exist, the result is a create-page screen with the text of the addpersonalurls-preload message plus this text preloaded.

In general, when a personal page does not exist, the URL opens the page for editing, and the content of the system messages addpersonalurls-preload and ID-preload is preloaded. This will also work for any URLs you add, provided that ID is equal to addpersonalurls-subpage_title_in_lowercase.

CSS
In the resulting HTML code, each link is wrapped into an &lt;li&gt; element having an id attribute with value pt-ID. This is a feature provided by MediaWiki and allows to format personal URLs individually via CSS.

The AddPersonalUrls exension uses this feature to add icons, taken from the Wikicommons Nuvola icons, to the new links as well as to the existing ones provided by MedaWiki. You can override this with your own CSS.