Extension:HitCounters

MediaWiki 拡張機能マニュアル

HitCounters リリースの状態: 安定
実装	データベース , データ抽出, 自分のウィキ
説明	ページビュー機能の提供
作者	Mark A. Hershberger (MarkAHershbergerトーク)
最新バージョン	0.4
MediaWiki	>= 1.36.0
PHP	7.3.19+
データベースの変更	はい
Composer	mediawiki/hit-counters
テーブル	hit_counter hit_counter_extension
ライセンス	GNU 一般公衆利用許諾書 3.0 以降
ダウンロード	拡張機能をダウンロード Git [?]: Git master をダウンロード リポジトリを参照 (Phabricator · GitHub) コミット履歴 リポジトリの貢献者 (GitHub) コード レビュー
パラメーター $wgDisableCounters $wgEnableAddPageId $wgHitcounterUpdateFreq $wgEnableAddTextLength
追加する権限 hitcounter-exempt
使用するフック AbuseFilter-builder AbuseFilter-computeVariable AbuseFilter-deprecatedVariables AbuseFilter-generateTitleVars LoadExtensionSchemaUpdates MagicWordwgVariableIDs PageViewUpdates ParserFirstCallInit ParserGetVariableValueSwitch SkinAddFooterLinks SpecialStatsAddExtra
Quarterly downloads	130 (Ranked 51st)
translatewiki.net で翻訳を利用できる場合は、HitCounters 拡張機能の翻訳にご協力ください
Vagrant role	hitcounters
問題点	未解決のタスク · バグを報告

The HitCounters extension displays the view count in the page footer and the most viewed pages on a special page called PopularPages. The extension provides page views statistics that were removed in MediaWiki 1.25 .

概要

Benefits

This extension provides feedback in the form of audience measurement to editors. Knowing the rough size of one's audience as an editor allows editors to identify and improve popular articles. HitCounters' special page PopularPages also allows editors to focus on improving those articles with the highest traffic, and helps readers discover a project's most curated content.

HitCounters extension enables determining the wikiFactor, a rough measure of a wiki website's popularity.

HitCounters extension is minimally intrusive with respect to data security and privacy concerns. The extension handles metrics on the server side so aggregated data stays within the site's security boundary. The extension does not inject JavaScript to be executed by the client, and does not ask a client to download additional un-audited code from a third party, like GoogleAnalyticsMetrics.

The extension does not track users who visit a page. As such, there's no need for special handling of Do Not Track browser requests or Global Privacy Control settings. The extension also does not use third party services, like GoogleAnalyticsMetrics.

The extension does not have dependencies which can cause conflicts. Other extensions, like GoogleAnalyticsMetrics, can cause problems during a Composer update. Also see Phabricator P6481 .

MediaWikiのコア実装との違い

Before MediaWiki 1.25, the page views counting functionality was in core MediaWiki. This extension is based on that same code, but was deliberately done in a more lightweight way in order to speed up processing time. Many lines of superfluous code were removed. Also, the old MediaWiki core code did numerous database queries on every page hit; these have all been removed as well. This change may possibly lead to some inaccuracies in the data.

The core differences that wiki administrators need to know are:

• The hit counts are stored in cache.
• The visible hit count at the bottom of each page is updated only once per day. (Pages with hit count less than 100 are updated once per minute.)
• If you refresh your browser on a wiki page, that hit is ignored.

何をもって閲覧とするか

According to tests conducted by several MediaWiki operators, a view is counted if a page is accessed normally (action=view), as well as action=render and when accessing a page revision.

A view is not counted with the other actions, such as action=raw, action=edit, and action=info.

Migration

If you are migrating from a version of MediaWiki 1.25 and earlier to a newer version, you must ensure to follow the advice and documentation outlined in this version of the documenation.

インストール

コンポーザーを使って、MediaWikiのディレクトリで以下の2つのコマンドを実行することで、この拡張機能をインストールすることができます。

• ダウンロードして、ファイルをextensions/フォルダー内のHitCountersという名前のディレクトリ内に配置します。
  開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/HitCounters
• 以下のコードを LocalSettings.php ファイルの末尾に追加します:

  wfLoadExtension( 'HitCounters' );
  

• 更新スクリプトを実行します。このスクリプトは、この拡張機能が必要とするデータベーステーブルを自動的に作成します。
• 必要に応じて設定します。
•  完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

Vagrantでのインストール:

• Vagrant を使用している場合は、vagrant roles enable hitcounters --provisionでインストールしてください。

設定

• $wgDisableCounters

  When set to true, it disables the notice in the pages footer saying "このページは 256 回アクセスされました。" as well as the special page PopularPages. This configuration parameter was removed with MediaWiki 1.35.0.

• $wgHitcounterUpdateFreq

  Sets how often page counters should be updated. Default value is 1.

• $wgGroupPermissions['sysop']['hitcounter-exempt'] = true;

  Exclude user group page views from counting.

Fork

There is a fork of this extension that offers custom settings to the user:

• REL1_25-v0.5.4 is backward compatible to MediaWiki 1.25.0.
• REL1_35-v0.5.5 is backward compatible to MediaWiki 1.35.3.
• REL1_38-v0.5.5 is backward compatible to MediaWiki 1.38.0.

See also

• Extension:GoogleAnalyticsMetrics - Provides site-wide metrics for Google Analytics users