MongoidCart

ActsAsProduct for Mongoid::Documents

Simple Mongoid based shopping cart. Every Model can get a Product to put into a cart. You simply need a User model and one or more models which should act as a product. Tests are written in rSpec.

Features:

• Multiple Models can be put into cart
• CartController already setup
• current_cart view_helpers for cart
• able to set more than one cart (multiple wishlists) (@wip)

@wip This project is evolving and work in progress! If you wanna use a most basic working version, you can nail down version 0.5. Use without version to stay on top.

Please feel free to contribute (Pull requests).

This project rocks and uses MIT-LICENSE.

Usage:

Put this into your gemfile

gem 'mongoid_cart'

Mount the cart engine and put this into your routes.rb (you can skip this, if you already have your cart_views)

mount MongoidCart::Engine => '/cart'

Now you have the CartController ready setup

Let's add the functionality to your model(s) Yes, you can attach this to more than one! ;-)

include MongoidCart::ActsAsProduct

With this line above your model will get new fields, relations and functions, you can override them in your model if you want, but they are present already:

field :sku, type: String # unique Product ID
field :product_title, type: String # Title/Name of the product
field :net_price, type: Float # simple net price for item
field :in_stock, type: Float # simple net price for item
field :units, type: Array # must provide an array with values for units of product

validates_presence_of :product_title, :net_price, :in_stock, :units

has_many :cart_items
carts # return all carts, where the product is used.

type # returns the class_name as string. This will be used by MongoidCart to be able to fetch your products.
cart # returns the cart.
amount= # set the amount to add or reduce
unit= # any unit of self.units
to_cart_item_params #returns params prepared to add to a cart. Can also be used in views for example.

Attach User to be able to have carts

include MongoidCart::ActsAsCustomer

This adds the following functions to your User.model

current_cart # returns the very last cart or creates one
carts # returns all carts of user

relations automatically created

+----------------+    +-------------------+   +----------------------+  +----------------------+
|                |    |                   |   |                      |  |        Model 1       |
|                |    |                   |   |                      |  |                      |
|     User       |    |                   |   |                      |  |        Product       |
| ActsAsCustomer +--> | MongoidCart::Cart <---+ MongoidCart::CartItem+-->     ActsAsProduct    |
|                |    |                   |   |                      |  |                      |
|                |    |                   |   |                      |  |                      |
|                |    |                   |   |                      |  |                      |
+----------------+    +-------------------+   +----------------------+  +----------------------+
                                                                     |
 has_many :carts       belongs_to :customer     belongs_to :cart     |   has_many :cart_items
                       has_many :cart_items     belongs_to :product  |   carts
                       products                 belongs_to :another_product
                       another_products                              |
                                                                     |  +----------------------+
                                                                     |  |       Model 2        |
                                                                     |  |                      |
                                                                     |  |    AnotherProduct    |
                                                                     --->    ActsAsProduct     |
                                                                        |                      |
                                                                        |                      |
                                                                        |                      |
                                                                        +----------------------+
                                                                                                                                                              has_many :cart_items
                                                                               carts

Now you can use it like this:

Your cart can be retrieved via current_cart

# add one product to cart
current_user.current_cart.add(Product.last)
# increments product by one if already given
current_user.current_cart.add(Product.last)

(if unit is not set, it will always the first unit in `units` array)

# increment product by n, and specific unit
current_user.current_cart.add(AnotherProduct.first, 2, AnotherProduct.units.sample)

# decrement product by one
current_user.current_cart.remove(Product.last)

# decrement product by n
current_user.current_cart.remove(Product.last, n)
current_user.current_cart.remove(Product.last, n, desired_unit)

To show your cart, simply make a partial which iterates through the ``current_cart` items

Example:

<% current_cart.each do |item| %>   
    <%= link_to(item.title, item) %> 
<% end %>

Price calculation

@wip