This file contains the class for core message collections implementation. More...
Public Member Functions | |
__construct (string $code) | |
Constructors. | |
getLanguage () | |
setInFile (array $messages) | |
Set translation from file, as opposed to translation which only exists in the wiki because they are not exported and committed yet. | |
setTags (string $type, array $keys) | |
Set message tags. | |
keys () | |
Returns list of available message keys. | |
getMessageKeys () | |
Returns list of message keys that are used in this collection after filtering. | |
getTags (string $type) | |
Returns stored message tags. | |
getAuthors () | |
Lists all translators that have contributed to the latest revisions of each translation. | |
addCollectionAuthors (array $authors, string $mode='append') | |
Add external authors (usually from the file). | |
loadTranslations () | |
Loads all message data. | |
resetForNewLanguage (string $code) | |
Some statistics scripts for example loop the same collection over every language. | |
slice ( $offset, $limit) | |
For paging messages. | |
filter (string $type, bool $condition=true, ?int $value=null) | |
Filters messages based on some condition. | |
filterUntranslatedOptional () | |
initMessages () | |
Constructs all Messages (ThinMessage) from the data accumulated so far. | |
offsetExists ( $offset) | |
ArrayAccess methods. | |
offsetGet ( $offset) | |
offsetSet ( $offset, $value) | |
offsetUnset ( $offset) | |
__get (string $name) | |
Fail fast if trying to access unknown properties. | |
__set (string $name, $value) | |
Fail fast if trying to access unknown properties. | |
rewind () | |
Iterator method. | |
current () | |
key () | |
next () | |
valid () | |
count () | |
Static Public Member Functions | |
static | newFromDefinitions (MessageDefinitions $definitions, string $code) |
Construct a new message collection from definitions. | |
Public Attributes | |
string | $code |
Language code. | |
Protected Attributes | |
array | $keys = [] |
array( Message display key => database key, ... ) | |
array | $messages = [] |
array( Message String => Message, ... ) | |
array | $tags = [] |
This file contains the class for core message collections implementation.
Message collection is collection of messages of one message group in one language. It handles loading of the messages in one huge batch, and also stores information that can be used to filter the collection in different ways.
Definition at line 38 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::__construct | ( | string | $code | ) |
Constructors.
Use newFromDefinitions() instead.
string | $code | Language code. |
Definition at line 80 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::__get | ( | string | $name | ) |
Fail fast if trying to access unknown properties.
Definition at line 916 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::__set | ( | string | $name, |
$value ) |
Fail fast if trying to access unknown properties.
mixed | $value |
Definition at line 925 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::addCollectionAuthors | ( | array | $authors, |
string | $mode = 'append' ) |
Add external authors (usually from the file).
string[] | $authors | List of authors. |
string | $mode | Either append or set authors. |
Definition at line 199 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::count | ( | ) |
Definition at line 960 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::current | ( | ) |
Definition at line 939 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::filter | ( | string | $type, |
bool | $condition = true, | ||
?int | $value = null ) |
Filters messages based on some condition.
Some filters cause data to be loaded from the database. PAGEINFO: existence and fuzzy tags. TRANSLATIONS: translations for every message. It is recommended to first filter with messages that do not need those. It is recommended to add translations from file with addInfile, and it is needed for changed filter to work.
string | $type |
|
bool | $condition | Whether to return messages which do not satisfy the given filter condition (true), or only which do (false). |
int | null | $value | Value for properties filtering. |
InvalidFilterException | If given invalid filter name. |
Definition at line 328 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::filterUntranslatedOptional | ( | ) |
Definition at line 390 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::getAuthors | ( | ) |
Lists all translators that have contributed to the latest revisions of each translation.
Causes translations to be loaded from the database. Is not affected by filters.
Definition at line 160 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::getLanguage | ( | ) |
Definition at line 97 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::getMessageKeys | ( | ) |
Returns list of message keys that are used in this collection after filtering.
Definition at line 141 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::getTags | ( | string | $type | ) |
Returns stored message tags.
string | $type | Tag type, usually optional or ignored. |
Definition at line 150 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::initMessages | ( | ) |
Constructs all Messages (ThinMessage) from the data accumulated so far.
Usually there is no need to call this method directly.
Definition at line 802 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::key | ( | ) |
Definition at line 948 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::keys | ( | ) |
Returns list of available message keys.
This is affected by filtering.
Definition at line 125 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::loadTranslations | ( | ) |
Loads all message data.
Must be called before accessing the messages with ArrayAccess or iteration.
Definition at line 219 of file MessageCollection.php.
|
static |
Construct a new message collection from definitions.
MessageDefinitions | $definitions | |
string | $code | Language code. |
Definition at line 89 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::next | ( | ) |
Definition at line 952 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::offsetExists | ( | $offset | ) |
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::offsetGet | ( | $offset | ) |
mixed | $offset |
Definition at line 893 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::offsetSet | ( | $offset, | |
$value ) |
mixed | $offset | |
mixed | $value |
Definition at line 901 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::offsetUnset | ( | $offset | ) |
mixed | $offset |
Definition at line 906 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::resetForNewLanguage | ( | string | $code | ) |
Some statistics scripts for example loop the same collection over every language.
This is a shortcut which keeps tags and definitions.
Definition at line 235 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::rewind | ( | ) |
Iterator method.
Definition at line 934 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::setInFile | ( | array | $messages | ) |
Set translation from file, as opposed to translation which only exists in the wiki because they are not exported and committed yet.
string[] | $messages | Array of translations indexed by display key. |
Definition at line 108 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::setTags | ( | string | $type, |
array | $keys ) |
Set message tags.
string | $type | Tag type, usually ignored or optional. |
string[] | $keys | List of display keys. |
Definition at line 117 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::slice | ( | $offset, | |
$limit ) |
For paging messages.
One can count messages before and after slice.
string | $offset | |
int | $limit |
Definition at line 256 of file MessageCollection.php.
MediaWiki\Extension\Translate\MessageLoading\MessageCollection::valid | ( | ) |
Definition at line 956 of file MessageCollection.php.
string MediaWiki\Extension\Translate\MessageLoading\MessageCollection::$code |
Language code.
Definition at line 48 of file MessageCollection.php.
|
protected |
array( Message display key => database key, ... )
Definition at line 55 of file MessageCollection.php.
|
protected |
array( Message String => Message, ... )
Definition at line 57 of file MessageCollection.php.
|
protected |
Definition at line 72 of file MessageCollection.php.