solidus
v4.4.2
ストアを完全に制御できる無料のオープンソースのeコマースプラットフォーム。
コミュニティ主導のプロジェクトとして、Solidusは、Solidusをビジネスに使用する開発者と利害関係者から寄付された資金と時間に依存しています。 Solidusの成長を支援したい場合は、次のことを検討してください。
現在、NebulabはSolidusの主要なコード貢献者およびディレクターであり、技術的なガイダンスとコミュニティの取り組みと活動を調整しています。
Solidus Ambassadorになることにより、このプロジェクトをサポートします。あなたのロゴは、あなたのウェブサイトへのリンクでここに表示されます。大使になる。
Solidusは、Ruby on Railsで構築された完全なオープンソースのeコマースソリューションです。それは騒ぎのフォークです。
SolidusクラスのドキュメントとSolidusガイドを参照して、Solidusが提供する機能に関する情報をご覧ください。
ソリッドはいくつかの宝石で構成されています。 Gemfileにsolidus Gemが必要な場合、Bundlerは次のすべての宝石をインストールします。
solidus_api （RestfulAPI）solidus_backend （管理エリア）solidus_core （必須モデル、メーラー、クラス）solidus_sample （サンプルデータ）すべての宝石は、完全に機能するeコマースプラットフォームを提供するために協力するように設計されています。ただし、 solidus_core GEMを使用して、独自のカスタムフロントエンド、管理インターフェイス、およびAPIと組み合わせることのみを行う場合があります。
ライブソリッドデモをこちらでお試しください。管理者セクションにアクセスできます。
ImageMagickがインストールされていることを確認することから始めます。これは、PaperClipに必要です。 （Macにいる場合は、HomeBrewを使用してインストールできます。）
Solidusを追加するには、データベースを備えた新しく作成されたRailsアプリケーションから始めます。
rails new my_storeアプリケーションのルートフォルダーで実行されます：
bundle add solidus
bin/rails g solidus:installプロンプトの指示に従ってください。
コマンドでRailsサーバーを起動します。
bin/rails sストアフロントはhttp：// localhost：3000/でアクセスでき、管理者はhttp：// localhost：3000/admin/にあります。
ストアのカスタマイズ方法については、カスタマイズガイドをご覧ください。
上記のインストール手順を実行することの一環として、管理者の電子メール/パスワードの組み合わせを設定するように求められます。デフォルト値は、それぞれ[email protected]とtest123です。
質問をする最良の方法は、Solidus Slackに参加して#Supportチャンネルに参加することです。
安定したビルドの代わりに、Solidusの出血エッジバージョンを使用する場合は、この行を使用してください。
gem 'solidus' , github : 'solidusio/solidus'注：マスターブランチは、完全に機能する状態になることを保証されていません。この支店を生産に使用するにはリスクが高すぎます。
デフォルトでは、インストールジェネレーター（ solidus:install ）は移行を実行し、シードデータとサンプルデータを追加します。これを使用して無効にすることができます
bin/rails g solidus:install --migrate=false --sample=false --seed=falseこれらのコマンドを使用して、これらの手順のいずれかをいつでも実行できます。
bin/rails railties:install:migrations
bin/rails db:migrate
bin/rails db:seed
bin/rails spree_sample:loadSolidus_auth_deviseが提供するオプションとレーキタスクもあります。
Solidusストアは開発モードでゆっくりと実行されることに気付くかもしれません。これは、開発中に各CSSとJavaScriptが個別のインクルードとしてロードされるためです。これはconfig/environments/development.rbに以下を追加することで無効にできます。
config . assets . debug = false余分な速度を得るには、Solidus管理者の内部でTurbolinkを有効にすることができます。
gem 'turbolinks', '~> 5.0.0'をGemfile （まだ存在していない場合）に追加し、 vendor/assets/javascripts/spree/backend/all.js次のように変更します。
//= require turbolinks
//
// ... current file content
//
//= require spree/backend/turbolinks-integration.js注意Turbolinksは、Solidus管理者への拡張機能やカスタマイズを破ることができることに注意してください。あなた自身の責任で使用してください。
Git Repoをクローンします
git clone git://github.com/solidusio/solidus.git
cd solidusGEM依存関係をインストールします
bin/setup注：PostgreSQLまたはMySQLを使用している場合は、DB環境変数を介してそれらの宝石をインストールする必要があります。
# PostgreSQL
export DB=postgresql
bin/setup
# MySQL
export DB=mysql
bin/setupdocker-compose up -dすべての宝石がインストールされるのを待ちます（ docker-compose logs -f appを介して進行状況を確認できます）。
画像を使用したいRubyバージョンを提供できます。
docker-compose build --build-arg RUBY_VERSION=3.0 app
docker-compose up -d Railsバージョンは、 RAILS_VERSION環境変数を介して実行時にカスタマイズできます。
RAILS_VERSION= ' ~> 5.0 ' docker-compose up -d実行中のテスト：
# sqlite
docker-compose exec app bin/rspec
# postgres
docker-compose exec app env DB=postgres bin/rspec
# mysql
docker-compose exec app env DB=mysql bin/rspecデータベースへのアクセス：
# sqlite
docker-compose exec app sqlite3 /path/to/db
# postgres
docker-compose exec app env PGPASSWORD=password psql -U root -h postgres
# mysql
docker-compose exec app mysql -u root -h mysql -ppassword Sandboxアプリケーションにアクセスできるようにするには、 rails serverに適切な--bindingオプションを提供してください。デフォルトでは、ポート3000が公開されていますが、 SANDBOX_PORT環境変数を介して変更できます。
SANDBOX_PORT=4000 docker-compose up -d
docker-compose exec app bin/sandbox
docker-compose exec app bin/rails server --binding 0.0.0.0 --port 4000Solidusは、Railsアプリケーションのコンテキスト内で実行されることを目的としています。テスト目的で、クローン化されたソースディレクトリ内にサンドボックスアプリケーションを簡単に作成できます。
このサンドボックスには、solidus_auth_deviseが含まれており、既にロードされている種子とサンプルデータで生成されます。
サンドボックスアプリケーションを作成します
bin/sandboxDB環境変数を設定することにより、PostgreSQLまたはMySQLを使用してサンドボックスを作成できます。
# PostgreSQL
export DB=postgresql
bin/sandbox
# MySQL
export DB=mysql
bin/sandboxローカル環境に応じて、RDBMSの環境変数を設定する必要がある場合があります。
DB_HOSTDB_USERDB_PASSWORDたとえば、Rails 6でサポートされていないRuby 2.4を使用している場合など、サンドボックスにRails 5.2アプリケーションを作成する必要がある場合は、 RAILS_VERSION環境変数を使用できます。
export RAILS_VERSION= ' ~> 5.2.0 '
bin/setup
bin/sandboxコマンドを実行することにより、RailsサーバーとSolidusフォルダーまたはSandbox Oneからその他のサービスを開始できます。
bin/dev注： bin/rails serverまたは同様のコマンドを実行すると、Railsサーバーのみが開始されます。これにより、管理者ページをロードしようとすると、エラーがcouldn't find file 'solidus_admin/tailwind.css'あります。
SolidusはテストにRSPECを使用します。テストライブラリの詳細については、そのドキュメントを参照してください。
Circleciを使用して、Solidusのテストとすべての着信プルリクエストを実行します。すべてのプルリクエストは、マージするために渡さなければなりません。
https://circleci.com/gh/solidusio/solidusでビルドステータスを見ることができます。
Chromedriverは、バックエンドテストスイートを実行するために必要です。
すべてのテスト仕様を実行するには、Solidusプロジェクトのルートでbin/buildスクリプトを実行します。
createuser --superuser --echo postgres # only the first time
bin/build bin/buildスクリプトは、デフォルトでPostGreSQLを使用して実行されますが、DB環境変数をDB=sqliteまたはDB=mysqlに設定することでオーバーライドできます。例えば：
env DB=mysql bin/buildMySQL関連のエラーでコマンドが失敗した場合は、このコマンドでユーザーを作成してみてください。
# Creates a user with the same name as the current user and no restrictions.
mysql --user= " root " --execute= " CREATE USER ' $USER '@'localhost'; GRANT ALL PRIVILEGES ON * . * TO ' $USER '@'localhost'; " 各宝石には、独自の一連のテストが含まれています。コアプロジェクトのテストを実行するには：
cd core
bundle exec rspecデフォルトでは、 rspec SQLite 3のテストを実行します。別のデータベースに対して仕様を実行する場合は、コマンドのデータベースを指定できます。
env DB=postgresql bundle exec rspecSimpleCovコードカバレッジレポートを実行したい場合：
COVERAGE=true bundle exec rspecSolidusで提供されるコア機能に加えて、コアプロジェクトの一部ではない（またはまだ）機能をストアに追加する方法はいくつかあります。
リストはextensions.solidus.ioにあります。
Solidusの拡張機能を書きたい場合は、Solidus_dev_support gemを使用できます。
Solidusはオープンソースプロジェクトであり、貢献を奨励しています。寄付する前に、contributing.mdをお読みください。
