CodeLoad/tr

CodeLoad, özelleştirilebilir bir kod sayfası yükleyicisidir. Toplulukların, kullanıcıları için Gadget'lar uzantısına benzer şekilde sağlanan kodu (JavaScript/CSS) etkinleştirmelerini sağlayan bir sistem kurmalarını sağlar. Komut dosyasını kullanan bir wikide, kullanıcı tercihleri [ Özel:BlankPage?Blankspecial=CodeLoadPrefs] sayfasında yapılandırılabilir. Bu sayfaya bir bağlantı Kısayollar diyalogu ve araç çubuğundaki "Araçlarım" menüsüne eklenir.

Kullanım

 * 1) Aşağıdaki satırı wikinizin MediaWiki:ImportJS sayfasına ekleyin: dev:CodeLoad.js
 * 2) Wiki yöneticileri tarafından kod tanımlamaları yapılmalıdır. Konfigürasyon bilgisi altta.

Tanımları yapılandırma
Tanımlar,  sayfasından yüklenir. Bazı örnek tanımlamalar mevcuttur, ki bunlar bir wikinin tanım sayfası için temel olarak kopyalanıp yapıştırılabilen + olabilir.

Bunlar, her bir anahtar için benzersiz bir kimliği (bu yalnızca komut dosyasının adı olabilir) ve bir nesne (tanım olarak tanımlanmalıdır) olması gereken  JavaScript değişkeniyle yapılandırılır. Her tanım nesnesi aşağıdaki anahtarları içerebilir:

AjaxRC için örnek bir alıntı:

Gruplar
Tanımlar isteğe bağlı olarak tercihler sayfasında gruplar halinde sıralanabilir. Bunlar, her kod için benzersiz bir kimliği olan bir nesne ve bir tercih dizisi (başlık sayfasında gösterilen başlık olarak gösterilen grubun kolay adı (olması gereken  JavaScript değişkeniyle yapılandırılır) değeri olarak, wiki metin bağlantıları, dostane grup adları içerisinde kullanılabilir.

Bir tanımın grubu,  öğesinde varolan bir kimliğe ayarlandığında, bu gruba eklenecektir. Ayarlanmış bir grubu olmayan veya  içinde olmayan bir grup kimliğine sahip herhangi bir tanım, 'Diğer' grubuna eklenecektir.

Makaleler
Makaleler dizisi bir veya daha fazla CSS ( ile biten) ve/veya JavaScript (  ile biten) sayfaların sayfa adlarını içermelidir. Bunlar, yerel sayfalar (MediaWiki ad alanında depolanan) veya Dev Wiki sayfasından olabilir. MediaWiki ad alanının dışından veya yerel wiki ve Dev Wiki dışındaki wikilerden yapılan ithalat desteklenmez. Sayfa adları, MediaWiki ad alanı önekini içermemelidir. Dev Wiki'den yapılan içe aktarma işlemleri için sayfa adını  ile önekleyin.

Tercihler
Tercihler (ayarlanmışsa) bir nesne olmalı ve aşağıdaki anahtarları içerebilir (tümü isteğe bağlı):

Tercihler nesnesi, bu tanımın tercihleri için özel anahtarlar da içerebilir. Her anahtar için bir tercih kimliği kullanılmalı ve değeri olarak boolean, sayı veya dize (tercih için varsayılan değer) kullanılmalıdır.

Tercihler için kolay adlar, her bir anahtar için tercih kimliğine sahip bir nesne ve değeri olarak bir dize (tercih için kolay ad) olan JavaScript değişkeni  ile yapılandırılabilir. Kolay tercihli isimler arasında wiki metin bağlantıları kullanılabilir. Bunlar tüm tanımlar arasında paylaşılır ve eğer bir dostane isim varsa, tercihler sayfasında tercih kodunun yerine kullanılacaktır.

Gereklilikler
Gereksinimler (ayarlandıysa) bir nesne olmalı ve aşağıdaki anahtarları içerebilir (tümü isteğe bağlı):

Giriş mesajı
İsteğe bağlı bir mesaj,  JavaScript değişkeniyle yapılandırılabilir ve varsayılan giriş metninin altında gösterilir. Bu, örneğin mevcut tanımlar hakkında daha fazla bilgi sağlamak veya daha fazla ayrıntı içeren bir sayfaya bağlantı sağlamak için kullanılabilir. Mesaj içerisinde wiki metin bağlantıları kullanılabilir.

CodeLoad tutulan tercihleri kullanma
CodeLoad ile ayarlanan/kaydedilen tercihlere, ilk argüman olarak bir tanım kimliğiyle  işlevi çağrılarak erişilebilir. Yerel komut dosyası tercihlerini yapılandırmak için önerilen yöntem budur. Örnek olarak AjaxRC tanımı kullanıldığında, aşağıdaki kod, tanım için kullanıcı tercihleriyle  değişkenini ayarlayacaktır. Kullanıcı tercihlerine daha sonra  değişkeninin özellikleri aracılığıyla erişilebilir.

requiresGlobalPrefs
Bir tanım için  true olarak ayarlanmışsa, bu tanımın tercihlerinin her biri genel   nesnesinde özellikler olarak gösterilecektir. Bu, Dev Wiki'den gelen komut dosyalarının CodeLoad kullanılarak kolayca yapılandırılmasını sağlamak için kullanılabilir. Örnek olarak AjaxRC tanımı kullanıldığında, aşağıdaki kod tanım için kullanıcı tercihlerine erişir.

globalPrefNamespace
Bir tanım için  true olarak ve   bir dizeye ayarlanmışsa (örneğin,  ), bu tanımın tercihleri,   adındaki tek bir nesneye (ad alanı) eklenir ve yalnızca bu nesne genel   nesnesinde bir özellik olarak gösterilir. Tercihlerinin kod içinde nasıl yapılandırıldığına bağlı olarak, belirli komut dosyaları için bu gerekli olabilir. Örnek olarak AjaxRC tanımı kullanıldığında, aşağıdaki kod tanım için kullanıcı tercihlerine erişir.