Erweiterung:ApiFeatureUsage
Appearance
ApiFeatureUsage Freigabestatus: stabil |
|
---|---|
Einbindung | Spezialseite , API |
Beschreibung | Access API feature usage log summaries |
Autor(en) | Brad Jorsch (AnomieDiskussion) |
Letzte Version | 1.0 (2016-12-07) |
Kompatibilitätspolitik | Snapshots werden zusammen mit MediaWiki veröffentlicht. Der Master ist nicht abwärtskompatibel. |
MediaWiki | 1.25+ |
PHP | 5.5.9+ |
Datenbankänderungen | Nein |
Lizenz | GNU General Public License 2.0 oder neuer |
Herunterladen | |
|
|
Quarterly downloads | 16 (Ranked 115th) |
Public wikis using | 847 (Ranked 303rd) |
Übersetze die ApiFeatureUsage-Erweiterung | |
Probleme | Offene Aufgaben · Einen Fehler melden |
The ApiFeatureUsage extension adds a special page and an API module to fetch summaries of data logged by ApiBase::logFeatureUsage(), which is typically an indication of use of deprecated API features.
Abhängigkeiten
Log data must be added to some sort of storage system. Currently Elasticsearch is supported via Erweiterung:Elastica .
Installation
- Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens
ApiFeatureUsage
im Ordnerextensions/
ablegen.
Entwickler und Code-Beitragende sollten stattdessen die Erweiterung von Git installieren, mit:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ApiFeatureUsage - Folgenden Code am Ende deiner LocalSettings.php -Datei einfügen:
wfLoadExtension( 'ApiFeatureUsage' );
- Erledigt – Navigiere zu Special:Version in deinem Wiki, um zu überprüfen, ob die Erweiterung erfolgreich installiert wurde.
Konfiguration
- Parameter
Name | Description |
---|---|
$wgApiFeatureUsageQueryEngineConf
|
Configuration array for accessing the log storage backend.
|
- Elastica backend (
ApiFeatureUsageQueryEngineElastica
)
Additional configuration values in $wgApiFeatureUsageQueryEngineConf
:
serverList
- Array of Elasticsearch servers. Notwendig.
maxConnectionAttempts
- Maximum connection attempts, default 1.
indexPrefix
- Prefix for the indexes to use. Standard ist "
apifeatureusage-
". indexFormat
- Date formatting for the indexes to use, see the PHP manual. Standard ist "
Y.m.d
". type
- Elasticsearch type to query. Standard ist "
api-feature-usage-sanitized
". featureField
- Field name for the logged value of $feature. Standard ist "
feature
". timestampField
- Field name for the logged timestamp. Standard ist "
@timestamp
". agentField
- Field name for the logged user agent. Standard ist "
agent
".
Verwendung
The extension adds a new special page, Special:ApiFeatureUsage, with a simple form to request a summary of feature usage logs for a user agent and date range.
The extension also adds an API query submodule, meta=featureusage
.
Siehe die automatisch generierte API-Dokumentation für Details.
Siehe auch
Diese Erweiterung wird in einem oder mehreren Wikis von Wikimedia verwendet. Das bedeutet mit hoher Wahrscheinlichkeit, dass die Erweiterung stabil ist und gut genug funktioniert, um auf solch häufig besuchten Webseiten benutzt zu werden. Suche nach dem Erweiterungs-Namen in den Wikimedia CommonSettings.php und den InitialiseSettings.php-Konfigurations-Dateien, um nachzusehen, wo es installiert ist. Eine vollständige Liste der installierten Erweiterungen in einem bestimmten Wiki wird auf Special:Version im Wiki generiert und angezeigt. |