Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Spree Commerce extension to list your retail store locations.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app include retailer type in admin/retailers#index
config upgrade to spree 1.1.0
db/migrate add retailer type class and associate it with retailers
test upgrade to spree 1.1.0
.gitignore first stab at 070 compatibility
.travis.yml only test master branch on travis [ci skip]
Rakefile clean up rakefile and include shouda matchers in activesupport::testcase
spree_retailers.gemspec upgrade to spree 1.1.0

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.