Manual:WikiPage.php/pt-br

Arquivo do MediaWiki: WikiPage.php
Localização:	includes/page/ (includes/Page/ in 1.46 or later)
Código-fonte:	master • 1.45.1 • 1.44.3 • 1.43.6
Classes:	MediaWiki\Page\WikiPage • Page

A classe WikiPage representa uma página do MediaWiki e seu histórico. Ela encapsula o acesso a informações da página armazenada no banco de dados, e permite o acesso a propriedades como texto da página (em formato Wikitexto), flags, etc.

Em teoria, WikiPage é suposta para ser objeto de modelo para as páginas, enquanto a classe Article lida com as funções de negócios e de apresentação.

Accessing a WikiPage object

• Se você tem um objeto Article, você pode obter um objeto WikiPage, usando Article::getPage().
• To request the WikiPage object from the current context, use RequestContext::getWikiPage() .

Criando um novo objeto WikiPage

Use a WikiPageFactory to create new WikiPage objects.

Métodos

• getContent( $audience ) – Obtém o conteúdo da última revisão, onde $audience pode ser um destes itens:
  1. RevisionRecord::FOR_PUBLIC – a ser exibida para todos os usuários
  2. RevisionRecord::FOR_THIS_USER – a ser exibida para o usuário em $wgUser
  3. RevisionRecord::RAW – obtém o texto independentemente das permissões

• Para obter o texto da última revisão, use:

$text = $wikiPage->getContent( RevisionRecord::RAW )->getText();

• convertSelectType() – convert 'fromdb', 'fromdbmaster' and 'forupdate' to READ_* constants.
• getActionOverrides() – compare: ContentHandler::getActionOverrides()
• clear() – clear object.
• clearPreparedEdit()
• pageDataFromTitle() – fetch a page record matching the Title object's namespace and title using a sanitized title string
• pageDataFromId()
• loadPageData() – load from a given source by title
• wasLoadedFrom() – check if page data was loaded
• loadFromRow() – load object from database row
• exists() – check if given page exists
• canExist()
• hasViewableContent()
• isNew() – check if the page has only one revision
• checkTouched() – check if page exists and is not a redirect. Loads page_touched
• isSamePageAs()

Accessors and checks

• getId() – get the page ID
• getTitle() – Obtém o objeto title do artigo.
• get data from the Title object:
  • getNamespace() – returns an integer
  • getDBkey()
  • getWikiId()
• getLanguage() – get language code for the page
• getContentHandler() – return ContentHandler instance to be used to deal with the content of this WikiPage.
• getContentModel() – return the page's content model id (see the CONTENT_MODEL_XXX constants).
• getRevisionRecord() – get latest RevisionRecord
• getContent() – get the content of the current revision.
• Get data from the page table
  • getQueryInfo() – return the tables, fields, and join conditions to be selected to create a new page object.
  • getTouched() – get the page_touched field
  • getLinksTimestamp() – get page_links_updated field
  • getLatest() – get page_latest field
  • getPageIsRedirectField() – see below
• getTimestamp() – get timestamp of latest revision. See also setTimestamp().
• Relating to contributing users:
  • getContributors() – get a list of users who have edited this article, excluding the user who made the last article revision
  • getUser() – get User ID of the user who made the last article revision.
  • getCreator() – get User ID of the user who created the page
• getUserText()
• getComment()
• getMinorEdit()
• isCountable()
• Relating to categories
  • getCategories() – get a list of categories this page is a member of.
  • getHiddenCategories()
• Relating to redirects
  • isRedirect()
  • getPageIsRedirectField() – get the value of the page_is_redirect field in the database
  • followRedirect() – get the Title object or URL this page redirects to.
  • getRedirectURL()
• Relating to parsing:
  • getParserOutput() – get a ParserOutput for the given ParserOptions and revision ID.
  • shouldCheckParserCache()
• Relating to the possibility of non-local databases
  • isLocal() – check if content shown on this page comes from the local DB.
  • getWikiDisplayName()
  • getSourceURL()
• getMutableCacheKeys()

Setters, page actions and checks

• setTimestamp()
• Relating to redirects:
  • insertRedirect()
  • insertRedirectEntry()
• doViewUpdates()
• doPurge() – run the actions of purging a page.
• insertOn() – insert a new empty page record for this article. Must be followed up by creating a revision and running $this->updateRevisionOn().
• updateRevisionOn() – update the page record to point to a newly saved revision.
• Relating to page sections:
  • supportsSections()
  • replaceSectionAtRev()
• newPageUpdater() – return PageUpdater for creating the page or creating new page revisions.
  • makeParserOptions() – get parser options suitable for rendering the primary article wikitext.
• updateParserCache() – update the parser cache. Likely to become deprecated.
• doSecondaryDataUpdates() – likely to become deprecated.
• doUpdateRestrictions() – update the article's restriction field, and leave a log entry. This works for protection both existing and non-existing pages.
• getCurrentUpdate() – get the state of an ongoing update, shortly before or just after it is saved to the database (since 1.38). Generally to be avoided.
• Relating to page protection:
  • insertNullProtectionRevision() – insert a new null/dummy revision for this page.
  • protectDescription() – build the description to serve as comment for the edit.
  • protectDescriptionLog() – build the description to serve as comment for the log entry.
• lockAndGetLatest() – Lock the page row for this title, namespace and id and return page_latest (or 0).
• getAutoDeleteReason() – auto-generates a deletion reason
• updateCategoryCounts() – should only be called from deferred updates or jobs to avoid contention.
• toPageRecord() – get the page represented by this WikiPage as a PageStoreRecord.
• magic methods: __clone(), __wakeup(), __toString()

Hook-like methods

• onArticleCreate(), onArticleDelete() and onArticleEdit()

Deprecated methods

• factory(), newFromID() and newFromRow() – methods for creating a WikiPage object – have been deprecated in favour of methods provided by WikiPageFactory.
• getRedirectTarget()
• replaceSectionContent()
• checkFlags()
• doUserEditContent()
• doEditUpdates()
• doDeleteArticleReal()
• doDeleteArticleBatched()
• doDeleteUpdates()
• getDeletionUpdates()
• hasDifferencesOutsideMainSlot()
• prepareContentForEdit() – prepare the content which is about to be saved.
• isBatchedDelete() – checks if deletion of this page would be batched. See now DeletePage::isBatchedDelete().

Veja wmdoc:mediawiki-core/master/php/classWikiPage.html para uma lista completa de métodos.

Ver também

• Manual:Modeling pages
• Manual:Código
• Manual:Convenções de codificação