spree_marketplace

KO | EN

gitlite — search

#javascript #nodejs #android #java #html #hacktoberfest #postcss #linux #css #spring #llvm #translation

spree_marketplace

★ 74 Open GitHub ↗

Turn Spree into a marketplace by extending spree drop ship.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

### Check out the latest, officially maintained [Spree Multi Vendor marketplace](https://github.com/spree-contrib/spree_multi_vendor) extension

SpreeMarketplace
================

[![Build Status](https://travis-ci.org/JDutil/spree_marketplace.svg?branch=master)](https://travis-ci.org/JDutil/spree_marketplace)
[![Code Climate](https://codeclimate.com/github/jdutil/spree_marketplace.png)](https://codeclimate.com/github/jdutil/spree_marketplace)
[![Coverage Status](https://coveralls.io/repos/jdutil/spree_marketplace/badge.png?branch=master)](https://coveralls.io/r/jdutil/spree_marketplace)
[![Dependency Status](https://gemnasium.com/jdutil/spree_marketplace.png?travis)](https://gemnasium.com/jdutil/spree_marketplace)

Spree Marketplace uses the [Spree Drop Ship](https://github.com/jdutil/spree_drop_ship) extension in order to enable using Spree as a Marketplace.  Mainly all that really means is that this extension enables sending payments to your drop ship suppliers through [Stripe](https://stripe.com) with their payment service.

All the other main marketplace functionality - such as - vendors, product setup, shipment details etc... is all accomplished by [Spree Drop Ship](https://github.com/jdutil/spree_drop_ship).

Integrations
------------

Spree Marketplace will support several other Spree extensions being used by scoping information by supplier.

Some extensions that can be used in conjunction with Spree Marketplace:

* spree_digital
* spree_editor (assumes use of ckeditor & you should delete the generated models & initializer in your app to use spree_editors copies)
* spree_group_pricing
* spree_marketplace
* spree_related_products

Please Note: If you intend to use any of these extensions you should install them before installing spree_marketplace so that spree_marketplace's migrations are run last.  You should also place spree_drop_ship & spree_marketplace AFTER all other extensions in your Gemfile.

Installation
------------

Add spree_marketplace to your Gemfile:

```ruby
gem 'spree_marketplace', github: 'jdutil/spree_marketplace'
```

Bundle your dependencies and run the installation generator:

```shell
bundle
bundle exec rails g spree_marketplace:install
```

Configuration
-------------

Once installed you must configure your [Stripe](https://stripe.com) API keys.  To do so you have two options:

1) Simply setup either as your payment processing method and spree_marketplace will use your payment methods api key.

2) Configure in an initializer by adding the following to the end of your `config/intializers/spree.rb`:

SpreeMarketplace::Config[:stripe_publishable_key] = 'YourPublishableKey'
    SpreeMarketplace::Config[:stripe_secret_key] = 'YourSecretKey'

3) Currently you must implement your own payment code as this varies between applications, but once the TODO list is complete this will be an optional configuration likely in a rake task.

Testing
-------

Be sure to bundle your dependencies and then create a dummy test app for the specs to run against.

```shell
bundle
bundle exec rake test_app
bundle exec rspec spec
```

When testing your applications integration with this extension you may use it's factories.
Simply add this require statement to your spec_helper:

```ruby
require 'spree_marketplace/factories'
```

TODO
----

- stop overridding spree_drop_ship's supplier ability if possible
- update product management of products
- permit attributes in controller
- On dso complete credit supplier bank account
- On order complete credit marketplace bank account w/commission
- On order complete credit marketplace bank account w/tax?
- Refactor to not rely on stripe & be interchangeable.
- suppliers should be able to manage option types and values (unsure about whether to scope to supplier or not, but thats probably best solution for everyone)

spree_marketplace

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README