Repository files navigation

Related Products is aSpree Commerce extension that 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 viaRelated Products tab on the edit product UI.

• Accessories
• Cross Sells
• Up Sells
• Compatible Products
• Replacement Products
• Warranty & Support Products

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=>[]

Since respond_to? will not work in this case, you can test whether a relation_type method exists with has_related_products?(method):

product.has_related_products?('accessories')# => trueifproduct.has_related_products?('accessories')# Display an accessories box..end

You can access all related products regardless of RelationType by:

product.relations=>[]

DiscountsYou 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 thecode value empty, and adding an Action of type :RelatedProductDiscount (blank codes are required for coupons to be automatically applied).

1. Add this extension to your Gemfile with this line:

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

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

Thebranch option is important: it must match the version of Spree you're using.For example, use3-0-stable if you're using Spree3-0-stable or any3.0.x version.

2. Install the gem using Bundler:

bundleinstall

3. Copy & run migrations

bundleexecrailsgspree_related_products:install

4. Restart your server

If your server was running, restart it so that it can find the assets properly.

See correspondingguidelines

Copyright (c) 2010-2015Brian Quinn andcontributors, released under theNew BSD License