Extension:Metadata/de-formal

This page is a translated version of the page Extension:Metadata and the translation is 12% complete.
MediaWiki extensions manual
OOjs UI icon advanced-invert.svg
Metadata
Release status: stable
Implementation Database
Description Provides a parser function and two PHP methods to set and get metadata about any wiki page
Author(s) SophivorusDiskussion
Latest version 2.0 (2022-02-14)
MediaWiki 1.35+
PHP 7.0+
Database changes Yes
License GNU General Public License 3.0 or later
Download
Translate the Metadata extension if it is available at translatewiki.net

The Metadata extension provides a simple parser function and two PHP methods to save and retrieve metadata about any wiki page.

This is a general purpose extension and does nothing useful by itself. It's meant to be used by other extensions and pieces of code to save and retrieve their own metadata.

The metadata is stored in a new database table.

Installation

  • Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens Metadata im Ordner extensions/ ablegen.
  • Folgenden Code am Ende Ihrer LocalSettings.php hinzufügen:
    wfLoadExtension( 'Metadata' );
    
  • Führen Sie das Aktualisierungsskript aus, welches automatisch die notwendigen Datenbanktabellen erstellt, die diese Erweiterung braucht.
  •   Done – Zu Special:Version in dem Wiki (bei Einstellung auf deutsch nach Spezial:Version) navigieren, um die erfolgreiche Installierung der Erweiterung zu überprüfen.

Usage

PHP

To save a simple key-value pair for a given page ID from PHP:

Metadata::set( $pageID, 'key', 'value' );

You can also set several key-value pairs at once, like so:

Metadata::set( $pageID, [
	'key1' => 'value1',
	'key2' => 'value2',
	'key3' => 'etc',
]);

If a value for any of the keys already exists, it will be overwritten. Once set, you can retrieve the saved data for a given key with the following code:

$value = Metadata::get( $pageID, 'key' );

You can also retrieve all the key-value pairs for a given page at once, like so:

$data = Metadata::get( $pageID );
foreach ( $data as $key => $value ) {
	// Do something
}

Wikitext

To store a simple key-value pair for the current page:

{{#metadata:key|value}}

To retrieve this value, simply do:

{{#metadata:key}}

Siehe auch