Extension:SandboxLink/en

From Linux Web Expert

MediaWiki extensions manual
SandboxLink
Release status: stable
Implementation User interface, MyWiki
Description Adds a link to user's personal sandbox to personal tools menu
Author(s) Bartosz Dziewoński (Matma Rextalk)
Latest version Continuous updates
Compatibility policy Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki 1.25+
Database changes No
License No license specified
Download
Help Help:Extension:SandboxLink/en
Quarterly downloads Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin').
Public wikis using Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin').
Translate the SandboxLink extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The SandboxLink extension adds a link to user's personal sandbox to personal tools menu. The sandbox is assumed to exist, or will be created, at a "/sandbox" subpage of user's userpage. The extension accurately reflects the existence of the page (redlink, vs always-a-bluelink in the gadget) which will be useful for bringing it to the attention of newcomers. The extension also keeps the link available on restricted special pages (special:preferences and special:userlogin).

More limited version of this functionality can be achieved with a JavaScript snippet: Snippets/MySandbox . This snippet was previously used as a gadget on many Wikimedia wikis, most of which had it set to default=on. The main disadvantages of the gadget are performance and mis-clicks: Because the snippet only loads after everything else is rendered, it causes a distracting "movement" in the personal bar. This also leads to many mis-clicks, when an editor tries to visit their userpage or usertalkpage, and those links moved just before the click. On the other hand, the disadvantage of the extension is that when installed on a wiki, there is no way for a user to opt out of the sandbox link appearing on the personal toolbar.

Usage

See Help:Extension:SandboxLink.

Installation

  • <translate> [[<tvar name=2>Special:ExtensionDistributor/SandboxLink/en</tvar>|Download]] and move the extracted <tvar name=name>SandboxLink/en</tvar> folder to your <tvar name=ext>extensions/</tvar> directory.</translate>
    <translate> Developers and code contributors should install the extension [[<tvar name=git>Special:MyLanguage/Download from Git</tvar>|from Git]] instead, using:</translate>cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/SandboxLink%2Fen
  • <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php </tvar> file:</translate>
    wfLoadExtension( 'SandboxLink/en' );
    
  • Configure as required.
  • File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>


Configuration

Server-side configuration

This extension provides one configuration option:

$wgSandboxLinkDisableAnon
(Default: true)
Whether to disable the functionality for anonymous users.

On-wiki configuration

The sandbox link generated by this extension can be tweaked by modifying some system messages.

sandboxlink-subpage-name
(Default in English: "sandbox", varies per language)
The name of user's subpage where the sandbox should be created. By default, the page used will be "User:Example/sandbox".
Set this message to '-' to remove the sandbox link for all users.
The value in wiki's content language will always be used, regardless of user's chosen language. If you're running a multilingual wiki, this can be overridden with the $wgForceUIMsgAsContentMsg MediaWiki configuration setting.
sandboxlink-portlet-label
(Default in English: "Sandbox", varies per language)
The label of the link in the user's personal toolbar.
tooltip-pt-sandbox
(Default in English: "Your sandbox", varies per language)
The text contained in the "title" attribute of the link to the sandbox. This text is displayed when the user hovers their mouse over the link.
sandboxlink-editintro-pagename
sandboxlink-preload-pagename
(Default: '-')
When the sandbox page does not exist, the page title to use for the 'editintro' and 'preload' parameters of the link. See Manual:Parameters to index.php#Options affecting the edit form. Not enabled by default.

See also