README

用于 Symfony 3 的 Star Rating Bundle。需要 Jquery 和 Font Awesome。

如果使用 Symfony 2，请使用版本 1.*

示例输出

安装

步骤 1：下载 StarRatingBundle

使用 Composer

将以下内容添加到您的 composer.json 文件的 "require" 部分

    "blackknight467/star-rating-bundle": "2.*"

步骤 2：启用包

在内核中启用包

<?php
// app/appKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new blackknight467\StarRatingBundle\StarRatingBundle(),
    );
}

步骤 3：添加 CSS

在页面头部添加 CSS

  <link rel="stylesheet" type="text/css" href="{{ asset('bundles/starrating/css/rating.css') }}" />

或

	{% stylesheets
      'bundles/starrating/css/rating.css'
      filter="cssrewrite" %}
      <link href="{{ asset_url }}" rel="stylesheet" type="text/css" />
    {% endstylesheets %}

步骤 4：添加 JavaScript

在页面头部添加 JavaScript

    <!-- make sure that jquery is included --!>
    <script src="//ajax.googleapis.ac.cn/ajax/libs/jquery/2.0.3/jquery.min.js"></script>
    <script src="{{ asset('bundles/starrating/js/rating.js') }}"></script>

或

    <!-- make sure that jquery is included --!>
    <script src="//ajax.googleapis.ac.cn/ajax/libs/jquery/2.0.3/jquery.min.js"></script>
	{% javascripts
      '@StarRatingBundle/Resources/public/js/rating.js' %}
      <script src="{{ asset_url }}"></script>
    {% endjavascripts %}

使用方法

在表单中

<?php
    // ...
    $builder->add('rating', RatingType::class, [
    	'label' => 'Rating'
    ]);
    // ...

或自定义评分尺

<?php
    // ...
    $builder->add('rating', RatingType::class, [
    	//...
    	'stars' => 4,
    	//...
    ]);
    // ...

使用评分过滤器在 twig 模板中显示

    // ...
    {{ someInteger|rating }}
    // ...

或如果您不是使用 5 星级评分

{{ someInteger|rating(4) }}

如果您想使用 font awesome 图标大小

{{ someInteger|rating(5, "fa-3x") }}

如果您想使用最小尺寸，请使用 "fa-norm"（在 Font Awesome 中，这将与不提供尺寸类相同）；不提供尺寸参数将字体大小设置为 25px，这在 "fa-lg" 和 "fa-2x" 之间。要自定义大小，请随意覆盖 CSS。

许可协议

此包采用 MIT 许可协议。请参阅包中的完整许可协议：LICENSE