Extension:FlaggedRevs/ja

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

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


 * Ensure that image hashes are up-to-date by running the maintenance script. 例:


 * 記事閲覧数の集計を有効にする
 * 定期的な集計を設定します.  定期的に を実行するようcronジョブを作成します. スクリプトの実行に要する時間を確認し、あなたの指定した間隔でcronジョブを設定するために を実行します.  例：ユーザー として毎時 を実行するcronジョブを作成する場合.
 * 利用者を査読者に昇格させる.  FlaggedRevs の初回インストール後は、査読者のウィジェットは利用者からは不可視になります. これを修正するにはウィキのビューロクラットとしてログイン後、Special:UserRights を開き 1 人以上の利用者に査読者の権限を付与します.  査読者には、編集可能なページ末に査読者用ウィジェットが表示されます.
 * 利用者を査読者に昇格させる.  FlaggedRevs の初回インストール後は、査読者のウィジェットは利用者からは不可視になります. これを修正するにはウィキのビューロクラットとしてログイン後、Special:UserRights を開き 1 人以上の利用者に査読者の権限を付与します.  査読者には、編集可能なページ末に査読者用ウィジェットが表示されます.
 * 利用者を査読者に昇格させる.  FlaggedRevs の初回インストール後は、査読者のウィジェットは利用者からは不可視になります. これを修正するにはウィキのビューロクラットとしてログイン後、Special:UserRights を開き 1 人以上の利用者に査読者の権限を付与します.  査読者には、編集可能なページ末に査読者用ウィジェットが表示されます.

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

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


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

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

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

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

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


 * – どの名前空間で査読が可能になるかを設定します. 整数配列で、 既定の名前空間がどのような整数にマッピングされるかは  を参照してください. また、読みやすさのために定義された定数を使用してください.
 * – タグとその'levels'設定を設定します.
 * 定義
 * は、各タグ名に対応するキーを持つ連想配列です. 配列の唯一の意味のある値は、レビューレベルの数を制御する'levels'であり、配列は1つの要素のみを持つことができます.
 * ラベル付け
 * 各タグは 「MediaWiki:revreview-<タグ名>」ページを編集することで、ラベルを名付けることができます.
 * 各タグの各レベルは、「MediaWiki:revreview-<タグ名>-<レベル番号>」を編集することで、ラベルを名付けることができます.
 * 既定では、各タグは  配列で設定された名称でラベル付けされています.  これを上書きして、例えばタグを大文字の名前で表示するには、管理者がこれらのページを編集して、表示されている内容を変更する必要があります. 例えば、MediaWiki:revreview-accuracy


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


 * {|class="wikitable"

!タグ !レベル !ラベル名ページ !内容
 * rowspan=3|accuracy
 * 0
 * MediaWiki:revreview-accuracy-0
 * 1
 * MediaWiki:revreview-accuracy-1
 * 2
 * MediaWiki:revreview-accuracy-2
 * }
 * 2
 * MediaWiki:revreview-accuracy-2
 * }
 * MediaWiki:revreview-accuracy-2
 * }
 * }


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


 * {|class="wikitable"

!タグ名 !colspan=3|レベル名
 * }
 * }
 * }
 * }
 * }
 * }


 * – 安定版を既定のページ表示にするかどうか
 * – 各フラグをキーに、各利用者権限を持った人が設定できるレベルの最高値を値に設定した連想配列
 * 例
 * 例

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

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

ワークフロー

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

利用者の自動昇格

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

高度な設定

 * - Restriction levels for /  rights. When a level is selected for a page, an edit made by a user will not be auto-reviewed if the user lacks the specified permission. Levels are set at Special:Stabilization.
 * - Set this to use FlaggedRevs only as a protection-like mechanism (Help:Pending changes), rather than the standard configuration.
 * - Define when users get to have their own edits auto-reviewed. Set to false to disable.
 * - Whether to use stable versions of templates when rendering the stable version of a page.

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

使用法

 * 関連項目: 

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

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



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



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



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

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


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

注記

 * この拡張機能によって が有効化されます が、査読済み版は最近の更新において巡回済みとされます. つまり、査読可能な版を巡回するには、査読するしかないということです.  査読不可能なページは引き続き、そのサイトの巡回設定にしたがって巡回されます.
 * 管理者は特定のページに対して、安定版を既定で表示するページとするかどうかを変更できます. これを無効化するには、  内で   と指定してください.
 * ページヘのリンク、カテゴリ、画像、テンプレート、言語間リンクおよび外部リンクは、最新版に基づきます.
 * 査読できないページを移動することはできません. これは意図的なもので、を参照してください.  To work around this, add   to LocalSettings.php
 * 編集者権限を剥奪するには、一時的にはブロックを、永久的には Special:UserRights (特別:利用者権限) を使用してください. 降格の記録は、追跡のために追加で表示されます.

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

action=review
ページをレビューします.


 * パラメーター
 * : フラグを設定するリビジョンID
 * : A csrf token retrieved through
 * : レビューへのコメント（任意）
 * : Set the flag named "accuracy" to the specified value; (replace "accuracy" with the flag name to set another flag)
 * : If set, revision will be unapproved rather than approved


 * 例

action=stabilize
ページ安定化の設定を変更します.


 * パラメーター
 * : 安定化させるページのタイトル
 * : 安定化の理由
 * : 安定化の有効期限. デフォルト: 無限
 * : Whether to auto-review 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)
 * : 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)

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=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   or   line from
 * 1) Drop the tables in
 * 1) Drop the columns ,  , and  , and the index   from the   table (if they exist; only older versions of FlaggedRevs used these)
 * 1) Run   from the command line to flush out the stable version links
 * 1) 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