Skip to content
Complete Ruby on Rails Ecommerce platform
Find file
Pull request Compare This branch is 1139 commits behind drhenner:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.bundle
.yardoc
app
autotest
config
db
doc
lib
public
script
solr/conf
spec
test
vendor/plugins
.gitignore
.gitmodules
.rspec
CHANGELOG.textile
Contributors.textile
Gemfile
LISENCE
README.textile
Rakefile
config.ru

README.textile

Project Overview

Please create a ticket if on github you have issues. They will be addressed ASAP.

Please look at the homepage for more details: www.ror-e.com

This is a Rails e-commerce platform. Other e-commerce projects that
use rails, don’t use rails in a standard way. They use engines or are a separate
framework altogether.

ROR ecommerce is a Rails 3 application with the intent to allow developers to create
an ecommerce solution easily. This solution includes, an Admin for Purchase Orders,
Product creation, Shipments, Fulfillment and creating Orders. There is a minimal
customer facing shopping cart understanding that this will be customized. The cart allows
you to track your customers cart history and includes a double entry accounting system.

The project has solr searching, compass and blueprint for CSS and uses jQuery.
The gem list is quite large and the project still has a large wish list but it is the most
complete solution for Rails today and it will only get better.

Please use Ruby 1.9.2 and enjoy Rails 3.1.1.

ROR_ecommerce is designed differently. If you understand Rails you will understand ROR_ecommerce.
There is nothing in this project that you wouldn’t see in a normal Rails application. If you don’t like
what is in the project just change it like you would in any other Rails app.

Contributors are welcome. For now email David Henner (drhenner@yahoo.com) to see how you
can contribute. (send your patch if you have one.) Soon there will be a bug tracking
system and a formal way to submit your patch.

We will always need help with UI, Documentation and code so feel free to help.

Getting Started

We have a google group. Ask question and help answer questions.
ror_ecommerce Google-group

install rvm with ruby 1.9.2 or if you have 1.9.2 on your system you’re good to go. Please refer to the rvm and bundler home pages for more details.

Configure your database.yml file (add the development and test database)

  1. Go into config/config.yml and change the encryption_key

aes = OpenSSL::Cipher::Cipher.new(‘AES-256-CBC’)
set_encryption_key_to = aes.random_iv

  1. gem install bundler
  2. bundle install
  3. rake db:create
  4. rake db:migrate
  5. rake db:seed
  6. rake db:test:prepare

######compass install

Need to create config/config.yml and change the encryption key and paypal or auth.net information.
You can also change config/config.yml.example to config/config.yml until you get your real info.

Paperclip will throw errors if not configured correctly.
you will need to find out where the Imagemagick program is installed
type “which identify” in the terminal and set Paperclip.options[:command_path] equal
to that path in environment.rb: Examples:
Paperclip.options[:command_path] = “/usr/local/bin”
into:
Paperclip.options[:command_path] = “/usr/bin”

Once everything is setup, start up the server with ‘rails server’ and direct it to
localhost:3000/admin/overviews

write down the username/password and follow the directions.

Adding Dalli for cache and the session store

Install memcached, this is easiest to do with homebrew and :

brew install memcached

memcached -vv ## you can config many other cache stores but
## the cookie store will not work (in the admin) and the DB session store will be a dog

TO TURN ON THE DALLI COOKIE STORE

Remove the cookie store on line one of config/initializers/session_store.rb go to the Gemfile and add

gem 'dalli'

then

bundle install
Finally UNCOMMENT the next 2 lines in config/initializers/session_store.rb

require 'action_dispatch/middleware/session/dalli_store'
Hadean::Application.config.session_store :dalli_store, :key => '_hadean_session_ugrdr6765745ce4vy'

TO TURN ON THE DALLI CACHE STORE

it is also recommended to change the cache store in config/environments/*.rb

config.cache_store = :dalli_store

Adding Solr Search

brew install solr

Uncomment the following in your gemfile

#gem 'sunspot_solr'
#gem 'sunspot_rails', '~> 1.3'

bundle install

start solr before starting you server
rake sunspot:solr:start

Go into product.rb and uncomment the following

searchable do
  text    :name, :default_boost => 2
  text      :product_keywords#, :multiple => true
  text      :description
  time      :deleted_at
end

Take a look at setting up solr
Solr in 5 minutes

If you get the following error: Errno::ECONNREFUSED (Connection refused – connect(2)): when you try to create a product or upload an image you have not started solr search. remember you need to run “rake sunspot:solr:start” or remove solr/search

TODOs:

  • product sales (eg. 20% off)
  • make admin UI have a better flow (product creation/ images / inventory)
  • remove memcached requirement
  • move solr to an engine
  • more documentation / videos for creating products/variants
  • easy setup of fake data for getting started

Author

RoR Ecommerce was written by David Henner with contributions from:

  • Oren Golan
  • Yury Velikanau

FYI:

Shipping categories are categories based off price:

you might have two shipping categories (light items) & (heavy items)
Have fun!!!

Something went wrong with that request. Please try again.