Magento - Long Term Support

This repository is the home of an unofficial community-driven project. It's goal is to be a dependable alternative to the Magento CE official releases which integrates improvements directly from the community while maintaining a high level of backwards compatibility to the official releases.

Pull requests with unofficial bug fixes and security patches from the community are encouraged and welcome!

Though Magento does not follow Semantic Versioning we aim to provide a workable system for dependency definition. Each Magento 1.<minor>.<revision> release will get its own branch (named 1.<minor>.<revision>.x) that will be independently maintained with upstream patches and community bug fixes for as long as it makes sense to do so (based on available resources). For example, Magento version 1.9.3.4 was merged into the 1.9.3.x branch.

Requirements

• PHP 7.0+ (PHP 7.3 with OpenSSL extension strongly recommended and verified compatible) (PHP 7.4 and 8.0 are supported)

• MySQL 5.6+ (8.0+ recommended)

• (optional) Redis 5+ (7.x recommended, latest verified compatible 7.0.4 with 20.x)

• PHP 7.4 and 8.0 are supported

• Please be aware that although OpenMage is compatible that 1 or more extensions may not be

If using php 7.2+ then mcrypt needs to be disabled in php.ini or pecl to fallback on mcryptcompat and phpseclib. mcrypt is deprecated from 7.2+ onwards.

Installation

Using Composer

Download the latest archive and extract it, clone the repo, or add a composer dependency to your existing project like so:

composer require "openmage/magento-lts":"^19.4.0"

To get the latest changes use:

composer require "openmage/magento-lts":"dev-main"

Note: dev-main is just an alias for current 1.9.4.x branch and may change

Using Git

If you want to contribute to the project:

git init
git remote add origin https://github.com/<YOUR GIT USERNAME>/magento-lts
git pull origin master
git remote add upstream https://github.com/OpenMage/magento-lts
git pull upstream 1.9.4.x
git add -A && git commit

More Information

Secure your installation

Don't use common paths like /admin for OpenMage Backend URL. Don't use the path in robots.txt and keep it secret. You can change it from Backend (System / Configuration / Admin / Admin Base Url) or by editing app/etc/local.xml:

<config>
    <admin>
        <routers>
            <adminhtml>
                <args>
                    <frontName><![CDATA[admin]]></frontName>
                </args>
            </adminhtml>
        </routers>
    </admin>
</config>

Don't use common file names like api.php for OpenMage API URLs to prevent attacks. Don't use the new file name in robots.txt and keep it secret with your partners. After renaming the file you must update the webserver configuration as follows:

• Apache .htaccess: RewriteRule ^api/rest api.php?type=rest [QSA,L]
• Nginx: rewrite ^/api/(\w+).*$ /api.php?type=$1 last;

Changes

Most important changes will be listed here, all other changes since 19.4.0 can be found in release notes.

Between Magento 1.9.4.5 and OpenMage 19.x

• bug fixes and PHP 7.x, 8.0 and 8.1 compatibility
• added config cache for system.xml #1916
• search for "NULL" in backend grids #1203
• removed modules Mage_Compiler, Mage_GoogleBase, Mage_Xmlconnect, Phoenix_Moneybookers

Between OpenMage 19.x and 20.x

Do not use 20.x.x if you need IE support.

• removed IE conditional comments, IE styles, IE scripts and IE eot files #1073
• removed frontend default themes (default, modern, iphone, german, french, blank, blue) #1600
• fixed incorrect datetime in customer block ($useTimezone parameter) #1525
• added redis as a valid option for global/session_save #1513
• reduce needless saves by avoiding setting _hasDataChanges flag #2066
• removed support for global/sales/old_fields_map defined in XML #921
• removed module Mage_PageCache #2258
• removed lib/flex containing unused ActionScript "file uploader" files #2271
• enabled website level config cache #2355

For full list of changes, you can compare tags.

New Config Options

• admin/design/use_legacy_theme
• admin/global_search/enable
• admin/emails/admin_notification_email_template
• catalog/product_image/progressive_threshold
• catalog/search/search_separator
• dev/log/max_level
• newsletter/security/enable_form_key
• sitemap/category/lastmod
• sitemap/page/lastmod
• sitemap/product/lastmod

New Events

• adminhtml_block_widget_form_init_form_values_after
• adminhtml_block_widget_tabs_html_before
• adminhtml_sales_order_create_save_before
• checkout_cart_product_add_before
• sitemap_cms_pages_generating_before
• sitemap_urlset_generating_before

Full list of events

Development Environment with ddev

• Install ddev
• Clone the repository as described in Installation -> Using Git
• Create a ddev config using $ ddev config the defaults should be good for you
• Open .ddev/config.yaml and change the php version to 7.2
• Type $ ddev start to download and start the containers
• Navigate to https://magento-lts.ddev.site
• When you are done you can stop the test system by typing $ ddev stop

PhpStorm Factory Helper

This repo includes class maps for the core Magento files in .phpstorm.meta.php. To add class maps for installed extensions, you have to install N98-magerun and run command:

n98-magerun.phar dev:ide:phpstorm:meta

You can add additional meta files in this directory to cover your own project files. See PhpStorm advanced metadata for more information.

Public Communication

• Discord (maintained by Flyingmana)

Maintainers

• Lee Saferite
• David Robinson
• Daniel Fahlke aka Flyingmana
• Tymoteusz Motylewski
• Sven Reichel

License

• OSL v3.0
• AFL v3.0

Contributors ✨

Thanks goes to these wonderful people (emoji key):

sv3n	Lee Saferite	Colin Mollenhour	David Robinson	Tymoteusz Motylewski	Daniel Fahlke	SNH_NL
Marc Romano	Fabian Blechschmidt	Luboš Hubáček	Erik Dannenberg	Jeroen Boersma	Leandro F. L.	Kevin Krieger
Ng Kiat Siong	bob2021	Bastien Lamamy	Dmitry Furs	Robert Coleman	Milan Davídek	Matt Davenport
elfling	henrykb	Tony	Mark Lewis	Eric Sean Turner	Eric Seastrand	Tobias Schifftner
Simon Sprankel	Tom Lankhorst	shirtsofholland	sebastianwagner	Maxime Huran	Pepijn	manuperezgo
luigifab	Loek van Gool	kpitn	kalenjordan	IOWEB TECHNOLOGIES	Florent	dvdsndr
Vincent MARMIESSE	Lucas van Staden	zamoroka	wpdevteam	Wouter Samaey	Vova Yatsyuk	Trevor Hartman
Somewhere	Fabian Schmengler />	Roman Hutterer	Sergei Filippov	Sam Steele	Ricardo Velhote	Roy Duineveld
Roberto Sarmiento Pérez	Pierre Martin	Rafał Dołgopoł	Rafael Patro	Andreas Pointner	Paul Rodriguez	ollb
Nicholas Graham	Makis Palasis	Miguel Balparda	Mark van der Sanden	Micky Socaci	Marvin Sengera	Kostadin A.
Julien Loizelet	Jonas Hünig	Stefan Jaroschek	Jacques Bodin-Hullin	Wilhelm Ellmann	Edwin.	drago-aca
Daniel Niedergesäß	J Davis	Damien Biasotto	Daniel Corn	Paweł Cieślik	André Herrn	Pablo Benmaman
aterjung	altdovydas	Alisson Júnior	Alex Kirsch	Branden	Pof Magicfingers	Michael Thessel
Jonathan Laliberte	Ivan Chepurnyi	Igor	Elias Kotlyar	Hejty1	Gaelle	Frédéric MARTINEZ
Tobias Faust	AndresInSpace	Francesco Boes	Daniel Bachmann	Damian Luszczymak	Fabrizio Balliano	Jouriy
Digital Pianism	Justin Beaty	ADDISON	Aria Stewart	Dean Williams	Henry Hirsch	kdckrs
Martin René Sørensen	Frank Rochlitzer	AlterWeb	Caprico	David Windell	Dragan Atanasov	Eugene Lamskoy
Ferdinand	Himanshu	Jakub Idziak	Joseph Maxwell	Joshua Dickerson	Kevin Bortnick	Mehdi Chaouch
Mohamed ELIDRISSI	Justin van Elst	Nicholas Graham	Patrick Schnell	Patrick Cronin	Petr Švamberg	Rafael Corrêa Gomes
Ralf Siepker	Sunel Tr	Tom Klingenberg	Toon	WEXO team	Wilfried Wolf	akrzemianowski
andthink	eetzen	lemundo-team	mdlonline	Benjamin MARROT	Tino Mewes	Carsten Brandt 💻
Enéias Ramos de Melo	Scott Moore

This project follows the all-contributors specification. Contributions of any kind welcome!