Extension:GettingStarted
A request to archive this extension has been made on Phabricator. See タスク T292654 for the archival request and the rationale for the request, and to leave comments about the request. |
現在、この拡張機能は積極的な保守が行われていません! それでも機能する可能性はありますが、バグ報告や機能の要望は無視される可能性が高くなります。 この拡張機能の開発や保守の作業を引き受けることに興味がある場合は、リポジトリの所有権を申請できます。 礼儀として、作者に問い合わせることをお勧めします。 保守を引き継いだ場合、このテンプレートは除去すべきです。また、拡張機能ページの {{extension}} 基礎情報ボックス内のリストにあなたの名前を保守担当者として追加してください。 |
![]() リリースの状態: 保守されていない |
|
---|---|
実装 | ユーザー インターフェイス, API |
説明 | 登録したばかりの編集者を対象に、タスクの提案と完了する方法を送信する |
作者 |
|
最新バージョン | 継続的な更新 |
MediaWiki | 1.25+ |
ライセンス | GNU 一般公衆利用許諾書 2.0 以降 |
ダウンロード | |
|
|
Quarterly downloads | 5 (Ranked 160th) |
translatewiki.net で翻訳を利用できる場合は、GettingStarted 拡張機能の翻訳にご協力ください | |
問題点 | 未解決のタスク · バグを報告 |
GettingStarted拡張機能はウィキペディアの新人編集者に活動への案内onboarding process を提供します。
この拡張機能は Growth チーム により2014年頃に導入されました。 しかしながら同チームは同年10月に解散、またその後、拡張機能の執筆者数名は焦点を他に移しています。 In October 2021, the extension was removed from Wikimedia wikis in favor of the newer GrowthExperiments extension.
機能
- UX/UI (ユーザー体験・ユーザーインターフェース) の詳細はOnboarding new Wikipedians をご参照ください
GettingStartedは新しく登録された編集者にいくつかのインターフェースを提供し、guided tours を使い入門篇のタスクを提案して、最初の編集を完了する方法を示します。
CentralAuth (一括ログイン) 拡張機能をインストールしてある場合、GettingStartedの利用者はアカウント作成直前に閲覧していたページ(有効な戻り先がない場合はメインページ)に戻ることになっています。 その戻った先にて、利用者は2つの行動選択肢としてその時点で表示されている記事の編集もしくは編集が簡単な別の記事を提示されます。
CentralAuthを未利用の場合には、プロセスは上記と同じですが、標準的なコア機能の中間ページが表示され、個人設定を変更できます(またはリンクをクリックして戻ります)。 内部参照元へのリンクが変更され、GettingStartedパラメータを含むようになりました(上記の招待の誘因です)。
インストール
- Install the required dependencies:
- EventLogging (for logging)
- GuidedTour (for providing tours and tooltips)
- Redis (for maintaining its lists of articles)
- ダウンロードして、ファイルを
extensions/
フォルダー内のGettingStarted
という名前のディレクトリ内に配置します。 - 以下のコードを LocalSettings.php ファイルの末尾に追加します:
wfLoadExtension( 'GettingStarted' );
- Configure as required
- 完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。
MediaWiki 1.27以前を稼働させている利用者へ:
上記の手順では、wfLoadExtension()
を使用してこの拡張機能をインストールする新しい方法を記載しています。
この拡張機能をこれらの過去のバージョン (MediaWiki 1.27以前) にインストールする必要がある場合は、wfLoadExtension( 'GettingStarted' );
の代わりに以下を使用する必要があります:
require_once "$IP/extensions/GettingStarted/GettingStarted.php";
設定
The following configuration parameters are provided:
$wgGettingStartedTasks
$wgGettingStartedCategoriesForTaskTypes
$wgGettingStartedExcludedCategories
$wgGettingStartedRedis
$wgGettingStartedRedisSlave
$wgGettingStartedRedisOptions
$wgGettingStartedRunTest
$wgvTaskRecommendationsExperimentV1StartDate
$wgTaskRecommendationsExperimentV1EndDate
API
gettingstartedgetpages | |
---|---|
このモジュールは generator としては使用できません。 | |
接頭辞 | gsgp |
必要な権限 | なし |
POST のみ? | いいえ |
自動生成ヘルプ | 現行バージョン |
The extension implements a MediaWiki API query list submodule "gettingstartedgetpages" that supplies
- suggested pages to work on
- or simply related pages.
"Related pages" relies on the morelike:
prefix search feature of the Cirrus Search extension.
Suggested pages are optional for the GettingStarted new user experience and they only appear if the wiki has appropriate task categories set.
GettingStarted stores lists of articles in Redis, populating them from on-wiki categories such as English Wikipedia's All articles needing copy edit according to the configuration in $wgGettingStartedCategoriesForTaskTypes
. You may also exclude certain categories via $wgGettingStartedExcludedCategories
.
On the Wikimedia cluster, configuration settings in InitialiseSettings.php determine their value.
View the generated API documentation for the gettingstartedgetpages API module on English Wikipedia. The following are examples of types of pages you request from the API:
- Get 10 random pages, related to Earth
- Get a single random page that needs copy-editing.
- Get three random pages needing copy-editing, in XML.
Developer notes
- Setting up the environment for automated browser testing
The extension's automated browser tests require that:
- The
$wgGettingStartedCategoriesForTaskTypes
variable has been configured in InitialiseSettings.php ; and - The
populate_categories.php
maintenance script has been run.
For example, if and when the extension's nightly build starts failing because there aren't any suggestions (see https://phabricator.wikimedia.org/diffusion/EGST/browse/master/tests/browser/features/modal_on_editable_returnto.feature$10), then run the populate_categories.php
maintenance script on the Beta Cluster, i.e.
ssh deployment-tin.deployment-prep.eqiad.wmflabs
foreachwikiindblist gettingstarted-with-category-suggestions.dblist extensions/GettingStarted/maintenance/populate_categories.php
関連項目
- List of MediaWiki messages used (English Wikipedia version)