Extension:ApiFeatureUsage/cs

Category:GPL licensed extensions/cs
Příručka k rozšířením MediaWiki
ApiFeatureUsage
Stav rozšíření: stabilníCategory:Stable extensions/cs
Implementace Speciální stránka Category:Special page extensions/cs, API Category:API extensions/cs
Popis Přehledy protokolu využití funkcí Access API
Autoři Brad Jorsch (Anomiediskuse)
Nejnovější verze 1.0 (2016-12-07)
Zásady kompatibility Vydání snímků současně s MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
MediaWiki 1.25+Category:Extensions with manual MediaWiki version
PHP 5.5.9+
Změny v databázi Ne
Licence GNU General Public License 2.0 nebo novější
Stáhnout Category:Extensions in Wikimedia version control/cs
  • $wgApiFeatureUsageQueryEngineConf
Čtvrtletní stahování 3 (Ranked 93rd)
Veřejné wiki používající rozšíření 847 (Ranked 302nd)
Přeložte rozšíření ApiFeatureUsage
Problémy Otevřené úkoly · Nahlásit chybu
Category:All extensions/cs

Rozšíření ApiFeatureUsage přidává speciální stránku a modul API pro načítání souhrnů dat zaznamenaných pomocí ApiBase::logFeatureUsage(), což je obvykle známkou použití zastaralých funkcí API.

Závislosti

Log data must be added to some sort of storage system. Currently Elasticsearch is supported via Extension:Elastica.

Installation

  • Stáhněte soubor/y a vložte je do adresáře pojmenovaného ApiFeatureUsage ve vaší složce extensions/.
    Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ApiFeatureUsage
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód:
    wfLoadExtension( 'ApiFeatureUsage' );
    
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Configuration

Parameters
Name Description
$wgApiFeatureUsageQueryEngineConf Configuration array for accessing the log storage backend.
class
Backend access class to instantiate. Either this or factory is required.
factory
PHP callable which must return an instance of a backend access class. Either this or class is required.
Elastica backend (ApiFeatureUsageQueryEngineElastica)

Additional configuration values in $wgApiFeatureUsageQueryEngineConf:

serverList
Array of Elasticsearch servers. Required.
maxConnectionAttempts
Maximum connection attempts, default 1.
indexPrefix
Prefix for the indexes to use. Default "apifeatureusage-".
indexFormat
Date formatting for the indexes to use, see the PHP manual. Default "Y.m.d".
type
Elasticsearch type to query. Default "api-feature-usage-sanitized".
featureField
Field name for the logged value of $feature. Default "feature".
timestampField
Field name for the logged timestamp. Default "@timestamp".
agentField
Field name for the logged user agent. Default "agent".

Usage

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. See the auto-generated API documentation for details.

See also

Category:Extensions used on Wikimedia/cs#ApiFeatureUsage/cs
Category:API extensions/cs Category:All extensions/cs Category:ApiDeprecationHelp extensions/cs Category:ApiLogFeatureUsage extensions/cs Category:Extensions in Wikimedia version control/cs Category:Extensions used on Wikimedia/cs Category:Extensions with manual MediaWiki version Category:GPL licensed extensions/cs Category:LoadExtensionSchemaUpdates extensions/cs Category:Special page extensions/cs Category:Stable extensions/cs