APIDeveloperUserRelease NotesDemoContact Us
  • Release Notes

    • Spree 4.2.0
    • Spree 4.1.0
    • Spree 4.0.0
    • Spree 3.7.0
    • Spree 3.6.0
    • Spree 3.5.0
    • Spree 3.4.0
    • Spree 3.3.0
    • Spree 3.2.0
    • Spree 3.1.0
    • Spree 3.0.0
    • Spree 2.4.0
    • Spree 2.3.0
    • Spree 2.2.0
    • Spree 2.1.0
    • Spree 2.0.0
    • Spree 1.3.0
    • Spree 1.2.0
    • Spree 1.1.0
    • Spree 1.0.0

Table Of Contents

Major/New FeaturesMulti-store managementExtracted Analytics tracker into an ExtensionAdmin Panel views exporterInstallationAdd Spree gems to GemfileRun bundle installUse the install generators to set up SpreeUpgradeUpdate GemfileRun bundle updateInstall missing migrationsRun migrationsOther GotchasNoteworthy ChangesFull Changelog

Spree 3.5.0

Major/New Features

3.5 is a smaller release to lay the groundwork for major new features described in Spree Development Roadmap. It also contains number of bug fixes and improvements besides described in this document.

Multi-store management

We’ve added an ability to manage multiple stores in one Spree instance of your application. Thanks to that you can easily create stores per region / language / currency. This feature will be enhanced in the next releases.

Contributed by Spark Solutions

Extracted Analytics tracker into an Extension

Our goal is always to keep the core Spree lean and flexible that’s why we’ve moved all of the code of Analytics Trackers to an Extension which you can use with any Spree 3.1+ version.

Spree Analytics Trackers extension currently supports Google Analytics and Segment.com.

Contributed by Spark Solutions

Admin Panel views exporter

You can easily copy all of the default spree admin Panel into your project with just one command line:

rails g spree:backend:copy_views

We hope will make backend customization the Admin Panel a lot easier.

Contributed by supatk

Installation

Add Spree gems to Gemfile

gem 'spree', '~> 3.5.0'
gem 'spree_auth_devise', '~> 3.3'
gem 'spree_gateway', '~> 3.3'

Run bundle install

Use the install generators to set up Spree

rails g spree:install --user_class=Spree::User
rails g spree:auth:install
rails g spree_gateway:install

Upgrade

Update Gemfile

gem 'spree', '~> 3.5.0'

Run bundle update

Install missing migrations

rails spree:install:migrations
rails spree_auth:install:migrations
rails spree_gateway:install:migrations

Run migrations

rails db:migrate

Other Gotchas

Install Spree Analytics Trackers extension

If you were previously using Analytics Trackers feature you need to install it as an extension as it was extracted from the core.

  1. Add Spree Analytics Trackers to your Gemfile:
gem 'spree_analytics_trackers', github: 'spree-contrib/spree_analytics_trackers'
  1. Install the gem using Bundler:
bundle install
  1. Copy and run migrations:
bundle exec rails g spree_analytics_trackers:install

You’re good to go!

Noteworthy Changes

Also please review each of the noteworthy changes, and ensure your customizations or extensions are not effected. If you are affected by a change, and have any of your own tips please submit a PR to help the next person!

  • Added Address#EXCLUDED_KEYS_FOR_COMPARISION so developers won’t need to rewrite Address#same_as method

    Spark Solutions

  • Added PromotionActionLineItem validations

    Spark Solutions

  • Renamed FrontendHelper#breadcrumbs to FrontendHelper#spree_breadcrumbs and Admin::NavigationHelper#icon to Admin::NavigationHelper#spree_icon

    Spark Solutions

  • Deprecated EnvironmentExtension

    Spark Solutions

  • Deprecated render_404

    Spark Solutions

  • Updated javascript libraries in vendor

    Spark Solutions

  • Added Dockerfile for sandbox application

    Spark Solutions

  • Replaced phantomjs with chrome headless

    Spark Solutions

  • Replaced FactoryGirl with FactoryBot

    Spark Solutions

  • Moved EmailValidator from lib to app

    Spark Solutions

  • Added rubocop-rspec and fixed linter issues

    artplan1

  • Added searching for a taxon with taxonomy in api

    saravanak

  • rescue nil removed from promotion rules and and promotion actions partials

    leemour

  • Dropped dependency on with_model gem

    Spark Solutions

  • Updated paperclip to ~> 6.0.0

    Spark Solutions

Full Changelog

You can view the full changes using Github Compare.

Propose changes to this page
Designed and developed bySpree Commerce & Ruby on Rails developers© Spree Commerce. 2021 All Rights Reserved.