Extension:Survey

From mediawiki.org
This page is a translated version of the page Extension:Survey and the translation is 100% complete.
MediaWiki manüel uzantıları
Survey
Sürüm durumu: deneysel
Uygulama Özel sayfa , API , Kullanıcı arayüzü, Ajax
Açıklama Anket, hizmetlilerin daha sonra belirli kullanıcı gruplarına gösterilebilecek anketleri tanımlamasına olanak tanıyan bir MediaWiki uzantısıdır.
Yazar(lar) Jeroen De Dauw
Sürdürücü(ler) WikiTeq team
En son sürüm 0.3.0 alpha (2014-04-02)
Uyumluluk politikası Uzun Süreli Destek sürümü olan her MediaWiki sürümü için uzantıda karşılık gelen bir dal vardır.
MediaWiki 1.39
PHP 7.0+
Veritabanı değişiklikleri Evet
Lisans GNU Genel Kamu Lisansı 2.0 veya üstü
İndir
README
  • $wgSurveySettings
  • surveyadmin
  • surveysubmit
Quarterly downloads 11 (Ranked 138th)
Translatewiki.net adresinde mevcutsa, Survey uzantısını çevirin
Sorunlar Açık görevler · Hata bildir

Survey uzantısı, hizmetlilerin daha sonra belirli kullanıcı gruplarına gösterilebilecek anketleri tanımlamasına olanak tanır. Şu anda desteklenen MediaWiki sürümünde işlevsel değildir.

Özelliklere genel bakış

  • Anketler, viki kullanıcılarına hoş bir pop-up formu kullanarak görüntülenir.
  • Anketler bir hizmet paneli aracılığıyla oluşturulabilir ve değiştirilebilir (Special:Surveys).
  • Anketler belirli kullanıcı türlerine gösterilebilir (oturum açmış, anonim, editör, onaylanmış,…)
  • Anketler, belirli bir kullanıcı yüzdesi için ve yalnızca belirli sayıda sayfa görüntülemesinden sonra gösterilebilir.
  • Anket soruları, bazıları cevapların kısıtlanmasına izin veren farklı türde girişlere sahip olabilir.
  • Anketler, vikide yayınlanmadan Special:TakeSurvey sayfasında hizmetlileri tarafından test edilebilir.
  • Anket başvurularının özetleri Special:SurveyStats sayfasında bulunabilir.
  • Anket gönderme verileri (yani kullanıcı cevapları) bir API yoluyla dışa aktarılabilir.

Kurulum

  • Dosyaları indirin ve extensions/ klasörünüzdeki Survey adlı dizine yerleştirin.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Survey
  • LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:
    wfLoadExtension( 'Survey' );
    
  • Bu uzantının ihtiyaç duyduğu gerekli veritabanı tablolarını otomatik olarak oluşturacak betik güncelleme komutunu çalıştırın.
  • Gerektiği gibi yapılandırın.
  • Yes Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.


Yapılandırma

Anket yapılandırması $egSurveySettings dosyanızdaki LocalSettings.php öğesine atanarak yapılır. Seçenekler aşağıda listelenmiştir ve varsayılan değerleri Anket ayarları dosyasında ayarlanır.

Ayarlar dosyasını DEĞİŞTİRMEMELİSİNİZ, ancak aşağıdaki açıklamaların yeterli olmaması durumunda, ayarları nasıl kullanacağınız hakkında bir fikir edinebilirsiniz.

Bir ayarın nasıl değiştirileceğine ilişkin örnek:

$egSurveySettings['defaultEnabled'] = true;

Kullanılabilir ayarlar:

Ad Tür Varsayılan Açıklama
defaultEnabled boolean false Anketlerin varsayılan olarak etkinleştirilmesi gerekiyorsa
defaultUserType Survey::$USER_ Survey::$USER_ALL Bir anketin varsayılan kullanıcı türü gösterilir
defaultNamespaces array array() Anketlerin gösterilmesi gereken varsayılan ad alanları. Ad alanı kısıtlaması olmayan boş liste
defaultRatio integer 100 Anketlerin gösterilmesi gereken varsayılan kullanıcı yüzdesi
defaultExpiry integer 60 * 60 * 24 * 30 Kullanıcıların anket tamamlanmasını saniye cinsinden izlemek için kullanılan çerezlerin varsayılan süresinin dolması
defaultMinPages integer 0 Ankete başlamadan önce kullanıcıların ziyaret etmesi gereken varsayılan minimum sayfa miktarı
JSDebug boolean false JavaScript hata ayıklamasının açık olup olmayacağını belirtir. Üretim ortamlarında yanlış olmalıdır.

Kullanım

Bu bölüm, anket oluşturmak ve yönetmek isteyen site hizmetlilerini hedeflemektedir. Kullanıcılar için anket yapma süreci açıklayıcı olmalıdır.

Anket oluşturma ve düzenleme

Anketler, Special:Surveys hizmetini haklarına sahip kişiler tarafından varsayılan olarak yalnızca hizmetliler oluşturulabilir, düzenlenebilir ve kaldırılabilir.

Test anketleri

Anketler, anket kullanıcı adını tıklayarak veya yönetici arayüzünde "bu ankete doldurun" ile test edilebilir. Bu sizi anket gönderimlerini test etmek için kullanabileceğiniz Special:TakeSurvey'e götürür. İstediğiniz kadar gönderebilirsiniz. Bu sayfaya yalnızca anket yöneticisi hakkına sahip kişiler erişebilir.

Anket dağıtma

Bir anket etkinleştirildiğinde, kullanıcı ölçütüyle eşleşen tüm kullanıcılar için viki çapında dağıtılır. Bu kullanıcıların anket etkinleştirilmeden önce minimum miktarda sayfayı ziyaret etmeleri gerekir; bu noktada bir piyango yapılır ve bu kullanıcıların yalnızca belirtilen yüzdesinin anketi almasını sağlar.

Bir anketi bir veya daha fazla sayfaya dağıtmak istiyorsanız, ‎<survey> etiketini her birine gömebilirsiniz. Aşağıdaki şekilde çağrılır:

<survey id="" ratio="" expiry="" min-pages="" />

Kimlik, "Special:TakeSurvey/" ifadesinden sonra gösterilen dize olan anketin kimliğiyle eşleşmelidir. Diğer özelliklerin her biri Özel: EditSurvey'de bulunan ayarlara karşılık gelir.

Anket etiketini kullanmanın her durumda düzgün çalışmayabilecek deneysel bir özellik olduğunu unutmayın.

Anketleri takip etme

Anket sonuçlarının bir özeti, hizmetli arayüzünden bağlanan Special:SurveyStats'ta bulunabilir. Buna yalnızca anket hizmetlisi hakkı olan kişiler erişebilir.

API üzerinden veri aktarma

Anket, şu 3 API modülünü kullanarak anketleri ve gönderim verilerini MediaWiki API aracılığıyla dışa aktarmanıza olanak tanır:

  • ApiQuerySurveys — sağlanan koşullara uygun anketler alın — api.php?action=query&list=surveys&suids=4|2
  • ApiQuerySurveySubmissions — anket için gönderimler alın — api.php?action=query&list=surveysubmissions&qsid=42
  • ApiQuerySurveyAnswers — cevapları alın (bir gönderideki her alan için 1 tane vardır) — api.php?action=query&list=surveyanswers&qaid=42

Bu modüller yalnızca surveyadmin hakkına sahip kişiler tarafından veri sorgulamak için kullanılabilir. Bu API modülleriyle ilgili tüm belgeleri vikinizdeki api.php adresinde bulabilirsiniz.

Sürüm

Sürüm 0.3.0 alfa, bu uzantıyı MediaWiki 1.23+ ile uyumluluk sağlama girişimidir.

Git içindeki sürüm notları bu noktada yalnızca 2.0 sürümüne kadar kapsar.

Uluslararasılaştırma

Anket tamamen uluslararasılaştırılmıştır. Anket mesajlarının çevirisi translatewiki.net sayfasında yapılır. Bu uzantı için çeviriyi burada bulabilirsiniz. Dil değerleri eklemek veya var olanları değiştirmek için translatewiki.net'te bir hesap oluşturmanız ve ardından bu sayfada belirli bir dili veya dilleri çevirmek için yöneticilerden izin istemeniz gerekir (bu çok basit süreç). Belirli bir dil için izniniz olduğunda, oturum açabilir ve o dilde olmasını istediğiniz iletileri ekleyebilir veya düzenleyebilirsiniz.

Yazarlar

Anket Jeroen De Dauw tarafından IEEE için WikiWorks danışmanı olarak yazılmıştır.

Ekran görüntüleri

Ayrıca bakınız