Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added notes about composer library/modules to README (for 19.5.x and 20.1.x) #2851

Merged
merged 8 commits into from
Dec 26, 2022
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 20 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ __Please be aware that although OpenMage is compatible that one or more extensio
Download the latest archive and extract it, clone the repo, or add a composer dependency to your existing project like so:

```bash
composer require "openmage/magento-lts":"^19.4.0"
composer require "openmage/magento-lts":"^19.5.0"
```

To get the latest changes use:
Expand Down Expand Up @@ -116,9 +116,8 @@ Most important changes will be listed here, all other changes since `19.4.0` can
- `Mage_Xmlconnect`
- `Phoenix_Moneybookers`


_If you rely on that modules you can reinstall them with composer:_
- `Mage_PageCache`: `composer require openmage/bc-mage-pagecache:dev-master`
_If you rely on those modules you can reinstall them with composer:_
- `Mage_PageCache`: `composer require openmage/module-mage-pagecache`

### Between OpenMage 19.4.18 / 20.0.16 and 19.4.19 / 20.0.17

Expand All @@ -140,6 +139,23 @@ Do not use 20.x.x if you need IE support.

For full list of changes, you can [compare tags](https://github.com/OpenMage/magento-lts/compare/1.9.4.x...20.0).

### Since OpenMage 19.5.0 / 20.1.0

Most of the 3rd party libraries/modules that were bundled in our repository were removed and migrated to composer dependencies.
This allows for better maintenance and upgradability.

Specifically:
- phpseclib, mcrypt_compat, Cm_RedisSession, Cm_Cache_Backend_Redis, Pelago_Emogrifier (#2411)
- Zend Framework 1 (#2827)

If your project uses OpenMage through composer then all dependencies will be managed automatically.
If you just extracted the release zip/tarball in your project's main folder then be sure to:
- remove the old copy of aforementioned libraries from your project, you can do that with this command:
`rm -rf lib/Cm lib/Credis lib/mcryptcompat lib/Pelago lib/phpseclib lib/Zend`
- download the new release zip file that is named `openmage-VERSIONNUMBER.zip`, this one is built to contain the `vendor`
folder generated by composer, with all the dependencies in it
- extract the zip file in your project's repository as you always did

### New Config Options

- `admin/design/use_legacy_theme`
Expand Down