Extension:TemplateSandbox

This is technical documentation of the extension. There is also a user documentation.

MediaWiki extensions manual

File:OOjs UI icon advanced-invert.svg TemplateSandbox Release status: stable
File:Screenshot of TemplateSandbox.png
Implementation	Special page , Page action
Description	Preview pages using sandboxed templates
Author(s)	Brad Jorsch (Anomietalk)
Latest version	1.1.0 (continuous updates)
Compatibility policy	Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki	1.35+
PHP	7.0+
License	GNU General Public License 2.0 or later
Download	<translate> Download extension</translate> <translate> Git</translate> [?]: <translate> Download Git master</translate> <translate> browse repository</translate> (Phabricator · GitHub) <translate> commit history</translate> <translate> repository contributors (GitHub)</translate> <translate> code review</translate>
Help	Help:Extension:TemplateSandbox
Parameters $wgTemplateSandboxEditNamespaces
Hooks used APIGetAllowedParams AlternateEditPreview ApiMakeParserOptions EditPage::importFormData importFormData extensions EditPage::showStandardInputs:options showStandardInputs:options extensions
Quarterly downloads
Public wikis using
Translate the TemplateSandbox extension if it is available at translatewiki.net
Issues	Open tasks · Report a bug

The TemplateSandbox extension adds the ability to preview a page using sandboxed versions of templates, allowing for easy testing before making the sandbox code live. It also works with Scribunto modules.

Installation

• <translate> [[<tvar name=2>Special:ExtensionDistributor/TemplateSandbox</tvar>|Download]] and move the extracted <tvar name=name>TemplateSandbox</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/TemplateSandbox
• <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php </tvar> file:</translate>

  wfLoadExtension( 'TemplateSandbox' );
  

• 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

Parameters

• $wgTemplateSandboxEditNamespaces - Namespaces in which to show the "Preview page with this template" box below the edit form. NS_TEMPLATE by default. Can be expanded to all namespaces by individual users using advancedtemplatesandbox.js.

Usage

The extension adds a new special page, Special:TemplateSandbox. To preview a page using sandboxed templates, do the following:

1. Copy the templates to be tested under a common prefix. For example, you might copy Template:Foo to User:Example/sandbox/Template:Foo. Alternatively, you might create User:Example/sandbox/Template:Foo as a redirect to Template:Foo/sandbox.
2. Go to Special:TemplateSandbox. Fill in the page or revision to be rendered, and the prefix you chose in step 1. It is possible to specify multiple prefixes (a prefix search path) by separating them using vertical bars, e.g. User:Example/sandbox1|User:Example/sandbox2.
3. Click View.

The extension also adds a box at the bottom of the edit form for pages in the namespaces configured in $wgTemplateSandboxEditNamespaces. This allows for previewing some other page as it would appear were the template being edited saved with the current contents of the edit form. The box can be forced to appear in the edit form for any page by adding the query parameter wpTemplateSandboxShow to the URL.

See also

• User:Jackmcbarn/advancedtemplatesandbox.js — A MediaWiki user script that enables use of TemplateSandbox for all pages.
• Help:ExpandTemplates
• Extension:SandboxLink
• Extension:Scribunto − This extension also allows for sandboxing Scribunto modules.