blackknight467 / star-rating-bundle
Star Rating Bundle for use with Symfony 2 using Font Awesome. This bundle adds the 'rating' form type and rating filter to render ratings. Simple and easy to use.
Installs: 183 024
Dependents: 0
Suggesters: 0
Security: 0
Stars: 26
Watchers: 5
Forks: 40
Open Issues: 13
Type:symfony-bundle
Requires
- php: >=5.3.2
Requires (Dev)
- symfony/framework-bundle: >=2.1
This package is not auto-updated.
Last update: 2024-10-26 15:39:28 UTC
README
Star Rating Bundle for Symfony 3. Requires Jquery and Font Awesome.
If Using Symfony 2. Use version 1.*
Sample Output
Installation
Step 1: Download the StarRatingBundle
Using Composer
Add the following to the "require" section of your composer.json
file:
"blackknight467/star-rating-bundle": "2.*"
Step 2: Enable the bundle
Enable the bundle in the kernel:
<?php // app/appKernel.php public function registerBundles() { $bundles = array( // ... new blackknight467\StarRatingBundle\StarRatingBundle(), ); }
Step 3: Add the css
Add the css in your page head
<link rel="stylesheet" type="text/css" href="{{ asset('bundles/starrating/css/rating.css') }}" />
or
{% stylesheets
'bundles/starrating/css/rating.css'
filter="cssrewrite" %}
<link href="{{ asset_url }}" rel="stylesheet" type="text/css" />
{% endstylesheets %}
Step 4: Add the js
Add the javascript to your page head
<!-- make sure that jquery is included --!>
<script src="//ajax.googleapis.com/ajax/libs/jquery/2.0.3/jquery.min.js"></script>
<script src="{{ asset('bundles/starrating/js/rating.js') }}"></script>
or
<!-- make sure that jquery is included --!>
<script src="//ajax.googleapis.com/ajax/libs/jquery/2.0.3/jquery.min.js"></script>
{% javascripts
'@StarRatingBundle/Resources/public/js/rating.js' %}
<script src="{{ asset_url }}"></script>
{% endjavascripts %}
Usage
In a Form
<?php // ... $builder->add('rating', RatingType::class, [ 'label' => 'Rating' ]); // ...
or for a custom rating scale:
<?php // ... $builder->add('rating', RatingType::class, [ //... 'stars' => 4, //... ]); // ...
Display in a twig template using the rating filter
// ...
{{ someInteger|rating }}
// ...
or if you are not using a 5 star scale
{{ someInteger|rating(4) }}
if you want to use the font awesome icon sizes
{{ someInteger|rating(5, "fa-3x") }}
If you want the smallest size use "fa-norm" (in font awesome, this would be the same as not providing an size class); providing no size argument sets the font size to 25px which is somewhere in between "fa-lg" and "fa-2x". To customize the size, feel free to override the css.
License
This bundle is under the MIT license. See the complete license in the bundle: LICENSE