MediaWiki\Extension\Translate\PageTranslation\TranslatablePage Class Reference

Mixed bag of methods related to translatable pages. More...

Inheritance diagram for MediaWiki\Extension\Translate\PageTranslation\TranslatablePage:

Public Member Functions
	getTitle ()
	@inheritDoc
	getText ()
	Returns the text for this translatable page.
	getRevision ()
	Revision is null if object was constructed using newFromText.
	getSourceLanguageCode ()
	Returns the source language of this translatable page.
	getMessageGroupId ()
	@inheritDoc
	getMessageGroup ()
	Returns MessageGroup used for translating this page.
	hasPageDisplayTitle ()
	Check whether title is marked for translation.
	getPageDisplayTitle (string $languageCode)
	Get translated page title.
	getStrippedSourcePageText ()
	getTranslationPage (string $targetLanguage)
	addMarkedTag (int $revision, array $value=null)
	Adds a tag which indicates that this page is suitable for translation.
	addReadyTag (int $revision)
	Adds a tag which indicates that this page source is ready for marking for translation.
	getMarkedTag ()
	Returns the latest revision which has marked tag, if any.
	getReadyTag ()
	Returns the latest revision which has ready tag, if any.
	unmarkTranslatablePage ()
	Removes all page translation feature data from the database.
	getTranslationUrl ( $code=false)
	Produces a link to translation view of a translation page.
	getMarkedRevs ()
	getTranslationPages ()
	@inheritDoc
	getTranslationUnitPages (?string $code=null)
	@inheritDoc
	getTranslationPercentages ()
	getTransRev (string $suffix)
	supportsTransclusion ()
	setTransclusion (bool $supportsTransclusion)
	getRevisionRecordWithFallback ()
	isMoveable ()
	@inheritDoc
	isDeletable ()
	@inheritDoc

Static Public Member Functions
static	newFromText (Title $title, string $text)
	Constructs a translatable page from given text.
static	newFromRevision (Title $title, int $revision)
	Constructs a translatable page from given revision.
static	newFromTitle (Title $title)
	Constructs a translatable page from title.
static	getMessageGroupIdFromTitle (Title $title)
	Constructs MessageGroup id for any title.
static	getTranslationPageFromTitle (Title $title)
static	isTranslationPage (Title $title)
static	parseTranslationUnit (LinkTarget $translationUnit)
	Helper to guess translation page from translation unit.
static	isSourcePage (Title $title)
static	clearSourcePageCache ()
	Clears the source page cache.
static	determineStatus (?int $readyRevisionId, ?int $markRevisionId, int $latestRevisionId)

Public Attributes
const	METADATA_KEYS
	List of keys in the metadata table that need to be handled for moves and deletions @phpcs-require-sorted-array.
const	DISPLAY_TITLE_UNIT_ID = 'Page display title'

Protected Member Functions
	__construct (Title $title)
Protected Member Functions inherited from MediaWiki\Extension\Translate\MessageGroupProcessing\TranslatableBundle
	getTranslationUnitPagesByTitle (Title $title, ?string $code=null)

Protected Attributes
	$title
	$revTagStore
	$text
	$revision
	$source
	$pageDisplayTitle

Static Protected Attributes
static	$tagCache = []

Detailed Description

Mixed bag of methods related to translatable pages.

Author

Niklas Laxström @license GPL-2.0-or-later

Definition at line 36 of file TranslatablePage.php.

Constructor & Destructor Documentation

__construct()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::__construct ( Title $title )

protected

Parameters

Title

$title

Title object for the page

Definition at line 68 of file TranslatablePage.php.

Member Function Documentation

addMarkedTag()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::addMarkedTag	(	int	$revision,
		array	$value = null )

Adds a tag which indicates that this page is suitable for translation.

Definition at line 283 of file TranslatablePage.php.

addReadyTag()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::addReadyTag

(

int

$revision

)

Adds a tag which indicates that this page source is ready for marking for translation.

Definition at line 289 of file TranslatablePage.php.

clearSourcePageCache()

static MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::clearSourcePageCache ( )

static

Clears the source page cache.

Definition at line 557 of file TranslatablePage.php.

determineStatus()

static MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::determineStatus ( ?int $readyRevisionId, ?int $markRevisionId, int $latestRevisionId )

static

Definition at line 562 of file TranslatablePage.php.

getMarkedRevs()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getMarkedRevs

(

)

Definition at line 333 of file TranslatablePage.php.

getMarkedTag()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getMarkedTag

(

)

Returns the latest revision which has marked tag, if any.

Definition at line 297 of file TranslatablePage.php.

getMessageGroup()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getMessageGroup

(

)

Returns MessageGroup used for translating this page.

It may still be empty if the page has not been ever marked.

Definition at line 190 of file TranslatablePage.php.

getMessageGroupId()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getMessageGroupId

(

)

@inheritDoc

Reimplemented from MediaWiki\Extension\Translate\MessageGroupProcessing\TranslatableBundle.

Definition at line 177 of file TranslatablePage.php.

getMessageGroupIdFromTitle()

static MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getMessageGroupIdFromTitle ( Title $title )

static

Constructs MessageGroup id for any title.

Definition at line 182 of file TranslatablePage.php.

getPageDisplayTitle()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getPageDisplayTitle

(

string

$languageCode

)

Get translated page title.

Definition at line 219 of file TranslatablePage.php.

getReadyTag()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getReadyTag

(

)

Returns the latest revision which has ready tag, if any.

Definition at line 302 of file TranslatablePage.php.

getRevision()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getRevision

(

)

Revision is null if object was constructed using newFromText.

Returns

null|int

Definition at line 163 of file TranslatablePage.php.

getRevisionRecordWithFallback()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getRevisionRecordWithFallback

(

)

Definition at line 446 of file TranslatablePage.php.

getSourceLanguageCode()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getSourceLanguageCode

(

)

Returns the source language of this translatable page.

In other words the language in which the page without language code is written.

Since

2013-01-28

Definition at line 172 of file TranslatablePage.php.

getStrippedSourcePageText()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getStrippedSourcePageText

(

)

Definition at line 243 of file TranslatablePage.php.

getText()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getText

(

)

Returns the text for this translatable page.

Definition at line 124 of file TranslatablePage.php.

getTitle()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getTitle

(

)

@inheritDoc

Reimplemented from MediaWiki\Extension\Translate\MessageGroupProcessing\TranslatableBundle.

Definition at line 119 of file TranslatablePage.php.

getTranslationPage()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getTranslationPage

(

string

$targetLanguage

)

Definition at line 260 of file TranslatablePage.php.

getTranslationPageFromTitle()

static MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getTranslationPageFromTitle ( Title $title )

static

Definition at line 251 of file TranslatablePage.php.

getTranslationPages()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getTranslationPages

(

)

@inheritDoc

Reimplemented from MediaWiki\Extension\Translate\MessageGroupProcessing\TranslatableBundle.

Definition at line 347 of file TranslatablePage.php.

getTranslationPercentages()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getTranslationPercentages

(

)

Definition at line 378 of file TranslatablePage.php.

getTranslationUnitPages()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getTranslationUnitPages

(

?string

$code = null

)

@inheritDoc

Reimplemented from MediaWiki\Extension\Translate\MessageGroupProcessing\TranslatableBundle.

Definition at line 374 of file TranslatablePage.php.

getTranslationUrl()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getTranslationUrl

(

$code = false

)

Produces a link to translation view of a translation page.

Parameters

string | bool

$code

MediaWiki language code. Default: false.

Returns

string Relative url

Definition at line 320 of file TranslatablePage.php.

getTransRev()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::getTransRev

(

string

$suffix

)

Definition at line 415 of file TranslatablePage.php.

hasPageDisplayTitle()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::hasPageDisplayTitle

(

)

Check whether title is marked for translation.

Definition at line 204 of file TranslatablePage.php.

isDeletable()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::isDeletable

(

)

@inheritDoc

Reimplemented from MediaWiki\Extension\Translate\MessageGroupProcessing\TranslatableBundle.

Definition at line 470 of file TranslatablePage.php.

isMoveable()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::isMoveable

(

)

@inheritDoc

Reimplemented from MediaWiki\Extension\Translate\MessageGroupProcessing\TranslatableBundle.

Definition at line 465 of file TranslatablePage.php.

isSourcePage()

static MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::isSourcePage ( Title $title )

static

Definition at line 531 of file TranslatablePage.php.

isTranslationPage()

static MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::isTranslationPage ( Title $title )

static

Returns

bool|self

Definition at line 475 of file TranslatablePage.php.

newFromRevision()

static MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::newFromRevision ( Title $title, int $revision )

static

Constructs a translatable page from given revision.

The revision must belong to the title given or unspecified behavior will happen.

Exceptions

MWException

Definition at line 92 of file TranslatablePage.php.

newFromText()

static MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::newFromText ( Title $title, string $text )

static

Constructs a translatable page from given text.

Some functions will fail unless you set revision parameter manually.

Definition at line 78 of file TranslatablePage.php.

newFromTitle()

static MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::newFromTitle ( Title $title )

static

Constructs a translatable page from title.

The text of last marked revision is loaded when needed.

Definition at line 111 of file TranslatablePage.php.

parseTranslationUnit()

static MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::parseTranslationUnit ( LinkTarget $translationUnit )

static

Helper to guess translation page from translation unit.

Definition at line 514 of file TranslatablePage.php.

setTransclusion()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::setTransclusion

(

bool

$supportsTransclusion

)

Definition at line 438 of file TranslatablePage.php.

supportsTransclusion()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::supportsTransclusion

(

)

Definition at line 429 of file TranslatablePage.php.

unmarkTranslatablePage()

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::unmarkTranslatablePage

(

)

Removes all page translation feature data from the database.

Does not remove translated sections or translation pages.

Definition at line 310 of file TranslatablePage.php.

Member Data Documentation

$pageDisplayTitle

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::$pageDisplayTitle

protected

Definition at line 63 of file TranslatablePage.php.

$revision

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::$revision

protected

Definition at line 59 of file TranslatablePage.php.

$revTagStore

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::$revTagStore

protected

Definition at line 55 of file TranslatablePage.php.

$source

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::$source

protected

Definition at line 61 of file TranslatablePage.php.

$tagCache

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::$tagCache = []

staticprotected

Definition at line 280 of file TranslatablePage.php.

$text

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::$text

protected

Definition at line 57 of file TranslatablePage.php.

$title

MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::$title

protected

Definition at line 53 of file TranslatablePage.php.

DISPLAY_TITLE_UNIT_ID

const MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::DISPLAY_TITLE_UNIT_ID = 'Page display title'

Definition at line 50 of file TranslatablePage.php.

METADATA_KEYS

const MediaWiki\Extension\Translate\PageTranslation\TranslatablePage::METADATA_KEYS

Initial value:

= [
        'maxid',
        'priorityforce',
        'prioritylangs',
        'priorityreason',
        'transclusion',
        'version'
    ]

List of keys in the metadata table that need to be handled for moves and deletions @phpcs-require-sorted-array.

Definition at line 41 of file TranslatablePage.php.

---

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

• src/PageTranslation/TranslatablePage.php