Magento Open Source 2.1.4 Release Notes

We are pleased to present Magento Open Source (formerly Community Edition) 2.1.4. This release includes many functional enhancements and fixes.

Highlights

Magento 2.1.4 contains more than 20 functional fixes and enhancements, and one security enhancement. Look for the following highlights in this release:

Security enhancement

This release includes an important enhancement to the security of your Magento software. While there are no confirmed attacks related to the Zend framework Zend_Mail library vulnerability to date, certain vulnerabilities can potentially be exploited to access customer information or take over administrator sessions. We recommend that you upgrade your existing Magento software to the latest version as soon as possible.

Functional fixes and enhancements

We address the following functional issues in this release.

Catalog

  • The storefront gallery now displays all the images associated with a configurable product. Previously, when you clicked on the swatches associated with a configurable product, the gallery displayed only one of several possible images. (GITHUB-6195), (GITHUB-4101)
  • Magento now displays the This is a required field message immediately adjacent to the product options as needed during checkout. Previously, Magento displayed this message at the bottom of the checkout form.

Checkout

  • Magento now successfully estimates shipping costs. Previously, when you tried to estimate shipping costs, the load indicator would spin indefinitely, and Magento displayed this exception, Object doesn't support this action. (GITHUB-5358), (GITHUB-7051)

Indexers

  • IndexerHandlerFactory no longer tries to cast the $indexer object to a String if an error occurs. Since $indexer is an object of type IndexerInterface and does not have a __toString() method, attempting to cast the $indexer object to a String previously resulted in an error. (GITHUB-5155)
  • The Magento flat indexer now collects correct product data for ROW_ID.
  • The Magento flat indexer no longer throws an error after flat tables are enabled and reindexed. This fix applies to both product and catalog tables.

Installation, configuration, and deployment

  • Third-party command line tools no longer fail when you run setup:di:compile.
  • Magento now correctly applies website configuration parameters to the corresponding store view. (GITHUB-7943)

Miscellaneous

  • Magento now displays the price of out-of-stock products. Previously, it did not display the price of out-of-stock products on the product page.
  • The Allow Gift Wrapping for Order Items setting now works as expected. Previously, when Stores > Configuration > Sales > Gift Options was set to No, users saw the Gift Option link under each product in their shopping cart.
  • Information set by the Default Billing Address and Default Shipping Address checkboxes on the Customer page are now saved correctly.
  • Admin users with appropriate permissions can now reset the passwords of more than one customer at a time. (GITHUB-5260)
  • Admin interface forms now load data as expected after initializing all components. Previously, under certain conditions, the load indicator would spin indefinitely, and Magento did not load data.
  • If you remove an item from the Compare Items list that is displayed on any Category page, Magento no longer redirects you to the Compare Products page.
  • The order comments history no longer duplicates the time that a comment was made. Previously, the time that a comment was entered was listed twice.

Payment methods

  • You can now successfully complete Paypal checkout with products that have custom options. (GITHUB-5938)
  • PayPal Payflow Pro now uses the currency you’ve specified in your store settings. Previously, Magento converted the total price into U.S. dollars, no matter which currency was specified in the store settings.
  • Magento no longer displays the No Payment method available message when a customer tries to ship items to a billing-restricted country.
  • Third-party payment gateways are now visible from the Admin. (GITHUB-7891)
  • Magento now updates you as expected on order comments and order history after you initiate a refund using Braintree. Previously, when you clicked the Refund button (to initiate a refund), Magento did not redirect you to order comments and history information.
  • We’ve fixed an issue with using PayPal Express Checkout to order products with custom options. Previously, although an Admin user could create and configure “File type” custom options, customers could not upload and store files within the order quote. (GITHUB-5434)

Travis builds

  • We’ve fixed a fatal issue that occurred if you executed the CatalogImportExport test before running a subsequent test. Previously, you’d receive this error: Failed asserting that false is true.
  • We’ve fixed a fatal issue that occurred if you ran Travis builds on imagettfbbox 2.1.2. Previously, you’d receive this error:

    PHP Fatal error: Call to undefined function Magento\Framework\Image\Adapter\imagettfbbox() in /home/travis/build/magento/magento2/lib/internal/Magento/Framework/Image/Adapter/Gd2.php

Known issues

  • Issue: You receive the following fatal error while installing 2.1.3 from repo.magento.com.

    > Fatal error: Cannot instantiate interface Magento\Framework\App\Config\Scope\ReaderPoolInterface in /var/www/html/magento2ce/vendor/magento/framework/ObjectManager/Factory/Dynamic/Developer.php on line 73.
    

    Workaround: You can avoid this fatal error by taking one of these actions:

    • If your Magento root directory is <Magento install dir>/pub, then start the Web Setup Wizard from http://<Magento host or IP>/setup instead of from http://<Magento host or IP>

    • Install Magento using the command line.

  • Issue: Magento fails to validate a customer address or customer attributes as expected during checkout.
  • Issue: Installing with Varnish can result in products not appearing on the frontend even after you purge the cache.
  • Issue: When editing a product, you cannot edit customizable options on the storeview level. Consequently, a change to one option affects products on all stores. Also, the Use Default Value check box for the option title does not work. Clearing this check box, and then changing the option title affects all storeviews.
  • Issue: You cannot use a negative value in the Quantity field for a product, even when you activate back orders (Stores > Configuration > Catalog > Inventory > Product Stock Options > Backorders = Allow Qty Below 0) (GITHUB-7401)
  • Issue: When you upgrade your Magento installation from the command line, the bin/magento commands do not skip the var/session folder, as expected. (The bin/magento commands include setup:cron:run, setup:upgrade, and setup:uninstall.) Workaround: Make var/session writeable before you run the bin/magento commands.
  • Issue: The Low Stock Products report (Admin > Reports > Products > Low Stock) is not working correctly.
  • Issue: You cannot re-enable a previously disabled Magento_AdminGws module without causing a range of JavaScript errors. Here is a sample error:

    [PDOException] SQLSTATE[42S02]: Base table or view not found: 1146 Table 'magento.quote_item' doesn't exist

  • Issue: You cannot generate secure content if you deploy static content under these conditions:

    • pub/static is in read-only mode

    • Magento is in production mode

    Requests to pub/static/_requirejs/frontend/Magento/luma/en_US/secure/requirejs-config.js, and consequently the frontend code, will fail under these conditions.

  • Issue: Client-side LESS compilation is not working properly. Consequently, page load performance is not optimal.

System requirements

Our technology stack is built on PHP and MySQL. For more information, see System Requirements.

Install the Magento software

You can get Magento Open Source (formerly Community Edition) 2.1 from Github, Composer, or using a compressed archive.

See one of the following sections for more information:

Get the Magento Open Source software using Composer

The Open Source software is available from repo.magento.com. Before getting the Open Source software, familiarize yourself with the Composer metapackage prerequisites, then run

composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition=<version> <installation directory name>

where <version> is 2.1.0, 2.1.1, and so on

For example, to install Magento Open Source 2.1.1 in the magento2 directory:

composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition=2.1.1 magento2

Get a compressed archive

The following table discusses where to get the Magento software. We provide the following downloads:

  • Magento Open Source software only
  • Magento Open Source software with sample data (designed to help you learn Magento faster)

These packages are easy to get and install. You don’t need to use Composer, all you need to do is to upload a package to your Magento server or hosted platform, unpack it, and run the web-based Setup Wizard.

Archives are available in the following formats: .zip, .tar.bz2, .tar.gz

To get the Magento Open Source software archive:

  1. Go to http://magento.com/download.
  2. Choose either the software or the software and sample data:

    • Magento-CE-<version>.* (without sample data)
    • Magento-CE-<version>+Samples.* (with sample data)

    <version> is the three-digit release number (for example, 2.0.7, 2.1.0, and so on).

Complete the installation

After you get the Open Source software:

  1. Set file system ownership and permissions.
  2. Install the software:

Upgrade from an earlier version

See the following sections for more information.

Upgrade an existing installation from the GitHub repository

Developers who contribute to the Open Source codebase can upgrade manually from the Magento Open Source GitHub repository.

  1. Go to the Contributing Developers page.

  2. Follow the instructions to pull the updates from the repository and update using Composer.

Other upgrades

Other types of upgrades are discussed in Upgrade to Magento version 2.1 (June 22, 2016).

Migration toolkits

The Data Migration Tool helps transfer existing Magento 1.x store data to Magento 2.x. This command-line interface includes verification, progress tracking, logging, and testing functions. For installation instructions, see Install the Data Migration Tool. Consider exploring or contributing to the Magento Data Migration repository.

The Code Migration Toolkit helps transfer existing Magento 1.x store extensions and customizations to Magento 2.0.x. The command-line interface includes scripts for converting Magento 1.x modules and layouts.

Credits

Dear community members, thank you for your suggestions and bug reports.