Skip to content

spree-contrib/spree_reviews

Folders and files

NameName
Last commit message
Last commit date
Jun 19, 2023
Nov 27, 2014
Jun 19, 2023
Aug 22, 2021
Feb 27, 2021
Jun 19, 2023
Jun 19, 2023
Jun 5, 2013
Jun 19, 2023
Nov 26, 2014
Feb 27, 2021
Feb 27, 2021
Feb 27, 2021
Feb 28, 2021
Jan 25, 2015
Jun 19, 2023
Jan 25, 2015
Feb 28, 2021
Jan 1, 2021
Jun 19, 2023

Repository files navigation

Reviews

Build Status Code Climate

Straightforward review/rating functionality.


Installation

Spree >= 3.1

gem 'spree_reviews', github: 'spree-contrib/spree_reviews'

Spree 3.0 and Spree 2.x

gem 'spree_reviews', github: 'spree-contrib/spree_reviews', branch: 'X-X-stable'

The branch option is important: it must match the version of Spree you're using. For example, use 3-0-stable if you're using Spree 3-0-stable or any 3.0.x version.

Now bundle up with:

bundle

Next, run the rake task that copies the necessary migrations and assets to your project:

bundle exec rails g spree_reviews:install

And finish with a migrate:

bundle exec rake db:migrate

Now you should be able to boot up your server with:

bundle exec rails s

That's all!


Usage

Action "submit" in "reviews" controller - goes to review entry form

Users must be logged in to submit a review

Three partials:

  • app/views/spree/products/_rating.html.erb -- display number of stars
  • app/views/spree/products/_shortrating.html.erb -- shorter version of above
  • app/views/spree/products/_review.html.erb -- display a single review

Administrator can edit and/or approve and/or delete reviews.

Implementation

Reviews table is quite obvious - and note the "approved" flag which is for the administrator to update.

Ratings table holds current fractional value - avoids frequent recalc...


Discussion

Some points which might need modification in future:

  • I don't track the actual user on a review (just their "screen name" at the time), but we may want to use this information to avoid duplicate reviews etc. See #18
  • Rating votes are tied to a review, to avoid spam. However: ratings are accepted whether or not the review is accepted. Perhaps they should only be counted when the review is approved.

Contributing

See corresponding contributing guidelines.


Copyright (c) 2009-2021 Spree Commerce and contributors, released under the New BSD License