MediaWiki master
|
Legacy class representing an editable page and handling UI for some page actions. More...
Inherits Page.
Inherited by CategoryPage, and ImagePage.
Public Member Functions | |
__construct (Title $title, $oldId=null) | |
addHelpLink ( $to, $overrideBaseUrl=false) | |
Adds help link with an icon via page indicators. | |
adjustDisplayTitle (ParserOutput $pOutput) | |
Adjust title for pages with displaytitle, -{T|}- or language conversion. | |
clear () | |
fetchRevisionRecord () | |
Fetches the revision to work on. | |
getActionOverrides () | |
Call to WikiPage function for backwards compatibility. | |
getContext () | |
Gets the context this Article is executed in. | |
getOldID () | |
getOldIDFromRequest () | |
Sets $this->mRedirectUrl to a correct URL if the query parameters are incorrect. | |
getPage () | |
Get the WikiPage object of this instance. | |
getParserOptions () | |
Get parser options suitable for rendering the primary article wikitext. | |
getParserOutput ( $oldid=null, UserIdentity $user=null) | |
Lightweight method to get the parser output for a page, checking the parser cache and so on. | |
getRedirectedFrom () | |
Get the page this view was redirected from. | |
getRevIdFetched () | |
Use this to fetch the rev ID used on page views. | |
getRobotPolicy ( $action, ParserOutput $pOutput=null) | |
Get the robot policy to be used for the current view. | |
getTitle () | |
Get the title object of the article. | |
isCurrent () | |
Returns true if the currently-referenced revision is the current edit to this page (and it exists). | |
isFileCacheable ( $mode=HTMLFileCache::MODE_NORMAL) | |
Check if the page can be cached. | |
protect () | |
action=protect handler | |
render () | |
Handle action=render. | |
setContext ( $context) | |
Sets the context this Article is executed in. | |
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 -\> | |
setRedirectedFrom (Title $from) | |
Tell the page view functions that this view was redirected from another page on the wiki. | |
showDeletedRevisionHeader () | |
If the revision requested for view is deleted, check permissions. | |
showMissingArticle () | |
Show the error text for a missing article. | |
showNamespaceHeader () | |
Show a header specific to the namespace currently being viewed, like [[MediaWiki:Talkpagetext]]. | |
showPatrolFooter () | |
If patrol is possible, output a patrol UI box. | |
showProtectionIndicator () | |
Show a lock icon above the article body if the page is protected. | |
showRedirectedFromHeader () | |
If this request is a redirect view, send "redirected from" subtitle to the output. | |
showViewFooter () | |
Show the footer section of an ordinary page view. | |
unprotect () | |
action=unprotect handler (alias) | |
view () | |
This is the default action of the index.php entry point: just view the page of the given title. | |
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(). | |
static | getRedirectHeaderHtml (Language $lang, Title $target, $forceKnown=false) |
Return the HTML for the top of a redirect page. | |
static | newFromID ( $id) |
Constructor from a page id. | |
static | newFromTitle ( $title, IContextSource $context) |
Create an Article object of the appropriate class for the given page. | |
static | newFromWikiPage (WikiPage $page, IContextSource $context) |
Create an Article object of the appropriate class for the given page. | |
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. | |
Public Attributes | |
int null | $mOldId |
The oldid of the article that was requested to be shown, 0 for the current revision. | |
ParserOutput null false | $mParserOutput = null |
The ParserOutput generated for viewing the page, initialized by view(). | |
Title null | $mRedirectedFrom = null |
Title from which we were redirected here, if any. | |
string false | $mRedirectUrl = false |
URL to redirect to or false if none. | |
Protected Member Functions | |
isDiffOnlyView () | |
newPage (Title $title) | |
showDiffPage () | |
Show a diff page according to current request variables. | |
tryFileCache () | |
checkLastModified returns true if it has taken care of all output to the client that is necessary for this request. | |
Protected Attributes | |
DatabaseBlockStore | $blockStore |
IConnectionProvider | $dbProvider |
LinkRenderer | $linkRenderer |
IContextSource null | $mContext |
The context this Article is executed in. | |
WikiPage | $mPage |
The WikiPage object of this instance. | |
RestrictionStore | $restrictionStore |
bool | $viewIsRenderAction = false |
Whether render() was called. | |
Legacy class representing an editable page and handling UI for some page actions.
This has largely been superseded by WikiPage, with Action subclasses for the user interface of page actions, and service classes for their backend logic.
Move and refactor remaining code
Deprecate
Definition at line 70 of file Article.php.
Article::__construct | ( | Titel | $title, |
$oldId = null ) |
Titel | $title | |
int | null | $oldId | Revision ID, null to fetch from request, zero for current |
Definition at line 141 of file Article.php.
References newPage().
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'.
string | $to | Target MediaWiki.org page title or encoded URL. |
bool | $overrideBaseUrl | Whether $url is a full URL, to avoid MW.o. |
Definition at line 1907 of file Article.php.
References getContext(), and getTitle().
Referenced by CategoryPage\closeShowCategory().
Article::adjustDisplayTitle | ( | ParserOutput | $pOutput | ) |
Adjust title for pages with displaytitle, -{T|}- or language conversion.
ParserOutput | $pOutput |
Definition at line 992 of file Article.php.
References getContext(), and MediaWiki\Parser\ParserOutput\getTitleText().
Article::clear | ( | ) |
Definition at line 261 of file Article.php.
Article::fetchRevisionRecord | ( | ) |
Fetches the revision to work on.
The revision is loaded from the database. Refer to $this->fetchResult for the revision or any errors encountered while loading it.
Public since 1.35
Definition at line 360 of file Article.php.
References StatusValue\fatal(), getTitle(), and wfDebug().
|
static |
Converts a String robot policy into an associative array, to allow merging of several policies using array_merge().
array | string | $policy | Returns empty array on null/false/'', transparent to already-converted arrays, converts string. |
Definition at line 1179 of file Article.php.
Article::getActionOverrides | ( | ) |
Call to WikiPage function for backwards compatibility.
Definition at line 2065 of file Article.php.
Article::getContext | ( | ) |
Gets the context this Article is executed in.
Definition at line 2050 of file Article.php.
Referenced by ImageHistoryList\__construct(), MediaWiki\EditPage\EditPage\__construct(), MediaWiki\Page\ProtectionForm\__construct(), and Action\factory().
Article::getOldID | ( | ) |
Definition at line 279 of file Article.php.
Article::getOldIDFromRequest | ( | ) |
Sets $this->mRedirectUrl to a correct URL if the query parameters are incorrect.
Definition at line 292 of file Article.php.
References getContext(), and getTitle().
Article::getPage | ( | ) |
Get the WikiPage object of this instance.
Definition at line 257 of file Article.php.
Referenced by ImageHistoryList\__construct(), MediaWiki\EditPage\EditPage\__construct(), CategoryPage\closeShowCategory(), ImagePage\getFile(), ImagePage\imageDupes(), ImagePage\loadFile(), ImagePage\openShowImage(), ImagePage\printSharedImageText(), ImagePage\setFile(), CategoryPage\view(), and ImagePage\view().
Article::getParserOptions | ( | ) |
Get parser options suitable for rendering the primary article wikitext.
Definition at line 2028 of file Article.php.
References getContext(), and ParserOptions\setRenderReason().
Article::getParserOutput | ( | $oldid = null, | |
UserIdentity | $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 Article::view() is forced to consider, so it's not appropriate to use there.
int | null | $oldid | Revision ID or null |
UserIdentity | null | $user | The relevant user |
Definition at line 2013 of file Article.php.
References ParserOptions\setRenderReason().
Article::getRedirectedFrom | ( | ) |
Get the page this view was redirected from.
Definition at line 229 of file Article.php.
|
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.
Sprache | $lang | |
Titel | $target | Destination to redirect |
bool | $forceKnown | Should the image be shown as a bluelink regardless of existence? |
Definition at line 1893 of file Article.php.
References MediaWiki\Linker\LinkRenderer\makeRedirectHeader(), and wfDeprecated().
Article::getRevIdFetched | ( | ) |
Use this to fetch the rev ID used on page views.
Before fetchRevisionRecord was called, this returns the page's latest revision, regardless of what getOldID() returns.
Definition at line 437 of file Article.php.
Article::getRobotPolicy | ( | $action, | |
ParserOutput | $pOutput = null ) |
Get the robot policy to be used for the current view.
string | $action | The action= GET parameter |
ParserOutput | null | $pOutput |
Definition at line 1095 of file Article.php.
References getContext(), MediaWiki\Parser\ParserOutput\getIndexPolicy(), getTitle(), NS_USER, and NS_USER_TALK.
Article::getTitle | ( | ) |
Get the title object of the article.
Definition at line 247 of file Article.php.
Referenced by ImageHistoryList\__construct(), MediaWiki\EditPage\EditPage\__construct(), and MediaWiki\Page\ProtectionForm\__construct().
Article::isCurrent | ( | ) |
Returns true if the currently-referenced revision is the current edit to this page (and it exists).
Definition at line 418 of file Article.php.
|
protected |
Definition at line 1081 of file Article.php.
References getContext().
Referenced by CategoryPage\view(), and ImagePage\view().
Article::isFileCacheable | ( | $mode = HTMLFileCache::MODE_NORMAL | ) |
Check if the page can be cached.
int | $mode | One of the HTMLFileCache::MODE_* constants (since 1.28) |
Definition at line 1987 of file Article.php.
References getContext(), and getTitle().
|
static |
Constructor from a page id.
int | $id | Article ID to load |
Definition at line 172 of file Article.php.
|
static |
Create an Article object of the appropriate class for the given page.
Titel | $title | |
IContextSource | $context |
Definition at line 184 of file Article.php.
References NS_FILE.
|
static |
Create an Article object of the appropriate class for the given page.
WikiPage | $page | |
IContextSource | $context |
Definition at line 218 of file Article.php.
References WikiPage\getTitle().
|
protected |
Titel | $title |
Reimplemented in CategoryPage, and ImagePage.
Definition at line 163 of file Article.php.
Referenced by __construct().
Article::protect | ( | ) |
action=protect handler
Definition at line 1935 of file Article.php.
|
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.
int | $articleID | ID of the article to purge |
Definition at line 1482 of file Article.php.
Article::render | ( | ) |
Article::setContext | ( | $context | ) |
Sets the context this Article is executed in.
IContextSource | $context |
Definition at line 2040 of file Article.php.
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 -\>
int | $oldid | Revision ID of this article revision |
Definition at line 1728 of file Article.php.
References MediaWiki\Output\OutputPage\addModuleStyles(), MediaWiki\Output\OutputPage\addSubtitle(), getContext(), MediaWiki\Context\ContextSource\getOutput(), and getTitle().
Article::setRedirectedFrom | ( | Titel | $from | ) |
Tell the page view functions that this view was redirected from another page on the wiki.
Titel | $from |
Definition at line 238 of file Article.php.
Article::showDeletedRevisionHeader | ( | ) |
If the revision requested for view is deleted, check permissions.
Send either an error message or a warning header to the output.
Definition at line 1668 of file Article.php.
References MediaWiki\Output\OutputPage\addHTML(), getContext(), MediaWiki\Context\ContextSource\getOutput(), getRequest(), getTitle(), and MediaWiki\Context\ContextSource\msg().
|
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 1007 of file Article.php.
References MediaWiki\Output\OutputPage\addBodyClasses(), MediaWiki\Output\OutputPage\addHTML(), getContext(), MediaWiki\Context\ContextSource\getOutput(), MediaWiki\Revision\RevisionRecord\getSlot(), and MediaWiki\Output\OutputPage\setPageTitleMsg().
Article::showMissingArticle | ( | ) |
Show the error text for a missing article.
For articles in the MediaWiki namespace, show the default message text. To be called from Article::view().
Definition at line 1491 of file Article.php.
References MediaWiki\Output\OutputPage\addHTML(), MediaWiki\Output\OutputPage\addWikiTextAsContent(), MediaWiki\Output\OutputPage\addWikiTextAsInterface(), getContext(), MediaWiki\Context\ContextSource\getOutput(), getTitle(), NS_MEDIAWIKI, NS_USER, NS_USER_TALK, MediaWiki\Output\OutputPage\setFollowPolicy(), MediaWiki\Output\OutputPage\setIndexPolicy(), and wfEscapeWikiText().
Article::showNamespaceHeader | ( | ) |
Show a header specific to the namespace currently being viewed, like [[MediaWiki:Talkpagetext]].
For Article::view().
Definition at line 1279 of file Article.php.
References getContext(), and getTitle().
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::setPreventClickjacking(true) and load a JS module.
Definition at line 1315 of file Article.php.
References MediaWiki\Output\OutputPage\addHTML(), MediaWiki\Output\OutputPage\addModules(), MediaWiki\Output\OutputPage\addModuleStyles(), getContext(), MediaWiki\Context\ContextSource\getOutput(), getTitle(), NS_FILE, RC_LOG, RC_NEW, and MediaWiki\Output\OutputPage\setPreventClickjacking().
Article::showProtectionIndicator | ( | ) |
Show a lock icon above the article body if the page is protected.
Definition at line 594 of file Article.php.
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.
Definition at line 1206 of file Article.php.
References MediaWiki\Output\OutputPage\addJsConfigVars(), MediaWiki\Output\OutputPage\addModules(), MediaWiki\Output\OutputPage\addSubtitle(), getContext(), MediaWiki\Context\ContextSource\getOutput(), getTitle(), MediaWiki\Output\OutputPage\setCanonicalUrl(), and MediaWiki\Output\OutputPage\setRedirectedFrom().
Article::showViewFooter | ( | ) |
Show the footer section of an ordinary page view.
Definition at line 1291 of file Article.php.
References getContext(), getTitle(), and NS_USER_TALK.
|
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)
Definition at line 1956 of file Article.php.
References getContext(), getTitle(), and wfDebug().
Article::unprotect | ( | ) |
action=unprotect handler (alias)
Definition at line 1943 of file Article.php.
Article::view | ( | ) |
This is the default action of the index.php entry point: just view the page of the given title.
Reimplemented in CategoryPage, and ImagePage.
Definition at line 451 of file Article.php.
References getContext(), getTitle(), wfDebug(), and wfMessage().
|
protected |
Definition at line 125 of file Article.php.
|
protected |
Definition at line 124 of file Article.php.
|
protected |
Definition at line 116 of file Article.php.
|
protected |
The context this Article is executed in.
If null, RequestContext::getMain() is used.
getContext
Definition at line 79 of file Article.php.
int null Article::$mOldId |
The oldid of the article that was requested to be shown, 0 for the current revision.
Definition at line 88 of file Article.php.
|
protected |
The WikiPage object of this instance.
Definition at line 82 of file Article.php.
ParserOutput null false Article::$mParserOutput = null |
The ParserOutput generated for viewing the page, initialized by view().
If no ParserOutput could be generated, this is set to false.
Definition at line 107 of file Article.php.
Title null Article::$mRedirectedFrom = null |
Title from which we were redirected here, if any.
Definition at line 91 of file Article.php.
string false Article::$mRedirectUrl = false |
URL to redirect to or false if none.
Definition at line 94 of file Article.php.
|
protected |
Definition at line 127 of file Article.php.
|
protected |
Whether render() was called.
With the way subclasses work here, there doesn't seem to be any other way to stop calling OutputPage::enableSectionEditLinks() and still have it work as it did before.
Definition at line 114 of file Article.php.