Open is the newest approach to the e-commerce solution built with Ruby on Rails. It is a fork of Spree.
Open consists of several gems. When you require the open
gem in your
Gemfile
, Bundler will install all of the gems maintained in this repository:
- open_api (RESTful API)
- open_frontend (Customer frontend)
- open_backend (Admin panel)
- open_core (Essential models, mailers, and classes)
- open_sample (Sample data)
Set up your local environment:
-
Install Ruby version 2.5.0 or newer.
-
Install the Rails 5 gem.
-
Install the Bundler gem.
Create a new app to your open store. Run the rails new command to create a new Rails app:
rails new open
Go to the directory that contains the generated Rails app:
cd open
Use a text editor to add Open gems to your Gemfile:
nano Gemfile
and add:
gem 'open', github: '99cm/open'
gem 'open_auth_devise', github: '99cm/open_auth_devise'
gem 'open_gateway', github: '99cm/open_gateway'
To run the new Rails app on your local computer, install dependencies by using Bundler:
bundle install
Start a local web server:
bundle exec bin/rails server
By default, the installation generator (rails g spree:install
) will run
migrations as well as adding seed and sample data. This can be disabled using
rails g spree:install --migrate=false --sample=false --seed=false
You can always perform any of these steps later by using these commands.
bundle exec rake railties:install:migrations
bundle exec rake db:migrate
bundle exec rake db:seed
bundle exec rake spree_sample:load
rails open_api:install:migrations
rails open_auth:install:migrations
rails open_gateway:install:migrations
Open Extensions provide additional features not present in the Core system.
Extension | Description |
---|---|
open_gateway | Open Store payment system builds with Open supported payment method gateways. |
open_auth_devise | Provides authentication services for Open, using the Devise gem. |
open_active_shipping | Provides active shipping to get shipping rates and tracking from various carriers. |
open_globalize | This is an integration of the Globalize with Open to localize model data. |
open_i18n | Provides translation files supporting Open that users can select and switch languages. |
open_editor | Supports to setup popular WYSIWYG text editor on Open project. |
open_essential_content | Provides static pages, content snippets, blogs, and an asset-upload interface on Open. |
open_print_invoice | Provides a model of bookkeeping document, which generates viewable and printable PDF. |
open_reviews | Provides basic review/rating functionality. |
open_reviews | Add comment and message funtionality to Open. |
Create a sandbox Rails application for testing purposes which automatically perform all necessary database setup
bundle exec rake sandbox
Start the server
cd sandbox
rails server