Template:Extension

This page is a translated version of the page Template:Extension and the translation is 100% complete.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Nederlands • ‎Scots • ‎Tiếng Việt • ‎Türkçe • ‎dansk • ‎español • ‎français • ‎galego • ‎italiano • ‎magyar • ‎norsk bokmål • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎македонски • ‎русский • ‎українська • ‎հայերեն • ‎العربية • ‎فارسی • ‎کوردی • ‎मराठी • ‎हिन्दी • ‎বাংলা • ‎မြန်မာဘာသာ • ‎中文 • ‎日本語 • ‎粵語 • ‎ꯃꯤꯇꯩ ꯂꯣꯟ • ‎조선말 • ‎한국어
Şablon belgelemesi

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             = 
|readme               = 
|changelog            = 
|example              = 
|namespace            = 
|parameters           = 
|tags                 = 
|rights               = 
|compatibility        = 
|bugzilla             = 
|phabricator          =
|vagrant-role         = 
}}
Parametre değerleriyle ilgili yardım için, aşağıya bakın.
MediaWiki manüel uzantıları
OOjs UI icon advanced.svg
{{{name}}}
Sürüm durumu: bilinmiyor
Placeholder.png
Uygulama {{{type1}}}, {{{type2}}}
Açıklama {{{description}}}
Yazar(lar) SomeAuthor (SomeUsertalk)
En son sürüm {{{version}}} ({{{update}}})
En son önizleme sürümü {{{version preview}}} ({{{update preview}}})
Uyumluluk politikası geçersiz
MediaWiki {{{mediawiki}}}
PHP {{{php}}}
Veritabanı değişiklikleri {{{needs-updatephp}}}
Composer {{{composer}}}
Tablolar [[Special:MyLanguage/Template:Extension/{{{table1}}} table|{{{table1}}}]][[:Template:Extension/{{{table1}}} table| ]]
[[Special:MyLanguage/Template:Extension/{{{table2}}} table|{{{table2}}}]][[:Template:Extension/{{{table2}}} table| ]]
Lisans {{{license}}}
İndir {{{download}}}
{{{readme}}}
{{{changelog}}}
Örnek {{{example}}}
{{{namespace}}}
{{{parameters}}}
{{{tags}}}

{{{rights}}}

{{{compatibility}}}
Translatewiki.net adresinde mevcutsa, Extension uzantısını çevirin
Vagrant rolü {{{vagrant-role}}}
Sorunlar [[phab:tag/{{{phabricator}}}|Açık görevler]] · Hata bildir

İç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.

İçerik parametreleri
Parametre Açıklama
nameuzantının adı
statusmevcut sürüm durumu

Biri:

  • unstable - bozuk - bu uzantıyı kullanmayın
  • experimental - gelişimin erken aşamalarında, büyük ölçüde değişebilir
  • beta - kararlı ancak tam olarak test edilmemiş
  • stable - kararlı sürüm
  • unmaintained - bakımsız - önceden istikrarlı olduğu iddia edildi, şimdi bakımsız
  • archive - arşivlendi - başka bir uzantıyla kullanımdan kaldırıldı veya birleştirildi
  • unknown - varsayılan

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:

  • parser - kategorize edilmemiş ayrıştırıcı uzantıları. Bir ayrıştırıcı uzantısı yazdıysanız, lütfen aşağıdaki daha spesifik türlerden birini kullanın:
  • access - catchall için User access extensions , yani izinler oluşturan, kimlik doğrulayan, izin veren, izinleri iptal eden veya kullanıcıların etkinliğini izleyen uzantılar. Bir erişim uzantısı yazdıysanız, lütfen aşağıdaki daha spesifik türlerden birini kullanın:
    • user activity - kullanıcı etkinliğini izleyen uzantılar (girişler, çıkışlar, yeni kullanıcı oluşturma vb.)
    • user identity - kullanıcıları oluşturan ve silen ve/veya kullanıcının kimliğini doğrulayan uzantılar
    • user rights - hak yönetimi sistemine ilişkin uzantılar, ör. hakların atanma şeklindeki değişiklikler, API, bakım araçları (yalnızca söz konusu uzantının özelliklerini kullanmak için gereken hakları adlandıran uzantıları içermez; bu amaçla rights parametresi kullanın)
  • interface - Kategorize edilmemiş kullanıcı arayüzü uzantıları için catchall.
    • media - $wgMediaHandlers ile bir dosya uzantısı kaydederek multimedya içeriğinin viki sayfalarına yerleştirilmesine izin veren uzantılar.
    • mywiki - MediaWiki deneyimlerini kişiselleştirebilmesi ve/veya bu altyapının yönetimine yardımcı olabilmesi için altyapı sağlayan uzantılar
    • notify - kullanıcılara e-posta gönderen, mesaj yayınlayan ve diğer topluluk bildirimi biçimleri sağlayan uzantılar
    • page action - page action s geliştiren veya değiştiren uzantılar. Bu, bir sayfayı okuyan, yazan, arayan, oluşturan, yeniden adlandıran, silen, yeniden yönlendiren veya tartışan bir eylemi uygulayan her şeyi içerir. Hakları (user rights kullanın) veya günlükleri (user activity kullanın) içermez.
    • search - kullanıcılar için sayfaları arayan ve seçen uzantılar.
    • skin - CSS veya JavaScript ekleyen veya dış görünüm çerçevesi aracılığıyla MediaWiki'nin görünümünü ve hissini değiştirmek için kanca işlevlerini uygulayan uzantılar.
    • ajax - Ajax programlama tekniklerini kullanan uzantılar.
    • special - SpecialPage sınıfını alt sınıflara ayıran, onun kancalarından birini kullanan veya SpecialPage.php içindeki bir veya daha fazla işlevi yama yapan uzantılar. Daha fazla bilgi için Special pages sayfasına bakın.
  • other
    • api - yeni bir API modülü ekleyen veya bir çekirdek API modülünü genişleten uzantılar.
    • hook - Kanca uzantısı - yeni bir kanca tanımlar - uzantınız tarafından kullanılan kancaları tanımlamak istiyorsanız aşağıdaki kanca1'e vb. bakın
    • database - MediaWiki kurulumunu destekleyen veritabanına tablolar ve/veya alanlar ekler
    • data extraction - Veri çıkarma
    • filerepo - dosya arka ucu olarak yeni dosya deposu türlerini ekleyen uzantı
    • example - Gerçek bir uzantı değil, nasıl yazılacağına dair bir örnek

'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:

  • kanca adını tek başına kullanın. Değerler için lütfen Manual:Hooks sayfasına bakın (ancak giriş '/' kısmını atlayın).

Uzantılarla tanımlanan özel kancalar için:

  • extensionName/hookName kullanın. Özel kancaların kısmi bir listesi için Extension hook registry sayfasına bakın.
Çoklu kanca için, ilk kancayı kanca1 ile, ikinciyi kanca2 ile atayın vb.
newhook1
newhook2
newhook3
newhook4
...
newhook90
uzantı tarafından sağlanan her kancanın adı Ayrıca kancaları Extension hook registry ile eklemek isteyebilirsiniz.
usernameYazarı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.
authorMediaWiki.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).
descriptionkısa açıklama
imageuzantının ekran görüntüsü veya logosu. Ad alanı olmadan ve [[]] olmadan sağlanmalıdır.
imagesizefakültatif, görüntünün boyutu (varsayılan boyut 220 pikseldir)
versionson sürüm
updateson güncelleme tarihi
compatibility policyuyumluluk politikası (kabul edilen değerler master, rel ve ltsrel şeklindedir). (biriktirme listesi )
mediawikiMediaWiki'nin gerekli sürümü
phpPHP'nin gerekli sürümü
needs-updatephpyes, uzantının MediaWiki'nin çalışabilmesi için bir veritabanı tablosu şeması değişikliği veya benzer bir eylem gerektirdiğini belirtir. Genel bir tuzaktır: Eğer update.php'yi çalıştırmayı unutursanız, uzantı gerektiriyorsa, MediaWiki'niz durur. no, uzantının çalıştırılması için update.php'ye ihtiyaç duymadığından ve böylece belirsizliği önlediğinden, bir değer olarak ayarlanmalıdır.

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/extensions/ExtensionName kopyaladıktan sonra manüel olarak başlatmanız gereken bir şema değiştirme komut dosyasıyla birlikte gelir (bir kez) wfLoadExtension( "ExtensionName"); "LocalSettings.php" içine eklendi, komut satırından çalıştırın:

cd path/to/wiki_install_directory
cd maintenance
php update.php
$IP , MediaWiki kurulumunuzun Kurulum Yolu (veya "dizin") anlamına gelir, aynı dizini LocalSettings.php , index.php vb.
composerMümkünse "satıcının" adı ve "paket" vendor/package girilmelidir, ör. mediawiki/semantic-media-wiki, kişileri doğrudan paket arşivi olarak hizmet veren packagist.org'a yönlendirmek için.
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.
licensehttps://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.
downloadindirme bağlantısı : Git, {{WikimediaDownload/tr}}.
repoGerrit 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.
readmereadme dosyasına harici bağlantı, ör. https://phabricator.wikimedia.org/r/browse/mediawiki/extensions/Flow;master;README
changelogdeğişiklik günlüğü dosyasına harici bağlantı, ör. Extension:LDAP Authentication/Changelog
parametersLocalSettings.php için mevcut parametreler
tagsuzantınızın kullandığı tüm etiketler (ör. <tag1>, <tag2>).
rightshaklar 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!
namespacebu uzantının kullanıldığı ad alanı
exampleörnek, web sitesi veya çalışan uzantının ekran görüntüsü
compatibilityEk uyumluluk bilgileri, örneğin uyumluluk çizelgeleri (önceden Template:Extension Testing kullanılıyordu). Özellikle bir tarayıcı için tam destek beklentilerinden sapılırken, herhangi bir istemci tarafı uyumluluk bilgisini buraya eklemeniz önerilir.
translateTam 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:
  • ext-LOWERCASE(NOSPACES(config içinde tanımlandığı gibi etiket)),
  • sonra URL'de aldığınız parametre
** "tümünü genişlet"'i tıkladıktan sonra adını languagestats içinde aranıyor.
bugzillaBugzilla MediaWiki uzantısı bileşen adı
phabricatorPhabricator proje adı
CheckUsageNameOverridekullanımı kontrol et bağlantısı için kullanılan sayfa adını geçersiz kılın.

Kontrol parametreleri

Kontrol parametreleri
Parametre Açıklama
templatemodeAna sayfanın otomatik olarak sınıflandırılmasını kontrol eder.

Normalde boş bırakılır. Alternatif değerler şunlardır:

  • nocats - kategorizasyonu ve 'kullanımı kontrol et' bağlantısını bastırır. Bu şablonu, bir uzantının alt sayfalarına veya uzantıların nasıl yapılır belgelerine ekliyorsanız, bu değeri kullanın. Örneğin, yukarıdaki kullanım resmi templatemode=nocats ile ayarlıyor çünkü bu gerçek bir uzantı sayfası değil ve bu sayfayı bu nedenle herhangi bir kategoriye eklemek istemiyoruz.
  • nousage - 'kullanımı kontrol et' bağlantısını bastırır. Sayfa bir alt sayfa ise bağlantı da bastırılır; Extension: ad alanında değil; veya 'templatemode=nocats' tarafından bastırılmışsa
Bu boş bırakılırsa, bu şablon ana bilgisayar sayfasını Category:All extensions/tr ve İçerik parametrelerine atanan değerlere bağlı olarak bir veya daha fazla ek kategoriye ekleyecektir.

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:

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:

Kanca parametrelerinin davranışını değiştirmek için:

Test durumu

Bu şablonu düzenledikten sonra aşağıdaki sayfaların hala uygun olup olmadığına bakın.

TemplateData

Maintenance: vulnerabilities, archived