API reference
User Documentation
Demo
GitHub
Search…
Developer's Documentation
🚀Getting Started
Installation
Headless Commerce
💻API
Storefront API
Platform API
🎨Storefronts
Next.js Commerce
Vue Storefront
⚙️Internals
Stores
Products
Orders
Payments
Shipments
Promotions
Inventory
Taxation
Addresses
Adjustments
Calculators
Preferences
🛠Customization
Dependencies
Business Logic
Storefront API
Checkout
Authentication
Permissions
Images
Internationalization
Storefront
Emails
🌏Deployment
Vendo
AWS
Heroku
Performance
🔑Security
General guidelines
API
PCI Compliance
Authentication & authorization
⏩Upgrades
How to perform upgrades
Upgrade guides
4.3 to 4.4
4.2 to 4.3
4.1 to 4.2
4.0 to 4.1
3.7 to 4.0
3.6 to 3.7
3.5 to 3.6
3.4 to 3.5
3.3 to 3.4
3.2 to 3.3
3.1 to 3.2
3.0 to 3.1
2.3 to 2.4
2.2 to 2.3
2.1 to 2.2
2.0 to 2.1
1.3 to 2.0
1.2 to 1.3
1.1 to 1.2
1.0 to 1.1
🎁Extensions
Extensions
Creating an extension
Advanced
Adding Spree to an existing Rails application
Deface
❤️Contributing
General guidelines
Developing Spree
Upgrading extensions
✨Releases Notes
Releases
Changelog
🤝Support
Core Team support
Slack Community
Powered By
GitBook
3.0 to 3.1
This guide covers upgrading a 3.0.x Spree store, to a 3.1.x store
Upgrade Rails
For this Spree release, you will need to upgrade your Rails version to at least 4.2.6.
gem
'rails'
,
'~> 4.2.6'
Upgrade Spree
For best results, use the spree gem in version 3.1.x:
gem
'spree'
,
'~> 3.1.0.rc1'
Run
bundle update spree
.
Copy and run migrations
Copy over the migrations from Spree (and any other engine) and run them using these commands:
rake railties:install:migrations
rake db:migrate
Spree Auth Devise & Spree Gateway
If you are using Spree Gateway and/or Spree Auth Devise you should also upgrade them:
gem
'spree_auth_devise'
,
'~> 3.1.0.rc1'
gem
'spree_gateway'
,
'~> 3.1.0.rc1'
For Spree Auth Devise run installer:
rails g spree:auth:install
(you don't have to override config/initializers/devise.rb)
Additional information
Make sure to v1 namespace custom rabl templates & overrides.
If your rabl templates reference others with extend you'll need to add the v1 namespace.
For example:
extends
'spree/api/zones/show'
Becomes:
extends
'spree/api/v1/zones/show'
Remove Spree::Config.check_for_spree_alerts
If you were disabling the alert checks you'll now want to remove this preference as it's no longer used.
Read the release notes
For information about changes contained within this release, please read the
3.1.0 Release Notes
.
Verify that everything is OK
Run your test suite, click around in your store and make sure it's performing as normal. Fix any deprecation warnings you see.
Previous
3.1 to 3.2
Next
2.3 to 2.4
Last modified
11mo ago
Copy link
Edit on GitHub
Outline
Upgrade Rails
Upgrade Spree
Copy and run migrations
Spree Auth Devise & Spree Gateway
Additional information
Make sure to v1 namespace custom rabl templates & overrides.
Remove Spree::Config.check_for_spree_alerts
Read the release notes
Verify that everything is OK