/spree-multi-domain

Multiple Spree stores on different domains - single unified backed for processing orders

Primary LanguageRuby

Multi Domain Store

This extension allows a single Spree instance to have several customer facing stores, with a single shared backend administration system (i.e. multi-store, single-vendor).

Current features:

  1. Store model which has the following attributes:

    1.1 name - The display name for the store.

    1.2 domains - a line separated list of fully qualified domain names used to associate a customers session with a particular store (you can use localhost and/or IP addresses too).

    1.3 code - which is a abbreviated version of the store's name (used as the layout directory name, and also helpful for separating partials by store).

    1.4 default - one store should be marked a default as a fallback in case the URL being used to access the site cannot be matched against any of the configured stores.

  2. Stores and domains can be maintained via the configuration section of the Admin interface

  3. Each store can have its own layout(s) - these layouts should be located in your site's theme extension in the app/views/spree/layouts/store#code/ directory. So, if you have a store with a code of "alpha" you should store its default layout in app/views/spree/layouts/alpha/spree_application.html.erb

  4. Each product can be assigned to one or more stores.

  5. All orders are associated with the store / domain that they were placed on.

  6. Google analytics trackers can be associated with a store.

Installation

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

Spree >= 3.1

gem 'spree_multi_domain', github: 'spree-contrib/spree-multi-domain'

Spree 3.0 and Spree 2.x

gem 'spree_multi_domain', github: 'spree-contrib/spree-multi-domain', branch: 'X-X-stable'

The branch option is important: it must match the version of Spree you're using. For example, use 3-0-stable if you're using Spree 3-0-stable or any 3.0.x version.

  1. Install the gem using Bundler:
bundle install
  1. Copy & run migrations
bundle exec rails g spree_multi_domain:install
  1. Restart your server

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

You should see 'Stores & Domains' in Configuration tab of Spree Admin.

Features To-do

  1. Taxonomies - associate stores with taxonomies.