Manual:$wgAllowDisplayTitle

From MediaWiki.org
Jump to: navigation, search
Parser: $wgAllowDisplayTitle
Allows use of DISPLAYTITLE magic word
Introduced in version: 1.7.0 (r13572)
Removed in version: still in use
Allowed values: (boolean)
Default value: true
(false prior to 1.11.0)

Other settings: Alphabetical | By Function

Details[edit | edit source]

When this option is enabled, users will be able to use the DISPLAYTITLE magic word to override the title of a page, provided the selected title normalises to the same canonical title.

For example, on a page titled IPod, one can use {{DISPLAYTITLE:iPod}} to force the title to appear as "iPod" when viewed. However, {{DISPLAYTITLE:Foo}} will not work, because "Foo" is not the same title as "IPod". Since MediaWiki 1.14, it is possible to disable this restriction and thus allow any display title by setting $wgRestrictDisplayTitle = false; This is not recommended however, as it breaks the wiki convention that a page's title is its name, and thus can be used for linking to it.

$wgAllowDisplayTitle was disabled by default in MediaWiki until 1.10.0, as previous implementations were buggy, incompatible with caching, and didn't perform title normalisation checks, which are essential to allow correct linking to articles.