Magento 2.0 Backward-Incompatible Changes

This topic discusses backward-incompatible changes since the Magento 2.0 General Availability (GA) release in November 2015.

• Module Magento_Catalog
  • Setup version 2.0.4 changes
    • Code changes
    • Form initialization changes
    • Flow changes

Module Magento_Catalog

Setup version 2.0.4 changes

You can check the setup_version parameter in <magento2>/app/code/Magento/Catalog/etc/module.xml.

Code changes

• General changes
  • Reset button has been removed
• POST data structure changed
  • The parent category ID parent_id is now posted in the general field
  • The category data from the general array is split to the specific arrays by a field set name

[
        'general' => [
            'name' => 'Category',
            'is_enabled' => 1,
            'layout_update' => '<XML CODE>',
            'enabled' => 1
        ],
        ...
    ]

[
        'general' => [
            'name' => 'Category',
            'is_enabled' => 1,
            'parent_id' => 3
        ],
        'custom_layout' => [
            'layout_update' => '<XML CODE>',
            'enabled' => 1
        ],
        ...
    ]

You can find a setup_version parameter in the <your_Magento_module_dir>/etc/module.xml file.

• The Google Optimizer POST data moved to a specific array
• On/Off fields
  • The input type has been changed from select to switcher
  • A web page sends POST message with attribute value = "true" if the field is checked or value = "false" if it is not
  • A server converts value attribute to the PHP true/false boolean type value

• Check boxes and radio buttons
  • Work as on/off fields
• Category products grid
  • Rendered by a UI component as a standalone block
  • Initialized using the magento-init event

Form initialization changes

• A form is built with the UI components (more info about a form component )
• The form is extended using the form configuration file <magento2>/app/code/Magento/Catalog/view/adminhtml/ui_component/category_form.xml (see Overview of UI components)
• The data provider \Magento\Catalog\Model\Category\DataProvider is used to set data and fields metadata for the form
• The default form data is now a part of metadata that is fetched from the \Magento\Catalog\Model\Category\DataProvider

Flow changes

When Products -> Categories menu item in the Magento Admin is chosen, the first root category is selected for editing by default now. You can create a new category or a root category manually only. Use the corresponding button Add Root Category or Add Subcategory.