Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Spree Commerce extension to list your retail store locations.
Ruby JavaScript
Fetching latest commit...
Cannot retrieve the latest commit at this time.

Spree Retailers Build Status

Spree Retailers is a Spree extension for listing your company's retail stores on your web site.


As usual, add 'spree_retailers' to your Gemfile and run bundle install:

# Spree 1.1.x
gem 'spree_retailers', :git => 'git://'

# Spree 1.0.x
gem 'spree_retailers', ''

# Spree 0.70.x
gem 'spree_retailers', ''

# Spree 0.50.x, 0.60.x
gem 'spree_retailers', ''

# Spree 0.40.x 
gem 'spree_retailers', ''

# install from source
gem 'spree_retailers', :git => 'git://'

Next, copy the migration file to your project:

# Spree 0.40.x, 0.50.x and 0.60.x
rake spree_retailers:install

# 0.70.x and above
rails g spree_retailers:install

Now, migrate your database with:

rake db:migrate

CSV Import

To import retailers via a CSV:

rake spree_retailers:import FILE=international_distributors.csv TYPE=Distributors SKIP_VALIDATION=true

Where the CSV file contains headers with the following names:
name, address, city, state, country, zipcode, phone, email, url, logo. SKIP_VALIDATION is only really helpful when you importing data that is missing the address fields


If you'd like to run tests:

git clone git://
cd spree_retailers
bundle install
bundle exec dummier
bundle exec rake


If you'd like a demo of spree_retailers:

git clone git://
cd spree_retailers
cp test/dummy_hooks/after_migrate.rb.sample test/dummy_hooks/after_migrate.rb
bundle install
bundle exec dummier
cd test/dummy
rails s


If you'd like to help out feel free to fork and send me pull requests!

To Do

  • Google map integration (we're already geocoding, so why not?)
  • Add (better) International Support


Copyright (c) 2011 - 2012 Spencer Steffen and Citrus, released under the New BSD License All rights reserved.

Something went wrong with that request. Please try again.