Titre affiché
A display title is the preferred title associated with a wiki page. It typically provides the string of text that is shown in the title header of a page. It is conceptually and technically distinct from the page title , i.e. the title by which a page is recorded and made accessible over the web. By default, a display title is synonymous with the page title but can be customised to suit your needs.
Different wikis use different naming conventions for the page title and display title. For instance, the convention on a site like Wikipedia is that the page title of an article should be descriptive of the subject, while the display title may be customised only to take on some formatting that page titles don't support (lowercase initial, italics, superscript). Other wikis may prefer to use short, hash-generated page titles and leave the descriptive part to the display title only. Either approach is possible.
MediaWiki core
For users and site admins
- The display title is usually visible as the title header of a page. A more reliable method of checking it, however, is by looking at the summary table that is usually known as Information sur la page .
- Unless the option
$wgAllowDisplayTitle
is set tofalse
, the magic word DISPLAYTITLE lets you set a custom display title for a page. To an extent, it allows for HTML formatting options such as italics.- In addition, the main page's display title can be overridden with the
Mainpage-title
/Mainpage-title-loggedin
system messages , described at Manuel:Page d'accueil .
- In addition, the main page's display title can be overridden with the
Configuration settings:
Name | Type | Description | Default |
---|---|---|---|
$wgAllowDisplayTitle | boolean | whether or not custom display titles are allowed to be set using DISPLAYTITLE. | true
|
$wgRestrictDisplayTitle | boolean | whether or not customisation should be restricted to formatting. | true
|
For developers
- The display title is stored in rows of the
page_props
table wherepp_propname
equals'displaytitle'
. Its value is stored inpp_propvalue
. - It can be retrieved in PHP. See e.g.
- PageProps::getProperties() - PageProps can be called using MediaWikiServices .
- The ParserOutput class offers the methods
getDisplayTitle()
andgetPageProperties()
.
- It can be set in the ParserOutput using
setDisplayTitle()
orsetPageProperty()
. - It can be retrieved over the API. See e.g.
Extensions
- Extension:DisplayTitle - builds on the use of the magic word DISPLAYTITLE by making sure that a wiki link to a page uses the display title as the default link text. It also provides a parser function to query a page's display title as well as an equivalent function for use in Lua.
- Extension:PageProperties - lets you edit the display title and other page properties with the aid of a form
- Extension:Semantic MediaWiki - builds on DISPLAYTITLE by automatically assigning the display title to a special property called "Display title of". See https://www.semantic-mediawiki.org/wiki/Help:Display_title