Template:Extension
 | Bu şablon, şablon söz diziminin karmaşık özelliklerini kullanır.
Şablonu düzenlemeden önce kurulumuna ve ayrıştırıcı işlevlerine alışmanız tavsiye edilir. Düzenlemeniz beklenmedik sorunlara neden oluyorsa, lütfen bu şablon çok sayıda sayfada görünebileceğinden bunu hızlı bir şekilde geri alın. Burada herhangi bir şeyi değiştirmeden önce deneyler yapabileceğinizi ve tüm iyileştirmeleri genel deneme tahtası veya kullanıcı alanınızda test etmeniz gerektiğini unutmayın. |
 | Lua kullanır: |
 | Bu şablon TemplateStyles kullanır: |
Bu şablon, bu vikideki tüm uzantı sayfalarına eklenmelidir (yalnızca ana sayfa). Yararlı bir bilgi kutusu ekler (aşağıya bakın) ve uzantıyı uygun durum ve uygulama türü kategorileriyle birlikte Category:Tüm uzantılar otomatik olarak ekler.
Kullanım
|
Kopyala ve yapıştır: {{Extension |templatemode =
|name =
|status =
|type1 =
|type2 =
|hook1 =
|hook2 =
|newhook1 =
|newhook2 =
|username =
|author =
|description =
|image =
|imagesize =
|version =
|update =
|version preview =
|update preview =
|compatibility policy =
|mediawiki =
|php =
|needs-updatephp =
|composer =
|table1 =
|table2 =
|license =
|download =
|repo =
|readme =
|changelog =
|help =
|example =
|namespace =
|parameters =
|tags =
|rights =
|compatibility =
|phabricator =
|translate =
|vagrant-role =
}}
Parametre değerleriyle ilgili yardım için, aşağıya bakın. |
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||
İçerik parametreleri
Bu bölümde, bilgi kutusu içeriğini yöneten parametreler açıklanmaktadır. templatemode ve diğer kontrol parametreleri ile ilgili yardım için lütfen Kontrol parametrelerine bakın.
| Parametre | Açıklama |
|---|---|
| name | uzantının adı |
| status |
mevcut sürüm durumu Biri:
Durum yukarıdakilerden başka bir şeyse, yok sayılır ve şablonda varsayılan 'Bilinmiyor' değeri görüntülenir. Değerin atlandığı durumlarda, değer bilinmiyor olarak sınıflandırılır. Değerin geçersiz olduğu durumlarda, hatanın yakalanıp düzeltilebilmesi için özel kategori içine yerleştirilir. |
| type1 type2 type3 type4 type5 type6 | uygulama türü
Bu uzantının oluşturulmasında kullanılan uygulama stratejileri. Bu parametre, programcıların çeşitli MediaWiki'ye özgü uygulama stratejileri veya kalıplarının örneklerini bulmalarına yardımcı olan kategoriler oluşturmak için kullanılır. Bu parametrenin değerleri bazen bir uzantının kullanım durumu veya amacına denk gelse de, bu parametrenin nedeni bu değildir. Bu parametre için seçtiğiniz değerler amaç veya olası kullanım senaryosu yeterince tanımlamazsa, ihtiyaç olduğu gibi kategori bağlantıları eklemenizi öneririz. type1, type2,... parametreleri için izin verilen değerler:
'type' için diğer herhangi bir değer geçersizdir ve uzantının Category:Extensions with invalid or missing type/tr içine yerleştirilmesine neden olur. Not: Birçok uzantının birden fazla türü vardır, bu sizin için geçerliyse,|type= yerine |type1=|type2=|type3=... yazın. Bir uzantı için en fazla altı tür tanımlayabilirsiniz. |
| hook1 hook2 hook3 hook4 ... |
uzantı tarafından kullanılan her kancanın adı
Bu alana değer girmek, uzantınızı göstermenin ve diğer geliştiricilere yardımcı olmanın iyi bir yoludur. Belgelenen her kanca, uzantıyı otomatik olarak o kancayı kullanan bir kategori listeleme uzantılarına ekler. Bu kategori, programcıların belirli bir kancayı kullanan uzantıların örneklerini kolayca bulabilmeleri için her kanca sayfasına otomatik olarak bağlanır. Yerleşik kancalar için:
Uzantılarla tanımlanan özel kancalar için:
|
| newhook1 newhook2 newhook3 newhook4 ... newhook90 |
uzantı tarafından sağlanan her kancanın adı Ayrıca kancaları Extension hook registry ile eklemek isteyebilirsiniz. |
| username | Yazarın MediaWiki.org'daki kullanıcı adı (eğer varsa). İhmal edilebilir, ancak mevcutsa yazarın user & user_talk sayfasına bağlanmak için kullanılacaktır. Ad alanı olmadan ve [[]] olmadan sağlanmalıdır. |
| MediaWiki.org kullanıcı adından farklıysa uzantı yazarının adı. Özgür metin. Atlanırsa, 'kullanıcı adı' alanı kullanılır (varsa). | |
| description | kısa açıklama |
| image | uzantının ekran görüntüsü veya logosu. Ad alanı olmadan ve [[]] olmadan sağlanmalıdır. |
| imagesize | fakültatif, görüntünün boyutu (varsayılan boyut 220 pikseldir) |
| version | son sürüm |
| update | son güncelleme tarihi |
| version preview | Preview version |
| update preview | Date of the last update to the preview version |
| compatibility policy | Uyumluluk politikası (kabul edilen değerler: master, main, rel, ltsrel). (biriktirme listesi) |
| mediawiki | MediaWiki'nin gerekli sürümü Most extensions should not need to use this — it defaults to the value of the 'requires' property of extension.json. See also Category:Extensions without MediaWiki version and Category:Extensions with manual MediaWiki version. |
| php | PHP'nin gerekli sürümü |
| needs-updatephp |
MediaWiki uzantı standartlarına uyan uzantılar, tarayıcınız aracılığıyla MediaWiki'yi başlatmadan ve erişmeden önce ve tüm uzantı dosyalarını
$IP, MediaWiki kurulumunuzun Kurulum Yolu (veya "dizin") anlamına gelir, aynı dizini LocalSettings.php, index.php vb. |
| composer | Uzantının standart biçiminde Composer paket adı. Bir uzantının "composer.json" dosyasında ayarlanırsa otomatik olarak dahil edilir (yani, bu durumda bu parametre gerekli değildir). Uzantının Packagist üzerindeki sayfasına bağlanacaktır. |
| table1 table2 table3 table4 ... table30 | uzantı tarafından kullanılan her bir çekirdek olmayan tablonun adı Uzantı sayfanızın bir alt sayfasına bağlantılar. Örneğin, Extension:CheckUser adresindeki "$table" Extension:CheckUser/cu_changes table bağlanacaktır. page veya revision gibi temel tabloları listelemeyin; yalnızca uzantılarla eklenen tabloları listeleyin. |
| license | https://spdx.org/licenses/ içinde bulunan kodlardan biri olarak bu uzantının kullanımını yöneten lisans, ör. GPL-2.0-or-later, GPL-2.0-only veya GPL-3.0-or-later vb. |
| download | indirme bağlantısı : Git, {{WikimediaDownload/tr}}. |
| repo | Gerrit deposunun adı, sayfa adından farklıysa, uzantının kodunun saklandığı yerdir. Bunu otomatik olarak ayarlamak |download= ayarlar ve şablonun verileri uygun extension.json dosyasından otomatik olarak yüklemesine izin verir. |
| readme | readme dosyasına harici bağlantı, ör. https://phabricator.wikimedia.org/r/browse/mediawiki/extensions/Flow;master;README |
| changelog | değişiklik günlüğü dosyasına harici bağlantı, ör. Extension:GeoGebra/Changelog |
| help | Link to user-help for the extension. If not provided, will look for Help:Extension:ExtensionName. If provided, full wikitext link should be given (because you may want to link to e.g. an external page). |
| example | örnek, web sitesi veya çalışan uzantının ekran görüntüsü |
| namespace | bu uzantının kullanıldığı ad alanı |
| parameters | LocalSettings.php için mevcut parametreler |
| uzantınızın kullandığı tüm etiketler (ör. <tag1>, <tag2>). | |
| rights | haklar uzantı tarafından eklendi. Lisansla karıştırılmamalıdır! Haklar makebot veya desysop gibidir, GFDL veya LGPL veya GPL gibi değildir - bunlar lisanslardır! |
| compatibility | Ek uyumluluk bilgileri, örneğin uyumluluk çizelgeleri. Özellikle bir tarayıcı için tam destek beklentilerinden sapılırken, herhangi bir istemci tarafı uyumluluk bilgisini buraya eklemeniz önerilir. |
| bugzilla | Bugzilla MediaWiki uzantısı bileşen adı |
| phabricator | Phabricator proje adı |
| translate |
Tam sayfayı bağlamak için isteğe bağlı parametre (ileti grubu kimliği ile) uzantı etkinleştirilirse translatewiki.net üzerinde çevrilebilir. Varsayılan bağlantı yanlışsa, manuel olarak şu şekilde ayarlayın:
** "tümünü genişlet"'i tıkladıktan sonra adını languagestats içinde aranıyor. |
| vagrant-role | MediaWiki-Vagrant role |
| CheckUsageNameOverride | kullanımı kontrol et bağlantısı için kullanılan sayfa adını geçersiz kılın. |
Kontrol parametreleri
| Parametre | Açıklama |
|---|---|
| templatemode |
Ana sayfanın otomatik olarak sınıflandırılmasını kontrol eder. Normalde boş bırakılır. Alternatif değerler şunlardır:
|
Bilgi kutusunu kullanma
Mevcut uzantı sayfaları
Bilgi kutusunu mevcut bir sayfaya eklemek istiyorsanız, kodu kopyalayıp bu sayfanın en üstüne yapıştırın.
Yeni bir uzantı sayfası oluşturun
Yeni bir uzantı sayfası oluşturmak istiyorsanız, aşağıya adı girin ve düğmesine tıklayın. Zaten yerinde bilgi kutusu şablonuyla yeni bir sayfa oluşturulacaktır.
MediaWiki kod deposunda kodunu paylaşan bir geliştirici şunları beklemelidir:
- Geri bildirim / Eleştiri / Kod incelemeleri
- Çerçeve kullanımı, güvenlik, verimlilik ve kullanılabilirlik gibi şeyler hakkında diğer geliştiricilerin incelemeleri ve yorumları.
- Geliştirici ince ayarı
- Diğer geliştiriciler, kodunuzu yeni çerçeve sınıfları ve yöntemlerini, kodlama kuralları ve çevirileri karşılayacak şekilde iyileştirmek veya temizlemek için gönderinizi değiştiriyor.
- Viki sistem hizmetlileri için iyileştirilmiş erişim
- Kodunuzu vikiye koymaya karar verirseniz, başka bir geliştirici daha kolay bakım için kodu MediaWiki kod havuzuna taşımaya karar verebilir. Daha sonra korumaya devam etmek için Geliştirici hesabı yaratabilirsiniz.
- Diğer geliştiricilerin gelecek sürümleri
- MediaWiki'nin yeni sürümleri yayınlandıkça kodunuzun yeni dalları otomatik olarak oluşturulur. Daha eski sürümleri desteklemek istiyorsanız bu dallara arka port eklemelisiniz.
- Kodunuzun yinelenen veya benzer amaçlarla diğer uzantılara dahil edilmesi, her uzantıdan en iyi özellikleri içeren.
- Katkı sağlayan
- Birleştirilmiş tüm uzantılar dahil olmak üzere, çalışmanızın gelecekteki sürümlerde korunması için katkı sağlayın.
- Benzer şekilde, özellikle bir birleşme gerçekleştirirken, kodundan ödünç aldığınız tüm uzantıların geliştiricilerine katkı vermelisiniz.
Bu eylemlerin herhangi birinden rahatsız olan herhangi bir geliştirici, kod deposunda barındırmamalıdır. İnsanların uzantı ve onu nereden indirebilecekleri hakkında bilgi sahibi olması için, uzantınız için vikide bir özet sayfası oluşturmanız hâlâ teşvik edilmektedir.
Bu şablonu geliştirme
Bu şablonu geliştirmek istiyorsanız, teşekkürler! Bu karmaşık bir şablondur, işte yol boyunca biraz yardım:
Uzantı oluştur düğmesi
Uzantı oluşturma düğmesi davranışını iyileştirmek için:
- Template:Extension/Sample: Yeni oluşturulan sayfalara önceden yüklenen standart uzantı.
- Template:Extension/CreateExtensionInputBox: Kullanıcıların kolayca uzantı oluşturmasını istediğiniz her yere eklenebilen bir giriş kutusu.
<inputbox>etiketiyle ilgili belgelendirme için lütfen Extension:InputBox adresine bakın.
Bilgi kutusu parametreleri
Genel olarak:
- Bu şablonun kullanımını kolaylaştırmak için bilgi kutusundaki her etiket, görüntülediği şablon parametrelerindeki belgelere bağlanır. Bir parametre eklerseniz, lütfen bunu içerik parametresi belgelerine eklediğinizden ve etiketini bu belgelere bağladığınızdan emin olun.
Uygulama türü parametrelerini değiştirmek/düzeltmek/eklemek için:
- Tartışma sayfasına bakın - bu alanla ilgili bazı kapsamlı tartışmalar yapıldı.
- Geçerli türler ve bağlandıkları şey Module:Extension olarak tanımlanır
Kanca parametrelerinin davranışını değiştirmek için:
- Template:Extension/HookInUse: Kullanımdaki bir kanca için bağlantılar ve kategoriler ekler. Bu şablonun Template:Foreach ile çağrılmasıyla birden çok kanca kullanılır.
- Template:Extension/HookInUseNoCats: Bu şablon
templatemode=nocatsiçinde kullanıldığında Template:Extension/HookInUse yerine kullanılır. Template:Foreach ile kullanılan şablonlar yalnızca bir parametre alabilir, bu nedenle çağrıyı Template:Extension/HookInUse modu ayarlayan başka bir şablonla sarmamız gerekir.
Test durumu
Bu şablonu düzenledikten sonra aşağıdaki sayfaların hala uygun olup olmadığına bakın.
TemplateData
| TemplateData | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Bu, Görsel Düzenleyici ve diğer araçlar tarafından kullanılan bu şablon için TemplateData belgesidir. Extension An infobox for a MediaWiki extension.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Maintenance: vulnerabilities, archived