Extension:Survey
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 |
|
|
|
|
Quarterly downloads | 3 (Ranked 129th) |
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üzdekiSurvey
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