MediaWiki  1.30.1
Article Class Reference

Class for viewing MediaWiki article and history. More...

Inheritance diagram for Article:
Collaboration diagram for Article:

Public Member Functions

 __construct (Title $title, $oldId=null)
 Constructor and clear the article. More...
 
 __get ( $fname)
 Use PHP's magic __get handler to handle accessing of raw WikiPage fields for backwards compatibility. More...
 
 __set ( $fname, $fvalue)
 Use PHP's magic __set handler to handle setting of raw WikiPage fields for backwards compatibility. More...
 
 addHelpLink ( $to, $overrideBaseUrl=false)
 Adds help link with an icon via page indicators. More...
 
 adjustDisplayTitle (ParserOutput $pOutput)
 Adjust title for pages with displaytitle, -{T|}- or language conversion. More...
 
 checkFlags ( $flags)
 Call to WikiPage function for backwards compatibility. More...
 
 checkTouched ()
 Call to WikiPage function for backwards compatibility. More...
 
 clear ()
 Clear the object. More...
 
 clearPreparedEdit ()
 Call to WikiPage function for backwards compatibility. More...
 
 commitRollback ( $fromP, $summary, $bot, &$resultDetails, User $guser=null)
 
 confirmDelete ( $reason)
 Output deletion confirmation dialog. More...
 
 delete ()
 UI entry point for page deletion. More...
 
 doDelete ( $reason, $suppress=false)
 Perform a deletion and output success or failure messages. More...
 
 doDeleteArticle ( $reason, $suppress=false, $u1=null, $u2=null, &$error='')
 
 doDeleteArticleReal ( $reason, $suppress=false, $u1=null, $u2=null, &$error='', User $user=null, $tags=[])
 Call to WikiPage function for backwards compatibility. More...
 
 doDeleteUpdates ( $id, Content $content=null)
 Call to WikiPage function for backwards compatibility. More...
 
 doEditContent (Content $content, $summary, $flags=0, $baseRevId=false, User $user=null, $serialFormat=null)
 Call to WikiPage function for backwards compatibility. More...
 
 doEditUpdates (Revision $revision, User $user, array $options=[])
 Call to WikiPage function for backwards compatibility. More...
 
 doPurge ()
 Call to WikiPage function for backwards compatibility. More...
 
 doRollback ( $fromP, $summary, $token, $bot, &$resultDetails, User $user=null)
 
 doUpdateRestrictions (array $limit, array $expiry, &$cascade, $reason, User $user)
 
 doViewUpdates (User $user, $oldid=0)
 Call to WikiPage function for backwards compatibility. More...
 
 exists ()
 Call to WikiPage function for backwards compatibility. More...
 
 followRedirect ()
 Call to WikiPage function for backwards compatibility. More...
 
 generateReason (&$hasHistory)
 
 getActionOverrides ()
 Call to WikiPage function for backwards compatibility. More...
 
 getAutoDeleteReason (&$hasHistory)
 Call to WikiPage function for backwards compatibility. More...
 
 getCategories ()
 Call to WikiPage function for backwards compatibility. More...
 
 getComment ( $audience=Revision::FOR_PUBLIC, User $user=null)
 Call to WikiPage function for backwards compatibility. More...
 
 getContentHandler ()
 Call to WikiPage function for backwards compatibility. More...
 
 getContentModel ()
 Call to WikiPage function for backwards compatibility. More...
 
 getContext ()
 Gets the context this Article is executed in. More...
 
 getContributors ()
 Call to WikiPage function for backwards compatibility. More...
 
 getCreator ( $audience=Revision::FOR_PUBLIC, User $user=null)
 Call to WikiPage function for backwards compatibility. More...
 
 getDeletionUpdates (Content $content=null)
 Call to WikiPage function for backwards compatibility. More...
 
 getHiddenCategories ()
 Call to WikiPage function for backwards compatibility. More...
 
 getId ()
 Call to WikiPage function for backwards compatibility. More...
 
 getLastPurgeTimestamp ()
 Call to WikiPage function for backwards compatibility. More...
 
 getLatest ()
 Call to WikiPage function for backwards compatibility. More...
 
 getLinksTimestamp ()
 Call to WikiPage function for backwards compatibility. More...
 
 getMinorEdit ()
 Call to WikiPage function for backwards compatibility. More...
 
 getOldestRevision ()
 Call to WikiPage function for backwards compatibility. More...
 
 getOldID ()
 
 getOldIDFromRequest ()
 Sets $this->mRedirectUrl to a correct URL if the query parameters are incorrect. More...
 
 getPage ()
 Get the WikiPage object of this instance. More...
 
 getParserOptions ()
 Get parser options suitable for rendering the primary article wikitext. More...
 
 getParserOutput ( $oldid=null, User $user=null)
 #- More...
 
 getRedirectedFrom ()
 Get the page this view was redirected from. More...
 
 getRedirectTarget ()
 Call to WikiPage function for backwards compatibility. More...
 
 getRedirectURL ( $rt)
 Call to WikiPage function for backwards compatibility. More...
 
 getRevIdFetched ()
 Use this to fetch the rev ID used on page views. More...
 
 getRevision ()
 Call to WikiPage function for backwards compatibility. More...
 
 getRevisionFetched ()
 Get the fetched Revision object depending on request parameters or null on failure. More...
 
 getRobotPolicy ( $action, $pOutput=null)
 Get the robot policy to be used for the current view. More...
 
 getTimestamp ()
 Call to WikiPage function for backwards compatibility. More...
 
 getTitle ()
 Get the title object of the article. More...
 
 getTouched ()
 Call to WikiPage function for backwards compatibility. More...
 
 getUndoContent (Revision $undo, Revision $undoafter=null)
 Call to WikiPage function for backwards compatibility. More...
 
 getUser ( $audience=Revision::FOR_PUBLIC, User $user=null)
 Call to WikiPage function for backwards compatibility. More...
 
 getUserText ( $audience=Revision::FOR_PUBLIC, User $user=null)
 Call to WikiPage function for backwards compatibility. More...
 
 hasViewableContent ()
 Call to WikiPage function for backwards compatibility. More...
 
 insertOn ( $dbw, $pageId=null)
 Call to WikiPage function for backwards compatibility. More...
 
 insertProtectNullRevision ( $revCommentMsg, array $limit, array $expiry, $cascade, $reason, $user=null)
 Call to WikiPage function for backwards compatibility. More...
 
 insertRedirect ()
 Call to WikiPage function for backwards compatibility. More...
 
 insertRedirectEntry (Title $rt, $oldLatest=null)
 Call to WikiPage function for backwards compatibility. More...
 
 isCountable ( $editInfo=false)
 Call to WikiPage function for backwards compatibility. More...
 
 isCurrent ()
 Returns true if the currently-referenced revision is the current edit to this page (and it exists). More...
 
 isFileCacheable ( $mode=HTMLFileCache::MODE_NORMAL)
 Check if the page can be cached. More...
 
 isRedirect ()
 Call to WikiPage function for backwards compatibility. More...
 
 loadFromRow ( $data, $from)
 Call to WikiPage function for backwards compatibility. More...
 
 loadPageData ( $from='fromdb')
 Call to WikiPage function for backwards compatibility. More...
 
 lockAndGetLatest ()
 Call to WikiPage function for backwards compatibility. More...
 
 makeParserOptions ( $context)
 Call to WikiPage function for backwards compatibility. More...
 
 pageDataFromId ( $dbr, $id, $options=[])
 Call to WikiPage function for backwards compatibility. More...
 
 pageDataFromTitle ( $dbr, $title, $options=[])
 Call to WikiPage function for backwards compatibility. More...
 
 prepareContentForEdit (Content $content, $revision=null, User $user=null, $serialFormat=null, $useCache=true)
 Call to WikiPage function for backwards compatibility. More...
 
 protect ()
 action=protect handler More...
 
 protectDescription (array $limit, array $expiry)
 Call to WikiPage function for backwards compatibility. More...
 
 protectDescriptionLog (array $limit, array $expiry)
 Call to WikiPage function for backwards compatibility. More...
 
 render ()
 Handle action=render. More...
 
 replaceSectionAtRev ( $sectionId, Content $sectionContent, $sectionTitle='', $baseRevId=null)
 Call to WikiPage function for backwards compatibility. More...
 
 replaceSectionContent ( $sectionId, Content $sectionContent, $sectionTitle='', $edittime=null)
 Call to WikiPage function for backwards compatibility. More...
 
 setContext ( $context)
 Sets the context this Article is executed in. More...
 
 setOldSubtitle ( $oldid=0)
 Generate the navigation links when browsing through an article revisions It shows the information as: Revision as of \<date\>; view current revision \<- Previous version | Next Version -\> More...
 
 setParserOptions (ParserOptions $options)
 Override the ParserOptions used to render the primary article wikitext. More...
 
 setRedirectedFrom (Title $from)
 Tell the page view functions that this view was redirected from another page on the wiki. More...
 
 setTimestamp ( $ts)
 Call to WikiPage function for backwards compatibility. More...
 
 shouldCheckParserCache (ParserOptions $parserOptions, $oldId)
 Call to WikiPage function for backwards compatibility. More...
 
 showDeletedRevisionHeader ()
 If the revision requested for view is deleted, check permissions. More...
 
 showMissingArticle ()
 Show the error text for a missing article. More...
 
 showNamespaceHeader ()
 Show a header specific to the namespace currently being viewed, like [[MediaWiki:Talkpagetext]]. More...
 
 showPatrolFooter ()
 If patrol is possible, output a patrol UI box. More...
 
 showRedirectedFromHeader ()
 If this request is a redirect view, send "redirected from" subtitle to the output. More...
 
 showViewFooter ()
 Show the footer section of an ordinary page view. More...
 
 supportsSections ()
 Call to WikiPage function for backwards compatibility. More...
 
 triggerOpportunisticLinksUpdate (ParserOutput $parserOutput)
 Call to WikiPage function for backwards compatibility. More...
 
 unprotect ()
 action=unprotect handler (alias) More...
 
 updateCategoryCounts (array $added, array $deleted, $id=0)
 Call to WikiPage function for backwards compatibility. More...
 
 updateIfNewerOn ( $dbw, $revision)
 Call to WikiPage function for backwards compatibility. More...
 
 updateRedirectOn ( $dbw, $redirectTitle, $lastRevIsRedirect=null)
 Call to WikiPage function for backwards compatibility. More...
 
 updateRestrictions ( $limit=[], $reason='', &$cascade=0, $expiry=[])
 
 updateRevisionOn ( $dbw, $revision, $lastRevision=null, $lastRevIsRedirect=null)
 Call to WikiPage function for backwards compatibility. More...
 
 view ()
 This is the default action of the index.php entry point: just view the page of the given title. More...
 
 viewRedirect ( $target, $appendSubtitle=true, $forceKnown=false)
 Return the HTML for the top of a redirect page. More...
 

Static Public Member Functions

static formatRobotPolicy ( $policy)
 Converts a String robot policy into an associative array, to allow merging of several policies using array_merge(). More...
 
static getRedirectHeaderHtml (Language $lang, $target, $forceKnown=false)
 Return the HTML for the top of a redirect page. More...
 
static newFromID ( $id)
 Constructor from a page id. More...
 
static newFromTitle ( $title, IContextSource $context)
 Create an Article object of the appropriate class for the given page. More...
 
static newFromWikiPage (WikiPage $page, IContextSource $context)
 Create an Article object of the appropriate class for the given page. More...
 
static onArticleCreate ( $title)
 
static onArticleDelete ( $title)
 
static onArticleEdit ( $title)
 
static purgePatrolFooterCache ( $articleID)
 Purge the cache used to check if it is worth showing the patrol footer For example, it is done during re-uploads when file patrol is used. More...
 
static selectFields ()
 

Public Attributes

string $mContent
 Text of the revision we are working on. More...
 
bool $mContentLoaded = false
 Is the content ($mContent) already loaded? More...
 
Content $mContentObject
 Content of the revision we are working on. More...
 
int null $mOldId
 The oldid of the article that is to be shown, 0 for the current revision. More...
 
ParserOptions $mParserOptions
 ParserOptions object for $wgUser articles. More...
 
ParserOutput $mParserOutput
 
Title $mRedirectedFrom = null
 Title from which we were redirected here. More...
 
string bool $mRedirectUrl = false
 URL to redirect to or false if none. More...
 
int $mRevIdFetched = 0
 Revision ID of revision we are working on. More...
 
Revision $mRevision = null
 Revision we are working on. More...
 

Protected Member Functions

 fetchContentObject ()
 Get text content object Does NOT follow redirects. More...
 
 getContentObject ()
 Returns a Content object representing the pages effective display content, not necessarily the revision's content! More...
 
 newPage (Title $title)
 
 showDiffPage ()
 Show a diff page according to current request variables. More...
 
 tryFileCache ()
 checkLastModified returns true if it has taken care of all output to the client that is necessary for this request. More...
 

Protected Attributes

IContextSource $mContext
 The context this Article is executed in. More...
 
WikiPage $mPage
 The WikiPage object of this instance. More...
 

Detailed Description

Class for viewing MediaWiki article and history.

This maintains WikiPage functions for backwards compatibility.

Todo:
Move and rewrite code to an Action class

See design.txt for an overview. Note: edit user interface and cache support functions have been moved to separate EditPage and HTMLFileCache classes.

Definition at line 35 of file Article.php.

Constructor & Destructor Documentation

◆ __construct()

Article::__construct ( Title  $title,
  $oldId = null 
)

Constructor and clear the article.

Parameters
Title$titleReference to a Title object.
int$oldIdRevision ID, null to fetch from request, zero for current

Definition at line 83 of file Article.php.

References newPage().

Member Function Documentation

◆ __get()

Article::__get (   $fname)

Use PHP's magic __get handler to handle accessing of raw WikiPage fields for backwards compatibility.

Parameters
string$fnameField name
Returns
mixed

Definition at line 2023 of file Article.php.

References $fname.

◆ __set()

Article::__set (   $fname,
  $fvalue 
)

Use PHP's magic __set handler to handle setting of raw WikiPage fields for backwards compatibility.

Parameters
string$fnameField name
mixed$fvalueNew value

Definition at line 2038 of file Article.php.

References $fname.

◆ addHelpLink()

Article::addHelpLink (   $to,
  $overrideBaseUrl = false 
)

Adds help link with an icon via page indicators.

Link target can be overridden by a local message containing a wikilink: the message key is: 'namespace-' + namespace number + '-helppage'.

Parameters
string$toTarget MediaWiki.org page title or encoded URL.
bool$overrideBaseUrlWhether $url is a full URL, to avoid MW.o.
Since
1.25

Definition at line 1504 of file Article.php.

References $out, getContext(), getTitle(), Skin\makeUrl(), and wfMessage().

Referenced by CategoryPage\closeShowCategory().

◆ adjustDisplayTitle()

Article::adjustDisplayTitle ( ParserOutput  $pOutput)

Adjust title for pages with displaytitle, -{T|}- or language conversion.

Parameters
ParserOutput$pOutput

Definition at line 681 of file Article.php.

References getContext(), and ParserOutput\getTitleText().

Referenced by view().

◆ checkFlags()

Article::checkFlags (   $flags)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::checkFlags

Definition at line 2054 of file Article.php.

References $flags.

◆ checkTouched()

Article::checkTouched ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::checkTouched

Definition at line 2062 of file Article.php.

◆ clear()

Article::clear ( )

Clear the object.

Definition at line 191 of file Article.php.

◆ clearPreparedEdit()

Article::clearPreparedEdit ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::clearPreparedEdit

Definition at line 2070 of file Article.php.

◆ commitRollback()

Article::commitRollback (   $fromP,
  $summary,
  $bot,
$resultDetails,
User  $guser = null 
)
Parameters
string$fromP
string$summary
bool$bot
array&$resultDetails
User | null$guser
Returns
array

Definition at line 2644 of file Article.php.

References getContext().

◆ confirmDelete()

Article::confirmDelete (   $reason)

Output deletion confirmation dialog.

Todo:
FIXME: Move to another file?
Parameters
string$reasonPrefilled reason

Definition at line 1674 of file Article.php.

References $link, $options, $title, $user, captcha-old\count, Xml\element(), getContext(), getTitle(), Html\hidden(), Linker\linkKnown(), Xml\listDropDownOptions(), Xml\listDropDownOptionsOoui(), Hooks\run(), LogEventsList\showLogExtract(), wfDebug(), and wfMessage().

Referenced by delete().

◆ delete()

◆ doDelete()

Article::doDelete (   $reason,
  $suppress = false 
)

Perform a deletion and output success or failure messages.

Parameters
string$reason
bool$suppress

Definition at line 1837 of file Article.php.

References $context, $user, Xml\element(), getContext(), getTitle(), Hooks\run(), LogEventsList\showLogExtract(), wfEscapeWikiText(), and wfMessage().

Referenced by delete().

◆ doDeleteArticle()

Article::doDeleteArticle (   $reason,
  $suppress = false,
  $u1 = null,
  $u2 = null,
$error = '' 
)
Parameters
string$reason
bool$suppress
int$u1Unused
bool$u2Unused
string&$error
Returns
bool

Definition at line 2616 of file Article.php.

◆ doDeleteArticleReal()

Article::doDeleteArticleReal (   $reason,
  $suppress = false,
  $u1 = null,
  $u2 = null,
$error = '',
User  $user = null,
  $tags = [] 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::doDeleteArticleReal

Definition at line 2078 of file Article.php.

References $user.

◆ doDeleteUpdates()

Article::doDeleteUpdates (   $id,
Content  $content = null 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::doDeleteUpdates

Definition at line 2091 of file Article.php.

◆ doEditContent()

Article::doEditContent ( Content  $content,
  $summary,
  $flags = 0,
  $baseRevId = false,
User  $user = null,
  $serialFormat = null 
)

Call to WikiPage function for backwards compatibility.

Deprecated:
since 1.29. Use WikiPage::doEditContent() directly instead
See also
WikiPage::doEditContent

Definition at line 2100 of file Article.php.

References $flags, $user, and wfDeprecated().

◆ doEditUpdates()

Article::doEditUpdates ( Revision  $revision,
User  $user,
array  $options = [] 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::doEditUpdates

Definition at line 2113 of file Article.php.

References $options, and $user.

◆ doPurge()

Article::doPurge ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::doPurge
Note
In 1.28 (and only 1.28), this took a $flags parameter that controlled how much purging was done.

Definition at line 2123 of file Article.php.

◆ doRollback()

Article::doRollback (   $fromP,
  $summary,
  $token,
  $bot,
$resultDetails,
User  $user = null 
)
Parameters
string$fromP
string$summary
string$token
bool$bot
array&$resultDetails
User | null$user
Returns
array

Definition at line 2631 of file Article.php.

References $user, and getContext().

◆ doUpdateRestrictions()

Article::doUpdateRestrictions ( array  $limit,
array  $expiry,
$cascade,
  $reason,
User  $user 
)
Parameters
array$limit
array$expiry
bool&$cascade
string$reason
User$user
Returns
Status

Definition at line 2583 of file Article.php.

References $user.

◆ doViewUpdates()

Article::doViewUpdates ( User  $user,
  $oldid = 0 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::doViewUpdates

Definition at line 2141 of file Article.php.

References $user.

◆ exists()

Article::exists ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::exists

Definition at line 2149 of file Article.php.

◆ fetchContentObject()

Article::fetchContentObject ( )
protected

Get text content object Does NOT follow redirects.

Todo:
When is this null?
Note
Code that wants to retrieve page content from the database should use WikiPage::getContent().
Returns
Content|null|bool
Since
1.21

Definition at line 313 of file Article.php.

References $mContentObject, Revision\FOR_THIS_USER, getContext(), getOldID(), getTitle(), getUser(), Revision\newFromId(), Hooks\run(), and wfDebug().

Referenced by getContentObject(), getRevisionFetched(), and view().

◆ followRedirect()

Article::followRedirect ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::followRedirect

Definition at line 2157 of file Article.php.

◆ formatRobotPolicy()

static Article::formatRobotPolicy (   $policy)
static

Converts a String robot policy into an associative array, to allow merging of several policies using array_merge().

Parameters
array | string$policyReturns empty array on null/false/'', transparent to already-converted arrays, converts string.
Returns
array 'index' => \<indexpolicy\>, 'follow' => \<followpolicy\>

Definition at line 823 of file Article.php.

References as.

Referenced by getRobotPolicy(), and OutputPage\setRobotPolicy().

◆ generateReason()

Article::generateReason ( $hasHistory)
Parameters
bool&$hasHistory
Returns
mixed

Definition at line 2653 of file Article.php.

References $handler, $title, and ContentHandler\getForTitle().

Referenced by delete().

◆ getActionOverrides()

Article::getActionOverrides ( )

Call to WikiPage function for backwards compatibility.

See also
ContentHandler::getActionOverrides

Definition at line 2165 of file Article.php.

◆ getAutoDeleteReason()

Article::getAutoDeleteReason ( $hasHistory)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getAutoDeleteReason

Definition at line 2173 of file Article.php.

◆ getCategories()

Article::getCategories ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getCategories

Definition at line 2181 of file Article.php.

◆ getComment()

Article::getComment (   $audience = Revision::FOR_PUBLIC,
User  $user = null 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getComment

Definition at line 2189 of file Article.php.

References $user.

◆ getContentHandler()

Article::getContentHandler ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getContentHandler

Definition at line 2197 of file Article.php.

◆ getContentModel()

Article::getContentModel ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getContentModel

Definition at line 2205 of file Article.php.

◆ getContentObject()

Article::getContentObject ( )
protected

Returns a Content object representing the pages effective display content, not necessarily the revision's content!

Note that getContent does not follow redirects anymore. If you need to fetch redirectable content easily, try the shortcut in WikiPage::getRedirectTarget()

This function has side effects! Do not use this function if you only want the real revision text if any.

Returns
Content Return the content of this revision
Since
1.21

Reimplemented in ImagePage.

Definition at line 216 of file Article.php.

References $mContentObject, fetchContentObject(), getContext(), getTitle(), ContentHandler\makeContent(), and NS_MEDIAWIKI.

Referenced by showMissingArticle(), and view().

◆ getContext()

◆ getContributors()

Article::getContributors ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getContributors

Definition at line 2213 of file Article.php.

◆ getCreator()

Article::getCreator (   $audience = Revision::FOR_PUBLIC,
User  $user = null 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getCreator

Definition at line 2221 of file Article.php.

References $user.

◆ getDeletionUpdates()

Article::getDeletionUpdates ( Content  $content = null)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getDeletionUpdates

Definition at line 2229 of file Article.php.

◆ getHiddenCategories()

Article::getHiddenCategories ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getHiddenCategories

Definition at line 2237 of file Article.php.

◆ getId()

Article::getId ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getId

Definition at line 2245 of file Article.php.

Referenced by ImagePage\getContentObject(), and ImagePage\openShowImage().

◆ getLastPurgeTimestamp()

Article::getLastPurgeTimestamp ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getLastPurgeTimestamp
Deprecated:
since 1.29

Definition at line 2132 of file Article.php.

References wfDeprecated().

◆ getLatest()

Article::getLatest ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getLatest

Definition at line 2253 of file Article.php.

◆ getLinksTimestamp()

Article::getLinksTimestamp ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getLinksTimestamp

Definition at line 2261 of file Article.php.

◆ getMinorEdit()

Article::getMinorEdit ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getMinorEdit

Definition at line 2269 of file Article.php.

◆ getOldestRevision()

Article::getOldestRevision ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getOldestRevision

Definition at line 2277 of file Article.php.

◆ getOldID()

Article::getOldID ( )
Returns
int The oldid of the article that is to be shown, 0 for the current revision

Definition at line 242 of file Article.php.

References $mOldId, and getOldIDFromRequest().

Referenced by fetchContentObject(), getRobotPolicy(), isCurrent(), showDeletedRevisionHeader(), showDiffPage(), showMissingArticle(), ImagePage\view(), and view().

◆ getOldIDFromRequest()

Article::getOldIDFromRequest ( )

Sets $this->mRedirectUrl to a correct URL if the query parameters are incorrect.

Returns
int The old id for the request

Definition at line 255 of file Article.php.

References $request, getContext(), getTitle(), and Revision\newFromId().

Referenced by getOldID().

◆ getPage()

Article::getPage ( )

Get the WikiPage object of this instance.

Since
1.19
Returns
WikiPage

Definition at line 184 of file Article.php.

References $mPage.

Referenced by ImageHistoryList\__construct(), EditPage\__construct(), and view().

◆ getParserOptions()

Article::getParserOptions ( )

Get parser options suitable for rendering the primary article wikitext.

Returns
ParserOptions

Definition at line 1982 of file Article.php.

References $mParserOptions, and getContext().

Referenced by getParserOutput(), and view().

◆ getParserOutput()

Article::getParserOutput (   $oldid = null,
User  $user = null 
)

#-

Lightweight method to get the parser output for a page, checking the parser cache and so on. Doesn't consider most of the stuff that WikiPage::view is forced to consider, so it's not appropriate to use there.

Since
1.16 (r52326) for LiquidThreads
Parameters
int | null$oldidRevision ID or null
User$userThe relevant user
Returns
ParserOutput|bool ParserOutput or false if the given revision ID is not found

Definition at line 1951 of file Article.php.

References $user, and getParserOptions().

Referenced by showMissingArticle().

◆ getRedirectedFrom()

Article::getRedirectedFrom ( )

Get the page this view was redirected from.

Returns
Title|null
Since
1.28

Definition at line 156 of file Article.php.

References $mRedirectedFrom.

◆ getRedirectHeaderHtml()

static Article::getRedirectHeaderHtml ( Language  $lang,
  $target,
  $forceKnown = false 
)
static

Return the HTML for the top of a redirect page.

Chances are you should just be using the ParserOutput from WikitextContent::getParserOutput instead of calling this for redirects.

Since
1.23
Parameters
Language$lang
Title | array$targetDestination(s) to redirect
bool$forceKnownShould the image be shown as a bluelink regardless of existence?
Returns
string Containing HTML with redirect link

Definition at line 1469 of file Article.php.

References $html, $lang, $title, as, Linker\link(), and wfMessage().

Referenced by WikitextContent\fillParserOutput().

◆ getRedirectTarget()

Article::getRedirectTarget ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getRedirectTarget

Definition at line 2285 of file Article.php.

◆ getRedirectURL()

Article::getRedirectURL (   $rt)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getRedirectURL

Definition at line 2293 of file Article.php.

◆ getRevIdFetched()

Article::getRevIdFetched ( )

Use this to fetch the rev ID used on page views.

Returns
int Revision ID of last article revision

Definition at line 416 of file Article.php.

References $mRevIdFetched.

Referenced by view().

◆ getRevision()

Article::getRevision ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getRevision

Definition at line 2301 of file Article.php.

◆ getRevisionFetched()

Article::getRevisionFetched ( )

Get the fetched Revision object depending on request parameters or null on failure.

Since
1.19
Returns
Revision|null

Definition at line 405 of file Article.php.

References $mRevision, and fetchContentObject().

Referenced by showDiffPage().

◆ getRobotPolicy()

Article::getRobotPolicy (   $action,
  $pOutput = null 
)

Get the robot policy to be used for the current view.

Parameters
string$actionThe action= GET parameter
ParserOutput | null$pOutput
Returns
array The policy that should be set
Todo:
actions other than 'view'

Definition at line 743 of file Article.php.

References $wgArticleRobotPolicies, $wgDefaultRobotPolicy, $wgNamespaceRobotPolicies, formatRobotPolicy(), getContext(), getOldID(), getTitle(), global, IP\isValid(), Block\newFromTarget(), NS_USER, and NS_USER_TALK.

Referenced by showMissingArticle(), and view().

◆ getTimestamp()

Article::getTimestamp ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getTimestamp

Definition at line 2309 of file Article.php.

◆ getTitle()

◆ getTouched()

Article::getTouched ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getTouched

Definition at line 2317 of file Article.php.

◆ getUndoContent()

Article::getUndoContent ( Revision  $undo,
Revision  $undoafter = null 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getUndoContent

Definition at line 2325 of file Article.php.

◆ getUser()

Article::getUser (   $audience = Revision::FOR_PUBLIC,
User  $user = null 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getUser

Definition at line 2333 of file Article.php.

References $user.

Referenced by fetchContentObject(), ImagePage\getThumbSizes(), updateRestrictions(), ImagePage\uploadLinksBox(), CategoryPage\view(), and ImagePage\view().

◆ getUserText()

Article::getUserText (   $audience = Revision::FOR_PUBLIC,
User  $user = null 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::getUserText

Definition at line 2341 of file Article.php.

References $user.

◆ hasViewableContent()

Article::hasViewableContent ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::hasViewableContent

Definition at line 2349 of file Article.php.

◆ insertOn()

Article::insertOn (   $dbw,
  $pageId = null 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::insertOn

Definition at line 2357 of file Article.php.

◆ insertProtectNullRevision()

Article::insertProtectNullRevision (   $revCommentMsg,
array  $limit,
array  $expiry,
  $cascade,
  $reason,
  $user = null 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::insertProtectNullRevision

Definition at line 2365 of file Article.php.

References $user.

◆ insertRedirect()

Article::insertRedirect ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::insertRedirect

Definition at line 2377 of file Article.php.

◆ insertRedirectEntry()

Article::insertRedirectEntry ( Title  $rt,
  $oldLatest = null 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::insertRedirectEntry

Definition at line 2385 of file Article.php.

◆ isCountable()

Article::isCountable (   $editInfo = false)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::isCountable

Definition at line 2393 of file Article.php.

◆ isCurrent()

Article::isCurrent ( )

Returns true if the currently-referenced revision is the current edit to this page (and it exists).

Returns
bool

Definition at line 389 of file Article.php.

References getOldID().

Referenced by view().

◆ isFileCacheable()

Article::isFileCacheable (   $mode = HTMLFileCache::MODE_NORMAL)

Check if the page can be cached.

Parameters
int$modeOne of the HTMLFileCache::MODE_* constants (since 1.28)
Returns
bool

Definition at line 1921 of file Article.php.

References getContext(), getTitle(), Hooks\run(), and HTMLFileCache\useFileCache().

Referenced by tryFileCache().

◆ isRedirect()

Article::isRedirect ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::isRedirect

Definition at line 2401 of file Article.php.

Referenced by showRedirectedFromHeader().

◆ loadFromRow()

Article::loadFromRow (   $data,
  $from 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::loadFromRow

Definition at line 2409 of file Article.php.

◆ loadPageData()

Article::loadPageData (   $from = 'fromdb')

Call to WikiPage function for backwards compatibility.

See also
WikiPage::loadPageData

Definition at line 2417 of file Article.php.

◆ lockAndGetLatest()

Article::lockAndGetLatest ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::lockAndGetLatest

Definition at line 2425 of file Article.php.

◆ makeParserOptions()

Article::makeParserOptions (   $context)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::makeParserOptions

Definition at line 2433 of file Article.php.

References $context.

◆ newFromID()

static Article::newFromID (   $id)
static

Constructor from a page id.

Parameters
int$idArticle ID to load
Returns
Article|null

Definition at line 101 of file Article.php.

References $t, and Title\newFromID().

◆ newFromTitle()

static Article::newFromTitle (   $title,
IContextSource  $context 
)
static

Create an Article object of the appropriate class for the given page.

Parameters
Title$title
IContextSource$context
Returns
Article

Definition at line 113 of file Article.php.

References $context, $title, Title\makeTitle(), NS_CATEGORY, NS_FILE, NS_MEDIA, and Hooks\run().

Referenced by ApiParse\execute(), RebuildFileCache\execute(), and newFromWikiPage().

◆ newFromWikiPage()

static Article::newFromWikiPage ( WikiPage  $page,
IContextSource  $context 
)
static

Create an Article object of the appropriate class for the given page.

Parameters
WikiPage$page
IContextSource$context
Returns
Article

Definition at line 145 of file Article.php.

References $article, $context, WikiPage\getTitle(), and newFromTitle().

Referenced by ApiEditPage\execute(), and MediaWiki\initializeArticle().

◆ newPage()

Article::newPage ( Title  $title)
protected
Parameters
Title$title
Returns
WikiPage

Reimplemented in ImagePage, and CategoryPage.

Definition at line 92 of file Article.php.

References $title.

Referenced by __construct().

◆ onArticleCreate()

static Article::onArticleCreate (   $title)
static
Parameters
Title$title
Deprecated:
since 1.24, use WikiPage::onArticleCreate() instead

Definition at line 2674 of file Article.php.

References $title, WikiPage\onArticleCreate(), and wfDeprecated().

◆ onArticleDelete()

static Article::onArticleDelete (   $title)
static
Parameters
Title$title
Deprecated:
since 1.24, use WikiPage::onArticleDelete() instead

Definition at line 2684 of file Article.php.

References $title, WikiPage\onArticleDelete(), and wfDeprecated().

◆ onArticleEdit()

static Article::onArticleEdit (   $title)
static
Parameters
Title$title
Deprecated:
since 1.24, use WikiPage::onArticleEdit() instead

Definition at line 2694 of file Article.php.

References $title, WikiPage\onArticleEdit(), and wfDeprecated().

◆ pageDataFromId()

Article::pageDataFromId (   $dbr,
  $id,
  $options = [] 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::pageDataFromId

Definition at line 2441 of file Article.php.

References $dbr, and $options.

◆ pageDataFromTitle()

Article::pageDataFromTitle (   $dbr,
  $title,
  $options = [] 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::pageDataFromTitle

Definition at line 2449 of file Article.php.

References $dbr, $options, and $title.

◆ prepareContentForEdit()

Article::prepareContentForEdit ( Content  $content,
  $revision = null,
User  $user = null,
  $serialFormat = null,
  $useCache = true 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::prepareContentForEdit

Definition at line 2457 of file Article.php.

References $user.

◆ protect()

Article::protect ( )

action=protect handler

Definition at line 1531 of file Article.php.

Referenced by unprotect().

◆ protectDescription()

Article::protectDescription ( array  $limit,
array  $expiry 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::protectDescription

Definition at line 2471 of file Article.php.

◆ protectDescriptionLog()

Article::protectDescriptionLog ( array  $limit,
array  $expiry 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::protectDescriptionLog

Definition at line 2479 of file Article.php.

◆ purgePatrolFooterCache()

static Article::purgePatrolFooterCache (   $articleID)
static

Purge the cache used to check if it is worth showing the patrol footer For example, it is done during re-uploads when file patrol is used.

Parameters
int$articleIDID of the article to purge
Since
1.27

Definition at line 1130 of file Article.php.

References $cache.

Referenced by LocalFile\recordUpload2().

◆ render()

Article::render ( )

Handle action=render.

Reimplemented in ImagePage.

Definition at line 1521 of file Article.php.

References getContext(), and view().

◆ replaceSectionAtRev()

Article::replaceSectionAtRev (   $sectionId,
Content  $sectionContent,
  $sectionTitle = '',
  $baseRevId = null 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::replaceSectionAtRev

Definition at line 2487 of file Article.php.

◆ replaceSectionContent()

Article::replaceSectionContent (   $sectionId,
Content  $sectionContent,
  $sectionTitle = '',
  $edittime = null 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::replaceSectionContent

Definition at line 2499 of file Article.php.

◆ selectFields()

static Article::selectFields ( )
static
Returns
array
Deprecated:
since 1.24, use WikiPage::selectFields() instead

Definition at line 2664 of file Article.php.

References WikiPage\selectFields(), and wfDeprecated().

Referenced by ArticleTest\testStaticFunctions().

◆ setContext()

Article::setContext (   $context)

Sets the context this Article is executed in.

Parameters
IContextSource$context
Since
1.18

Definition at line 1996 of file Article.php.

References $context.

◆ setOldSubtitle()

Article::setOldSubtitle (   $oldid = 0)

Generate the navigation links when browsing through an article revisions It shows the information as: Revision as of \<date\>; view current revision \<- Previous version | Next Version -\>

Parameters
int$oldidRevision ID of this article revision

Definition at line 1307 of file Article.php.

References $context, $mRevision, $unhide, $user, getContext(), Linker\getRevDeleteLink(), getTitle(), Linker\linkKnown(), Revision\newFromId(), Linker\revComment(), Linker\revUserTools(), and Hooks\run().

Referenced by view().

◆ setParserOptions()

Article::setParserOptions ( ParserOptions  $options)

Override the ParserOptions used to render the primary article wikitext.

Parameters
ParserOptions$options
Exceptions
MWExceptionIf the parser options where already initialized.

Definition at line 1969 of file Article.php.

References $options.

◆ setRedirectedFrom()

Article::setRedirectedFrom ( Title  $from)

Tell the page view functions that this view was redirected from another page on the wiki.

Parameters
Title$from

Definition at line 165 of file Article.php.

◆ setTimestamp()

Article::setTimestamp (   $ts)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::setTimestamp

Definition at line 2511 of file Article.php.

◆ shouldCheckParserCache()

Article::shouldCheckParserCache ( ParserOptions  $parserOptions,
  $oldId 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::shouldCheckParserCache

Definition at line 2519 of file Article.php.

◆ showDeletedRevisionHeader()

Article::showDeletedRevisionHeader ( )

If the revision requested for view is deleted, check permissions.

Send either an error message or a warning header to the output.

Returns
bool True if the view is allowed, false if not.

Definition at line 1264 of file Article.php.

References $link, $user, Revision\DELETED_RESTRICTED, Revision\DELETED_TEXT, getContext(), getOldID(), and getTitle().

Referenced by view().

◆ showDiffPage()

Article::showDiffPage ( )
protected

Show a diff page according to current request variables.

For use within Article::view() only, other callers should use the DifferenceEngine class.

Definition at line 693 of file Article.php.

References $request, $rev, $unhide, $user, getContext(), getOldID(), getRevisionFetched(), list, and wfMessage().

Referenced by view().

◆ showMissingArticle()

Article::showMissingArticle ( )

◆ showNamespaceHeader()

Article::showNamespaceHeader ( )

Show a header specific to the namespace currently being viewed, like [[MediaWiki:Talkpagetext]].

For Article::view().

Definition at line 929 of file Article.php.

References getContext(), getTitle(), and wfMessage().

Referenced by view().

◆ showPatrolFooter()

Article::showPatrolFooter ( )

If patrol is possible, output a patrol UI box.

This is called from the footer section of ordinary page views. If patrol is not possible or not desired, does nothing. Side effect: When the patrol link is build, this method will call OutputPage::preventClickjacking() and load mediawiki.page.patrol.ajax.

Returns
bool

Definition at line 966 of file Article.php.

References $cache, $dbr, $link, $title, $user, $wgEnableAPI, $wgEnableWriteAPI, $wgUseFilePatrol, $wgUseNPPatrol, $wgUseRCPatrol, DB_REPLICA, getContext(), getTitle(), global, RecentChange\isInRCLifespan(), Linker\linkKnown(), RecentChange\newFromConds(), NS_FILE, RC_LOG, wfGetDB(), and wfMessage().

Referenced by showViewFooter().

◆ showRedirectedFromHeader()

Article::showRedirectedFromHeader ( )

If this request is a redirect view, send "redirected from" subtitle to the output.

Returns true if the header was needed, false if this is not a redirect view. Handles both local and remote redirects.

Returns
bool

Definition at line 852 of file Article.php.

References $context, $query, $request, $wgRedirectSources, getContext(), getTitle(), global, isRedirect(), Linker\linkKnown(), Linker\makeExternalLink(), and Hooks\run().

Referenced by view().

◆ showViewFooter()

Article::showViewFooter ( )

Show the footer section of an ordinary page view.

Definition at line 943 of file Article.php.

References getContext(), getTitle(), IP\isValid(), NS_USER_TALK, Hooks\run(), and showPatrolFooter().

Referenced by view().

◆ supportsSections()

Article::supportsSections ( )

Call to WikiPage function for backwards compatibility.

See also
WikiPage::supportsSections

Definition at line 2527 of file Article.php.

◆ triggerOpportunisticLinksUpdate()

Article::triggerOpportunisticLinksUpdate ( ParserOutput  $parserOutput)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::triggerOpportunisticLinksUpdate

Definition at line 2535 of file Article.php.

◆ tryFileCache()

Article::tryFileCache ( )
protected

checkLastModified returns true if it has taken care of all output to the client that is necessary for this request.

(that is, it has sent a cached version of the page)

Returns
bool True if cached version send, false otherwise

Definition at line 1890 of file Article.php.

References $cache, getContext(), getTitle(), isFileCacheable(), and wfDebug().

Referenced by view().

◆ unprotect()

Article::unprotect ( )

action=unprotect handler (alias)

Definition at line 1539 of file Article.php.

References protect().

◆ updateCategoryCounts()

Article::updateCategoryCounts ( array  $added,
array  $deleted,
  $id = 0 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::updateCategoryCounts

Definition at line 2543 of file Article.php.

◆ updateIfNewerOn()

Article::updateIfNewerOn (   $dbw,
  $revision 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::updateIfNewerOn

Definition at line 2551 of file Article.php.

◆ updateRedirectOn()

Article::updateRedirectOn (   $dbw,
  $redirectTitle,
  $lastRevIsRedirect = null 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::updateRedirectOn

Definition at line 2559 of file Article.php.

◆ updateRestrictions()

Article::updateRestrictions (   $limit = [],
  $reason = '',
$cascade = 0,
  $expiry = [] 
)
Parameters
array$limit
string$reason
int&$cascade
array$expiry
Returns
bool

Definition at line 2596 of file Article.php.

References getContext(), and getUser().

◆ updateRevisionOn()

Article::updateRevisionOn (   $dbw,
  $revision,
  $lastRevision = null,
  $lastRevIsRedirect = null 
)

Call to WikiPage function for backwards compatibility.

See also
WikiPage::updateRevisionOn

Definition at line 2567 of file Article.php.

◆ view()

◆ viewRedirect()

Article::viewRedirect (   $target,
  $appendSubtitle = true,
  $forceKnown = false 
)

Return the HTML for the top of a redirect page.

Chances are you should just be using the ParserOutput from WikitextContent::getParserOutput instead of calling this for redirects.

Parameters
Title | array$targetDestination(s) to redirect
bool$appendSubtitle[optional]
bool$forceKnownShould the image be shown as a bluelink regardless of existence?
Returns
string Containing HTML with redirect link
Deprecated:
since 1.30

Definition at line 1447 of file Article.php.

References $lang, $out, getContext(), getTitle(), and wfMessage().

Member Data Documentation

◆ $mContent

string Article::$mContent

Text of the revision we are working on.

Todo:
BC cruft

Definition at line 49 of file Article.php.

◆ $mContentLoaded

bool Article::$mContentLoaded = false

Is the content ($mContent) already loaded?

Definition at line 58 of file Article.php.

◆ $mContentObject

Content Article::$mContentObject

Content of the revision we are working on.

Since
1.21

Definition at line 55 of file Article.php.

Referenced by fetchContentObject(), and getContentObject().

◆ $mContext

IContextSource Article::$mContext
protected

The context this Article is executed in.

Definition at line 37 of file Article.php.

Referenced by getContext().

◆ $mOldId

int null Article::$mOldId

The oldid of the article that is to be shown, 0 for the current revision.

Definition at line 61 of file Article.php.

Referenced by getOldID().

◆ $mPage

WikiPage Article::$mPage
protected

The WikiPage object of this instance.

Definition at line 40 of file Article.php.

Referenced by getPage().

◆ $mParserOptions

ParserOptions Article::$mParserOptions

ParserOptions object for $wgUser articles.

Definition at line 43 of file Article.php.

Referenced by getParserOptions().

◆ $mParserOutput

ParserOutput Article::$mParserOutput

Definition at line 76 of file Article.php.

◆ $mRedirectedFrom

Title Article::$mRedirectedFrom = null

Title from which we were redirected here.

Definition at line 64 of file Article.php.

Referenced by getRedirectedFrom().

◆ $mRedirectUrl

string bool Article::$mRedirectUrl = false

URL to redirect to or false if none.

Definition at line 67 of file Article.php.

◆ $mRevIdFetched

int Article::$mRevIdFetched = 0

Revision ID of revision we are working on.

Definition at line 70 of file Article.php.

Referenced by getRevIdFetched().

◆ $mRevision

Revision Article::$mRevision = null

Revision we are working on.

Definition at line 73 of file Article.php.

Referenced by getRevisionFetched(), and setOldSubtitle().


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