- Bu uzantı varsayılan olarak etkin değil, ancak mevcuttur.
Küçük araçlar, bunları kullanmayı "seç" olan kullanıcılara özel CSS veya JavaScript sunar. Tüm kullanıcılar için yüklenen topluluk CSS ve JS'nin aksine, küçük araç CSS ve JS yalnızca küçük aracı etkinleştiren kullanıcılar tarafından görülür. Küçük araçlar her topluluğa özeldir; kullanıcılar bunları "Küçük araçlar" sekmesi altındaki tercihler sayfasında etkinleştirebilir veya devre dışı bırakabilir.
Küçük araçları, kullanıcılara site genelinde isteğe bağlı deneyimler sağlamanın bir yoludur. Ancak, anonim kullanıcıların küçük araçları etkinleştiremeyeceğini veya varsayılan olarak etkin olarak ayarlanmış herhangi bir küçük aracı devre dışı bırakamayacağını unutmayın.
İçindekiler
Uzantı talep etme
Varsayılan olarak, çoğu Fandom topluluğu küçük aracı kullanmaz. Küçük araçlar bir uzantı tarafından desteklenir; küçük araçları kullanmak isteyen herhangi bir topluluk, bu toplulukta uzantının etkinleştirilmesini talep etmek için personele başvurun.
Küçük araçların listesi
Bir topluluğun küçük araçları listesini görüntülemek için Özel:KüçükAraçlar sayfasına gidin. Bu özel sayfa ayrıca küçük araç açıklamaları için düzenleme bağlantıları sağlayacak, her küçük araç tarafından kullanılan dosyaların bir listesini gösterecek ve her küçük araç için gereken hakları gösterecektir. Bu sayfada küçük araçları etkinleştiremeyeceğinizi veya devre dışı bırakamayacağınızı unutmayın; kullandığınız küçük araçları etkinleştirmek veya devre dışı bırakmak için Özel:Tercihler sayfasına gitmelisiniz.
Gadgets uzantısının etkinleştirilmediği vikiler, Özel:KüçükAraçlar sayfasında olmadığı için bir hata sayfası gösterecektir.
Bir küçük araç oluşturma
Küçük araç tanımı
Bir küçük araç oluşturmanın ilk adımı onu tanımlamaktır. Bunu yapmak için topluluğunuzdaki MediaWiki:Gadgets-definition öğesini düzenleyin. Her küçük araç madde işaretli listedeki bir girişle tanımlanır, bu nedenle her satır
* ile başlamalıdır. Küçük araç tanımı biçimlendirmesi aşağıdaki gibidir:
* küçük_araç_adı [options] | dosya1 | dosya2 | vb.
küçük_araç_adıbenzersiz ve harfe duyarlı olmalıdır. Temel bir Latin harfiyle (
[A-Za-z]) başlamalı ve ardından herhangi bir sayıda harf, rakam (
[0-9]), tireler (
-), alt çizgiler (
_), iki nokta üst üste (
:) ve noktalar (
.) gelebilir.
optionshakkında açıklama için § Küçük araç seçenekleri bölümüne bakın.
dosya1,
dosya2vb. hakkında bir açıklama için § Küçük araç dosyaları bölümüne bakın.
- Vikinizde çok sayıda küçük aracı varsa,
==başlıklar==kullanarak listeyi bölümlere ayırmanız yardımcı olabilir. Örneğin, aşağıdaki dört küçük aracı listesi iki bölüme ayrılmıştır: yardımcı programlar ve görsel. Küçük araç adları gibi, bölüm başlıkları da büyük/küçük harf duyarlıdır ve benzersiz olmalıdır.
==araçlar== * Araç1 [ResourceLoader] | NiceUtility.js * Araç2 [ResourceLoader|rights=rollback] | RollbackUtil.js | RollbackUtil.css ==görsel== * Tema1 [type=styles] | CoolTheme.css * Tema2 [type=styles] | FireTheme.css
Küçük araç açıklaması
Varsayılan olarak, kullanıcılar küçük aracınızı Özel:Tercihler sayfasında
⧼gadget-küçük_araç_adı⧽ olarak sunulduğunu görür. Bu çok yararlı bir açıklama değil. Bu açıklamayı vikinizde MediaWiki:Gadget-gadget-küçük_araç_adı seçeneğine giderek düzenleyebilirsiniz. Ayrıca Özel:KüçükAraçlar sayfasındaki küçük araç listesine gidebilir ve her bir küçük araç tanımının yanındaki "Düzenle" bağlantısını tıklayabilirsiniz.
Küçük araç açıklamaları makul olmalıdır. Yararlı bir açıklama, kullanıcının küçük aracı etkinleştirmesi durumunda farklı göreceği veya erişeceği her şeyi açıklar. Küçük araçların, kullanıcılarınıza deneyimlerini değiştirme konusunda seçenekler sunmakla ilgili olduğunu unutmayın. Bunun için doğru bilgiye ihtiyaçları var.
Bölüm başlıkları da daha kullanıcı dostu görünecek şekilde düzenlenebilir. Yukarıdaki örnekte,
utilities başlığını düzenlemek için MediaWiki:Gadget-section-utilities seçeneğine gidin veya Özel:KüçükAraçlar sayfasındaki bölüm başlığının yanındaki "Düzenle" bağlantısını tıklayın.
Küçük araç seçenekleri
Küçük araç tanımı, küçük aracın nasıl yükleneceğini veya kimlerin etkinleştirebileceğini daha fazla belirten seçenekler içerebilir. Her seçenek bir
| dikey çizgi karakteriyle ayrılmalıdır. ResourceLoader gibi herhangi bir parametre almayan seçenekler basitçe kendi başlarına dahil edilebilir; parametre alan seçenekleri, eşittir işareti ve ardından virgülle ayrılmış bir parametre listesi ile dahil edilmelidir, örneğin
rights=rollback,delete.
Aşağıdaki tablo, Fandom toplulukları için mevcut küçük aracı seçeneklerini listeler.
|Ad||Parametreler||Açıklama|


||Hiçbiri||Küçük aracın betiklerini ResourceLoader ile uyumlu olarak işaretler.|
Bu seçenek, en az bir JS dosyası yükleyen herhangi bir küçük aracı için gereklidir, aksi takdirde Özel:KüçükAraçlar bir hata görüntüler ve JS yüklenmez.


||Virgülle ayrılmış ResourceLoader modül adları||Küçük araçtta ResourceLoader uyumlu kaynaklar yoksa (yani uyumlu olarak işaretlenmemiş stil ve betik yoksa) bu seçeneğin hiçbir etkisi olmadığını unutmayın.|


||Virgülle ayrılmış ayrıcalık adları||Bu ayrıcalıklara sahip olmayan kullanıcıların tercihlerinde küçük aracı devre dışı bırakın ve gizleyin. Kullanıcı haklarının kullanıcı grupları olmadığını unutmayın; kullanıcı haklarının tam listesi Özel:ListGroupRights sayfasında mevcuttur.|


||Hiçbiri||Varsayılan olarak ayarlanan tüm küçük araçları özelleştirme politikasına UYMALIDIR.|
Küçük aracı anonim kullanıcılar da dahil olmak üzere herkes için varsayılan olarak etkinleştirin. Bu küçük aracı yalnızca kayıtlı kullanıcılar devre dışı bırakabilir.


||"Yalnızca" CSS dosyalarını yükleyen küçük araçları için |
Küçük araç dosyaları
Bir küçük aracın ekmek ve tereyağı, etkinleştirildiğinde yüklediği dosyalardır. Bir küçük aracın yüklediği her CSS veya JS sayfasının önüne MediaWiki:Gadget- eklenmelidir. Yukarıdaki örnekte Araç2, MediaWiki:Gadget-RollbackUtil.js ve MediaWiki:Gadget-RollbackUtil.css sayfasında bulunacak olan "RollbackUtil.js" ve "RollbackUtil.css" adlı iki dosyayı tanımlar. Küçük araç ve dosyalar için aynı adı kullanmak iyi bir kuraldır, ancak gösterildiği gibi bu bir gereklilik değildir.
Küçük araç öneki dışında, küçük araç CSS ve JS dosyaları diğer CSS veya JS dosyaları gibi çalışır. Bu nedenle, lütfen küçük araç JS dosyalarının herkes için yayınlanmadan önce JavaScript inceleme süreci tarafından onaylanması gerektiğini unutmayın. Yükleme sırası açısından, küçük araçları diğer yerel topluluk kodundan sonra, ancak kişisel koddan "önce" yüklenir.
Bir küçük araç istendiği kadar sayfa yükleyebilir, ancak birden fazla JS ve bir CSS sayfası yüklemek nadirdir. Küçük araç tanımında her dosyanın önüne bir
| çizgi karakteri gelmelidir. Herhangi bir küçük araç CSS veya JS sayfası, birden fazla küçük araç tarafından da yüklenebilir. Diğer yan sayfalar gibi, küçük araçlar da yalnızca JS veya CSS kullanılarak yazılabilir.