编辑“Gallery:模块:评价（rating）”

== 介绍 ==
Gallery2评价/评分（rating）模块是在Gallery2.1中添加进来的。
其编写者是[http://seiler.us Don Seiler (rizzo)]，以及valiant，mindless和bharat的大力协助。

== 特点 ==

Gallery 2.2添加了一个动态相册视图用以显示Gallery中获得较高评价的项目。在站点管理中可为此视图配置外观主题，外观主题设定以及分类次序。

=== 用户界面 ===

Gallery2评价模块使用一个5星界面，该界面用于用户评分的选取以及平均评分的显示。默认的外观主题使用金色的星星来代表用户的选择，而带红色边框的星星则用于表示该项目的当前平均分。

该模块具有外观主题可定制性。因此外观主题开发者应该能修改图片而且可以使用水平评分条。该评分条默认是隐藏的。

==== AJAX ====

星形UI使用的是最新的internet科技中的流行词，那就是AJAX！对于一般用户来说，这意味着无需进行页面重载入就可以提交评分以及评分显示的更新。Javascript以及后台HTTP呼叫将做此项工作并更新页面。

=== 权限 ===

Gallery2的rating模块充分利用了Gallery2的权限系统，因此某站点管理员可以限制特定用户组用户对项目评分的添加甚至查看。最简单的例子就是让所有人查看评价，但仅允许已注册用户添加评分。

=== 分类排序 ===

你能够通过评分（同时包括升序和降序）来对某相册中的项目进行分类排序。

==== 投票偏移保护====

我们对恶意刷投票数的行为还是有防范的，Gallery2的评价模块就印证了这一点。基本上它只允许单个用户对一个项目进行投票。当匿名用户进行投票时，我们会追踪他的会话ID以及远程识别器信息以确定唯一的用户。为了能够打造一个公平公正的评价系统，我们会做更多的努力来完善这个模块的。

== 截图==
''有的时候我会发上来的。''

== 用法 ==

要启用评分的话，你需要同时启用rating模块'''并为相册属性（编辑相册->相册）下的某个给定相册开启rating'''。

定义权限（可以为各相册/项目进行定义）：浏览某个相册，点击编辑权限并添加或移除特定用户或组的''添加评分（add ratings）''和''查看评分（view ratings）''权限。

通过选择编辑相册->外观主题下的评价''区块''来向便利/相册页面/相片页面添加评分界面。

== 自定义==
通过调整CSS，模板以及图片你可以自定义评分界面的呈现方式。

要调整CSS的话，打开themes/*/theme.css并添加
  .giRatingUI img {}
  .giRatingUnit {}
  .giRatingHidden {}
  .giRatingVotes {}
  .giRatingEmpty {}
  .giRatingEmptyUserYes {}
  .giRatingHalfUserNo {}
  .giRatingHalfUserYes {}
  .giRatingFullUserNo {}
  .giRatingFullUserYes {}
  .giRatingAverage {}
当然你可以在{}中设定任何的CSS。你ihai可以修改一下的CSS类别：
  .giRatingUI {
      margin: 10px auto; /* 为默认评分模块星形图像的居中所必须*/
  }
  #gsThumbMatrix .giRatingAverageContainer {
      margin: auto;
  }

== Bug及特点请求 ==

所有Gallery2.1模块中的bug和特点请求都应分别地归档到Gallery的sourceforge [http://sourceforge.net/tracker/?group_id=7130&atid=107130 bug]以及 [http://sourceforge.net/tracker/?group_id=7130&atid=357130 特点请求]跟踪中。

有关gallery-contrib模块的任何bug都应通过电子邮件告知Don Seiler，don [at] seiler [dot] us。2.1之前的版本不接受新特点请求。

=== 任务 ===
该模块为一effort satisfy的[http://sourceforge.net/pm/task.php?func=detailtask&project_task_id=106402&group_id=7130&group_project_id=14056 Task #106402]。；另有有关该主题的 [http://gallery.menalto.com/node/34758 论坛帖子]。

* Remove rating specific CSS from theme.css and the css that needs to be there should be generalized, there should not be rating specific CSS in theme.css (we can't have a monolithic CSS file for our modular application)

=== 特点请求 ===
'''Change/erase ratings:''' [http://gallery.menalto.com/node/78129 Modify Rating enhancement]

''These should be added to the Gallery2 RFE tracker.'' --[[User:Rizzo|Rizzo]] 13:07, 16 December 2005 (PST)

I'm putting these in a priority order, and grouping what I see as dupes or related.

# Enable iconpack developers to include alternate stars that can be used in place of default stars --[[User:Thumb|thumb]] 19:07, 22 November 2005 (PST)
# A block on the photo page or in the sidebar could have more than 1 line, so we could have 1 line to show your rating and 1 line to show the average
#* I think this is a theme issue.  If we do things right then the theme can define it, but it would still be the same for item summaries vs blocks, since they use the same template.
# A top x rated items block
#* keep your pr0n site requests off here.  or email them with a paypal donation ;)  --[[User:Rizzo|Rizzo]] 08:32, 11 November 2005 (PST)
# Add other voting / rating styles, not just 5 stars. Maybe drop dwon / radio votes too, with user defined text...
# Enable voting option as an overlay of image blocks
# combine with the dynamic_view module in order to get a "top-of-album/subalbum" selection based on viewer's votes

[[category:Gallery 2:Modules]]