Extension:WatchAnalytics

This page is a translated version of the page Extension:WatchAnalytics and the translation is 45% complete.
Other languages:
MediaWiki 拡張機能マニュアル
OOjs UI icon advanced-invert.svg
WatchAnalytics
リリースの状態: 安定
EVAWatchAnalyticsApril2015.png
実装 特別ページ , 利用者アクティビティ , 通知
説明 Encourages good distribution of watchers
作者 James Montalvo,
Kris Field (Jamesmontalvo3トーク)
最新バージョン 3.2.0 (2020-06-12)
MediaWiki 1.31+
PHP 5.3+
データベースの変更 はい
Composer mediawiki/watch-analytics
ライセンス MIT ライセンス
ダウンロード
README

 

  • $egWatchAnalyticsPageScoreNamespaces
  • $egPendingReviewsEmphasizeDays
  • $egPendingReviewsNumberWatchSuggestions
  • $egPendingReviewsShowWatchSuggestionsIfReviewsUnder
  • $egWatchAnalyticsWatchQualityColors
  • $egWatchAnalyticsReviewStatusColors
viewpagescore, clearreviews

使用状況とバージョン マトリクスを確認してください。

WatchAnalytics 拡張機能は watchlist テーブルを利用して、個々のページとウィキ全体がどれだけよく守られているかの統計を表示し、また、放置されたページを見たりレビューしたりするように利用者を招待します。

開発の状態

現在、この拡張機能はベータ版品質と見なされています。この拡張機能のバージョンは、製作者の企業環境内で頻繁に使用されています。 新しいバージョンは、「安定版」と見なす前に、より良いテストと文書化が必要であり、今後の改良では、開発バージョンを安定したマスターバージョンから分離する必要があります。

さらに、この拡張機能をインターネットに公開されたWiki用に設定可能にすることは、現在のところほとんど考慮されていません。 すべての機能は企業での使用を念頭に置いて設計されており、これを安定的に呼ぶ前に、利用者のプライバシーを保護するための設定オプションが利用可能である必要があります。

インストール

  • ダウンロードして、ファイルをextensions/フォルダー内のWatchAnalyticsという名前のディレクトリ内に配置します。
  • 以下のコードを LocalSettings.php の末尾に追加します:
    require_once "$IP/extensions/WatchAnalytics/WatchAnalytics.php";
    
  • 更新スクリプトを実行します。このスクリプトは、この拡張機能が必要とするデータベーステーブルを自動的に作成します。
  • お好みで設定を変更してください
  •   完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

設定

変数
変数 既定 説明
$egWatchAnalyticsPageScoreNamespaces NS_MAIN, NS_TALK ページスコアを表示する名前空間を指定するための配列。
$egPendingReviewsEmphasizeDays 7 After how many days should the pending reviews link in the top-right become bigger and threateningly shake at the user. To disable this feature set this value to zero.
$egPendingReviewsNumberWatchSuggestions 20 How many pages to show in Pending Reviews. This should also be user-configurable.
$egPendingReviewsShowWatchSuggestionsIfReviewsUnder 5 When number of pending reviews is under this number, show Watch Suggestions. Set to zero to disable.
$egWatchAnalyticsWatchQualityColors "50" : "plaid",

"5" : "excellent",

"1.5" : "okay",

ページスコアの色付け方法を定義するために使用する配列。
$egWatchAnalyticsReviewStatusColors "5" : "excellent",

"3" : "okay"

ページスコアの色付け方法を定義するために使用する配列。
$egWatchAnalyticsPageCounter false
$egWatchAnalyticsShowUnreviewDiff true Set true to display page diff in yellow unreview banner on page. This makes it more obvious that a page is being reviewed when a user navigates to the page directly (not through Special:PendingReviews)
$egPendingReviewMaxDiffChar

$egPendingReviewMaxDiffRows

3500

15

Max number of Chars or Rows in a diff to show inline diff on Special:PendingReviews

利用者権限

  • To enable the Page Scores for users, they need to be granted the viewpagescore right (既定では管理者のみ有効です)。
  • To allow a user to clear reviews using Special:ClearPendingReviews, they need to be granted the clearreviews right (default: sysop).

使用法

Page scores

On each page in the main namespace (or any namespace added to the $egWatchAnalyticsPageScoreNamespaces variable) two scores are displayed near the heading which indicate how well the page is being watched in general (the "scrutiny") and the total number of people who have reviewed the latest version of the page. Clicking on these scores brings you to the PageStatistics special page.

 
Showing page scores added by Watch Analytics

Special:PageStatistics

Provides explanations of what "scrutiny" and "reviewers" mean. Below this it lists the page editors in order of number of revisions, who is watching the page, and whether or not they have reviewed the latest revision. At the bottom of the page it has a chart showing how many reviewers the page had at any given time in the past. In future versions this data will be used to determine an average length of time for the page to get n-reviewers, thus making it possible to find pages that tend to not be reviewed quickly.

Special:WatchAnalytics

The WatchAnalytics special page provides information about pages, users and the overall state of watchers on the wiki.

ページ情報

For pages it provides information like the number of people watching, the number people who have reviewed the latest revision, and the "watch quality" of the page. Watch quality refers to how well the watchers of the page do at quickly reviewing changes to the page. Right now the algorithm for this number is pretty poor, and in future uses it will hopefully provide better page scoring.

利用者情報

Provides similar information but for users. This includes how many pages the user is watching, how many pending reviews they have, how long their oldest review is, etc. This table can be filtered by user group and page category, which can be helpful to see how sub-organizations (e.g. creating a group type "Engineering") are doing at watching certain pages.

User-page relationship visualization

A D3.js force-directed graph showing how users are watching pages. Users are represented by orange dots around the outside, and pages are represented by blue dots. Lines between users and pages indicate that the user is watching the page. If the line is red it means that the user has not seen the most recent version of the page. Note that this visualization will not work well for very large wikis.

 
A D3.js force-directed graph showing the watch-relationship between users and pages.

Special:PendingReviews

This special page is a simplified version of Special:Watchlist. Special:Watchlist is very daunting for new editors and has a lot of unnecessary information even for seasoned editors. Pending Reviews shows which pages the user has not seen the latest version (of pages in the user's watchlist). These pages are prioritized by how important it is for the wiki to have the page reviewed, which right now is entirely determined by how many people have reviewed the page. In the future it will hopefully take into account revision scoring methods.

ApprovedRevs

If you have Extension:Approved Revs 1.0+ installed Special:PendingReviews will now show pages needing approval below your pending reviews. Clicking on the pending approval will show you the diff between the current edit and the last approved version of the page. There is also an "approve" button which allows you to approve the page from the diff page.

Compatibility: WatchAnalytics 3.0+ works on wikis that either don't have ApprovedRevs installed or have ApprovedRevs 1.0+. It will not work with earlier versions of approved revs.

Watch suggestions

利用者の保留中のレビューの一覧の下には、利用者が見るべき他のページの候補があります。これらは、利用者のウォッチリストにリンクされている、またはウォッチリストからリンクされているすべてのページを検索して決定されます。 これらのページは、ウォッチリストのページからのリンク数、現在のウォッチャーの数、ページのトラフィック量によってランク付けされます。したがって、ウォッチャーの数が少なく、トラフィックの多いページが高い優先順位を得られます。

Special:ClearPendingReviews

この特別ページでは 'clearreviews' 権限 (既定値: sysop) を持つ利用者が、カテゴリおよび/またはページ名に基づいて、一定期間の保留レビューを消去できるようにします。これは管理者が大量のレビューを作成するReplaceTextを使用するようなウィキで行われるメンテナンスに便利でしょう。

メンテナンス スクリプト

forgivePendingReviews.php
used to clear reviews. This script has not been used by the author in a long time, and users should only execute it after backing up their database. Make sure it does what you want before using.
watchAnalyticsRecordState.php
records the user and page watch state (how many watchers, how many pending, etc).

addCategoryToWatchlist.php

Adds every page in a category (or categories) to a user's (or multiple users') watchlist. Called like: php addCategoryToWatchlist.php --usernames=Jamesmontalvo3,Darenwelsh --categories="List of ISS Spacewalks,Astronauts"

今後の検討課題

  • 利用者の個人設定を追加し、「保留レビュー」を使用するかどうかを選択できるようにする
  • 保留中のレビューに表示する結果の数を利用者が選択できるようにする
  • Allow disabling of the force-directed graph visualization (since it may not work with large wikis)