A title formatter service for MediaWiki. More...
Public Member Functions | |
| formatTitle ( $namespace, $text, $fragment='', $interwiki='') | |
| Returns the title formatted for display. More... | |
| getFullText (LinkTarget $title) | |
| Returns the title formatted for display, with namespace and fragment. More... | |
| getNamespaceName ( $namespace, $text) | |
| Returns the name of the namespace for the given title. More... | |
| getPrefixedDBkey (LinkTarget $target) | |
| Return the title in prefixed database key form, with interwiki and namespace. More... | |
| getPrefixedText (LinkTarget $title) | |
| Returns the title formatted for display, including the namespace name. More... | |
| getText (LinkTarget $title) | |
| Returns the title text formatted for display, without namespace of fragment. More... | |
Detailed Description
A title formatter service for MediaWiki.
This is designed to encapsulate knowledge about conventions for the title forms to be used in the database, in urls, in wikitext, etc.
- Since
- 1.23
Definition at line 35 of file TitleFormatter.php.
Member Function Documentation
◆ formatTitle()
| TitleFormatter::formatTitle | ( | $namespace, | |
| $text, | |||
$fragment = '', |
|||
$interwiki = '' |
|||
| ) |
Returns the title formatted for display.
Per default, this includes the namespace but not the fragment.
- Note
- Normalization is applied if $title is not in TitleValue::TITLE_FORM.
- Parameters
-
int | bool $namespace The namespace ID (or false, if the namespace should be ignored) string $text The page title string $fragment The fragment name (may be empty). string $interwiki The interwiki prefix (may be empty).
- Returns
- string
Implemented in MediaWikiTitleCodec.
◆ getFullText()
| TitleFormatter::getFullText | ( | LinkTarget | $title | ) |
Returns the title formatted for display, with namespace and fragment.
- Parameters
-
LinkTarget $title The title to format
- Returns
- string
Implemented in MediaWikiTitleCodec.
◆ getNamespaceName()
| TitleFormatter::getNamespaceName | ( | $namespace, | |
| $text | |||
| ) |
Returns the name of the namespace for the given title.
- Note
- This must take into account gender sensitive namespace names.
- Todo:
- Move this to a separate interface
- Parameters
-
int $namespace string $text
- Exceptions
-
InvalidArgumentException
- Returns
- string
Implemented in MediaWikiTitleCodec.
◆ getPrefixedDBkey()
| TitleFormatter::getPrefixedDBkey | ( | LinkTarget | $target | ) |
Return the title in prefixed database key form, with interwiki and namespace.
- Since
- 1.27
- Parameters
-
LinkTarget $target
- Returns
- string
Implemented in MediaWikiTitleCodec.
◆ getPrefixedText()
| TitleFormatter::getPrefixedText | ( | LinkTarget | $title | ) |
Returns the title formatted for display, including the namespace name.
- Parameters
-
LinkTarget $title The title to format
- Returns
- string
Implemented in MediaWikiTitleCodec.
◆ getText()
| TitleFormatter::getText | ( | LinkTarget | $title | ) |
Returns the title text formatted for display, without namespace of fragment.
- Note
- Only minimal normalization is applied. Consider using TitleValue::getText() directly.
- Parameters
-
LinkTarget $title The title to format
- Returns
- string
Implemented in MediaWikiTitleCodec.
The documentation for this interface was generated from the following file:
- includes/title/TitleFormatter.php
