mIRC Addon Ayar Penceresi: Kullanıcı Dostu Yapılandırma

Bir addon'un ne kadar kullanıldığını belirleyen en önemli etkenlerden biri, ayarlarının ne kadar kolay değiştirilebildiğidir. Kullanıcının kodu açıp satır düzenlemesi gereken bir addon, scripting bilmeyen kişiler için erişilemez kalır. mIRC addon ayar penceresi, bu sorunu çözer: Kullanıcı tek komutla bir pencere açar ve ayarları arayüzden değiştirir.

Temel Yapı

Bir ayar penceresi üç parçadan oluşur:

1. Dialog tanımı: Pencerenin görünümü ve kontrolleri.
2. Yükleme kodu: Pencere açıldığında mevcut ayarları dosyadan okuyup kontrollere yerleştirmek.
3. Kaydetme kodu: Kullanıcı kaydet dediğinde değerleri doğrulayıp dosyaya yazmak.

Dialog tanımının ayrıntıları için mIRC dialog tasarımı yazımıza bakın.

Ayarları Gruplamak

Birkaç ayardan fazlası varsa gruplamak zorunludur. Gruplama mantığı genellikle işleve göre yapılır:

• Genel: Addon'un açık kapalı durumu, temel davranış.
• Kanallar: Hangi kanallarda çalışacağı.
• Mesajlar: Gönderilecek metinler ve biçimleri.
• Sınırlar: Eşik değerleri, bekleme süreleri, boyut sınırları.
• Gelişmiş: Çoğu kullanıcının dokunmayacağı ayarlar.

Dialog'da gruplama çerçeveleri kullanmak, görsel olarak bu ayrımı belirginleştirir. On ikiden fazla ayar varsa sekmeli yapıya geçmek, pencereyi okunabilir tutar.

Kontrol Türü Seçimi

Her ayar için doğru kontrolü seçmek, kullanım hatalarını azaltır:

Ayar türü	Uygun kontrol
Açık kapalı	Onay kutusu
Birkaç seçenekten biri	Seçenek düğmeleri veya açılır liste
Sayısal değer	Yalnızca sayı kabul eden metin kutusu
Kısa metin	Metin kutusu
Uzun metin	Çok satırlı metin kutusu
Liste (kanallar, kelimeler)	Liste kutusu, yanında ekle ve sil butonları
Dosya veya klasör yolu	Metin kutusu, yanında gözat butonu

Sayısal alanlarda yalnızca sayı kabul eden kontrol kullanmak, doğrulama işini büyük ölçüde kendiliğinden çözer.

Liste Yönetimi

Kanal listesi veya kelime listesi gibi ayarlar, en çok dikkat gerektiren kısımdır. Tipik bir liste yönetimi arayüzü şöyledir: Bir liste kutusu, altında bir metin giriş alanı ve Ekle, Düzenle, Sil butonları.

Kullanım akışı: Kullanıcı metin alanına yazıp Ekle'ye basar, öğe listeye eklenir. Listeden bir öğe seçtiğinde metin alanına gelir ve Düzenle ile değiştirebilir. Sil, seçili öğeyi kaldırır.

Bu arayüz, kullanıcının virgülle ayrılmış uzun bir metin yazmasından çok daha hatasız çalışır.

Doğrulama

Kullanıcı girdisini kaydetmeden önce doğrulamak, addon'unuzun beklenmedik değerlerle çalışmaya başlamasını önler.

Doğrulanması gerekenler:

• Sayısal değerler: Sayı mı, makul aralıkta mı?
• Kanal adları: Geçerli bir kanal adı biçiminde mi?
• Dosya yolları: Klasör var mı, yazma izni var mı?
• Boş bırakılamayan alanlar: Zorunlu ayarlar doldurulmuş mu?
• Mantıksal tutarlılık: Birbirine bağlı ayarlar çelişiyor mu?

Doğrulama başarısız olduğunda kullanıcıya neyin yanlış olduğunu açıkça söyleyin. "Geçersiz değer" mesajı yardımcı olmaz; "Bekleme süresi 1 ile 300 saniye arasında olmalı" mesajı sorunu çözer.

Varsayılana Döndürme

Kullanıcılar bazen ayarlarla oynayıp işleri bozar ve başa dönmek ister. Bir "Varsayılana döndür" butonu bu ihtiyacı karşılar.

Bu butonu eklerken bir onay adımı koymak iyi olur: Kullanıcı yanlışlıkla basıp bütün ayarlarını kaybetmesin. Ayrıca yalnızca o anki sekmenin ayarlarını sıfırlayan bir seçenek de düşünülebilir.

İptal Davranışı

İptal butonu hiçbir değişikliği kaydetmemelidir. Bu basit görünür ama uygulamada dikkat gerektirir: Kullanıcı bir ayarı değiştirip İptal'e bastığında, değişiklik dosyaya yazılmamış olmalıdır.

Bunu sağlamanın yolu, değişiklikleri yalnızca Kaydet butonunda dosyaya yazmaktır. Ayarları anında uygulayan bir tasarım seçtiyseniz, İptal butonunu hiç koymayın; kullanıcıyı yanıltmayın.

Yardım ve Açıklamalar

Bir ayarın ne işe yaradığı adından anlaşılmıyorsa, yanına kısa bir açıklama metni eklemek gerekir. Pencere dar olduğu için uzun açıklamalar sığmaz; bunun için birkaç çözüm vardır:

• Ayarın altına tek satırlık küçük puntolu açıklama.
• Fare üzerine gelince açıklama gösteren bir ipucu.
• Bir yardım butonu veya penceresi.
• Ayar adını daha açıklayıcı yazmak.

Son seçenek genellikle en iyisidir: "Bekleme (sn)" yerine "Komutlar arası bekleme süresi (saniye)" yazmak, hiçbir ek açıklamaya gerek bırakmaz.

Pencere Boyutu ve Konumu

Pencereyi makul boyutta tutun: Çok büyük pencereler küçük ekranlarda taşar. Kontrolleri hizalı yerleştirmek, pencereyi düzenli gösterir.

Kullanıcının pencereyi taşıdığı konumu kaydedip bir sonraki açılışta kullanmak, düşünceli bir dokunuştur. Bu, dialog tanımındaki konum parametrelerini bir ayar dosyasından okumakla yapılır.

Ayarları Anında Uygulamak

Kullanıcı Kaydet'e bastığında ayarların hemen etkili olması beklenir. Bazı ayarlar bunu kendiliğinden yapar (bir dosyadan okunan değerler), bazıları ise addon'un yeniden yapılandırılmasını gerektirir (timer aralıkları, olay grupları).

Kaydetme kodunuzda, değişen ayarlara göre gerekli yeniden yapılandırmayı yapmak gerekir: Timer aralığı değiştiyse timer'ı yeniden kurmak, addon kapatıldıysa ilgili grupları devre dışı bırakmak gibi. Timer'lar için mIRC timer yazımıza bakın.

Komut Adı

Ayar penceresini açan komutun adı, addon'unuzun önekiyle başlamalı ve hatırlanabilir olmalıdır. Kılavuzda bu komutu belirgin şekilde yazın; kullanıcıların ilk arayacağı şey budur.

Ek olarak bir menü öğesi eklemek de faydalıdır: Kullanıcı komutu hatırlamasa bile menüden ulaşabilir. Menüler için mIRC popup menüleri yazımıza bakın.

Gerçek Bir Senaryo

Bir geliştirici, kanal koruma addon'unun on dört ayarını kodun başında bir blokta tutuyor. Kullanıcılardan sürekli "şu ayarı nasıl değiştirebilirim" soruları geliyor ve bazıları kodu bozup addon'u çalışmaz hâle getiriyor. Geliştirici bir ayar penceresi yazıyor: Ayarları üç sekmeye bölüyor, sayısal alanlar için yalnızca sayı kabul eden kutular kullanıyor, kanal listesini ekle sil butonlarıyla yönetilen bir liste kutusuna alıyor, her ayarın yanına açıklayıcı etiket koyuyor ve bir varsayılana döndür butonu ekliyor. Destek soruları neredeyse tamamen kesiliyor ve addon'un kullanıcı sayısı belirgin şekilde artıyor.

Bu küçük yatırım, addon geliştiricilerinin destek yüküne harcadığı zamanı belirgin şekilde azaltır ve kullanıcıların addon ile ilk karşılaşmasını olumlu kılar.

Sonuç

Ayar penceresi, addon'unuzu scripting bilmeyen kullanıcılar için de erişilebilir kılar. Ayarları işleve göre gruplayın, her ayar için doğru kontrolü seçin, listeleri ekle sil arayüzüyle yönetin, girdiyi doğrulayıp açıklayıcı hata mesajları gösterin, varsayılana döndürme sunun ve ayar adlarını kendi kendini açıklayacak şekilde yazın. Addon'unuzu dağıtıma hazırlamak için sıradaki rehberimiz mIRC addon paketleme.