spree

This patch release contains bug fixes backported from master. We'd like to thank all the contributors who made this happen 👍

• require Rails >= 5.2.1.1 due to https://nvd.nist.gov/vuln/detail/CVE-2018-16477
• fixed Rails 5.2.2 compatibility https://github.com/spree/spree/commit/5e054bc093c60860e0f4b280af4e343ccd216b5b

This patch release contains bug fixes backported from master. We'd like to thank all the contributors who made this happen 👍

• Support for ruby-money 6.13 and removal of all deprecations for money 7.0

This patch release contains bug fixes backported from master. We'd like to thank all the contributors who made this happen 👍

• Support for Rails 5.2.1 https://github.com/spree/spree/commit/64fea99ef68f093c6a066de9ffb1de7e2cf8d457

This patch release contains bug fixes backported from master. We'd like to thank all the contributors who made this happen 👍

• Update acts-as-taggable-on version to 6.0 for Rails 5.2 compatibility (https://github.com/spree/spree/commit/5869ec4e0acbcf195e7e2c7c9b5e827d6fba4dee)
• Lock version of Rails to 5.2.0 due to ransack issues with 5.2.1 (https://github.com/spree/spree/commit/e6249d8d900bb2667aafa9a567590a29f564b9f6)

This patch release contains bug fixes backported from master. We'd like to thank all the contributors who made this happen 👍

Fixes

• Fix ambiguous column error #8840 (https://github.com/spree/spree/commit/158ab1fc5d797013cb6b4770bba8f20dc57ebc5b)
• Moved promotions seed from default to samples, Fixes #8726 (https://github.com/spree/spree/commit/659136e3a2298a5771e78e2ad9cd7ae9e10d69cc)

This patch release contains fix for problems with authenticity token due to rails changing their behaviour about handling API requests.

Fixes

• Stop requiring authenticity token for API v1 endpoints #8846 https://github.com/spree/spree/commit/6693ab214854e5d2125bc85dd4e0431fd42dc16b

Major/New Features

Alongside Spree 3.5 (for Rails 5.1) we're releasing Spree 3.6 (for Rails 5.2). Spree 3.6 has all of the features of Spree 3.5 plus Rails 5.2, ActiveStorage and Ruby 2.5 support out of the box.

If you're on a Spree 3.4 (or earlier) please see Spree 3.5 release notes also.

Rails 5.2 support

Spree 3.6 is now compatible with Rails 5.2 compared to 3.5 which used to run on Rails 5.1. Thanks to that you can start using all of the new great features available in Rails 5.2

Contributed by Spark Solutions

ActiveStorage support

Active Storage facilitates uploading files to a cloud storage service like Amazon S3, Google Cloud Storage, or Microsoft Azure Storage and attaching those files to Active Record objects. It comes with a local disk-based service for development and testing and supports mirroring files to subordinate services for backups and migrations.

ActiveStorage was introduced in Rails 5.2 and with Spree 3.6 release it's the default file stoage option. We'll still support Paperclip until Spree 4.0 when it will be removed from Spree core.

Contributed by Spark Solutions

Ruby 2.5 support

Spree now works with Ruby 2.2 (>= 2.2.7), 2.3.x, 2.4.x and 2.5.x.

Contributed by Spark Solutions

Installation

Add Spree gems to Gemfile

gem 'spree', '~> 3.6.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 your Rails version to 5.2

Please follow the official Rails guide to upgrade your store.

Update Gemfile

gem 'spree', '~> 3.6.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

Migrate to ActiveStorage (optional)

Please follow the official paperclip guide if you want to use ActiveStorage instead of paperclip.

You can still use paperclip for attachment management by setting SPREE_USE_PAPERCLIP environment variable to true, but keep in mind that paperclip is DEPRECATED and we will remove paperclip support in Spree 4.0.

Noteworthy changes

Please see Spree 3.5 release notes

Full Changelog

You can view the full changes using Github Compare.

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 a 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'

2. Install the gem using Bundler:

bundle install

3. 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 affected. 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 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.

This patch release contains bug fixes backported from master. We'd like to thank all the contributors who made this happen 👍

Fixes

• Fix charged amount for non-fractional currencies #8681 https://github.com/spree/spree/commit/d13d395ca80e0117f03be4f86f359183fa43674a
• add no-cache to checkout edit action https://github.com/spree/spree/commit/1992da1be4d3e8d46412ada6ef0e06b72c593100
• Fixed applying promotions to line items with multiple option values https://github.com/spree/spree/commit/80dd8ef27ae2d0d62841c89deb9aac43506f94fa
• Stop re-appending spree locale paths in dev mode https://github.com/spree/spree/commit/3f2f5c0b87e280cfef6ebf72db243763e034b249

This patch release contains bug fixes backported from master. We'd like to thank all the contributors who made this happen 👍

Fixes

• Fix charged amount for non-fractional currencies #8681 https://github.com/spree/spree/commit/158266b6cbb70e0e4da433a1feac6de387a93fbe
• add no-cache to checkout edit action https://github.com/spree/spree/commit/01fdb976b9f723b171e5adf4e18bb278b18a3f61
• Fixed applying promotions to line items with multiple option values https://github.com/spree/spree/commit/2a70a9a2c7941e82d7ee22c3578b0b143cd304e1
• Stop re-appending spree locale paths in dev mode https://github.com/spree/spree/commit/74b4e1131d35ff3b6298312dbb2299169786e41c

This patch release contains bug fixes backported from master. We'd like to thank all the contributors who made this happen 👍

Fixes

• replace factory girl with bot (https://github.com/spree/spree/commit/6f0073e0d1b14b0f74a1a7064045331968fda267)
• Set PG gem version to 0.18 (https://github.com/spree/spree/commit/44706affbd910536da29124aefd8be6a1ac7e02d)
• Minor changes to workaround Globalize bug (https://github.com/spree/spree/commit/687043bc5fc0faaca9e43ee101186357880b323c)
• add no-cache to checkout edit action (https://github.com/spree/spree/commit/cd8c81fd85f52c7783e05fedb557611a5e7bc235)
• Fixed applying promotions to line items with multiple option values (https://github.com/spree/spree/commit/d1ca09714a8a9a0c303b3a149ce09c3a383ab21c)
• Spree::Money returns decimal_mark and thousands_separator (https://github.com/spree/spree/commit/17c3b6c7729b11a7410752a45f3bcf366d181476)
• Fixed sandbox gemfile (https://github.com/spree/spree/commit/d7a41b012c6248b72fadb032ae95c1f75cae5681)
• Fix charged amount for non-fractional currencies #8681 (https://github.com/spree/spree/commit/08578693ba0807bfc1602d2686b83ae41a192f52)
• Stop re-appending spree locale paths in dev mode (https://github.com/spree/spree/commit/8ca1603bd9c333d99346da93883130e323d5c705)

This patch release contains bug fixes backported from master. We'd like to thank all the contributors who made this happen 👍

Fixes:

• Stop re-appending spree locale paths in dev mode https://github.com/spree/spree/commit/3b3bed414b1f8829af8170d275305beb3ac6fcd8
• Fix charged amount for non-fractional currencies #8681 https://github.com/spree/spree/commit/cade47cfeb4c60155484264a08c9ab9994931667
• Spree::Money returns decimal_mark and thousands_separator https://github.com/spree/spree/commit/d1c1538ae0543ac8e5a065fa4a84731659cf009b
• add no-cache to checkout edit action https://github.com/spree/spree/commit/da53a4cfa5f582f28e0a80f5720e08f3a43a3144
• Set PG gem version to 0.18 https://github.com/spree/spree/commit/45d325a1f1afeb5a587442fdd275de3a1cab45e8

For changes please refer to https://github.com/spree/spree/blob/master/guides/content/release_notes/3_6_0.md

For changes please refer to https://github.com/spree/spree/blob/master/guides/content/release_notes/3_5_0.md

For changes please refer to https://github.com/spree/spree/blob/master/guides/content/release_notes/3_5_0.md

This patch release contains bug fixes backported from master. We'd like to thank all the contributors who made this happen 👍

All

• pg gem dependency set to ~> 0.18 because of compatibility issues with pg version >=1.0(https://github.com/spree/spree/commit/0a6ad121fc02253697ec1aed6103b1537bc3235a)
• paperclip updated to 5.2.0 since older versions have security issues(https://github.com/spree/spree/commit/9bc4c6d465f1748e6ac8c0bafd7982924200e054)

Core

• fixed: rescue DB exceptions in should_persist? method from Spree::Preferences::Store since it failed randomly on initialization (https://github.com/spree/spree/commit/0b2118cd4358efd201f84960661b36f6f3cf09de)

Cmd

• added spree_backend:copy_views to copy all views from spree to application(https://github.com/spree/spree/commit/55416a24d186f202b48bd695b142ecc757d7a4ee)
• changed extension generator to use chromedriver instead of poltergeist in new extensions (https://github.com/spree/spree/commit/be195ca34ccfdb673453eda066d0abe5fa573b33)

Sample

• stop duplicating taxons in seeds (https://github.com/spree/spree/commit/a7e174d9124ea4ac258a455adcb3e5c1659d1c07)

This patch release contains bug fixes backported from master. We'd like to thank all the contributors who made this happen 👍

All

• replaced FactoryGirl with FactoryBot - however, you can still safely use FactoryGirl and you don't need to change it in your projects if you don't want to (https://github.com/spree/spree/commit/5bda05af67d9c039411bbf69b6500e7c7eabf97f)
• pg gem dependency set to ~> 0.18 because of compatibility issues with pg version >=1.0(https://github.com/spree/spree/commit/2ff32c124f7e8ebbb929968915e44c23d896ce2f)
• paperclip updated to 5.2.0 since older versions have security issues(https://github.com/spree/spree/commit/bb96cc8a29fbe1e9fb1bf253d3ad69f919a12708)

Core

• fixed: rescue DB exceptions in should_persist? method from Spree::Preferences::Store since it failed randomly on initialization (https://github.com/spree/spree/commit/ad46ef4d2ed1cddab8691511cad69fe95e718ba3)

This patch release contains bug fixes backported from master. We'd like to thank all the contributors who made this happen 👍

All

• fixed: shipment management API & Admin Panel using new inventory units logic (https://github.com/spree/spree/pull/8473)
• replaced FactoryGirl with FactoryBot - however, you can still safely use FactoryGirl and you don't need to change it in your projects if you don't want to (https://github.com/spree/spree/commit/9c2ee33b617baf68f64c4fa674e8e21db30ff671, https://github.com/spree/spree/commit/e106c5b2aaefedce80188fb9869aa31d9540d270)

Core

• fixed: prioritize web over asset pipeline in premailer (https://github.com/spree/spree/commit/9b1097b1793a56949ecbb58c7b5677ce09cb8e1a)
• fixed: clone address instead of using same objects to stop overwriting them
  (https://github.com/spree/spree/commit/cd870034a9a0dcf217482051b2e12443bfb930fc)
• fixed issues with extension generator template (https://github.com/spree/spree/commit/d7f134c08a4f2cb7fd4d91b98fcc251ca2f02d5d)

Admin Panel

• fixed: add query terms in customer search - admin panel (https://github.com/spree/spree/commit/7f239e5ce2888b823683e1f8b25df8d9d757aa3f)

This patch release contains bug fixes backported from master. We'd like to thank all the contributors who made this happen 👍

This version requires Rails >= 5.1.4 so please update your Gemfiles and run bundle update rails before updating Spree

All

• fixed: shipment management API & Admin Panel using new inventory units logic (https://github.com/spree/spree/pull/8478)

Core

• fixed: State Transition for multiple exchanges (https://github.com/spree/spree/commit/61da8eed1066d8b01677cdbf7c5560bc5c2d5441)
• fixed: Moving state change & timestamp update before sending email (https://github.com/spree/spree/commit/2d79efd849344c6a00ff86a2f61e3f6303d8cd02)
• fixed: prioritize web over asset pipeline in premailer (https://github.com/spree/spree/commit/cfb65d3bcc446947ed91d0ef268b57b0cd217b36)
• fixed: clone address instead of using same objects to stop overwriting them
  (https://github.com/spree/spree/commit/6e06fe7d93c5801f9c7167deecae06fa23503fa3)

Admin Panel

• Updated jsTree (https://github.com/spree/spree/commit/281f7d6d28fc40bc7d61739b4184bd4a41a36d79)
• fixed: add query terms in customer search - admin panel (https://github.com/spree/spree/commit/32e9f881e5e61e478d66fe7e8c1c12258467d464)

This patch release contains bug fixes backported from master. We'd like to thank all the contributors who made this happen 👍

Core

• fixed: State Transition for multiple exchanges (https://github.com/spree/spree/commit/366a15229989c46f6f3418ccbaece6ff34046df6)
• fixed: Moving state change & timestamp update before sending email (https://github.com/spree/spree/commit/dd028953273f1a3ce56609a3c5673c33181937c6)
• fixed: prioritize web over asset pipeline in premailer (https://github.com/spree/spree/commit/e98e2fb466f931ad99d0e275742dcf69b4fd9169)
• fixed: clone address instead of using same objects to stop overwriting them
  (https://github.com/spree/spree/commit/5b373c7e7335341ac46b2c46f67f5edaaf95c2ce)

Admin Panel

• Updated jsTree (https://github.com/spree/spree/commit/76d38e64df688755a322780965bc966dd21532e3)
• fixed: add query terms in customer search - admin panel (https://github.com/spree/spree/commit/baece7af46e851d987cd3525bd96b21b35590bdd)