Extension:GettingStarted

From mediawiki.org
This page is a translated version of the page Extension:GettingStarted and the translation is 89% complete.
MediaWiki manüel uzantıları
GettingStarted
Sürüm durumu: bakımsız
Uygulama Kullanıcı arayüzü, API
Açıklama Yeni düzenleyicilere görev önerileri sunar ve editörlere bu görevleri nasıl tamamlayacaklarını gösterir
Yazar(lar)
  • Munaf Assaf,
  • Matthew Flaschen,
  • Pau Giner,
  • Kaity Hammerstein,
  • Ori Livneh,
  • Rob Moen,
  • S Page,
  • Sam Smith,
  • Moiz Syed
En son sürüm Güncellemeler devam etmekte
MediaWiki 1.25+
Lisans GNU Genel Kamu Lisansı 2.0 veya üstü
İndir
  • $wgGettingStartedRedisSlave
  • $wgGettingStartedTasks
  • $wgGettingStartedRedisOptions
  • $wgGettingStartedRedis
  • $wgGettingStartedCategoriesForTaskTypes
  • $wgGettingStartedExcludedCategories
Quarterly downloads 5 (Ranked 159th)
Translatewiki.net adresinde mevcutsa, GettingStarted uzantısını çevirin
Sorunlar Açık görevler · Hata bildir

GettingStarted uzantısı Vikipedi'nin yeni düzenleyicileri için bir ilk katılım süreci sağlar.

Uzantı, yaklaşık 2014 yılında Büyüme ekibi tarafından dağıtıldı. Bununla birlikte, Ekim 2014'te Büyüme ekibi dağıldı ve o zamandan beri uzantının bazı yazarları odak noktasını değiştirdi. In October 2021, the extension was removed from Wikimedia wikis in favor of the newer GrowthExperiments extension.


Özellikler

UX/UI, Onboarding new Wikipedians sayfasında daha ayrıntılı olarak açıklandı

GettingStarted, yeni kaydolan editörlere giriş görevleri önermek için çeşitli arayüzler sağlar ve ilk düzenlemelerini nasıl tamamlayacaklarını göstermek için guided tours kullanır.

CentralAuth kuruluysa, GettingStarted kullanıcıları kayıt sonrası dahili kaynaklarına (veya yönlendirici yoksa ana sayfaya) yeniden yönlendirilir. Kullanıcılar geri gönderildikten sonra, onlara ya geçerli sayfayı düzenlemeleri ya da düzenlenmesi kolay bir şey önerisi almaları için bir davet verilir.

CentralAuth olmadan yukarıdakiler aynıdır, ancak tercihlerinizi değiştirmenize (veya geri dönmek için bir bağlantıyı tıklamanıza) izin veren standart çekirdek geçiş sayfası gösterilir. Dahili yönlendirenlerine bağlantı, bir GettingStarted parametresi içerecek şekilde değiştirilir (yukarıda belirtilen daveti tetikler).

Kurulum

  • Install the required dependencies:
  • Dosyaları indirin ve extensions/ klasörünüzdeki GettingStarted adlı dizine yerleştirin.
  • LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:
    wfLoadExtension( 'GettingStarted' );
    
  • Configure as required
  • Yes Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.

MediaWiki 1.27 veya önceki bir sürümü çalıştıran kullanıcılara:

Yukarıdaki talimatlar, bu eklentiyi wfLoadExtension() kullanarak kurmanın yeni yolunu açıklar. Bu uzantıyı önceki sürümlerine (MediaWiki 1.27 ve önceki sürümler) yüklemeniz gerekirse, wfLoadExtension( 'GettingStarted' ); yerine kullanmanız gerekir:

require_once "$IP/extensions/GettingStarted/GettingStarted.php";
CentralAuth is supported but not required.

Yapılandırma

The following configuration parameters are provided:

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

API

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:

  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

Ayrıca bakınız