kartik-v / yii2-widget-rating
A Yii2 widget for the simple yet powerful bootstrap-star-rating plugin with fractional rating support (sub repo split from yii2-widgets)
Installs: 3 324 643
Dependents: 10
Suggesters: 0
Security: 0
Stars: 45
Watchers: 6
Forks: 5
Open Issues: 0
Type:yii2-extension
Requires
README
yii2-widget-rating
The StarRating widget is a wrapper for the Bootstrap Star Rating Plugin JQuery Plugin designed by Krajee. This plugin is a simple yet powerful JQuery star rating plugin for Bootstrap. Developed with a focus on utlizing pure CSS-3 styling to render the control.
NOTE: This extension is a sub repo split of yii2-widgets. The split has been done since 08-Nov-2014 to allow developers to install this specific widget in isolation if needed. One can also use the extension the previous way with the whole suite of yii2-widgets.
Installation
The preferred way to install this extension is through composer. Check the composer.json for this extension's requirements and dependencies. Read this web tip /wiki on setting the minimum-stability
settings for your application's composer.json.
To install, either run
$ php composer.phar require kartik-v/yii2-widget-rating "*"
or add
"kartik-v/yii2-widget-rating": "*"
to the require
section of your composer.json
file.
Latest Release
NOTE: Refer the CHANGE LOG for details on changes to various releases.
Demo
You can refer detailed documentation and demos on usage of the extension.
Usage
use kartik\rating\StarRating; // Usage with ActiveForm and model echo $form->field($model, 'rating')->widget(StarRating::classname(), [ 'pluginOptions' => ['size'=>'lg'] ]); // With model & without ActiveForm echo StarRating::widget([ 'name' => 'rating_1', 'pluginOptions' => ['disabled'=>true, 'showClear'=>false] ]);
License
yii2-widget-rating is released under the BSD-3-Clause License. See the bundled LICENSE.md
for details.