Using with an attribute model. weight is a sample attribute name

$this->widget('ext.DzRaty.DzRaty', array(
	'model' => $model,
	'attribute' => 'weight',
));

Using with a single input element

$this->widget('ext.DzRaty.DzRaty', array(
	'name' => 'my_rating_field',
	'value' => 3,
));

Just adding readOnly option - Model attributte

$this->widget('ext.DzRaty.DzRaty', array(
	'model' => $model,
	'attribute' => 'weight',
	'options' => array(
		'readOnly' => TRUE,
	),
));

Just adding readOnly option - Input element

$this->widget('ext.DzRaty.DzRaty', array(
	'name' => 'my_rating_field',
	'value' => 3,
	'options' => array(
		'readOnly' => TRUE,
	),
));

Half values

Save float values and use half star icons.

$this->widget('ext.DzRaty.DzRaty', array(
	'name' => 'my_rating_field',
	'value' => 3.5,
	'options' => array(
		'half' => TRUE
	),
	'htmlOptions' => array(
		'class' => 'new-half-class'
	),
));

Cancel button

Add a button to cancel the score.

$this->widget('ext.DzRaty.DzRaty', array(
	'name' => 'my_rating_field',
	'value' => 2,
	'options' => array(
		'cancel' => TRUE,
		'cancelPlace' => 'right',
	),
));

Custom data values

Add custom data to your input field using data option

$this->widget('ext.DzRaty.DzRaty', array(
	'name' => 'my_rating_field',
	'value' => 4,
	'data' => array('Awful', 'Bad', 'Poor', 'Regular', 'Decent', 'Interesting', 'Good', 'Very good', 'Great', 'Excellent'),
));

Single value

Turn on just one star with single option

$this->widget('ext.DzRaty.DzRaty', array(
	'name' => 'my_rating_field',
	'value' => 1,
	'options' => array(
		'single' => TRUE,
	),
));

Javascript events handling

Available event callbacks: Read Only, Click, Mouseover and Mouseout

$this->widget('ext.DzRaty.DzRaty', array(
	'name' => 'my_rating_field',
	'value' => 3,
	'options' => array(
		'click' => "js:function(score, evt){ alert('Click event: score is ' + score); }",
		'mouseover' => "js:function(score, evt){ $('#score-info').html('Click a star! Current score: '+score); }",
	),
));

Custom path and icon images

Change images path and all off and on icons: cancel, star, starHalf.

$this->widget('ext.DzRaty.DzRaty', array(
	'name' => 'my_rating_field',
	'value' => 2,
	'options' => array(
		'path' => Yii::app()->request->baseUrl. '/images/raty',
		'cancel' => TRUE,
		'cancelPlace' => 'right',
	  	'half' => TRUE,
		'width' => 200,
		'starOff' => 'raty-dezero-off.png',
		'starOn' => 'raty-dezero-on.png',
		'starHalf' => 'raty-dezero-half.png',
	  	'cancelOff' => 'raty-cancel-off.png',
	  	'cancelOn' => 'raty-cancel-on.png',
	),
));

Icon range

Choose an icon image for each position and name

$this->widget('ext.DzRaty.DzRaty', array(
	'name' => 'my_rating_field',
	'value' => 3,
	'options' => array(
		'path' => Yii::app()->request->baseUrl. '/images/raty',
		'iconRange' => array(
		  array(
			'range' => 2,
			'on' => 'face-a-on.png',
			'off' => 'face-a-off.png'
		  ),
		  array(
			'range' => 3,
			'on' => 'face-b-on.png',
			'off' => 'face-b-off.png'
		  ),
		  array(
			'range' => 4,
			'on' => 'face-c-on.png',
			'off' => 'face-c-off.png'
		  ),
		  array(
			'range' => 5,
			'on' => 'face-d-on.png',
			'off' => 'face-d-off.png'
		  ),
	)),
));

Use DzRaty in your CGridView widget.
The extension provides a filter and a data column for CGridView widget with jQuery Raty plugin support.

Displaying 1-5 of 5 results.

	Title	Director	Score
	The Day After Tomorrow	Roland Emmerich
	The Avengers	Joss Whedon
	Sunshine	Danny Boyle
	Inception	Christopher Nolan
	The Golden Compass	Chris Weitz

42513

$this->widget('zii.widgets.grid.CGridView', array(
	'filter' => $model,
	'dataProvider'	=> $model->search(),
	'afterAjaxUpdate' => 'js:function() { dzRatyUpdate(); }',	// #1 - Let widget works after AJAX update
	'columns' => array(
		'image',
		'title',
		'director',
		array(
			'name' => 'score',
			'class' => 'ext.DzRaty.DzRatyDataColumn',	// #2 - Add a jQuery Raty data column
			'options' => array(				//      Custom options for jQuery Raty data column
				'space' => FALSE
			),
			'filter' => array('ext.DzRaty.DzRaty', array(	// #3 - Add a jQuery Raty filter column
				'model' => $model,
				'attribute' => 'score',
				'options' => array(			//      Custom options for jQuery Raty filter column
					'cancel' => TRUE,
					'cancelPlace' => 'right'
				),
			))
		)
	)
));