Manual:Uzantılar

Uzantılar, MediaWiki'nin görünüşünü ve çalışma şeklini özelleştirmenizi sağlar.

• Viki kullanıcıları uzantıları arasında gezinebilir.
• Sistem yöneticileri, yönettikleri MediaWiki yüklemelerinde kurulum (veya kaldır) uzantısını yapabilir.
• Geliştiriciler yeni uzantılar yazabilir veya uzantıları geliştirebilir veya koruyabilir.

Bazı uzantılar MediaWiki geliştiricileri tarafından korunurken, diğerleri üçüncü taraf geliştiricileri tarafından yazılmıştır. Sonuç olarak, birçoğunun böcekleri vardır ve hepsinin birbiriyle uyumlu olması garanti edilmez. Bazıları bakımsızdır; tüm uzantılar MediaWiki'nin tüm sürümlerinde çalışmaz. Herhangi bir uzantıyı, özellikle güvensiz olarak etiketlenenleri kullanmak kendi sorumluluğunuzdadır. Çekirdek yazılıma yama gerektiren bir uzantı kullanıyorsanız, veritabanınızı yedeklediğinizden emin olun. Bu vikinizi kırma riskini önlemeye yardımcı olur.

Uzantı türleri

Ayrıştırıcı etiketleri

Ayrıştırıcı etiketleri, yerleşik viki işaretlemesini, basit dize işleme veya tam gelişmiş bilgi alma gibi ek özelliklerle genişletir.

→ Ayrıştırıcı etiketleri hakkında daha fazla bilgi edinin

Ayrıştırıcı işlevleri

Ayrıştırıcı işlevleri, sayfadaki diğer viki öğeleriyle 'etkileşimde bulunabilen' ve belirli bir çıkış veren özel viki biçimlendirme sözdizimidir.

→ Ayrıştırıcı işlevleri hakkında daha fazla bilgi edinin

Kancalar

Kancalar, tanımlı bir olay (sayfa kaydetme veya kullanıcı girişi yapma gibi) gerçekleştiğinde özel kodun yürütülmesine izin verir.

→ Kancalar hakkında daha fazla bilgi edinin

Özel sayfalar

Özel sayfalar, belirli bir işlevi yerine getirmek üzere yazılım tarafından talep üzerine oluşturulan sayfalardır.

→ Özel sayfalar hakkında daha fazla bilgi edinin

Görünümler

Görünümler, kullanıcıların MediaWiki'nin görünümünü ve hissini özelleştirmesini sağlar.

→ Görünümler hakkında daha fazla bilgi edinin

Sihirli kelimeler

Sihirli kelimeler, çeşitli wiki metin dizelerini bir işlevle ilişkili tek bir kimliğe eşlemek için kullanılan bir tekniktir.

→ Sihirli kelimeler hakkında daha fazla bilgi edinin

API

MediaWiki, kimlik doğrulama, sayfa işlemleri ve arama gibi bazı wiki özelliklerine erişime izin veren bir web hizmeti olan bir eylem API'si sağlar.

→ MediaWiki API'si hakkında daha fazla bilgi edinin

Sayfa içerik modelleri

MediaWiki 1.21 ile sunulan ContentHandler , viki sayfalarının JSON veya Markdown gibi vikimetin dışındaki verilerden oluşmasını mümkün kılar.

→ İçerik modelleri hakkında daha fazla bilgi edinin

Doğrulama

MediaWiki, özel kimlik doğrulama mekanizmaları yoluyla güvenliği artırmak için kimlik doğrulamayla ilgili iki çerçeve olan SessionManager ve AuthManager'ı sağlar.

→ Doğrulama hakkında daha fazla bilgi edinin

Tarama uzantıları

Daha önce yazılmış olan uzantıların tamamını görmek için Category:Kategoriye göre uzantılar kategorisine göz atabilirsiniz. Bu uzantıları yükleme veya kendi uzantılarınızı yazma hakkında bilgi için aşağıya bakın.

Yüklü uzantıları kontrol etme

Yalnızca sunucudaki dosya sistemine (ve genellikle veritabanına) yönetim erişimi olan bir kişi MediaWiki için uzantılar yükleyebilir, ancak herkes Special:Version sayfasına erişerek MediaWiki örneğinde hangi uzantıların etkin olduğunu kontrol edebilir. Örneğin, bu uzantılar Türkçe Vikipedi'de etkindir.

Bir uzantı yükleme

MediaWiki, kurulum tamamlandıktan hemen sonra uzantıları kabul etmeye hazır. Bir uzantı eklemek için aşağıdaki adımları izleyin:

1. Başlamadan önce

   Birçok uzantı, unix komutlarını kullanarak kurulum için tasarlanmış talimatlar sağlar. Uzantı yardım sayfalarında listelenen bu komutları girmek için kabuk erişimine (SSH) ihtiyacınız vardır.

2. Uzantınızı indirin.

   Uzantı Distribütörü, popüler uzantıların çoğunu seçmenize ve indirmenize yardımcı olur.

   Uzantılar genellikle modüler paketler halinde dağıtılır. Genellikle kendi $IP /extensions/ adreslerinin alt dizinlerine girerler. Wikimedia'da Git deposu depolanan uzantıların listesi git:mediawiki/extensions üzerinde bulunur. Bazı uzantılar sürüm kontrolü kullanmıyor ve önerilmez.

   Bazı uzantılar paketler, composer veya paket depolarında da mevcuttur.

3. Uzantınızı yükleyin..

   LocalSettings.php dosyasının sonuna şunu ekleyin:

   wfLoadExtension( 'ExtensionName' );
   

   Bu satır PHP yorumlayıcısını uzantı dosyasını okumaya zorlar ve böylece dosyayı MediaWiki tarafından erişilebilir kılar.

   Bazı uzantılar bakım komut dosyalarıyla çakışabilir, örneğin doğrudan $_SERVER erişiyorlarsa (önerilmez).

   Bu durumda, bakım komut dosyalarının hala çalışabilmesi için koşullu olarak sarılabilirler.

if ( !$wgCommandLineMode ) {
   wfLoadExtension ( 'ExtensionName' );
}

importDump.php bakım betiği, yukarıdaki koşul dahilinde dahil gibi Extension:Semantic MediaWiki , Uzantı:Sayfa Formları gibi özelleştirilmiş ad alanları gerektiren herhangi bir uzantı için başarısız olacaktır.

Uzantılar için gerekli izinlerin ayarlandığından emin olun!

Bu kurulum prosedürü çoğu uzantı için yeterli olsa da, bazıları farklı bir kurulum prosedürü gerektirir. Ayrıntılar için uzantınızın belgelerine bakın.

LocalSettings.php dosyasındaki yapılandırma değişkenlerini değiştirmek istiyorsanız, bunu uzantı dahil olmak üzere genellikle sonra yapmanız gerekir. Aksi takdirde, uzantıda tanımlanan varsayılanlar ayarlarınızın üzerine yazılır.

Bir uzantı güncelleme

MediaWiki'yi her güncellediğinizde bazı uzantıların güncellenmesi gerekirken, diğerleri birden çok sürümle çalışır. Bir uzantının yeni bir sürümüne yükseltmek için:

1. Uzantının yeni sürümünü indirin
2. extension/UzantıAdı dizinindeki tüm uzantı dosyalarını yeni dosyalarla değiştirin. LocalSettings.php dosyasında bulunan uzantı yapılandırmasını kaldırmayın
3. Uzantı, MediaWiki veritabanında değişiklik gerektiriyorsa, Update.php bakım betiği çalıştırmanız gerekir. Çoğu uzantı bu komut dosyasının çalıştırılması gerekip gerekmediğini belirtir. (Betiği çalıştırmadan önce verilerinizin yedeğini alın). Komut satırı erişiminiz yoksa, web güncelleyiciyi de kullanabilirsiniz.

Bu talimatlar uzantıların %99'unu kapsar. Yükseltmekte olduğunuz uzantıda bunlardan farklı talimatlar varsa, muhtemelen uzantının talimatlarını izlemelisiniz

Bir uzantıyı kaldırma

Satırı kaldırmak için LocalSettings.php dosyasından uzantı adıyla kaldırın:

wfLoadExtension( 'ExtensionName' );

• Uzantının yapılandırmasıyla ilgili tüm satırları kaldırmalısınız.
• Uzantı herhangi bir veritabanı değişikliği sağlıyorsa, bunları kaldırmak için update.php çalıştırmanız gerekir.

Ayrıca bakınız

• Category:Uzantılar
• Template:Extension
• Manual:Developing extensions
• Manual:Translating extensions - Çeviri uzantıları hakkında bilgi.