#ROR Ecommerce
##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
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.2.
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. Fork this repo, make any changes (big or small) and create a pull request.
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 Ruby 1.9.3. If you have 1.9.2 or 1.9.3 on your system you're good to go. Please refer to the RVM site for more details.
Copy the database.yml for your setup. For SQLite3, cp config/database.yml.sqlite3 config.database.yml and for MySQL cp config/database.yml.mysql config.database.yml and update for your username/password.
Run rake secret and copy what it gives you and paste it under encryption_key in config/config.yml
- gem install bundler
- bundle install
- rake db:create:all
- rake db:migrate db:seed
- rake db:test:prepare
Once everything is setup, start up the server with rails server and direct your web browser to localhost:3000/admin/overviews. Write down the username/password (these are only shown once) and follow the directions.
##Quick Evaluation
If you just want to see what ror_ecommerce looks like, before you enter and products into the database run the following command:
rake db:seed_fake
Now you should have a minimal dataset to go through the various parts of the app. Make should you have the config/config.yml setup before you try to checkout though. Also take a look at The 15 minute e-commerce video
##YARDOCS
If you would like to see the docs then you can generate them with the following command:
yardoc --no-private --protected app/models/*.rb
####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 Imagemagick 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"
##Adding Dalli for cache and the session store
This isn't required, but for a speedy site, using memcached is a good idea.
Install memcached, If you're on a Mac, the easiest way to install Memcached is to use homebrew and run:
brew install memcached
memcached -vv
####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
brew install solr
Uncomment the following in your gemfile
#gem 'sunspot_solr'
#gem 'sunspot_rails', '~> 1.3'
then
bundle install
start solr before starting you server rake sunspot:solr:start
Go to the bottom of product.rb and uncomment the section with "Product.class_eval"
Take a look at setting up solr - Solr in 5 minutes
If you get the error, Errno::ECONNREFUSED (Connection refused - connect(2)): when you try to create a product or upload an image, you have not started solr search. You need to run rake sunspot:solr:start or remove solr completely.
##TODOs:
- product sales (eg. 20% off)
- more documentation / videos for creating products/variants
- easy setup of fake data for getting started
##Author
RoR Ecommerce was created by David Henner. Contributors.
##FYI:
Shipping categories are categories based off price:
you might have two shipping categories (light items) & (heavy items)
Have fun!!!