Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Related products extension for SpreeCommerce.com
Ruby

This branch is 92 commits behind spree-contrib:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app
config
db/migrate
lib
script
spec
.gitignore
.rspec
.travis.yml
Gemfile
README.md
Rakefile
Versionfile
spree_related_products.gemspec

README.md

Related Products

Build
Status

This extension provides a generic way for you to define different types of relationships between your products, by defining a RelationType for each type of relationship you'd like to maintain.

You can manage RelationTypes via the admin configuration menu, and you can maintain product relationships via Related Products tab on the edit product UI.

Possible uses

  • Accessories

  • Cross Sells

  • Up Sells

  • Compatible Products

  • Replacement Products

  • Warranty & Support Products

Relation Types

When you create a RelationType you can access that set of related products by referencing the relation_type name, see below for an example:

    rt = Spree::RelationType.create(:name => "Accessories", :applies_to => "Spree::Product")
     => #<Spree::RelationType id: 4, name: "Accessories" ...>
    product = Spree::Product.last
     => #<Spree::Product id: 1060500592 ...>
    product.accessories
     => []

You can access all related products regardless of RelationType by:

    product.relations
     => []

Discounts You can optionally specify a discount amount to be applied if a customer purchases both products.

Note: In order for the coupon to be automatically applied, you must create a promotion leaving the code value empty, and adding an Action of type : RelatedProductDiscount (blank codes are required for coupons to be automatically applied).

Installation

Add to Gemfile:

gem 'spree_related_products', :git => 'git://github.com/spree/spree_related_products.git'

Run:

$ bundle
$ bundle exec rails g spree_related_products:install

Development

* Fork the repo
* clone your repo
* Run `bundle`
* Run `bundle exec rake test_app` to create the test application in `spec/test_app`.
* Make your changes.
* Ensure specs pass by running `bundle exec rake`
* Submit your pull request
Something went wrong with that request. Please try again.