Table of contents:
The first sub-release of eZ Studio 15.12 is available as of February 2nd.
For the release notes of the corresponding (and included) eZ Platform sub-release, see eZ Platform 15.12.1 Release Notes.
Changes since 15.12
Summary of changes
- Enhanced Landing Page drag-and-drop interactions, including a better visualization of dropping blocks onto the page:
- Timeline toolbar now covers all changes in all Schedule Blocks on a given Landing Page.
- Timeline toolbar is now also available in View mode on Landing Pages:
- Added an Approval Timeline which lists all review requests for a given Content item:
- Modified template of the notification email sent to reviewers from Flex Workflow.
- Minor UI improvements (including: updated icons, labels, date picker and others):
- Added notification when copying a URL.
- Numerous bug fixes.
Full list of improvements
Full list of bugfixes
Upgrading a 15.12 Studio project
You can easily upgrade your existing Studio project in version 15.12 (1.0) using Composer.
Start from the project root. First, create a new branch from:
a) your master project branch, or
b) the branch you are upgrading on:
In case of different localization of the sources, add ezsystems/ezstudio
as an upstream remote:
Then pull the tag into your branch:
You will get conflicts, and it is perfectly normal. The most common ones will be on composer.json
and composer.lock
.
If you get a lot of conflicts (on the doc
folder for instance), and eZ Platform was installed from the share.ez.no tarball, it might be because of incomplete history. You will have to run git fetch ezstudio --unshallow
to load the full history, and run the merge again.
The latter can be ignored, as it will be regenerated when we execute composer update later. The easiest way is to checkout the version from the tag, and add it to the changes:
Merging composer.json
Manual merging
Conflicts in composer.json
need to be fixed manually. If you're not familiar with the diff output, you may checkout the tag's version, and inspect the changes. It should be readable for most:
You should see what was changed, as compared to your own version, in the diff output. The 1.1.0 tag changes the requirements for all of the ezsystems/
packages. Those should be left untouched. All of the other changes should be removals of your project's additions. You can use git checkout -p
to selectively cancel those changes:
Answer no
(do not discard) to the requirement changes of ezsystems
dependencies, and yes
(discard) to removals of your changes.
Using composer require
You may also checkout your own composer.json, and run the following commands to update the ezsystems
packages requirements from v1.0.x to v1.1.0:
Fixing other conflicts (if any)
Depending on the local changes you have done, you may get other conflicts: configuration files, kernel...
There shouldn't be many, and you should be able to figure out which value is the right one for all of them:
- Edit the file, and identify the conflicting changes. If a setting you have modified has also been changed by us, you should be able to figure out which value is the right one.
- Run
git add conflicting-file
to add the changes
Updating composer.lock
At this point, you should have a composer.json file with the correct requirements. Run composer update
to update the dependencies.
In order to restrict the possibility of unforeseen updates of 3rd party packages, we recommend by default that composer update
is restricted to the list of packages we have tested the update for. You may remove this restriction, but be aware that you might get a package combination we have not tested.
On PHP conflict
Because from this release onwards eZ Platform is compatible only with PHP 5.5 and higher, the update command above will fail if you use an older PHP version. Please update PHP to proceed.
Commit, test and merge
Once all the conflicts have been resolved, and composer.lock
updated, the merge can be committed. Note that you may or may not keep composer.lock
, depending on your version management workflow. If you do not wish to keep it, run git reset HEAD <file>
to remove it from the changes. Run git commit
, and adapt the message if necessary. You can now test the project, run integration tests... once the upgrade has been approved, go back to master
, and merge the upgrade-1.1.0
branch: