README

简单的评分插件

要求

此插件需要 Craft CMS 3.0.0-beta.23 或更高版本。

安装

要安装此插件，请按照以下说明操作。

1. 打开您的终端并进入您的 Craft 项目

    cd /path/to/project
   

2. 然后告诉 Composer 加载插件

    composer require ournameismud/rate-me
   

3. 在控制面板中，转到设置 → 插件，然后点击 Rate Me 的“安装”按钮。

Rate Me 概述

捕获元素评分的简单插件。

配置 Rate Me

插件提供了以下设置

仅限登录用户

勾选此选项以限制发表评论仅限于登录用户（否则评分可以匿名提交）。

电子邮件接收者

您可以为发表评分时通知的接收者指定接收者。只需添加逗号分隔的电子邮件接收者列表。

使用 Rate Me

示例表单

带有 1 到 5 级评分下拉菜单的示例表单

<form method="POST">
	<input type="hidden" name="action" value="rate-me/default/rate" />
	<input type="hidden" name="element" value="{{ elementId }}" />
	{{ csrfInput() }}
	{% set rating = craft.rateMe.getRating( elementId ) %}
	<fieldset>
		<legend>Rate Me</legend>
		<label for="rating">Rating</label>
		<select name="rating" id="rating">
			{% for i in 1..5 %}
			<option {{ rating == i ? 'selected' }} value="{{ i }}">{{ i }}</option>
			{% endfor %}
		</select>	
		<button" type="submit">{{'Submit'|t}}</button>
	</fieldset>
</form>

变量

getRating

将元素 ID 传递到以下：{{ craft.rateMe.getRating( elementId ) }} 以获取该用户的评分（如果未登录则将生成匿名会话 ID）

getAverage

要获取特定元素的平均评分，请使用以下：{% set average = craft.rateMe.getAverage( elementId ) %}。这将返回一个包含计数和平均评分的对象，例如 {{ average.rating }} 和 {{ average.count }}。如果该元素不存在评分，则该变量将返回 null。

您可以使用 |number_format twig 过滤器来四舍五入评分数字。

Rate Me 路线图

一些要完成的事情以及潜在功能的想法

• 发布它

由 @cole007 提供，图标由 Rose Alice Design 设计，来自 Noun Project