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 é executadogetOldID()- 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 queWikiPage::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étodoshow()do arquivo ViewAction chama a funçãoArticle::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 chamados a partir deste arquivo são listados na categoria Category:MediaWiki hooks included in Article.php.