MediaWiki REL1_28
WikiFilePage Class Reference

Special handling for file pages. More...

Inheritance diagram for WikiFilePage:
Collaboration diagram for WikiFilePage:

Public Member Functions

 __construct ( $title)
 
 doPurge ( $flags=self::PURGE_ALL)
 Perform the actions of a page purging.
 
 followRedirect ()
 
 getDuplicates ()
 
 getFile ()
 
 getForeignCategories ()
 Get the categories this file is a member of on the wiki where it was uploaded.
 
 getRedirectTarget ()
 
 isLocal ()
 
 isRedirect ()
 
 setFile ( $file)
 
- Public Member Functions inherited from WikiPage
 __clone ()
 Makes sure that the mTitle object is cloned to the newly cloned WikiPage.
 
 __construct (Title $title)
 Constructor and clear the article.
 
 checkFlags ( $flags)
 Check flags and add EDIT_NEW or EDIT_UPDATE to them as needed.
 
 checkTouched ()
 Loads page_touched and returns a value indicating if it should be used.
 
 clear ()
 Clear the object.
 
 clearPreparedEdit ()
 Clear the mPreparedEdit cache field, as may be needed by mutable content types.
 
 commitRollback ( $fromP, $summary, $bot, &$resultDetails, User $guser, $tags=null)
 Backend implementation of doRollback(), please refer there for parameter and return value documentation.
 
 doDeleteArticle ( $reason, $suppress=false, $u1=null, $u2=null, &$error='', User $user=null)
 Same as doDeleteArticleReal(), but returns a simple boolean.
 
 doDeleteArticleReal ( $reason, $suppress=false, $u1=null, $u2=null, &$error='', User $user=null, $tags=[], $logsubtype='delete')
 Back-end article deletion Deletes the article with database consistency, writes logs, purges caches.
 
 doDeleteUpdates ( $id, Content $content=null, Revision $revision=null)
 Do some database updates after deletion.
 
 doEdit ( $text, $summary, $flags=0, $baseRevId=false, $user=null)
 Change an existing article or create a new article.
 
 doEditContent (Content $content, $summary, $flags=0, $baseRevId=false, User $user=null, $serialFormat=null, $tags=[])
 Change an existing article or create a new article.
 
 doEditUpdates (Revision $revision, User $user, array $options=[])
 Do standard deferred updates after page edit.
 
 doRollback ( $fromP, $summary, $token, $bot, &$resultDetails, User $user, $tags=null)
 Roll back the most recent consecutive set of edits to a page from the same user; fails if there are no eligible edits to roll back to, e.g.
 
 doUpdateRestrictions (array $limit, array $expiry, &$cascade, $reason, User $user, $tags=null)
 Update the article's restriction field, and leave a log entry.
 
 doViewUpdates (User $user, $oldid=0)
 Do standard deferred updates after page view (existing or missing page)
 
 exists ()
 
 getActionOverrides ()
 
 getAutoDeleteReason (&$hasHistory)
 Auto-generates a deletion reason.
 
 getCategories ()
 #-
 
 getComment ( $audience=Revision::FOR_PUBLIC, User $user=null)
 
 getContent ( $audience=Revision::FOR_PUBLIC, User $user=null)
 Get the content of the current revision.
 
 getContentHandler ()
 Returns the ContentHandler instance to be used to deal with the content of this WikiPage.
 
 getContentModel ()
 Returns the page's content model id (see the CONTENT_MODEL_XXX constants).
 
 getContributors ()
 Get a list of users who have edited this article, not including the user who made the most recent revision, which you can get from $article->getUser() if you want it.
 
 getCreator ( $audience=Revision::FOR_PUBLIC, User $user=null)
 Get the User object of the user who created the page.
 
 getDeletionUpdates (Content $content=null)
 Returns a list of updates to be performed when this page is deleted.
 
 getHiddenCategories ()
 Returns a list of hidden categories this page is a member of.
 
 getId ()
 
 getLastPurgeTimestamp ()
 Get the last time a user explicitly purged the page via action=purge.
 
 getLatest ()
 Get the page_latest field.
 
 getLinksTimestamp ()
 Get the page_links_updated field.
 
 getMinorEdit ()
 Returns true if last revision was marked as "minor edit".
 
 getOldestRevision ()
 Get the Revision object of the oldest revision.
 
 getParserOutput (ParserOptions $parserOptions, $oldid=null, $forceParse=false)
 Get a ParserOutput for the given ParserOptions and revision ID.
 
 getRedirectURL ( $rt)
 Get the Title object or URL to use for a redirect.
 
 getRevision ()
 Get the latest revision.
 
 getText ( $audience=Revision::FOR_PUBLIC, User $user=null)
 Get the text of the current revision.
 
 getTimestamp ()
 
 getTitle ()
 Get the title object of the article.
 
 getTouched ()
 Get the page_touched field.
 
 getUndoContent (Revision $undo, Revision $undoafter=null)
 Get the content that needs to be saved in order to undo all revisions between $undo and $undoafter.
 
 getUser ( $audience=Revision::FOR_PUBLIC, User $user=null)
 
 getUserText ( $audience=Revision::FOR_PUBLIC, User $user=null)
 
 hasViewableContent ()
 Check if this page is something we're going to be showing some sort of sensible content for.
 
 insertOn ( $dbw, $pageId=null)
 Insert a new empty page record for this article.
 
 insertProtectNullRevision ( $revCommentMsg, array $limit, array $expiry, $cascade, $reason, $user=null)
 Insert a new null revision for this page.
 
 insertRedirect ()
 Insert an entry for this page into the redirect table if the content is a redirect.
 
 insertRedirectEntry (Title $rt, $oldLatest=null)
 Insert or update the redirect table entry for this page to indicate it redirects to $rt.
 
 isCountable ( $editInfo=false)
 Determine whether a page would be suitable for being counted as an article in the site_stats table based on the title & its content.
 
 loadFromRow ( $data, $from)
 Load the object from a database row.
 
 loadPageData ( $from='fromdb')
 Load the object from a given source by title.
 
 lockAndGetLatest ()
 Lock the page row for this title+id and return page_latest (or 0)
 
 makeParserOptions ( $context)
 Get parser options suitable for rendering the primary article wikitext.
 
 pageDataFromId ( $dbr, $id, $options=[])
 Fetch a page record matching the requested ID.
 
 pageDataFromTitle ( $dbr, $title, $options=[])
 Fetch a page record matching the Title object's namespace and title using a sanitized title string.
 
 prepareContentForEdit (Content $content, $revision=null, User $user=null, $serialFormat=null, $useCache=true)
 Prepare content which is about to be saved.
 
 prepareTextForEdit ( $text, $revid=null, User $user=null)
 Prepare text which is about to be saved.
 
 protectDescription (array $limit, array $expiry)
 Builds the description to serve as comment for the edit.
 
 protectDescriptionLog (array $limit, array $expiry)
 Builds the description to serve as comment for the log entry.
 
 replaceSectionAtRev ( $sectionId, Content $sectionContent, $sectionTitle='', $baseRevId=null)
 
 replaceSectionContent ( $sectionId, Content $sectionContent, $sectionTitle='', $edittime=null)
 
 setTimestamp ( $ts)
 Set the page timestamp (use only to avoid DB queries)
 
 shouldCheckParserCache (ParserOptions $parserOptions, $oldId)
 Should the parser cache be used?
 
 supportsSections ()
 Returns true if this page's content model supports sections.
 
 triggerOpportunisticLinksUpdate (ParserOutput $parserOutput)
 Opportunistically enqueue link update jobs given fresh parser output if useful.
 
 updateCategoryCounts (array $added, array $deleted, $id=0)
 Update all the appropriate counts in the category table, given that we've added the categories $added and deleted the categories $deleted.
 
 updateIfNewerOn ( $dbw, $revision)
 If the given revision is newer than the currently set page_latest, update the page record.
 
 updateRedirectOn ( $dbw, $redirectTitle, $lastRevIsRedirect=null)
 Add row to the redirect table if this is a redirect, remove otherwise.
 
 updateRevisionOn ( $dbw, $revision, $lastRevision=null, $lastRevIsRedirect=null)
 Update the page record to point to a newly saved revision.
 

Protected Member Functions

 loadFile ()
 
- Protected Member Functions inherited from WikiPage
 clearCacheFields ()
 Clear the object cache fields.
 
 formatExpiry ( $expiry)
 
 loadLastEdit ()
 Loads everything except the text This isn't necessary for all uses, so it's only done if needed.
 
 pageData ( $dbr, $conditions, $options=[])
 Fetch a page record with the given conditions.
 
 setLastEdit (Revision $revision)
 Set the latest revision.
 

Protected Attributes

array $mDupes = null
 
File $mFile = false
 
bool $mFileLoaded = false
 
LocalRepo $mRepo = null
 
- Protected Attributes inherited from WikiPage
int $mDataLoadedFrom = self::READ_NONE
 One of the READ_* constants.
 
int $mId = null
 
Revision $mLastRevision = null
 
string $mLinksUpdated = '19700101000000'
 
Title $mRedirectTarget = null
 
string $mTimestamp = ''
 Timestamp of the current revision or empty string if not loaded.
 
string $mTouched = '19700101000000'
 

Additional Inherited Members

- Static Public Member Functions inherited from WikiPage
static factory (Title $title)
 Create a WikiPage object of the appropriate class for the given title.
 
static getAutosummary ( $oldtext, $newtext, $flags)
 Return an applicable autosummary if one exists for the given edit.
 
static newFromID ( $id, $from='fromdb')
 Constructor from a page id.
 
static newFromRow ( $row, $from='fromdb')
 Constructor from a database row.
 
static onArticleCreate (Title $title)
 The onArticle*() functions are supposed to be a kind of hooks which should be called whenever any of the specified actions are done.
 
static onArticleDelete (Title $title)
 Clears caches when article is deleted.
 
static onArticleEdit (Title $title, Revision $revision=null)
 Purge caches on page update etc.
 
static selectFields ()
 Return the list of revision fields that should be selected to create a new page.
 
- Public Attributes inherited from WikiPage
stdClass $mPreparedEdit = false
 Map of cache fields (text, parser output, ect) for a proposed/new edit.
 
Title $mTitle = null
 
const PURGE_ALL = 7
 
const PURGE_CDN_CACHE = 1
 
const PURGE_CLUSTER_PCACHE = 2
 
const PURGE_GLOBAL_PCACHE = 4
 
 $mDataLoaded = false
 
 $mIsRedirect = false
 
 $mLatest = false
 
- Public Attributes inherited from IDBAccessObject
const READ_LOCKING = 3
 Constants for object loading bitfield flags (higher => higher QoS)
 
const READ_NONE = -1
 
- Static Protected Member Functions inherited from WikiPage
static flattenRestrictions ( $limit)
 Take an array of page restrictions and flatten it to a string suitable for insertion into the page_restrictions field.
 

Detailed Description

Special handling for file pages.

Definition at line 28 of file WikiFilePage.php.

Constructor & Destructor Documentation

◆ __construct()

WikiFilePage::__construct (   $title)

Definition at line 38 of file WikiFilePage.php.

References $title.

Member Function Documentation

◆ doPurge()

WikiFilePage::doPurge (   $flags = self::PURGE_ALL)

Perform the actions of a page purging.

Parameters
integer$flagsBitfield of WikiPage::PURGE_* constants
Returns
bool

Reimplemented from WikiPage.

Definition at line 165 of file WikiFilePage.php.

References $flags, loadFile(), and wfDebug().

◆ followRedirect()

WikiFilePage::followRedirect ( )
Returns
bool|mixed|Title

Reimplemented from WikiPage.

Definition at line 90 of file WikiFilePage.php.

References $from, loadFile(), and NS_FILE.

◆ getDuplicates()

WikiFilePage::getDuplicates ( )
Returns
array|null

Definition at line 134 of file WikiFilePage.php.

References $mDupes, $self, as, loadFile(), and RepoGroup\singleton().

◆ getFile()

WikiFilePage::getFile ( )
Returns
bool|File

Definition at line 126 of file WikiFilePage.php.

References $mFile, and loadFile().

◆ getForeignCategories()

WikiFilePage::getForeignCategories ( )

Get the categories this file is a member of on the wiki where it was uploaded.

For local files, this is the same as getCategories(). For foreign API files (InstantCommons), this is not supported currently. Results will include hidden categories.

Returns
TitleArray|Title[]
Since
1.23

Definition at line 196 of file WikiFilePage.php.

References $dbr, $mFile, WikiPage\$mTitle, $res, $title, loadFile(), TitleArray\newFromResult(), NS_CATEGORY, and wfDebug().

◆ getRedirectTarget()

WikiFilePage::getRedirectTarget ( )
Returns
mixed|null|Title

Reimplemented from WikiPage.

Definition at line 72 of file WikiFilePage.php.

References $from, WikiPage\$mRedirectTarget, loadFile(), and NS_FILE.

◆ isLocal()

WikiFilePage::isLocal ( )
Returns
bool

Reimplemented from WikiPage.

Definition at line 118 of file WikiFilePage.php.

References loadFile().

Referenced by SkinTemplate\buildContentNavigationUrls().

◆ isRedirect()

WikiFilePage::isRedirect ( )
Returns
bool

Reimplemented from WikiPage.

Definition at line 106 of file WikiFilePage.php.

References loadFile().

◆ loadFile()

WikiFilePage::loadFile ( )
protected

◆ setFile()

WikiFilePage::setFile (   $file)
Parameters
File$file

Definition at line 47 of file WikiFilePage.php.

Member Data Documentation

◆ $mDupes

array WikiFilePage::$mDupes = null
protected

Definition at line 36 of file WikiFilePage.php.

Referenced by getDuplicates().

◆ $mFile

File WikiFilePage::$mFile = false
protected

Definition at line 30 of file WikiFilePage.php.

Referenced by getFile(), and getForeignCategories().

◆ $mFileLoaded

bool WikiFilePage::$mFileLoaded = false
protected

Definition at line 34 of file WikiFilePage.php.

◆ $mRepo

LocalRepo WikiFilePage::$mRepo = null
protected

Definition at line 32 of file WikiFilePage.php.


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