Extension:GettingStarted/ru

Справка по расширениям MediaWiki

GettingStarted Статус релиза: не поддерживается
Реализация	Пользовательский интерфейс, API
Описание	Delivers task suggestions to new editors and shows editors how to complete those tasks
Автор(ы)	Munaf Assaf, Matthew Flaschen, Pau Giner, Kaity Hammerstein, Ori Livneh, Rob Moen, S Page, Sam Smith, Moiz Syed
Последняя версия	Постоянные обновления
MediaWiki	1.25+
Лицензия	GNU General Public License 2.0 или позднее
Скачать	Скачать расширение Git [?]: скачать текущую версию исходника репозиторий (Phabricator · GitHub) история изменений список разработчиков (GitHub) code review
Параметры $wgGettingStartedRedisSlave $wgGettingStartedTasks $wgGettingStartedRedisOptions $wgGettingStartedRedis $wgGettingStartedCategoriesForTaskTypes $wgGettingStartedExcludedCategories
Используемые хуки ArticleDeleteComplete BeforePageDisplay CategoryAfterPageAdded CategoryAfterPageRemoved CentralAuthPostLoginRedirect GetPreferences MakeGlobalVariablesScript PostLoginRedirect ResourceLoaderGetConfigVars ResourceLoaderRegisterModules UserLogoutComplete
Ежеквартальные загрузки	5 (Ranked 157th)
Переведите расширение 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. In October 2021, the extension was removed from Wikimedia wikis in favor of the newer Расширение:GrowthExperiments extension.

Features

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)
• Скачайте и распакуйте файл(ы) в папку с названием GettingStarted в вашей папке extensions/.
• Добавьте следующий код в конце вашего файла 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";

CentralAuth is supported but not required.

Настройка

The following configuration parameters are provided:

• $wgGettingStartedTasks
• $wgGettingStartedCategoriesForTaskTypes
• $wgGettingStartedExcludedCategories
• $wgGettingStartedRedis
• $wgGettingStartedRedisSlave
• $wgGettingStartedRedisOptions
• $wgGettingStartedRunTest
• $wgvTaskRecommendationsExperimentV1StartDate
• $wgTaskRecommendationsExperimentV1EndDate

API

gettingstartedgetpages
Этот модуль не может быть использован в качестве генератора.
Префикс	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

api.php?action=query&list=gettingstartedgetpages&gsgptaskname=morelike&gsgpexcludedtitle=Earth&gsgpcount=10&format=json [попробуйте в ApiSandbox]

• Get a single random page that needs copy-editing.

api.php?action=query&list=gettingstartedgetpages&gsgptaskname=copyedit&gsgpcount=1 [попробуйте в ApiSandbox]

• Get three random pages needing copy-editing, in XML.

api.php?action=query&list=gettingstartedgetpages&gsgptaskname=copyedit&gsgpcount=3&format=xml [попробуйте в ApiSandbox]

Developer notes

Setting up the environment for automated browser testing

The extension's automated browser tests require that:

1. The $wgGettingStartedCategoriesForTaskTypes variable has been configured in InitialiseSettings.php ; and
2. 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)