Modül:İleti kutusu/belge

[bullvar_katip]

Bu modül , , , , , ve şablonlarının yürütülmesinde kullanılmaktadır. Direkt olarak sayfalarda kullanılmak için tasarlanmayan bu üst modülün işlevlerinden yararlanmak için sıralanan ileti şablonları kullanılmalıdır. Kullanımı Bu modülü başka bir Lua modülünde kullanmak için öncelikle söz konusu modüle çağrılması gerekir: İleti kutusu oluşturmak için işlevi kullanılmalıdır. Böylece kutu türü (dizgi olarak) ve ileti kutusunda kullanılacak olarak parametreler çağrılmış olur. Kullanılabilir yedi kutu türü bulunmaktadır: Kutulara tanımlı parametreler için şablon belgelemesine bakılabilir. #invoke ile kullanım Ana işlevin yanı sıra her kutu türü için ayrı işlevler de tanımlı bulunmaktadır. Bu işlevlere , şeklinde kutu kodlarını tanımlayarak erişim sağlanabilir. Bu işlevler diğer modüllerden çağrıldıklarında çalışacaktır ancak yalnızca #invoke çağrısı ile iletilen değişkenleri işlemek için kullanılan kodlara erişebileceklerinden işlevini çağırmak verimli bir kullanım biçimi olacaktır. Teknik detaylar Bu modül yukarıda listelenen her kutu türü için aynı temel kodu kullansa da yapılandırma verilerindeki farklılıklar kutuları birbirlerinden ayırmaktadır. Yapılandırma komutları ve ne anlama geldikleri aşağıda açıklanmıştır: - ileti kutusunun tür parametresi tarafından kullanılan verileri içeren tablodur. Tablo anahtarları, tür parametresine iletilebilecek değerlerden müteşekkil olup bu tablo değerleri türler tarafından kullanılan sınıfları ve resimleri saklamaktadırlar. - tür parametresine hiçbir değer girilmezse veya geçersiz bir değer belirtilmişse kullanılacak olan varsayılan tür ayarı. - tür parametresine girilen değer geçersizse hata gösterilip gösterilmeyeceğine dair ayar. - boş değerler modüle iletilen parametrelerden çıkarılır. Ancak allowBlankParams tablosunda yer alan parametrelere girilen boşluk karakteri korunur. - ileti kutusunun "küçük=evet" komutu ile daha küçük boyutta bir sürümünün oluşturulmasına dair ayar. - küçük parametresine girilecek özelleştirilebilir değer. Örneğin "left" şeklinde ayarlanmışsa "küçük=left" komutu ile küçük boyutta bir mesaj kutusu oluşturulabilir. - küçük ileti kutusu için kullanılacak sınıf. - yk ([y]erine [k]oyma) denetiminin yapılıp yapılmayacağına dair ayar. - ileti kutusunda kullanılacak sınıf dizisi. - resim belirtilmemişse boş hücresinin kullanılıp kullanılmayacağına dair ayar. Ekranın tamamına yayılmayan ileti kutularının boyut aralıklarını korumak için kullanılır. - boş resim hücrelerinin biçimlendirilip biçimlendirilmeyeceğine dair ayar. - "resim=blank" komutu hiçbir resmin görüntülenmemesini sağlar. - küçük ileti kutularında kullanılan resimler otomatik olarak 30x30 piksel olarak ayarlanır. Bu ayar ile özel boyut belirlenebilir. - resmin içine alınıp izin verilen en büyük boyuta zorlanmasına dair ayar. - "sorun", "çözüm", "tartışma" vb. daraltılabilen metin alanlarının kullanılıp kullanılmayacağına dair ayar. Şu anda yalnızca 'da kullanılmaktadır. - ileti kutusunun sağ tarafındaki resmin gizlenmesine dair ayar. "sağresim=none" komutu sağ tarafta hiçbir resmin görüntülenmesine izin vermez. - "altbaşlık" parametresi için varsayılan ad. komuuna bağlı olarak çalışır. - ana ad alanında kategorilere izin verilmesine dair ayar. - şablonun kullanıldığı sayfalara yerleştirilecek ana kategorinin adı. - şablona tanımlı kategoriyi görüntülemek için parametresinin gerekli olup olmadığına dair ayar. - şablon tarafından kullanılacak olan hata kategorisinin adı. - kullanılıp kullanılmadığı denetlenecek olan parametre adları. Herhangi biri eksikse hata olarak algılanır ve uygulanır.