Extension:Survey

This extension is professionally maintained by the WikiTeq team.

WikiTeq provides official support for MediaWiki LTS releases only. It may work with other MediaWiki releases.

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	Uzantıyı indir Git [?]: Git master'ı indir depoyu göz at (Phabricator · GitHub) geçmişi işleyin veri deposu katkıda bulunanlar (GitHub) kod incelemesi README
Parametreler $wgSurveySettings
Eklenen haklar surveyadmin surveysubmit
Kullanılan kancalar LoadExtensionSchemaUpdates UnitTestsList ParserFirstCallInit ArticleViewHeader AdminLinks
Quarterly downloads	3 (Ranked 137th)
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.
•  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

• 
  Mevcut Special:Surveys listeleyen anketler
• 
  Special:EditSurvey , anketler için düzenleme arayüzüdür
• 
  Anketler kullanıcılara açılır ekran olarak görüntülenir ve Special:TakeSurveytest sayfasında edilebilir
• 
  Anket başvurularının özetleri Special:SurveyStats sayfasında bulunabilir