eZ Demo 5.0 upgrade

Compatibility notice
Please be aware that issues can occur if eZ Webin and eZ Demo are used in the same installation. This is because the two extensions have similarities at the code level, such as class names, which will considered them as duplicated. In resume, we don't recommend or support the usage of both extensions in parallel, in the same eZ Publish installation.

1. Back-up

Before starting the eZ Publish Demo Site upgrading process, make sure that you have a working backup of the existing website state including database, extensions, INI settings, etc. During the upgrade process the existing "ezdemo" extension and its dependencies will be removed and replaced with a new version.

2. Packages

Download the following packages from http://packages.ez.no/ezpublish/5.0/ (latest version):

"ezdemo_extension.ezpkg" 
"ezstarrating_extension.ezpkg" 
"ezgmaplocation_extension.ezpkg" 
"ezwt_extension.ezpkg"
"ezflow_extension.ezpkg"
"ezcomments_extension.ezpkg"

Go to the packages management interface in the "Administration Interface". This can be done via the "Setup" tab, where you can click on the "Packages" link in the left menu:

The package management screen

From the Repository drop-down box choose "eZ-systems" and then click on the “Change repository” button. From the list of available packages, remove the following ones:

"ezdemo_extension" 
"ezstarrating_extension" 
"ezgmaplocation_extension" 
"ezwt_extension" 
"ezflow_extension"
"ezcomments_extension"

Be sure that the repository chosen is “eZ-systems” and click on the “Import new package” button. In the next view select "ezdemo_extension" and click on the “Import package” button. Once the "ezdemo_extension" is imported click on “Install package”. In the next view choose the “Replace extension” option and click on the “Continue” button. Repeat these steps for the rest of new extensions ("ezstarrating_extension", "ezgmaplocation_extension", "ezwt_extension", “ezflow_extension” and “ezcomments_extension”).

3. Autoload update

The autoload array needs to be updated for the new extensions. In order to do so, execute the following command from the eZ Publish Legacy root folder:

$ cd /<ezpublish5-root-dir>/ezpublish_legacy/
$ php bin/php/ezpgenerateautoloads.php -e -p

4. Content classes

eZ Publish Demo Site 5.0 comes with two new content classes: “Call To Action” and “Call To Action Feedback”. Using the eZ Publish package manager from the Administration Interface, import these classes by following the package import wizard steps (like shown above). The new content classes can be found in the “ezdemo” extension folder under “/packages/5.0”:

call_to_action_feedback-1.0-1.ezpkg
call_to_action-1.0-1.ezpkg

5. Database changes

eZ Publish Demo Site 5.0 's ezcomment requires a database update, which is available in the following path:

/<ezpublish5-root-dir>/ezpublish_legacy/extension/ezcomments/update/database/<database>/5.0/dbupdate-1.4.0-to-5.0.0.sql

6. INI settings

Remove the following template override rules to all your public siteaccesses, in settings/siteaccess/(site_name)/override.ini.append.php files

[block_banner_url]
Source=block/view/view.tpl
MatchFile=block/banner_url.tpl
Subdir=templates
Match[type]=Banner
Match[view]=banner_url

[dynamic_banner_code]
Source=block/view/view.tpl
MatchFile=block/banner_code.tpl
Subdir=templates
Match[type]=Banner
Match[view]=banner_code

Add the following template override rules to all your public siteaccesses, in settings/siteaccess/(site_name)/override.ini.append.php files, for the new content classes:

[call_to_action_mail]
Source=content/collectedinfomail/form.tpl
MatchFile=collectedinfomail/call_to_action.tpl
Subdir=templates
Match[class_identifier]=call_to_action

[full_call_to_action]
Source=node/view/full.tpl
MatchFile=full/call_to_action.tpl
Subdir=templates
Match[class_identifier]=call_to_action

[full_call_to_action_feedback]
Source=node/view/full.tpl
MatchFile=full/call_to_action_feedback.tpl
Subdir=templates
Match[class_identifier]=call_to_action_feedback

[block_banner_internal]
Source=block/view/view.tpl
MatchFile=block/banner_internal.tpl
Subdir=templates
Match[type]=Banner
Match[view]=default

[block_banner_external]
Source=block/view/view.tpl
MatchFile=block/banner_external.tpl
Subdir=templates
Match[type]=Banner
Match[view]=external

[block_banner_code]
Source=block/view/view.tpl
MatchFile=block/banner_code.tpl
Subdir=templates
Match[type]=Banner
Match[view]=code

[gallery_item_video]
Source=node/view/gallery_item.tpl
MatchFile=gallery_item/video.tpl
Subdir=templates
Match[class_identifier]=video

[gallery_viewer_video]
Source=node/view/gallery_viewer.tpl
MatchFile=gallery_viewer/video.tpl
Subdir=templates
Match[class_identifier]=video

7. Clear Cache

Once the upgrade script is done, you need to clear the cache by executing the following command from the eZ Publish Legacy root folder:

$ cd /<ezpublish5-root-dir>/ezpublish_legacy/
$ php bin/php/ezcache.php --clear-all --purge