Handbuch: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 79% complete.

Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎polski • ‎português do Brasil • ‎中文 • ‎日本語

Die Article-Klasse behandelt die Präsentation und Interaktion mit MediaWiki-Seiten und ihrer Geschichte. Es ist eng mit der WikiPage-Klasse, welche die Modellobjekte für Seiten bietet.

Diese Datei enthält z.B. eine Version der Funktion view() für die Anzeige einer Seite, aufgerufen von der ViewAction.php (eine andere Version ist in RawAction.php). Diese Funktion liest den Wikitext $mContent der Seite aus der Datenbank, mit Funktionen getContent(), loadContent() und fetchContent() und ordnet diese auf $text. Danach wird es Funktion outputWikiText() aufrufen, um $text zu verarbeiten.

Warnung Warnung: Article ist eine Front-End UI-Klasse nicht eine API für die Interaktion mit Seiteninhalten. Bitte verwenden Sie WikiPage dafür.

Erstellen eines neuen Artikelobjekts

Um Article zu instantiieren, rufen Sie eine der statischen Werkmethoden auf:

  • Article::newFromId( $id ) - * Article::newFromId($id), wo $id eine Artikel id ist.
  • Article::newFromTitle( Title $title, IContextSource $context ) - * Article::newFromTitle(Title $title, IContextSource $context): erstellt ein Artikelobjekt der entsprechenden Klasse für den Titel.
  • Article::newFromWikiPage( WikiPage $page, IContextSource $context ) - * Article::newFromWikiPage(WikiPage $page, IContextSource $context): erstellt ein Artikelobjekt der entsprechenden Klasse für die angegebene Seite.
  • new Article( Title $title ) - creates an Article object from the given title.

Methoden

  • getContent(): erhält den Text dieser Version. Diese Funktion hat Nebenwirkungen. Verwenden Sie diese Funktion nicht, wenn Sie nur den echten Text der Version wollen, wenn überhaupt.
  • getContext() (seit 1.18): erhält den Kontext dieses Artikels worin er ausgeführt ist.
  • getOldID(): erhält die OldID des Artikels, der gezeigt wird, oder 0 für die aktuelle Version.
  • getPage() (seit 1.19): erhält das WikiPage-Objekt von dieser Instanz.
  • getParserOptions(): erhält die Parseroptionen, welche für die Wiedergabe des Hauptartikel-Wikitext geeignet sind.
  • getParserOutput([$oldid, User $user]): eine leichte Methode, um die Parserausgaben für eine Seite zu holen, die Überprüfung des Parserzwischenspeicher zu bekommen und so weiter. Es berücksichtigt die meisten Sachen nicht, die WikiPage::view() gezwungen ist zu betrachten.
  • getRevIdFetched(): holt die rev ID welche auf Seitenansichten verwendet wird.
  • getRevisionFetched() (seit 1.19): erhält dass geholte Versionsobjekt je nach Anforderungsparameter oder null, im Fehlerfall.
  • getRobotPolicy(string $action, ParserOutput $pOutput): erhält die Roboterregel welche für die aktuelle Ansicht verwendet werden. $action ist eine Zeichenfolge, die action= GET und $pOutput-Parameter enthalten.
  • getTitle(): erhält die Title verbunden mit dieser Seite.
  • isCurrent(): erwidert wahr, wenn die aktuell referenzierte Version die aktuelle Bearbeitung auf dieser Seite ist (und es existiert).
  • isFileCacheable(): erwidert wahr wenn die Seite zwischengspeichert werden kann.
  • view(): Diese Methode übernimmt die (Standard) Aktion um eine Seite anzusehen. Aktionen (wie "ansehen", "zurücksetzen", "löschen", etc.) werden durch Aktionsunterklassen abgewickelt. Die show()-Methode der Viewaction ruft Article::view() auf, um die eigentliche Arbeit zu tun.

Siehe https://doc.wikimedia.org/mediawiki-core/master/php/classArticle.html für eine komplette Liste der Methoden.

Hooks

Hooks aufgerufen aus dieser Datei, werden in der Category:MediaWiki hooks included in Article.php Kategorie aufgelistet.

Siehe auch