Extension:FlaggedRevs/ja

FlaggedRevisions拡張機能を使うと、編集者(Editor)および査読者(Reviewer)は記事の各版を格付けし、どの特定の版を既定として通常のページ表示に用いるか設定できます. これらの版は、読み込まれたテンプレートや画像が変更されても、そのまま残ります. これはつまり、MediaWikiを、よりコンテンツマネージメントシステムらしくするものです.

導入
下記の手順で FlaggedRevs をインストールしてください:

'''あなたが現在利用している MediaWiki の版が1.17版あるいはそれ以降の版であることを確認してください. '''もしそうでないならば FlaggedRevs をインストールする前に、MediaWiki をアップグレードすることが必要です.
 * 1) FlaggedRevs をダウンロードする あなたが現在使っているMediaWikiの版に適応する版のFlaggedRevsを選んでください. 例えば、あなたがMediaWiki 1.17を使っているならば、FlaggedRevs 1.17をダウンロードしてください.
 * 2) 利用者のインストールした MediaWiki の ディレクトリにダウンロードした版を抽出. サンプルを示します.
 * 3) 画像のハッシュの更新を保つため、管理スクリプトのpopulateImageSha1.phpを走らせます . 次に例を示します.
 * 4) 必ず  ディレクトリをウェブサーバから可読に保ちます (するとウェブサーバから FlaggedRevs CSS や画像、JavaScript が供給されます).  例：ウェブサーバの利用者が ディレクトリのオーナー ではない という前提で、次を走らせます.
 * 5) 記事閲覧数の集計を可能にします. 
 * 6) オンデマンドの集計を無効にします.    を  に追加します.  これは記事のアクセスごとに集計を実行しないようにします (さもないと統計が最新版でない多くの記事に同時多発のアクセスが発生した場合にパフォーマンス低下を誘発しかねません. )
 * 7) 定期的な集計を設定します.  定期的に を実行するようcronジョブを作成します.    を実行し、スクリプトが利用者のcronジョブを走らせて指定した間隔に設定するのに費やす時間を確認します.  一例として、cronジョブの作成により利用者 として毎時、 を実行する場合.
 * 1) 記事閲覧数の集計を可能にします. 
 * 2) オンデマンドの集計を無効にします.    を  に追加します.  これは記事のアクセスごとに集計を実行しないようにします (さもないと統計が最新版でない多くの記事に同時多発のアクセスが発生した場合にパフォーマンス低下を誘発しかねません. )
 * 3) 定期的な集計を設定します.  定期的に を実行するようcronジョブを作成します.    を実行し、スクリプトが利用者のcronジョブを走らせて指定した間隔に設定するのに費やす時間を確認します.  一例として、cronジョブの作成により利用者 として毎時、 を実行する場合.


 * 1) に以下の行を追加してFlaggedRevs を実行可能に設定します.
 * 2)  を実行、MediaWiki のデータベースのスキーマを更新.  これは前項の段階を保存した 後で 実行します. さもないとどのページにアクセスしてもデータベースエラーを返します.
 * 3) 利用者を査読者に推薦.  FlaggedRevs の初回インストール後は、査読者のウィジェットは利用者からは不可視になります.  これを修正するにはウィキのビューロクラットとしてログイン後、Special:UserRights を開きひとりまたは複数の利用者に権限を付与します.  査読者には、編集可能なページ末に査読者用ウィジェットが表示されます.
 * 1) 利用者を査読者に推薦.  FlaggedRevs の初回インストール後は、査読者のウィジェットは利用者からは不可視になります.  これを修正するにはウィキのビューロクラットとしてログイン後、Special:UserRights を開きひとりまたは複数の利用者に権限を付与します.  査読者には、編集可能なページ末に査読者用ウィジェットが表示されます.

利用者権限と利用者グループ
何も設定していない場合は、誰も何も査読することができないため、最初に利用者権限を設定する必要があります.

利用者権限
FlaggedRevsは、以下の利用者権限を新しく追加します.
 * – この権限を有する利用者は、各版を査読することができます.
 * – この権限を有する利用者は、各版を査読し、すべてのタグを任意のレベルに設定出来ます.
 * – この権限を有する利用者によって作成されたすべての版は、自動的に査読済みとなります.
 * – 当該の利用者による差し戻しの自動巡回.
 * – この権限を有する利用者は、特別:未査読ページ一覧を見ることができます.
 * – 利用者は安定版のいずれのページも設定を変更できます
 * – 利用者は安定版のいずれのページも移動できます

利用者グループ
FlaggedRevsは、以下の利用者グループを新しく追加します.


 * – MediaWiki 標準の利用者権限  に加えて、  の権限を持ちます
 * –  の権限に加えて、MediaWiki の標準的な利用者権限   を持ちます
 * – の権限を持ちます.

利用者権限の割り当て
利用者権限は以下の2つの方法で各利用者に割り当てることができます.

で既に設定されている利用者グループへ、これらの権限を割り当てる方法です.
 * 既存の利用者グループへの割り当て

特別:利用者権限を使って、利用者アカウントを手動で特定のグループに追加します.
 * 特定の利用者への割り当て
 * 既定の設定では：
 * ビューロクラットは、査読者(Reviewer)を追加・除去できます.
 * 管理者は、自動査読者(Autoreviewer)および編集者(Editor)を追加・除去できます.

基本的な設定
FlaggedRevs.phpは多くの設定可能な変数を追加します. これらの変数はLocalSettings.php内で設定してください


 * – どの名前空間で査読が可能になるかを設定します. 整数配列で、 どの整数番号がどの名前空間に対応しているかは、includes/Defines.php などを確認してください.
 * – 各タグの「levels」「quality」「pristine」を設定します.
 * 定義
 * は、各タグ名をキーとし、それらの「levels」「quality」「pristine」の設定配列を値とした連想配列です.
 * 'levels'では、査読レベルの数を設定します
 * 'quality'では、どのレベルが「」(quality)とされるかを設定します
 * 'pristine'では、どのレベルが「」(pristine)とされるかを設定します
 * ラベル付け
 * 各タグは 「MediaWiki:revreview-<タグ名>」ページを編集することで、ラベルを名付けることができます.
 * 各タグの各レベルは、「MediaWiki:revreview-<タグ名>-<レベル番号>」を編集することで、ラベルを名付けることができます.
 * 例
 * 例えば、「正確性」(accuracy)、「内容の深さ」(depth)、「語調」(tone)の3つのタグにそれぞれ3段階のレベルを設定したいとします.
 * また、「正確性」(accuracy)と「内容の深さ」(depth)の、レベル2以上を「」(quality)と認定したいとします. この時の設定は以下のようになります.
 * 既定では、各タグは$wgFlaggedRevsTags配列で設定された名称でラベル付けされています. つまりこの例では、各タグは「accuracy」「depth」「tone」と表示されます.
 * ここで、例えば名称を変更したい場合、以下のページを編集することで設定できます.
 * {|class="wikitable"
 * {|class="wikitable"

!タグ !ラベル名ページ !内容
 * accuracy
 * MediaWiki:revreview-accuracy
 * depth
 * MediaWiki:revreview-depth
 * tone
 * MediaWiki:revreview-tone
 * 語調(Tone)
 * }
 * tone
 * MediaWiki:revreview-tone
 * 語調(Tone)
 * }
 * }


 * タグのレベル名を設定するには、以下のページを編集することで設定できます.


 * {|class="wikitable"

!タグ !レベル !ラベル名ページ !内容
 * rowspan=3|accuracy
 * 0
 * MediaWiki:revreview-accuracy-0
 * 1
 * MediaWiki:revreview-accuracy-1
 * 2
 * MediaWiki:revreview-accuracy-2
 * rowspan=3|depth
 * 0
 * MediaWiki:revreview-depth-0
 * 1
 * MediaWiki:revreview-depth-1
 * 2
 * MediaWiki:revreview-depth-2
 * rowspan=3|tone
 * 0
 * MediaWiki:revreview-tone-0
 * 弱(Weak)
 * 1
 * MediaWiki:revreview-tone-1
 * 良(Good)
 * 2
 * MediaWiki:revreview-tone-2
 * 秀(Excellent)
 * }
 * rowspan=3|tone
 * 0
 * MediaWiki:revreview-tone-0
 * 弱(Weak)
 * 1
 * MediaWiki:revreview-tone-1
 * 良(Good)
 * 2
 * MediaWiki:revreview-tone-2
 * 秀(Excellent)
 * }
 * 2
 * MediaWiki:revreview-tone-2
 * 秀(Excellent)
 * }


 * これらの設定のまとめは次のようになります.


 * {|class="wikitable"

!タグ名 !colspan=3|レベル名
 * 語調(Tone)
 * 弱(Weak)
 * 良(Good)
 * 秀(Excellent)
 * }
 * 語調(Tone)
 * 弱(Weak)
 * 良(Good)
 * 秀(Excellent)
 * }
 * 語調(Tone)
 * 弱(Weak)
 * 良(Good)
 * 秀(Excellent)
 * }
 * }


 * – 安定版を既定のページ表示にするかどうか
 * – 各フラグをキーに、各利用者権限を持った人が設定できるレベルの最高値を値に設定した連想配列
 * 例
 * – ページ名の配列で、 これらのページはFlaggedRevsの対象からは除外されます. 査読はできなくなり、UIも元の状態に戻ります.  ページ名中の空白はアンダーバー(_)に変更してください（例："Main page" -> "Main_page"）
 * – ページ名の配列で、 これらのページはFlaggedRevsの対象からは除外されます. 査読はできなくなり、UIも元の状態に戻ります.  ページ名中の空白はアンダーバー(_)に変更してください（例："Main page" -> "Main_page"）
 * – ページ名の配列で、 これらのページはFlaggedRevsの対象からは除外されます. 査読はできなくなり、UIも元の状態に戻ります.  ページ名中の空白はアンダーバー(_)に変更してください（例："Main page" -> "Main_page"）

ユーザー インターフェイス

 * – 有効化されると、アイコン表示されたUIが使用されます. 編集モードでのタグは変更されません.
 * – 最新版が査読されている場合、査読状況を示すボックス・バーを隠すかどうかを設定できます. これらに関する説明文も除去されます.

ワークフロー

 * – この利用者グループに属する利用者には、既定で最新版（下書き版）を表示します.
 * – 有効化された場合、「autoreview」権限を持つ利用者によるすべての編集は、保存と同時に自動的に査読済みになります. 「査読を送信」ボタンを押す必要はありません.  ただし、自動査読が実行されるためには、それより前の版が査読されている必要があり、未査読の版がある場合は発動しません.
 * – が有効化されている場合に、自動査読された場合にどのタグがどのレベルとして評価されるのかを設定します.  許可されていると、以前の版のタグレベルと同じレベルに設定されます.  これは連想配列で、各キーがタグで、各値がタグのレベルです.
 * 例

利用者の自動昇格

 * – 配列のキーとして次の項目を使用します. 日付、編集回数、時間の頻度、ベンチマーク、eメール確認、コンテンツページの最近の更新、コンテンツ編集の合計回数、編集したコンテンツページ総数、編集要約欄の使用状況、IP の独自性、利用者ページの有無. 値は右記の項目を表します. 特定の利用者アカウントが編集者資格に自動で推薦される条件となる日数／編集回数、さらにeメール確認と利用者ページの有無が必須条件かどうか.  当該の利用者はX 件以上の編集を Y 日以上の間隔を挟んで実施するものと規定され、ベンチマーク数を X、日数を Y にそれぞれ充当します.  すべて無効にするには、この変数を false に設定.
 * 例
 * $wgFlaggedRevsAutopromoteは例えば以下のように設定出来ます
 * 例
 * $wgFlaggedRevsAutopromoteは例えば以下のように設定出来ます

高度な設定
FlaggedRevs.phpに設定可能な選択肢の完全な一覧があります（いくつかは説明コメント付きです）. ただし、このファイルを編集するのではなく、LocalSettings.phpで設定するよう注意してください.

利用者以外は記事の安定版のみを閲覧できるようにするには、 を参照してください.

使用法

 * 関連項目: 

ページの承認
査読権限を持つ利用者には、ページ表示の際 (ページの下部) や差分表示の際 (ページの上部) に小さな格付けフォームが表示され、それを使用して版の査読をすることができます. 各タグは、少なくとも承認できる最低レベルを満たしている必要があります. 査読前に、利用者はテンプレートや画像を含むページ全体を確認する必要があります. 「(安定版との差分)」を使えばこの作業をより早く実行できるでしょう.

利用者は、編集できないページを査読することはできません. また、設定できないレベルより下に、レベルを下げることもできません. もちろん、ブロックされた利用者はなにもできません.



Special:StableVersions(特別:安定版)では、査読済みのすべての版や、個別ページの査読済み版の一覧をみることができます.



保存
Special:UnreviewedPages(特別:未査読ページ一覧)では、未査読なページの一覧が表示されます（編集者のみが使用できます）. 表示する名前空間を指定する必要があり、カテゴリを指定することもできます.



Special:OldReviewedPages(特別:保留中の変更)では、査読済みだが編集が保留されているページの一覧が表示されます （編集者のみが使用できます）. 表示するカテゴリを指定することもできます.



査読できないページも、編集者によって（主に荒らし対策の目的で）引き続き巡回することもでき、巡回された一覧も表示できます.

主要な査読レベルに達した査読済みページの一覧は特別:査読済みページ(Special:Reviewedpages)で見ることができます.



記録
すべての関連操作は永久的に記録されるため、すべて後から追跡したり確認することができます.


 * 編集者など各グループへの追加・除去の記録は'Special:Log/userrights'(特別:記録/&lt;グループ名>)で確認できます.
 * 版の承認・非承認の記録は'Special:Log/review'(特別:記録/review)に保存されています.
 * 安定版の設定変更記録は'Special:Log/stable'(特別:記録/stable)に表示されます.

Special:QualityOversight(特別：上級査読記録)では、良質(quality)レベルとなった版の記録のみを見ることができます. 承認や確認で記録が流れてしまう場合に有用です.

注記

 * この拡張機能によって が有効化されます が、査読済み版は最近の更新において巡回済みとされます. つまり、査読可能な版を巡回するには、査読するしかないということです.  査読不可能なページは引き続き、そのサイトの巡回設定にしたがって巡回されます.
 * 管理者は特定のページに対して、良質認定が優先されるかどうか、安定版を既定で表示するページとするかどうかを変更できます. この機能を無効化するにはlocalsettings.php内で と指定してください.
 * ページヘのリンク、カテゴリ、画像、テンプレート、言語間リンクおよび外部リンクは、最新版に基づきます.
 * 査読できないページを移動することはできません. This is deliberate; see T15994. To work around this, add   to LocalSettings.php
 * 編集者権限を剥奪するには、一時的にはブロックを、永久的には Special:UserRights (特別:利用者権限) を使用してください. An extra demotion log item will appear for tracking purposes.

API
FlaggedRevs adds API modules for reviewing revisions and configuring "stabilization" of pages, a module for retrieving flag configuration, and three list modules corresponding to the special pages for reviewed pages, unreviewed pages and "old" reviewed pages.

Some more API documenation is at Extension:FlaggedRevs/API.

action = review
Reviews a page.


 * パラメーター
 * : The revision ID for which to set the flags
 * : A csrf token retrieved through
 * : Comment for the review (optional)
 * : Set the flag named "accuracy" to the specified value; (replace "accuracy" with the flag name to set another flag)


 * 例

action = stabilize
Changes page stabilization settings.


 * パラメーター
 * : Title of page to be stabilized
 * : Reason for stabilization
 * : (Deprecated?) Stabilization expiry. Default: infinite
 * : Whether to auto-review the page
 * : Whether to watch the page
 * : An edit token retrieved through
 * For protection-like configurations :
 * : The right users must have in order for their edits to not require review.
 * Otherwise :
 * : Default revision to show (latest | stable)
 * : Which stable revision should be shown (pristine | quality | latest). Default: quality
 * : Restriction level for the 'autoreview' right (sysop | none). Default: none


 * 例

action = flagconfig
Shows information about review flag configuration.

The following parameters are returned for each tag:
 * : the name of the flag
 * : the number of possible levels the flag has (not counting the "unreviewed" level)
 * : level the flag must be for the revision to be considered "quality"
 * : level the flag must be for the revision to be considered "pristine"

The displayed name for each flag and the different level names for each flag are MediaWiki messages, so can be set and retrieved through the appropriate page; for example the name for the first level of the "accuracy" flag is located at MediaWiki:revreview-accuracy-1.


 * 例

list = reviewedpages
Lists pages that have been reviewed.


 * パラメーター
 * : Start listing at this page id.
 * : Stop listing at this page id.
 * : In which direction to list.
 * : The namespaces to enumerate.
 * : How to filter for redirects
 * : How to filter by quality (0=sighted,1=quality)
 * : How many total pages to return.


 * 例

list = unreviewedpages
Lists pages which have never been reviewed.


 * パラメーター
 * : Start listing at this page title.
 * : Stop listing at this page title.
 * : The namespaces to enumerate.
 * : How to filter for redirects
 * : How to filter by quality (0=sighted,1=quality)
 * : How many total pages to return.


 * 例

list = oldreviewedpages
Lists pages that have at some point been reviewed, but for which the most recent revision is not reviewed.


 * パラメーター
 * : Start listing from this timestamp
 * : Stop listing at this timestamp.
 * : In which direction to list.
 * : The namespaces to enumerate.
 * : How to filter for redirects
 * : How many total pages to return.


 * 例

prop=flagged
Use action=query&prop=flagged to get information about the flagging status of the given pages.

制限

 * ウィキを横断した読み込みは対象外になります.
 * 外部画像（コモンズは除く）も対象外です.
 * 査読者が閲覧した時間と査読した時間で条件が変化し、他のテンプレートを読み込むような上位テンプレートがあるかもしれません. ゆえに、この異なったテンプレートが読み込まれる版のIDへのポインターは存在しません. もしこのようなことになった場合は、査読中に通知されます.

アンインストール

 * 1) Remove the include line from
 * 2) Drop the tables in.
 * 3) Drop the columns ,  , and  , and the index   from the   table (if they exist; only older versions of FlaggedRevs used these)
 * 4) Run   from the command line to flush out the stable version links
 * 5) Run   from the command line if you use

試験プラットフォーム

 * 
 * 
 * 

関連項目

 * – edits remain private until they're approved
 * Flagged Revisions
 * – documentation about the user groups and rights created by this extension, while it was at use on mediawiki.org
 * – edits remain private until they're approved
 * Flagged Revisions
 * – documentation about the user groups and rights created by this extension, while it was at use on mediawiki.org

外部リンク

 * Quality Assurance in an Open Project – 2008 Wikimedia blog post
 * Images of Flagged Revisions – ウィキメディア・コモンズ
 * About Flagged Revisions – メタ・ウィキ

ライセンス
© GPL, Aaron Schulz, Joerg Baach, 2007