##### Jquery.com Plugin Page

Adından da anlaşılacağı gibi Jquery ile basit bir oy verme eklentisi.
Sebep ?:
Halihazırda bulunan hiç bir Jquery tabanlı rating eklentisi istediğim biçimde kullanıma izin vermiyordu. En çok rahatsız olduğum nokta, kullanıcının bir kez oy verdikten sonra aynı ekran üzerinde aynı içeriği tekrar oylayabilmesiydi. Bu nedenle diğer rating eklentileri ile ayrıldığı en önemli özelliği, içeriğe oy verdiğiniz anda, oy verme linklerinin kullanım dışı olması.

Kullanımı:
Eklenti iki şekilde kullanılabiliyor. Birincisi bir içeriğe 5 üzerinden bir oy vermenizi sağlayan rating özelliği ile. Bu kullanımda ekranda 5 adet oy verme yıldızı görünüyor, siz birini seçtiğinizde oyunuz o yıldızın konumu üzerinden değerlendiriliyor.
İkinci kullanımda genellikle tarayıcılarda gördüğümüz tek yıldız şeklindeki favorilere ekleme seçeneği. Bu özelliği aktif ettiğinizde, ekranda sadece bir adet yıldız görünür durumda oluyor. Kullanıcının bu yıldıza ilk tıklamasında eklenti özelliklerinde belirtilen url’ye vote=1 parametresi ile istek yapılıyor, ve favorilere eklendiğini gösterecek şekilde yıldız seçili hale geliyor. Kullanıcı aynı yıldıza tekrar tıklarsa, url bu kez vote=0 parametresi ile çağırılıyor ve yıldız kullanım dışı olduğunu gösterecek şekilde biçimleniyor.

Eklentiyi uygulamalarınız içerisinde kullanabilmek için gerekli kod basit olarak şu şekilde:

$('#rateholder').rater({
  url: 'data.php',
	mediapath: 'indicator_image_path',
	value: 4
});

Eklentinin özelliklerini açıklayalım:

$('#rateholder').rater({
      url: 'vote.php',
      enabled: true,
      favstar: false,
      favtitle: 'save as favorite',
      mediapath: '',
      indicator: true,
      value: 0,
      callback: false
    });

url: verdiğiniz oyun ajax isteği olarak post edileceği adresi ayarlar. Varsayılan olarak vote.php isimli bir dosyaya istek yapar.
enabled: eklentinin tıklanmaya açık olup olmadığını ayarlar, false ise linkler devre dışı kalır. varsayılan değer true
favstar: eklentinin favorilere ekleme yıldızı özelliğinde kullanılmasını sağlar. varsayılan değer false
favtitle: favorilere ekleme özelliği kullanıldığında, arayüz içerisinde gösterilecek başlığı atamanızı sağlar. varsayılan başlık save as favorite
mediapath: oy verdiğinizde ajax isteğinden sonuç alınana kadar ekranda kullanıcıyı oyalayacak belkeme animasyonun içeren gif dosyasının okunacağı kaynağı gösterir. varsayılan değer “./” şeklindedir
indicator: oy verildiğinde yükleniyor animasyonunun görüntülenip görüntülenmeyeceğini belirlemenizi sağlar. varsayılan değer true
value: parametresi ise o an ekranda görünen rating arayüzünün kaç adet yıldız olarak görüneceğini belirtmektedir. varsayılan değer 0, alabileceği en büyük değer 5
callback: bu özelliğe atayacağınız bir fonksiyon ile, verilen oy parametre olarak gönderdiğiniz fonksiyona aktarılır ve ajax isteği yapılmaz. Özellikle kullanıcının oy verebilmek amacıyla oturum açması gerektiği uygulamalarda, kolaylık sağlaması için hazırlanmıştır. varsyılan olarak false atanmıştır.

Eklentinin kullanıcı arayüzünü oluşturan css biçimlendirmesini http://www.pmob.co.uk/temp/star-rating2.htm adresinden aldım. Tasarımının sahibi Paul O’Brien’a teşekkür ediyorum. Bana arayüzün hazırlanmasının ayrıntılı anlatıldığı bir sayfanın adresini de yolladı: http://www.search-this.com/2007/05/23/css-the-star-matrix-pre-loaded/

Uygulama 4 dosya içermektedir.
jquery.simple.rater.js => ana eklenti dosyası
jquery.simple.rater.css => eklenti biçimlendirmelerini sağlayan stil dosyası
star-matrix.gif => eklentinin arayüzünü oluşturan yıldızları oluşturan gif dosyası, css dosyası ile aynı dizin içerisinde olmalıdır. isterseniz, css dosyası içerisinden yolunu değiştirebilirsiniz
indicator.gif => oy verildiğinde ajax isteği sonlanana kadar ekranda görünülenecek animasyonu içeren dosya, zorunlu değil, ancak oy verilirken kullanıcının bir şekilde durumdan haberdar edilmesi mantıklı bir seçenek

Kısa açıklamaların ardından örnekler için: samples.html
Dosyalara ulaşmak için: jquery.simple.rater.zip
Jquery.com Plugin Page