Presentation at Imagine 2014

2. Sergii Shymko
Software Engineer
Magento
Running 1.x Extensions
on Magento 2

3. Legal
Copyright © 2014 Magento, Inc. All Rights Reserved.
Magento®, eBay Enterprise™ and their respective logos are trademarks, service marks,
registered trademarks, or registered service marks of eBay, Inc. or its subsidiaries. Other
trademarks or service marks contained in this presentation are the property of the
respective companies with which they are associated.
This presentation is for informational and discussion purposes only and should not be
construed as a commitment of Magento, Inc. or GSI Commerce, Inc. d/b/a eBay Enterprise
(“eBay Enterprise”) or of any of their subsidiaries or affiliates. While we attempt to ensure
the accuracy, completeness and adequacy of this presentation, neither Magento, Inc.,
eBay Enterprise nor any of their subsidiaries or affiliates are responsible for any errors or
will be liable for the use of, or reliance upon, this presentation or any of the information
contained in it. Unauthorized use, disclosure or dissemination of this information is
expressly prohibited.

4. Extension Selection
Too complex
“Hello World”
$0

5. Subject Extension
Vertical Navigation with CSS Classes
magentocommerce.com/magento-connect/vertical-navigation-with-css-classes.html
As of May 8, 2014
53,528
Rico Neitzel
Vinai Kopp
Raúl Fishman
OSL 3.0

6. Storefront

7. Admin Panel

8. Source Code Stats
PHP
25%
Config
25%
CSV
25%
Templates
9%
Layout
8%
CSS
8%

9. Let’s Make It Work with M2 !

10. Magento 1.x Magento 2
Directory Structure
app/
code/
community/
<Vendor>/<Module>/
etc/modules/
locale/<locale>/
design/
<area>/base/default/
skin/
<area>/base/default/
app/
code/
<Vendor>/<Module>
/
etc/
i18n/<locale>/
view/<area>/

11. Configuration Files1

12. Magento 1.x Magento 2
Config Reorganization
app/
code/community/
RicoNeitzel/VertNav/
etc/
config.xml
app/
code/
RicoNeitzel/VertNav/
etc/[<area>/]
module.xml
…
…

13. Magento2Magento1.x
Module Definition
<config>
<modules>
<RicoNeitzel_VertNav>
<version>0.4.2</version>
<active>true</active>
<codePool>community</codePool>
<depends>
<Mage_Catalog/>
<config>
<module name="RicoNeitzel_VertNav"
version="0.4.2"
active="true">
<depends>
<module name="Magento_Catalog"/>
<module_dir>/etc/module.xml
app/etc/modules/<module>.xml
<module_dir>/etc/config.xml

14. Magento2Magento1.x
System Configuration
<config>
<sections>
<catalog>
<groups>
<vertnav>
<fields>
<hide_vertnav>
<sort_order>10</sort_order>
<config>
<system>
<section id="catalog">
<group id="vertnav">
<field id="hide_vertnav"
type="select"
sortOrder="10">
<module_dir>/etc/system.xml
<module_dir>/etc/adminhtml/system.xml

15. View Layer2

16. Magento 1.x Magento 2
Static Files
skin/
frontend/
base/
default/
vertnav.css
app/
code/
RicoNeitzel/VertNav/
view/
frontend/
style.css

17. Magento 1.x Magento 2
Templates
app/
design/
frontend/
base/default/
template/
vertnav/
left.phtml
app/
code/
RicoNeitzel/VertNav/
view/
frontend/
left.phtml

18. Magento 1.x Magento 2
Layout Files
app/
design/
frontend/
base/default/
layout/
vertnav.xml
app/
code/
RicoNeitzel/VertNav/
view/
frontend/
layout/
default.xml
…

19. Magento2Magento1.x
Layout Format
<layout>
<default>
<reference name="left">
<block type="vertnav/navigation"
name="catalog.vertnav"
template="vertnav/left.phtml"/>
<layout>
<referenceContainer name="left">
<block class="RicoNeitzel_VertNav_Block_Navigation"
name="catalog.vertnav"
template="RicoNeitzel_VertNav::left.phtml"/>
vertnav.xml
default.xml

20. <?php // code ;)3

21. Magento2Magento1.x
Namespaces
class Mage_Catalog_Block_Navigation {...}
class RicoNeitzel_VertNav_Block_Navigation
extends Mage_Catalog_Block_Navigation {...}
namespace MagentoCatalogBlock;
class Navigation {...}
class RicoNeitzel_VertNav_Block_Navigation
extends MagentoCatalogBlockNavigation {...}
Prefixes, PHP < 5.3
Namespaces, PHP ≥ 5.3

22. Magento 1.x Magento 2
Core Reorganization
app/
code/core/
Mage/
Adminhtml/
Page/
Core/
Mage.php
lib/Varien/
app/
code/
Magento/
Backend/
Theme/
Core/
Store/
lib/Magento/Framework/

23. No “Mage” in Magento 2

24. Dependency Injection

25. Magento2Magento1.x
Dependency on Singleton
Mage::getSingleton('module/class');
Mage::getResourceSingleton('module/class');
Mage::helper('module');
function __construct(
VendorModuleClass $service
) {
$this->_service = $service;
}
Service Location
Constructor Injection

26. Magento2Magento1.x
Dependency on Transient
Mage::getModel('module/class');
Mage::getResourceModel('module/class');
function __construct(
VendorModuleClassFactory $factory
) {
$this->_factory = $factory;
}
$transientObj = $this->_factory->create();
Static Factory Methods
Factory Code Generation

27. Internationalization
Localization

28. Magento 1.x Magento 2
Dictionaries
app/
locale/
de_DE/
RicoNeitzel_VertNav.csv
es_MX/
RicoNeitzel_VertNav.csv
app/
code/
RicoNeitzel/VertNav/
i18n/
de_DE.csv
es_MX.csv

29. Magento2Magento1.x
Localization via “gettext”
class Vendor_Module_Helper_Data
extends Mage_Core_Helper_Abstract
{
// Literally empty
}
echo Mage::helper('module')->__('Wake up, %s...', 'Neo');
echo __('Wake up, %1...', 'Imagine attendee');
Module Context
Global Function

30. We’re All Set !4

32. Effort & Gains
20 hours
 Single module dir
 Config validation
 Unit testable
19 commits

33. Sergii Shymko
sshymko@ebay.com
sergey@shymko.net
github.com/magento/magento2 – Magento 2
github.com/riconeitzel/VertNav – original extension
github.com/sshymko/VertNav – extension M2 fork
Thank You!
Q & A