Extension:Semantic Title

The Semantic Title extension allows an alternate display title to be displayed on the title bar of a page and as the link text displayed for links to a page - both on links from another page as well as on self-links from the page itself. The display title can be set using the  magic word (see the help page on magic words for technical metadata and Manual:$wgAllowDisplayTitle) or, using this extension, with a semantic property or Cargo field. The value of the display title is stored in the displaytitle property of the MediaWiki page_props table (Manual:page_props table).

For example, if page `Bug:32758' has semantic property `Title' with value `SMW handles timezones incorrectly', and Semantic Title is properly installed and configured, visible page title will be `SMW handles timezones incorrectly', with subtitle `Bug:32758'.

Similarly, link to the page will be `SMW handles timezones incorrectly' with tooltip `Bug:32758'.

returns `SMW handles timezones incorrectly' as plain text (not a link).

Rationale
Let us assume we are creating a bug tracking system based on MediaWiki. Semantic MediaWiki converts wiki into a database. Pages become objects or entities (e. g. bugs) with properties (e. g. title, submitter, severity, component, etc). We want every bug is identified by its number, assigned automatically. Semantic Forms allows it:

...

so every new bug receives unique identifier. Everything works, but bug page title will be `Bug:32758', links to this bug will also be `Bug:32758', while we want to see bug titles (set by user, not an id assigned by system) in page titles and links. This is the job for Semantic Title extension.

Installation
If you are using semantic properties to set the display title, this extension requires Semantic MediaWiki to be installed first. If you are using Cargo fields to set the display title, this extension requires Cargo to be installed first.

If you are upgrading to Version 3.0 of this extension, you will need to run the refreshLinks.php and runJobs.php maintenance scripts to correctly set the displaytitle property for all of the pages in your wiki.

If this extension is used with the HidePrefix extension, Semantic Title should be included before HidePrefix (Semantic Title does not touch title if it was set to non-default value, e. g. processed by HidePrefix extension).

Use a semantic property as display title
To set the display title using a semantic property:

where:


 * NS_NAMESPACE_X — Namespace constants, e.g.,  , or a user-defined namespace. Only pages in specified namespaces are affected. You can use the integer index of the namespace or the associated namespace constant. Do not use the string name of the namespace.
 * Property name# — Name of property of data type text to be used as title in the specified namespace. It is important that the data type of the property is of type text so you need to manually create the respective property on the wiki (or use the special page  when Semantic Forms is installed.)

Use a Cargo field as display title
To set the display title using a Cargo field:

Hide subtitle
You may also optionally set  to "true" to hide the subtitle that shows the "real" page title.

Usage
Being installed and configured, Semantic Title handles page titles and links with no user intervention.

However, category listings may look ugly, because listings show semantic titles while pages are sorted in order of their actual titles. Use  magic word to fix it, e. g.:

Has title::title

If you need a semantic title of a page as plain text (not a link), use  parser function:

Usage for developers
Other extensions can call ` ' static function to get a semantic title by given title.

Release Notes

 * Version 3.2
 * This version provides a bug fix which prevents setting link texts to empty strings.
 * Version 3.1
 * This version fixed a bug if non-existant pages are involved.
 * Version 3.0
 * This version is a significant reimplementation of the functionality. It now uses the MediaWiki built-in page_props table to be consistent with the implementation of the  magic word. Consequently, Semantic Title will now work with display titles set with that magic word.
 * Added support for display titles set with Cargo fields.
 * Removed Semantic Title API as it is no longer necessary. The display title can be queried using the MediaWiki API (action=query&prop=pageprops ...)


 * Version 2.1
 * Added SemanticTitle:getText and API interface.


 * Version 2.0
 * Talk pages that have a semantic title for the associated subject page have their titles displayed with that semantic title. The display of the talk page title can be customized with the message "semantictitle-talkpagetitle".
 * Fixed character encoding bug.
 * Coding style modifications.


 * Version 1.3
 * Fixed bug that caused the page title not to be transformed on pages that use the LiquidThreads extension. This may also have affected other pages with title fragments.


 * Version 1.2
 * Added support for the SelfLinkBegin hook (Linker.php in MediaWiki core). This replaces self links on a page with the semantic title text as the link text.


 * Version 1.1.0
 * Remediated XSS vulnerability CVE-2014-2854.
 * Migrated to JSON i18n. Beginning with MediaWiki 1.23, translation strings are stored in JSON files, and the EXTENSION.i18n.php file only exists to provide compatibility with older releases of MediaWiki. For more information about this migration, see: https://www.mediawiki.org/wiki/Requests_for_comment/Localisation_format.

Caveats

 * Sematic Title overrides edit page title set by Semantic Forms (specified by ` ' construct).