Extension:Page Forms/Input types/tr

Bu sayfa, Page Forms'da bulunan çeşitli giriş türlerini ve bunlar için ayarlanabilen parametreleri ve diğer özelleştirmeleri kapsar.



text
Varsayılan giriş türü; HTML "metin" girişine karşılık gelir.

Özel parametreler:

textarea
HTML etiketine karşılık gelir.

Özel parametreler:



Otomatik tamamlamayla metin, metin alanı otomatik tamamlamayla
Bu iki giriş 5.0 sürümünde "combobox" ve "tokens" için takma adlara dönüştürüldü. Önceki sürümler için, bunlar  ve   giriş türleriyle aynı şekilde görüntülenir ve aynı şekilde yapılandırılabilir, ancak aynı zamanda bir veya birden çok değerde otomatik tamamlama sağlarlar. Otomatik tamamlamanın nasıl özelleştirileceğini öğrenmek için aşağıdaki "Değerleri ve eşlemeleri ayarlama" ve "Otomatik tamamlama" sayfalarına bakın.

combobox
"Comboox" giriş türü bir combo box arabirimi sağlar: normal bir otomatik tamamlama alanı gibi işlev gören, ancak açılır listeninki gibi ek bir aşağı ok simgesi olan bir girişi, kullanıcı tüm mevcut değerleri aynı anda görür. Select2 JavaScript kitaplığı kullanılarak uygulanır.

Özel parametreler:

tokens
Bu girdi türü, alandaki değerleri "tokenizes" haline getirir, yani her bir değerin etrafına bir blok koyar ve onu yalnızca bir karakter dizisi yerine tek bir birim haline getirir. Bu "tokens" daha sonra yeniden düzenlenebilir. "combobox" gibi, bu girişi Select2 JavaScript kitaplığı kullanılarak gerçekleştirilir.

Özel parametreler:

Varsayılan olarak, "tokens" tek satırlı bir girdi olarak görünür ve daha fazla değer eklendikçe gerekirse dikey olarak genişler. Bazı durumlarda, genişleyeceğini kullanıcılara daha açık hale getirmek için, bu girişinin başladığında bir satırdan daha uzun görünmesini isteyebilirsiniz. Bunu tek bir giriş için yapmak için, alan etiketine " " gibi bir  parametresi ekleyin, ardından MediaWiki:Common.css ile aşağıdakine benzer bir şey ekleyin:

Bunun vikideki tüm "tokens" girişlerine uygulanmasını istiyorsanız, bunun yerine MediaWiki:Common.css ile şöyle bir şey ekleyin:

radiobutton
"radiobutton" girişi HTML "radio" girişine karşılık gelir. Kullanıcının yalnızca birini seçebileceği bir dizi değeri gösterir.

Varsayılan olarak, ilk radyo düğmesi değeri "None" ve kullanıcının boş bir değer seçmesine izin verir. "None" görünmesini önlemek için, alanı "mandatory" yapmanın yanı sıra izin verilen değerlerden birini alanın "default=" değeri yapmalısınız.

dropdown
"dropdown" giriş, HTML &lt;select&gt; etiketine karşılık gelir. Kullanıcının yalnızca birini seçebileceği bir açılır değerler listesi gösterir.

checkboxes
"checkboxes" girişi, kullanıcının herhangi bir sayıda değer seçmesine izin veren onay kutularını görüntüler. Belirli bir sayıdan fazla onay kutusu varsa, "Tümünü seç" ve "Hiçbirini seçme" bağlantıları otomatik olarak onay kutuları kümesinin üzerinde görünerek kullanıcıların tümünü veya hiçbirini otomatik olarak işaretlemelerine olanak tanır. Bu sayı  değişkeni tarafından belirlenir, varsayılan olarak 10'dur, ancak LocalSettings.php içinde değiştirilebilir.

Özel parametreler:

listbox
"listbox" girişi, "multiple" özniteliği eklenmiş HTML &lt;select&gt; etiketine karşılık gelir. Kullanıcının herhangi bir sayıda değeri seçebileceği dikey bir seçenek listesi gösterir.

Özel parametreler:

tree
"tree" giriş türü, alanın bir veya daha fazla öğeyi tutup tutamayacağına bağlı olarak tüm değerlerin yanlarında radiobuttons veya checkboxes olduğu hiyerarşik, ağaç tarzı bir girişe izin verir. Değerler, viki içindeki bir kategori ağacından gelebilir veya form tanımında manüel olarak ayarlanabilir.

Bu giriş, bir veya daha fazla değeri tutup tutamayacağını nasıl anlar ve bu nedenle radyo düğmelerini ve onay kutularını görüntülemelidir? Şablondaki alanın bir değerler listesi tutuyor olarak tanımlanıp tanımlanmadığını (#arraymap kullanarak) kontrol eder. Yine de bu kontrol mükemmel değil. tree girişi checkboxes yerine radiobuttons gösteriyorsa, bunun bir liste olduğunu belirlemek için form tanımındaki alan etiketine "|list" parametresini eklemeniz yeterlidir.

Değerlerin kaynağına bağlı olarak, şu iki ek parametreden birini belirtmeniz gerekir:


 * - kategorinin adını "ağacın" tepesine ayarlar.
 * - tüm ağaç yapısını ayarlar; derinlik seviyesini ayarlamak için vikimetin tarzı madde işaretleri kullanmalısınız.

"structure" parametresini kullanırsanız, aşağıdaki gibi görünmelidir:

Ayrıca isteğe bağlı olarak şu parametreleri de ayarlayabilirsiniz:


 * - ağacın içinde göründüğü kutunun yüksekliğini piksel cinsinden ayarlar.
 * - ağacın içinde göründüğü kutunun genişliğini piksel cinsinden ayarlar.
 * - alan bir değerler listesi içerebileceği zaman sınırlayıcıyı ayarlar. Varsayılan ','.
 * - üst kategorinin adını gizler.
 * - başlangıçta gösterilen üç seviyenin sayısını ayarlar. Varsayılan 10.

Bu giriş türünü burada kullanan örnek bir form görebilirsiniz.



Kategori adları için
Bir kategori ağacını görüntülemek için "tree" giriş türünü kullanıyorsanız, bu girişin önünde "Kategori:" ad alanı olmadan yalnızca seçilen kategorilerin adlarını yazdıracağını unutmayın; bu nedenle, bunun sayfada da görünmesini istiyorsanız, şablonun onu eklemesi gerekecektir.

Alan birden fazla kategori belirtiyorsa ve şablon bunu yapmak için #arraymap kullanıyorsa, #arraymap çağrısı şunun gibi görünmelidir:

...başka bir deyişle, kategori etiketleri arasına virgül yazdırmaktan kaçınmak için #arraymap için son "delimeter" parametresini belirtmeniz ve onu boşluk veya benzeri bir şey yapmanız gerekir.

checkbox
Boole değerleri için kullanılan tek bir onay kutusu.

Özel parametreler:

date
Bu giriş, yıl, ay ve gün için üç ayrı giriş içerir.

datetime
"datetime" girişi "date" girişine benzer, ancak saat, dakika, saniye ve ÖÖ/ÖS için ek girişler içerir.

Özel parametreler:

year
"year", bir tarih alanı için yalnızca yıllık bir değer elde etmek için kullanılan basit bir metin girişidir.

datepicker
"datepicker", kullanıcının JavaScript tabanlı bir açılır pencere takvimi yardımıyla bir tarih seçmesine izin verir.

Special parameters:

The starting day of the week (e.g., Saturday, Sunday or Monday) is set based on the language of the wiki; it unfortunately cannot be set independently of the language. If your wiki is in English and you would like weeks in the calendar input to start on Monday instead of Sunday (which is the default), you can do that by setting your wiki's language to be "en-gb" instead of "en".

datetimepicker
"datetimepicker", "datepicker" ile çok benzeyen JavaScript tabanlı bir girdi türüdür, ancak hem tarih hem de saati seçmek için açılır pencereler içerir. Varsayılan olarak  şeklindedir. Parametre seti, aşağıdakilerin yanı sıra tümü "datepicker" ile içerir:

rating
"rating" giriş türü, kullanıcının bir derecelendirme girmesine izin vermek için bir dizi yıldız görüntüler.

Özel parametreler:

googlemaps, leaflet, openlayers
"googlemaps", "leaflet" ve "openlayers" girdi türleri, sırasıyla Google Maps, Leaflet veya OpenLayers hizmetlerini kullanarak bir koordinat değeri elde etmek için bir harita görüntülemenizi sağlar.

"googlemaps" girişini kullanıyorsanız, bir Google Haritalar API anahtarı almanız ve ardından girdinin görüntülenmesi için  ayarıyla LocalSettings.php olarak ayarlamanız gerekebilir.

Bu giriş türleri için isteğe bağlı olarak şu parametreleri de ayarlayabilirsiniz:

"leaflet" giriş türü bir ek parametreye izin verir:

Tüm harita girişleri, koordinatları daha kolay bulmak için bir adres girmenize izin verir. Ancak form, adresi girmek için zaten bir veya daha fazla alan içeriyorsa, kullanıcının iki kez girmesi gerekebilir. Birincisi verileri gerçekten saklamak için ve ikincisi koordinatları bulmak için. Kullanıcıların bu ikili işi yapmak zorunda kalmasını önlemek için, adres alanlarının, noktayı bulurken değerlerini doğrudan haritaya beslemesini sağlayabilirsiniz. Bunu "feeds to map=" parametresini kullanarak yapabilirsiniz. "feeds to map" ile burada arayın.

Varsayılan olarak bu biçimlerin tümü harici JavaScript koduna dayanır. Ancak, yalnızca OpenLayers uzantısını yükleyerek "openlayers" biçiminin bunun yerine yerel JavaScript kodunu kullanmasını sağlayabilirsiniz.

Devre dışı bırakma
Bu giriş türlerinin hepsinin vikinizin verilerini (yani, sorgu sonuçlarında bulunan verileri) harici hizmetlere gönderdiğini unutmayın. Bunlar, Page Forms kodunun, dış değerlerde otomatik tamamlama dışında harici olarak veri gönderen tek kısmıdır, ancak bunun çalışması için ek yapılandırma gerektirir. Özel bir vikiniz varsa ve veri çıkmaması konusunda çok endişeliyseniz, aşağıdakileri LocalSettings.php ile eklemek isteyebilirsiniz:

Bu, herhangi bir dış hizmetin Page Forms tarafından kullanılmasına izin vermeyecektir. Bu, şu anda bu üç giriş türünü devre dışı bırakmak anlamına gelir.

regexp
"regexp" giriş türü gerçek bir girdi türü değil, daha ziyade ek, düzenli ifade tabanlı doğrulama ile başka bir girişi (çoğunlukla "metin") görüntüleme yeteneğidir. Bu giriş türü ve parametrelerinin daha ayrıntılı açıklaması için buraya bakın.



Veri türleri için izin verilen giriş türleri
Tanımlanmış her bir veri türü, Cargo veya Semantic MediaWiki kullanılırken, varsayılan bir giriş türüne ve uygun olduğunda varsayılan bir giriş boyutuna sahiptir. Ek olarak, alan yalnızca "tek bir değer" yerine sınırlandırılmış bir değerler listesi içeriyorsa, bazı veri türleri özel işlemeye sahiptir.

Her veri türü için varsayılanlar ve diğer izin verilen giriş türleri, tek değerler için:

Ve burada, belirli bir veri türünün ayrılmış listeleri için varsayılan ve diğer izin verilen girdi türleri verilmiştir:



Dosya yükleme
Formdaki bir alan, yüklenen bir dosyanın adını (örneğin, bir resim) barındırıyorsa, kullanıcıların bu dosyayı doğrudan form aracılığıyla yüklemesine izin verebilirsiniz. Bu, form tanımında bu alanın bildirimine "uploadable" parametresini ekleyerek yapılır. Bu, formdaki bu alanın yanına "Dosya yükle" yazan bir bağlantı ekleyecektir; kullanıcı bu bağlantıyı tıklarsa, kullanıcının bir dosya yüklemesine izin veren (FancyBox JavaScript kitaplığını kullanarak) bir "lightbox" tarzı pencere açacaktır. Kullanıcı bunu yaptığında, pencere kapanacak ve alan yüklenen dosyanın adını içerecektir. Alan bir değerler listesi içerecek şekilde yapılandırılırsa, yeni dosya adı daha önce ne varsa ona eklenir; aksi takdirde, dosya adı daha önce içerdiği alanın üzerine yazacaktır.

"uploadable" parametresinin yalnızca "text", "text ile otomatik tamamlama", "combobox" veya "tokens" türündeki alanlarda kullanılabileceğini unutmayın.

Yüklenebilir alanlar için, alan tanımında "default filename=" parametresini ayarlayarak yüklenen dosyaların varsayılan dosya adını da ayarlayabilirsiniz. Bu parametrenin değeri ayrıştırıcı işlevlerini, sihirli sözcükleri ve benzerlerini içerebilir. Ayrıca, eklenen veya düzenlenen sayfanın adıyla değiştirilen "&lt;page name>" değişkenini de içerebilir. Dolayısıyla, alan tanımına "default filename=Image for &lt;page name>" parametresini eklemek, örneğin "Abc" adlı bir sayfa için, yüklenen herhangi bir dosyanın varsayılan adını "Image for Abc" olarak ayarlayacaktır. Yalnızca "Imageneeded.png" gibi kullanmak için varsayılan bir dosya belirtmek isterseniz, normal "default=Imageneeded.png" parametresinin işe yarayacağını unutmayın.

Dosya yükleme demosunu burada görebilirsiniz.

LocalSettings.php dosyanızda,   olarak ayarlanmışsa yükleme penceresinin çalışmayacağını unutmayın.

MediaWiki'nin yükleme sistemini kullanmak yerine, doğrudan işletim sisteminin kendi yüklemesini kullanmak için yüklenebilir alanları da ayarlayabilirsiniz. Bu, kullanıcıya daha az seçenek sunar, ancak daha basit bir işlemdir ve mobil cihazlarda fotoğraf yükleme gibi bazı ilginç seçenekler alındıktan hemen sonra sunabilir. Bunu yapmak için, aşağıdaki satırı LocalSettings.php dosyasına ekleyin:

Yüklenebilir alanlar için özel parametreler şunlardır:
 * - Bunun yüklenebilir bir alan olduğunu belirtir.
 * - Yüklenen resmini küçük resminin formdaki alanın altına yerleştirilmesi gerektiğini belirtir.
 * filename - Bu alanla yüklenen dosyalar için varsayılan dosya adını belirtir.