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 82% 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 ) - * Article::newFromTitle(Title $title, IContextSource $context): cria um objeto Article da classe apropriada para o título dado.
  • Article::newFromWikiPage( WikiPage $page, IContextSource $context ) - * 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(): 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() (since 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() (since 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() (desde a versão 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