README

Elgg 的星级评分

用法

首先，您可以使用插件设置定义评分标准，或者调用 elgg_stars_register_rating_annotation_name($criteria1); 为您打算使用的每个评分标准。
添加对现有实体的评分表单

echo elgg_view_form('stars/rate', array(), array(
	'entity' => $entity,
	'annotation_names' => array($criteria1, $criteria2)
));

这将显示一个包含2个星级评分模块的表单。用户输入将实时处理。您无需在您的侧进行任何进一步编码。

要将星级输入添加到您的表单中，请简单调用

echo elgg_view('input/stars', array(
	'name' => 'stars'
));

在您的动作中，您将使用标准的 Elgg API

$stars = get_input('stars');

查看 input/stars 获取更多参数列表，包括最小值和最大值；

要获取单个或多个标准的值，您可以调用

$ratings = elgg_stars_get_entity_rating_values($entity, array($criteria1, $criteria2);

您可以将第二个参数留空，以获取所有注册评分标准的总值。

请注意，此函数将返回一个关联数组，其中：$ratings['value'] 是所有评分的实际平均值。评分未加权，因此如果您计划使用多个评分标准，您需要添加自己的加权算法。

要显示星级评分尺度上的任何值

echo elgg_view('output/stars', array(
	'value' => $my_value
));

您还可以指定 'min'、'max' 和 'step' 参数来配置尺度。

快速、渐进增强、触摸支持、可定制（只需更换图片或更改一些 CSS）、无障碍 JavaScript（使用 HTML5 data-* 属性）、RTL 支持、ARIA & 键盘支持。您可以使用任意数量的星星，以及任意步长。