Manual:Article.php

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Article.php and the translation is 89% complete.
Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎polski • ‎português do Brasil • ‎中文 • ‎日本語

A classe Article lida com a apresentação e interação com páginas MediaWiki e seu histórico. Ela está intimamente relacionada com a classe WikiPage, que fornece o objeto modelo para as páginas.

Este arquivo contém, por exemplo, uma versão da função view() para a visualização de uma página, chamada a partir do arquivo ViewAction.php (outra versão está em RawAction.php). Esta função busca o wikitexto $mContent da página do banco de dados usando funções getContent(), loadContent() e fetchContent(), e atribui isso a $text. Depois disso, chama a função outputWikiText() para processar $text.

Atenção Atenção: Article é uma classe de interface de usuário front-end, não uma API para interagir com o conteúdo da página. Por favor, use WikiPage para essa finalidade.

A criação de um novo objeto Article

Para instanciar Article, chame um dos métodos de fatoração estáticos:

  • Article::newFromId( $id ) - * Article::newFromId($id), onde $id é uma ID do artigo.
  • Article::newFromTitle( Title $title, IContextSource $context ) - cria um objeto Article da classe apropriada para o título dado.
  • Article::newFromWikiPage( WikiPage $page, IContextSource $context ) - cria um objeto Article da classe apropriada para determinada página.
  • new Article( Title $title ) - creates an Article object from the given title.

Métodos

  • getContent() ((removido na 1.29); superseded by WikiPage::getContent() ) - obtém o texto desta revisão. Esta função tem efeitos colaterais. Não use esta função se você apenas deseja o texto da revisão real, se houver.
  • getContext() (1.18+) - obtém o contexto em que este objeto Article é executado
  • getOldID() - obtém o antigo ID do artigo que é para ser mostrado, ou 0 para a revisão atual.
  • getPage() (1.19+) - obtém o objeto WikiPage desta instância.
  • getParserOptions() - obtém as opções do analisador adequadas para processar o wikitexto do artigo primário.
  • getParserOutput([$oldid, User $user]) - um método leve para obter a saída do analisador, para uma página, verificando o cache de analisador e assim por diante. Não considera a maioria das coisas que WikiPage::view() é forçado a considerar.
  • getRevIdFetched() - Obtém o ID da revisão usado em page views.
  • getRevisionFetched() (1.19+) - obtém o objeto Revisão buscado dependendo dos parâmetros de solicitação ou nulo em caso de falha.
  • getRobotPolicy(string $action, ParserOutput $pOutput) - obtém a diretiva de robôs para ser usado para a exibição atual. $action é uma string que contém o parâmetro action= GET e $pOutput.
  • getTitle() - obtém o objeto Title associado a esta página.
  • isCurrent() - retorna true se a revisão atualmente referenciada é a edição atual para esta página (e existe).
  • isFileCacheable() - retorna true se a página pode ser armazenada em cache.
  • view() - este método lida com a ação (padrão) de visualização de uma página. Ações (como 'view', 'revert', 'delete', etc) são tratadas por subclasses Action. O método show() do arquivo ViewAction chama a função Article::view() para realizar a tarefa atual.

Veja https://doc.wikimedia.org/mediawiki-core/master/php/classArticle.html para uma lista completa dos métodos.

Hooks

Hooks chamados a partir deste arquivo são listados na categoria Category:MediaWiki hooks included in Article.php .

Ver também