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ı işlevleri
Kancalar
Özel sayfalar
Görünümler
Sihirli kelimeler
API
Sayfa içerik modelleri
Doğrulama
Tarama uzantıları
Daha önce yazılmış olan uzantıların tamamını görmek için Kategori: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:
- 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.
- 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.
- Uzantınızı yükleyin..
LocalSettings.phpdosyası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:
- Uzantının yeni sürümünü indirin
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- 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.
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.
Ayrıca bakınız
- Kategori:Uzantılar
- Template:Extension
- Manual:Developing extensions
- Manual:Translating extensions - Çeviri uzantıları hakkında bilgi.