MediaWiki
REL1_22
|
The Message class provides methods which fulfil two basic services: More...
Public Member Functions | |
__construct ($key, $params=array()) | |
Constructor. | |
__toString () | |
Magic method implementation of the above (for PHP >= 5.2.0), so we can do, eg: $foo = Message::get( $key ); $string = "<abbr>$foo</abbr>";. | |
bitrateParams () | |
Add parameters that are bitrates and will be passed through Language::formatBitrate before substitution. | |
content () | |
Returns the message as a Content object. | |
durationParams () | |
Add parameters that are durations of time and will be passed through Language::formatDuration before substitution. | |
escaped () | |
Returns the message text. | |
exists () | |
Check whether a message key has been defined currently. | |
expiryParams () | |
Add parameters that are expiration times and will be passed through Language::formatExpiry before substitution. | |
getFormat () | |
Returns the message format. | |
getKey () | |
Returns the message key. | |
getParams () | |
Returns the message parameters. | |
inContentLanguage () | |
Request the message in the wiki's content language, unless it is disabled for this message. | |
inLanguage ($lang) | |
Request the message in any language that is supported. | |
isBlank () | |
Check whether a message does not exist, or is an empty string. | |
isDisabled () | |
Check whether a message does not exist, is an empty string, or is "-". | |
numParams () | |
Add parameters that are numeric and will be passed through Language::formatNum before substitution. | |
params () | |
Adds parameters to the parameter list of this message. | |
parse () | |
Fully parse the text from wikitext to HTML. | |
parseAsBlock () | |
Returns the parsed message text which is always surrounded by a block element. | |
plain () | |
Returns the message text as-is, only parameters are substituted. | |
rawParams () | |
Add parameters that are substituted after parsing or escaping. | |
setContext (IContextSource $context) | |
Set the language and the title from a context object. | |
setInterfaceMessageFlag ($value) | |
Allows manipulating the interface message flag directly. | |
sizeParams () | |
Add parameters that are file sizes and will be passed through Language::formatSize before substitution. | |
text () | |
Returns the message text. | |
timeperiodParams () | |
Add parameters that are time periods and will be passed through Language::formatTimePeriod before substitution. | |
title ($title) | |
Set the Title object to use as context when transforming the message. | |
toString () | |
Returns the message parsed from wikitext to HTML. | |
useDatabase ($value) | |
Enable or disable database use. | |
Static Public Member Functions | |
static | bitrateParam ($value) |
static | durationParam ($value) |
static | expiryParam ($value) |
static | newFallbackSequence () |
Factory function accepting multiple message keys and returning a message instance for the first message which is non-empty. | |
static | newFromKey ($key) |
Factory function that is just wrapper for the real constructor. | |
static | numParam ($value) |
static | rawParam ($value) |
static | sizeParam ($value) |
static | timeperiodParam ($value) |
Protected Member Functions | |
extractParam ($param) | |
Extracts the parameter type and preprocessed the value if needed. | |
fetchMessage () | |
Wrapper for what ever method we use to get message contents. | |
parseText ($string) | |
Wrapper for what ever method we use to parse wikitext. | |
replaceParameters ($message, $type= 'before') | |
Substitutes any parameters into the message text. | |
transformText ($string) | |
Wrapper for what ever method we use to {{-transform wikitext. | |
Protected Attributes | |
$content = null | |
Content object representing the message. | |
$format = 'parse' | |
Format for the message. | |
$interface = true | |
In which language to get this message. | |
$key | |
The message key. | |
Language | $language = null |
In which language to get this message. | |
string | $message |
$parameters = array() | |
List of parameters which will be substituted into the message. | |
$title = null | |
Title object to use as context. | |
$useDatabase = true | |
Whether database can be used. |
The Message class provides methods which fulfil two basic services:
First implemented with MediaWiki 1.17, the Message class is intended to replace the old wfMsg* functions that over time grew unusable.
You should use the wfMessage() global function which acts as a wrapper for the Message class. The wrapper let you pass parameters as arguments.
The most basic usage cases would be:
// Initialize a Message object using the 'some_key' message key $message = wfMessage( 'some_key' ); // Using two parameters those values are strings 'value1' and 'value2': $message = wfMessage( 'some_key', 'value1', 'value2' );
Since wfMessage() returns a Message instance, you can chain its call with a method. Some of them return a Message instance too so you can chain them. You will find below several examples of wfMessage() usage.
Fetching a message text for interface message:
A Message instance can be passed parameters after it has been constructed, use the params() method to do so:
wfMessage( 'welcome-to' ) ->params( $wgSitename ) ->text();
{{GRAMMAR}} and friends work correctly:
wfMessage( 'are-friends', $user, $friend ); wfMessage( 'bad-message' ) ->rawParams( '<script>...</script>' ) ->escaped();
Messages can be requested in a different language or in whatever current content language is being used. The methods are:
Sometimes the message text ends up in the database, so content language is needed:
Checking whether a message exists:
wfMessage( 'mysterious-message' )->exists() // returns a boolean whether the 'mysterious-message' key exist.
If you want to use a different language:
$userLanguage = $user->getOption( 'language' ); wfMessage( 'email-header' ) ->inLanguage( $userLanguage ) ->plain();
Use full parsing:
// old style: wfMsgExt( 'key', array( 'parseinline' ), 'apple' ); // new style: wfMessage( 'key', 'apple' )->parse();
Parseinline is used because it is more useful when pre-building HTML. In normal use it is better to use OutputPage::(add|wrap)WikiMsg.
Places where HTML cannot be used. {{-transformation is done.
// old style: wfMsgExt( 'key', array( 'parsemag' ), 'apple', 'pear' ); // new style: wfMessage( 'key', 'apple', 'pear' )->text();
Shortcut for escaping the message too, similar to wfMsgHTML(), but parameters are not replaced after escaping by default.
$escaped = wfMessage( 'key' ) ->rawParams( 'apple' ) ->escaped();
Definition at line 159 of file Message.php.
Message::__construct | ( | $ | key, |
$ | params = array() |
||
) |
Constructor.
$key,: | message key, or array of message keys to try and use the first non-empty message for | |
array | $params | message parameters |
Reimplemented in RawMessage.
Definition at line 220 of file Message.php.
Magic method implementation of the above (for PHP >= 5.2.0), so we can do, eg: $foo = Message::get( $key ); $string = "<abbr>$foo</abbr>";.
Definition at line 609 of file Message.php.
static Message::bitrateParam | ( | $ | value | ) | [static] |
Add parameters that are bitrates and will be passed through Language::formatBitrate before substitution.
Varargs,: | numeric parameters (or single argument that is array of numeric parameters) |
Definition at line 436 of file Message.php.
Message::content | ( | ) |
Returns the message as a Content object.
Definition at line 544 of file Message.php.
static Message::durationParam | ( | $ | value | ) | [static] |
Add parameters that are durations of time and will be passed through Language::formatDuration before substitution.
Varargs,: | numeric parameters (or single argument that is array of numeric parameters) |
Definition at line 364 of file Message.php.
Message::escaped | ( | ) |
Returns the message text.
{{-transformation is done and the result is escaped excluding any raw parameters.
Definition at line 676 of file Message.php.
Message::exists | ( | ) |
Check whether a message key has been defined currently.
Definition at line 686 of file Message.php.
static Message::expiryParam | ( | $ | value | ) | [static] |
Add parameters that are expiration times and will be passed through Language::formatExpiry before substitution.
Varargs,: | numeric parameters (or single argument that is array of numeric parameters) |
Definition at line 382 of file Message.php.
Message::extractParam | ( | $ | param | ) | [protected] |
Extracts the parameter type and preprocessed the value if needed.
string | array | $param | Parameter as defined in this class. |
Definition at line 799 of file Message.php.
Message::fetchMessage | ( | ) | [protected] |
Wrapper for what ever method we use to get message contents.
MWException |
Reimplemented in RawMessage.
Definition at line 861 of file Message.php.
Message::getKey | ( | ) |
Returns the message parameters.
Definition at line 251 of file Message.php.
Request the message in the wiki's content language, unless it is disabled for this message.
Definition at line 494 of file Message.php.
Message::inLanguage | ( | $ | lang | ) |
Request the message in any language that is supported.
As a side effect interface message status is unconditionally turned off.
$lang | Mixed: language code or Language object. |
MWException |
Definition at line 470 of file Message.php.
Message::isBlank | ( | ) |
Check whether a message does not exist, or is an empty string.
Definition at line 696 of file Message.php.
Check whether a message does not exist, is an empty string, or is "-".
Definition at line 706 of file Message.php.
static Message::newFallbackSequence | ( | ) | [static] |
Factory function accepting multiple message keys and returning a message instance for the first message which is non-empty.
If all messages are empty then an instance of the first message key is returned.
Varargs,: | message keys (or first arg as an array of all the message keys) |
Definition at line 289 of file Message.php.
static Message::newFromKey | ( | $ | key | ) | [static] |
Factory function that is just wrapper for the real constructor.
It is intended to be used instead of the real constructor, because it allows chaining method calls, while new objects don't.
string | $key | message key |
Varargs,: | parameters as Strings |
Definition at line 275 of file Message.php.
static Message::numParam | ( | $ | value | ) | [static] |
Add parameters that are numeric and will be passed through Language::formatNum before substitution.
Varargs,: | numeric parameters (or single argument that is array of numeric parameters) |
Definition at line 346 of file Message.php.
Message::params | ( | ) |
Adds parameters to the parameter list of this message.
Varargs,: | parameters as Strings, or a single argument that is an array of Strings |
Definition at line 309 of file Message.php.
Message::parse | ( | ) |
Fully parse the text from wikitext to HTML.
Definition at line 635 of file Message.php.
Returns the parsed message text which is always surrounded by a block element.
Definition at line 665 of file Message.php.
Message::parseText | ( | $ | string | ) | [protected] |
Wrapper for what ever method we use to parse wikitext.
string | $string | Wikitext message contents |
Definition at line 840 of file Message.php.
Message::plain | ( | ) |
Returns the message text as-is, only parameters are substituted.
Definition at line 655 of file Message.php.
static Message::rawParam | ( | $ | value | ) | [static] |
$value |
Definition at line 716 of file Message.php.
Referenced by NewUsersLogFormatter\getMessageParameters(), PatrolLogFormatter\getMessageParameters(), and MoveLogFormatter\getMessageParameters().
Add parameters that are substituted after parsing or escaping.
In other words the parsing process cannot access the contents of this type of parameter, and you need to make sure it is sanitized beforehand. The parser will see "$n", instead.
Varargs,: | raw parameters as Strings (or single argument that is an array of raw parameters) |
Definition at line 328 of file Message.php.
Message::replaceParameters | ( | $ | message, |
$ | type = 'before' |
||
) | [protected] |
Substitutes any parameters into the message text.
string | $message | the message text |
string | $type | either before or after |
Definition at line 781 of file Message.php.
Message::setContext | ( | IContextSource $ | context | ) |
Set the language and the title from a context object.
$context | IContextSource |
Definition at line 453 of file Message.php.
Message::setInterfaceMessageFlag | ( | $ | value | ) |
Allows manipulating the interface message flag directly.
Can be used to restore the flag after setting a language.
$value | bool |
Definition at line 513 of file Message.php.
static Message::sizeParam | ( | $ | value | ) | [static] |
Add parameters that are file sizes and will be passed through Language::formatSize before substitution.
Varargs,: | numeric parameters (or single argument that is array of numeric parameters) |
Definition at line 418 of file Message.php.
Message::text | ( | ) |
Returns the message text.
{{-transformation is done.
Definition at line 645 of file Message.php.
static Message::timeperiodParam | ( | $ | value | ) | [static] |
Add parameters that are time periods and will be passed through Language::formatTimePeriod before substitution.
Varargs,: | numeric parameters (or single argument that is array of numeric parameters) |
Definition at line 400 of file Message.php.
Message::title | ( | $ | title | ) |
Set the Title object to use as context when transforming the message.
$title | Title object |
Definition at line 535 of file Message.php.
Returns the message parsed from wikitext to HTML.
Definition at line 557 of file Message.php.
Message::transformText | ( | $ | string | ) | [protected] |
Wrapper for what ever method we use to {{-transform wikitext.
string | $string | Wikitext message contents |
Definition at line 851 of file Message.php.
Message::useDatabase | ( | $ | value | ) |
Enable or disable database use.
$value | Boolean |
Definition at line 524 of file Message.php.
Message::$content = null [protected] |
Content object representing the message.
Definition at line 207 of file Message.php.
Format for the message.
Supported formats are: * text (transform) * escaped (transform+htmlspecialchars) * block-parse * parse (default) * plain
Definition at line 192 of file Message.php.
Message::$interface = true [protected] |
In which language to get this message.
True, which is the default, means the current interface language, false content language.
Definition at line 164 of file Message.php.
Message::$key [protected] |
The message key.
Definition at line 176 of file Message.php.
In which language to get this message.
Overrides the $interface variable.
Definition at line 171 of file Message.php.
string Message::$message [protected] |
Definition at line 211 of file Message.php.
Message::$parameters = array() [protected] |
List of parameters which will be substituted into the message.
Definition at line 181 of file Message.php.
Message::$title = null [protected] |
Title object to use as context.
Definition at line 202 of file Message.php.
Message::$useDatabase = true [protected] |
Whether database can be used.
Definition at line 197 of file Message.php.