Skip to content

brayvasq/spree_multi_vendor

 
 

Repository files navigation

Spree Multi Vendor

Build Status

This is a spree multi vendor marketplace extension. It's a great starting point if you're building a marketplace on top of Spree. Our goal was flexibility to allow you to tweak it to your needs.

Check out this extension multi vendor marketplace demo and launch your marketplace within weeks, not months.

Developed and maintained by:

Spark Solutions

Features

You can create and manage Vendors who can manage on their own:

  • Orders
  • Products
  • Option Types
  • Properties
  • Stock Locations
  • Shipping Methods
  • Vendor profile

Also:

  • Super Admins can assign Users to Vendors
  • You can modify which permissions and models/resources Vendors can manage quite easily

Contributions welcome! :)

Installation

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

    gem 'spree_multi_vendor', github: 'spree-contrib/spree_multi_vendor'
  2. Install the gem using Bundler:

    bundle install
  3. Copy & run migrations

    bundle exec rails g spree_multi_vendor:install
  4. Restart your server

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

  5. Optionally you can also create sample Vendor by running:

    bundle exec rake spree_multi_vendor:sample:create

Upgrading

  1. Fetch new database migrations:

    bundle exec rake railties:install:migrations FROM=spree_multi_vendor
  2. Run migrations

    bundle exec rails db:migrate

Email previews

Spree offers emails preview generator for development purposes. To generate them, use command:

bundle exec rails g spree_multi_vendor:mailers_preview

After that, start rails server locally and go to: localhost:3000/rails/mailers

(it requires seeded development database in order to work properly)

Testing

First bundle your dependencies, then run rake. rake will default to building the dummy app if it does not exist, then it will run specs. The dummy app can be regenerated by using rake test_app.

bundle
bundle exec rake

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

require 'spree_multi_vendor/factories'

Contributing

If you'd like to contribute, please take a look at the instructions for installing dependencies and crafting a good pull request.

License

Spree Multi Vendor is copyright © 2017-2018 Spark Solutions Sp. z o.o.. It is free software, and may be redistributed under the terms specified in the LICENCE file.

About Spark Solutions

Spark Solutions

Spree Vendors is maintained by Spark Solutions Sp. z o.o.

We are passionate about open source software. We are available for hire.

Packages

No packages published

Languages

  • Ruby 90.8%
  • HTML 9.2%