MediaWiki REL1_37
ApiHelpParamValueMessage Class Reference

Message subclass that prepends wikitext for API help. More...

Inheritance diagram for ApiHelpParamValueMessage:
Collaboration diagram for ApiHelpParamValueMessage:

Public Member Functions

 __construct ( $paramValue, $text, $params=[], $deprecated=false, $internal=false)
 
 fetchMessage ()
 
 getParamValue ()
 Fetch the parameter value.
 
 isDeprecated ()
 Fetch the 'deprecated' flag.
 
 isInternal ()
 Fetch the 'internal' flag.
 
- Public Member Functions inherited from Message
 __construct ( $key, $params=[], Language $language=null)
 
 __serialize ()
 
 __toString ()
 Magic method implementation of the above (for PHP >= 5.2.0), so we can do, eg: $foo = new Message( $key ); $string = "<abbr>$foo</abbr>";.
 
 __unserialize ( $data)
 
 bitrateParams (... $params)
 Add parameters that are bitrates and will be passed through Language::formatBitrate before substitution.
 
 content ()
 Returns the message as a Content object.
 
 dateParams (... $params)
 Add parameters that are dates and will be passed through Language::date before substitution.
 
 dateTimeParams (... $params)
 Add parameters that are date-times and will be passed through Language::timeanddate before substitution.
 
 durationParams (... $params)
 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 (... $params)
 Add parameters that are expiration times and will be passed through Language::formatExpiry before substitution.
 
 getKey ()
 Returns the message key.
 
 getKeysToTry ()
 
 getLanguage ()
 Returns the Language of the Message.
 
 getParams ()
 Returns the message parameters.
 
 getTitle ()
 Get a title object for a mediawiki message, where it can be found in the mediawiki namespace.
 
 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 "-".
 
 isMultiKey ()
 
 numParams (... $params)
 Add parameters that are numeric and will be passed through Language::formatNum before substitution.
 
 page (?PageReference $page)
 Set the page object to use as context when transforming the message.
 
 params (... $args)
 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.
 
 plaintextParams (... $params)
 Add parameters that are plaintext and will be passed through without the content being evaluated.
 
 rawParams (... $params)
 Add parameters that are substituted after parsing or escaping.
 
 serialize ()
 
 setContext (IContextSource $context)
 Set the language and the title from a context object.
 
 setInterfaceMessageFlag ( $interface)
 Allows manipulating the interface message flag directly.
 
 sizeParams (... $params)
 Add parameters that are file sizes and will be passed through Language::formatSize before substitution.
 
 text ()
 Returns the message text.
 
 timeParams (... $params)
 Add parameters that are times and will be passed through Language::time before substitution.
 
 timeperiodParams (... $params)
 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 (string $format)
 Returns the message formatted a certain way.
 
 unserialize ( $serialized)
 
 useDatabase ( $useDatabase)
 Enable or disable database use.
 

Protected Attributes

 $deprecated
 
 $internal
 
 $paramValue
 
- Protected Attributes inherited from Message
Content $content = null
 Content object representing the message.
 
PageReference $contextPage = null
 page object to use as context.
 
bool $interface = true
 In which language to get this message.
 
string $key
 The message key.
 
string[] $keysToTry
 List of keys to try when fetching the message.
 
Language bool $language = false
 In which language to get this message.
 
string $message
 
array $parameters = []
 List of parameters which will be substituted into the message.
 
bool $useDatabase = true
 Whether database can be used.
 

Private Member Functions

 subMessage ( $key)
 

Additional Inherited Members

- Static Public Member Functions inherited from Message
static bitrateParam ( $bitrate)
 
static dateParam (string $date)
 
static dateTimeParam (string $dateTime)
 
static durationParam ( $duration)
 
static expiryParam ( $expiry)
 
static listParam (array $list, $type='text')
 
static newFallbackSequence (... $keys)
 Factory function accepting multiple message keys and returning a message instance for the first message which is non-empty.
 
static newFromKey ( $key,... $params)
 Factory function that is just wrapper for the real constructor.
 
static newFromSpecifier ( $value)
 Transform a MessageSpecifier or a primitive value used interchangeably with specifiers (a message key string, or a key + params array) into a proper Message.
 
static numParam ( $num)
 
static plaintextParam ( $plaintext)
 
static rawParam ( $raw)
 
static sizeParam ( $size)
 
static timeParam (string $time)
 
static timeperiodParam ( $period)
 
- Public Attributes inherited from Message
const FORMAT_BLOCK_PARSE = 'block-parse'
 Use normal wikitext -> HTML parsing (the result will be wrapped in a block-level HTML tag)
 
const FORMAT_ESCAPED = 'escaped'
 Transform {{..}} constructs, HTML-escape the result.
 
const FORMAT_PARSE = 'parse'
 Use normal wikitext -> HTML parsing but strip the block-level wrapper.
 
const FORMAT_PLAIN = 'plain'
 Use message text as-is.
 
const FORMAT_TEXT = 'text'
 Transform {{..}} constructs but don't transform to HTML.
 
- Protected Member Functions inherited from Message
 extractParam ( $param, $format)
 Extracts the parameter type and preprocessed the value if needed.
 
 formatListParam (array $params, $listType, $format)
 Formats a list of parameters as a concatenated string.
 
 formatPlaintext ( $plaintext, $format)
 Formats a message parameter wrapped with 'plaintext'.
 
 parseText ( $string)
 Wrapper for what ever method we use to parse wikitext.
 
 replaceParameters ( $message, $type, $format)
 Substitutes any parameters into the message text.
 
 transformText ( $string)
 Wrapper for what ever method we use to {{-transform wikitext.
 
- Static Protected Attributes inherited from Message
static array $listTypeMap
 Mapping from Message::listParam() types to Language methods.
 

Detailed Description

Message subclass that prepends wikitext for API help.

This exists so the apihelp-*-paramvalue-*-* messages don't all have to include markup wikitext while still keeping the 'APIGetParamDescriptionMessages' hook simple.

@newable

Since
1.25

Definition at line 34 of file ApiHelpParamValueMessage.php.

Constructor & Destructor Documentation

◆ __construct()

ApiHelpParamValueMessage::__construct (   $paramValue,
  $text,
  $params = [],
  $deprecated = false,
  $internal = false 
)
See also
Message::__construct
Stability: stable
to call
Parameters
string$paramValueParameter value being documented
string$textMessage to use.
array$paramsParameters for the message.
bool$deprecatedWhether the value is deprecated
bool$internalWhether the value is internal
Exceptions
InvalidArgumentException
Since
1.30 Added the $deprecated parameter
1.35 Added the $internal parameter

Definition at line 53 of file ApiHelpParamValueMessage.php.

References $deprecated, $internal, and $paramValue.

Member Function Documentation

◆ fetchMessage()

ApiHelpParamValueMessage::fetchMessage ( )
Returns
string

Reimplemented from Message.

Definition at line 95 of file ApiHelpParamValueMessage.php.

References Message\$message, isDeprecated(), isInternal(), and subMessage().

◆ getParamValue()

ApiHelpParamValueMessage::getParamValue ( )

Fetch the parameter value.

Returns
string

Definition at line 70 of file ApiHelpParamValueMessage.php.

References $paramValue.

◆ isDeprecated()

ApiHelpParamValueMessage::isDeprecated ( )

Fetch the 'deprecated' flag.

Since
1.30
Returns
bool

Definition at line 79 of file ApiHelpParamValueMessage.php.

References $deprecated.

Referenced by fetchMessage().

◆ isInternal()

ApiHelpParamValueMessage::isInternal ( )

Fetch the 'internal' flag.

Since
1.35
Returns
bool

Definition at line 88 of file ApiHelpParamValueMessage.php.

References $internal.

Referenced by fetchMessage().

◆ subMessage()

ApiHelpParamValueMessage::subMessage (   $key)
private

Member Data Documentation

◆ $deprecated

ApiHelpParamValueMessage::$deprecated
protected

Definition at line 37 of file ApiHelpParamValueMessage.php.

Referenced by __construct(), and isDeprecated().

◆ $internal

ApiHelpParamValueMessage::$internal
protected

Definition at line 38 of file ApiHelpParamValueMessage.php.

Referenced by __construct(), and isInternal().

◆ $paramValue

ApiHelpParamValueMessage::$paramValue
protected

Definition at line 36 of file ApiHelpParamValueMessage.php.

Referenced by __construct(), and getParamValue().


The documentation for this class was generated from the following file: