Extension:GettingStarted/zh
GettingStarted 发布状态: 稳定版 |
|
---|---|
实现 | 用户界面, API |
描述 | Delivers task suggestions to new editors and shows editors how to complete those tasks |
作者 |
|
最新版本 | Continuous updates |
MediaWiki | 1.25+ |
许可协议 | GNU通用公眾授權條款2.0或更新版本 |
下载 | |
|
|
翻譯GettingStarted擴充功能如在translatewiki.net可用 | |
问题 | 尚未完成的工作 · 回報錯誤 |
The GettingStarted extension provides an onboarding process for new editors of Wikipedia.
The extension was deployed by the Growth team circa 2014. However, in October, 2014, the Growth team disbanded and since then a number of the extension's authors have shifted focus. The extension is still maintained by Sam Smith.
功能
- UX/UI described in more detail at Onboarding new Wikipedians
GettingStarted provides several interfaces for suggesting introductory tasks to newly-registered editors, and it uses guided tours to show them how to complete their first edits.
If CentralAuth is installed, GettingStarted users are redirected back to their internal referrer (or the main page, if there was no referrer) post-registration. After users are sent back, they are provided with an invitation to either edit the current page or take a suggestion of something easy to edit.
Without CentralAuth, the above is the same, but the standard core interstitial page letting you change your preferences (or click a link to return) shows. The link to their internal referrer is modified to include a GettingStarted parameter (triggering the above-mentioned invitation).
安装
- 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
完成 – 在您的wiki上导航至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)
![]() | 此扩展被用于一个或多个维基媒体项目上。 这可能意味着扩展稳定且工作良好,足以用在同等高流量的网站上。 请在维基媒体的CommonSettings.php和InitialiseSettings.php配置文件中寻找此扩展名称以查看安装它的网站。 详细的已安装扩展的完整列表可在wiki的Special:Version页面找到。 |
- Stable extensions/zh
- User interface extensions/zh
- API extensions/zh
- GPL licensed extensions/zh
- Extensions in Wikimedia version control/zh
- ArticleDeleteComplete extensions/zh
- BeforePageDisplay extensions/zh
- CategoryAfterPageAdded extensions/zh
- CategoryAfterPageRemoved extensions/zh
- CentralAuthPostLoginRedirect extensions/zh
- GetPreferences extensions/zh
- MakeGlobalVariablesScript extensions/zh
- PostLoginRedirect extensions/zh
- ResourceLoaderGetConfigVars extensions/zh
- ResourceLoaderRegisterModules extensions/zh
- UserLogoutComplete extensions/zh
- All extensions/zh
- Extensions used on Wikimedia/zh
- Growth/zh