4.2 to 4.3

​

Update Gemfile

Since Spree 4.3 spree gem doesn’t include spree_emails, spree_backend and spree_frontend gems. It only consists of Spree Core and Spree API.

You need to add them to your Gemfile if you want to use them.

bundle add spree_emails spree_backend spree_frontend

​

Remove gems merged into Spree Core

These gems were merged into Spree Core in version 4.3. All of their functionality is now included in the spree gem so you can remove them.

​

Optional Remove SpreeMultiDomain

If you used that gem in the past you need to remove it. Multi-Store is now incorporated into Spree core and you cannot use that gem anymore.

1. Remove spree_multi_domain from your Gemfile

   bundle remove spree_multi_domain
   

2. Remove //= require spree/frontend/spree_multi_domain from vendor/assets/javascripts/spree/frontend/all.js

3. Remove //= require spree/backend/spree_multi_domain from vendor/assets/javascripts/spree/backend/all.js

​

Optional Remove Spree Editor

Spree 4.3 includes TinyMCE 5 editor built-in. It’s not recommended to use spree_editor gem anymore.

bundle remove spree_editor

​

Optional Remove Spree Static Content

Spree 4.3 includes a built-in CMS. It’s not recommended to use spree_static_content

bundle remove spree_static_content

​

Install missing migrations

rake railties:install:migrations

​

Run migrations

bin/rails db:migrate

​

Additional fixes and hints

​

Upgrade Sprockets to v4

In your project create app/assets/config/manifest.jss file with contents:

//= link_tree ../images
//= link_tree ../javascripts
//= link_directory ../stylesheets .css

More on this topic.

​

Admin Panel fix

If you’ve developed custom features for your Admin Panel, please replace any occurrences of

render partial: 'spree/shared/error_messages'

to

render partial: 'spree/admin/shared/error_messages'

​

Read the release notes

For information about changes contained within this release, please read the Release notes.