Manual:Article.php

Arquivo MediaWiki: Article.php
Local:	includes/page/
Código fonte:	master • 1.42.3 • 1.41.4 • 1.39.10
Classes:	Article

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. This function fetches the wikitext $mContent of the page from the database using functions getContent(), loadContent() and fetchContent(), and assigns this to $text. After that it calls function outputWikiText() (deprecated) to process $text.

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

• Manual:Code
• Manual:Convenções de codificação