Manual:Article.php
| Arquivo do MediaWiki: Article.php | |
|---|---|
| Localização: | includes/page/ (includes/Page/ in 1.46 or later) |
| Código-fonte: | master • 1.45.3 • 1.44.5 • 1.43.8 |
| Classes: | MediaWiki\Page\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 $2, que fornece o objeto modelo para as páginas.
It is closely related to the WikiPage class, which provides the model object for pages.
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(), 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.