This page is a translated version of the page Extension:TemplateSandbox and the translation is 46% complete.
这是这个扩展的技术文档。 There is also a user documentation.
OOjs UI icon advanced-invert.svg
發佈狀態: 穩定版本
Screenshot of TemplateSandbox.png
实现 特殊页面 , 页面操作
描述 Preview pages using sandboxed templates
作者 Brad Jorsch (Anomie讨论)
最新版本 1.1.0 (continuous updates)
兼容性政策 快照跟随MediaWiki发布。 master分支不向後兼容。
MediaWiki 1.35+
PHP 7.0+
许可协议 GNU通用公眾授權條款2.0或更新版本
  • $wgTemplateSandboxEditNamespaces
季度下載量 70 (Ranked 105th)
公開的wiki使用 1,213 (Ranked 194th)
問題 尚未完成的工作 · 报告錯誤

TemplateSandbox 扩展增加了使用沙盒版本模板预览页面的能力,允许在沙盒代码上线之前轻松测试。 它也适用于 Scribunto 模块。


  • 下载文件,并将其放置在您extensions/文件夹中的TemplateSandbox目录内。
  • 将下列代码放置在您的LocalSettings.php 的底部:
    wfLoadExtension( 'TemplateSandbox' );
  •   完成 – 在您的wiki上导航至Special:Version,以验证已成功安装扩展。

致使用MediaWiki 1.24或更早版本的用户:

上面的说明介绍的是安装此扩展的新方法,它使用wfLoadExtension()。 如果您需要在早期版本(MediaWiki 1.24和更早版本)中安装此扩展,而不是wfLoadExtension( 'TemplateSandbox' );,您需要使用:

require_once "$IP/extensions/TemplateSandbox/TemplateSandbox.php";


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


此扩展会添加一个新的特殊页面: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. 点击查看

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.