Jump to content

Extension:HitCounters

From mediawiki.org
This page is a translated version of the page Extension:HitCounters and the translation is 32% complete.
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 以降
ダウンロード
  • $wgDisableCounters
  • $wgHitcounterUpdateFreq
  • $wgEnableAddPageId
  • $wgEnableAddTextLength
hitcounter-exempt
四半期ごとのダウンロード数 127 (Ranked 46th)
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 concerning 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 the GoogleAnalyticsMetrics extension.

The extension has no dependencies that can cause conflicts. Other extensions, like GoogleAnalyticsMetrics, can cause problems during a Composer update. Also see 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 made lighter to speed up processing time. Many lines of superfluous code were removed. Also, the old MediaWiki core code performed numerous database queries on every page hit; these have all been removed. This change may lead to some inaccuracies in the data.

The core differences that wiki administrators need to know are:

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

何をもって閲覧とするか

According to tests conducted by several MediaWiki operators, a view is counted if a page is accessed (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 documentation.

インストール

  • ダウンロードして、ファイルをextensions/フォルダー内のHitCountersという名前のディレクトリ内に配置します。
    開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/HitCounters
  • 以下のコードを LocalSettings.php ファイルの末尾に追加します:
    wfLoadExtension( 'HitCounters' );
    
  • 更新スクリプトを実行します。このスクリプトは、この拡張機能が必要とするデータベーステーブルを自動的に作成します。
  • 必要に応じて設定します。
  • Yes 完了 – ウィキの「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". The default value is false.
  • $wgHitcounterUpdateFreq
    Sets how often page counters should be updated. The default value is 1.
  • $wgGroupPermissions['sysop']['hitcounter-exempt'] = true;
    Exclude user group page views from counting.
  • $wgEnableAddPageId
    When set to true, it adds the PageId to the special page "PopularPages". The default value is false.
  • $wgEnableAddTextLength
    When set to true, it adds the TextLength to the special page "PopularPages". The default value is false.

Fork

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

See also