edit

eZ Studio 15.12.1 Release notes

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:

Dropping a block onto a Landing 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:

Landing Page in View mode with a Timeline

  • Added an Approval Timeline which lists all review requests for a given Content item:

Approval timeline screen

  • Modified template of the notification email sent to reviewers from Flex Workflow.
  • Minor UI improvements (including: updated icons, labels, date picker and others):

Datepicker

  • Added notification when copying a URL.
  • Numerous bug fixes.

Full list of improvements

Key Summary T
EZEE-509 Get information about content workflow status and messages history from backend Feature
EZEE-508 Schedule block: when removing content from the future the content is not moved to the history Bug
EZEE-506 As a user, I want to see approval timeline in content editor mode Story
EZEE-500 The timeline should display all future changes from all the schedule blocks at once Sub-task
EZEE-499 Add the timeline to the Page view Sub-task
EZEE-498 Show a dashed frame when dragging over valid target area Improvement
EZEE-497 Change Schedule block's Delete label Improvement
EZEE-496 Change Schedule block's Settings label Improvement
EZEE-494 Datepicker add animation and CSS changes Improvement
EZEE-493 When clicking on Copy URL user gets a notification that confirms the action done Improvement
EZEE-487 Draggable interaction - show dashed frame in place of selected element Improvement
EZEE-486 Refine dragging interaction with elements Improvement
EZEE-485 Change cursor to show that an element is draggable Improvement
EZEE-451 When switching from Page to Content I'm not redirected to a correct page in PlatformUI Bug
EZEE-450 Replace Slot Icon and label Improvement
EZEE-449 Change the page title Improvement
EZEE-412 Update Flex Workflow email template Improvement
EZEE-402 Dynamic Landing page, define width & height for resizable Page Description input box Improvement
EZEE-392 Moving blocks on landing pages is tricky Bug
EZEE-373 As a User, I want to be able to access the Scheduled Block toolbar at all times Improvement
EZEE-326 As an editor I would like to see the now time indicator in the timeline when scheduling content inside a schedule block Story
EZEE-185 As an editor I would like to see overflow block select field hidden when overflow is turned off Improvement

22 issues

Full list of bugfixes

Key Summary T
EZP-25291 No `languageCode` is set when creating a new content after canceling previous new content creation Bug
EZEE-521 The preview height is incorrect Bug
EZEE-518 On Publish action page is reloaded twice Bug
EZEE-505 When navigating in the Page mode the URL in the browser address bar is not updating Bug
EZEE-490 Getting error when opening landing page editor Bug
EZEE-475 ContentTypes to be displayed change is not stored after publish Bug
EZEE-459 Block not found exception on publish after adding extra block Bug
EZEE-458 "button.removeTarget is not a function" error on logout Bug
EZEE-444 Blocks are not rendered in the correct order when opening a landing page in the editor Bug
EZEE-442 [IE11] The filled slots number is displayed incorrectly Bug
EZEE-441 Scroll in editing Landing Page on IE don't work, on FF works slowly Bug
EZEE-411 Flex workflow not working when receiving notification Bug
EZEE-406 Landing Page editing is blocked when page does not have any blocks (empty zones) Bug
EZEE-403 Embed block preview layout position Bug
EZEE-398 [IE] Schedule block Timeline colour rendering is broken Bug
EZEE-397 [IE] Content List & Keyword block empty field validation always fails Bug
EZEE-396 [IE] Landing Page zones layout is broken Bug
EZEE-394 [IE] Basics section layout is broken Bug
EZEE-393 I can't select the block that I just added to my page Bug
EZEE-391 Adding a gallery block to a new landing page breaks the layout view Bug
EZEE-312 Cogwheel stuck when creating "Landing Page" Bug

21 issues

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:

From your master branch

git checkout -b upgrade-1.1.0

In case of different localization of the sources, add ezsystems/ezstudio as an upstream remote:

From the upgrade-1.1.0 branch

git remote add ezstudio http://github.com/ezsystems/ezstudio.git

Then pull the tag into your branch:

From the upgrade-1.1.0 branch

git pull ezstudio v1.1.0

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:

From the upgrade-1.1.0 branch

git checkout --theirs composer.lock && git add composer.lock

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:

From the upgrade-1.1.0 branch

git checkout --theirs composer.json && git diff composer.json

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:

git checkout -p composer.json

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:

git checkout --ours composer.json
composer require --no-update "ezsystems/ezpublish-kernel:~6.1.0"
composer require --no-update "ezsystems/platform-ui-bundle:~1.1.0"
composer require --no-update "ezsystems/studio-ui-bundle:~1.1.0"
composer require --no-update "ezsystems/ezstudio-demo-bundle:~1.1.0"
composer require --no-update "ezsystems/landing-page-fieldtype-bundle:~1.1.0"
composer require --no-update "ezsystems/flex-workflow:~1.1.0"
composer require --dev --no-update "ezsystems/behatbundle:~6.1.0"

# PHP requirement is now 5.5+, and 7.0 is now supported for dev use (see top of this page for requirements link)
composer require --no-update "php:~5.5|~7.0"

# As there are some bugs with Symfony 2.8, make sure to pull in Symfony 2.7 LTS updates
composer require --no-update "symfony/symfony:~2.7.0"

# This command will remove platform.php: "5.4.4" as php 5.4 is no longer supported
composer config --unset platform.php

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. 

composer update --with-dependencies ezsystems/ezpublish-kernel ezsystems/platform-ui-bundle ezsystems/repository-forms ezsystems/studio-ui-bundle ezsystems/ezstudio-demo-bundle ezsystems/landing-page-fieldtype-bundle ezsystems/flex-workflow

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:

git checkout master
git merge upgrade-1.1.0
Read the Docs