Back-up

Before starting the eZ Flow 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 eZ Flow extension will be removed and replaced with a new version. eZ Flow default content classes will be replaced as well.

Packages

Download following packages from http://packages.ez.no/ezpublish/4.2/4.2.0:

ezflow_extension.ezpkg
ezwebin_extension.ezpkg
ezstarrating_extension.ezpkg
ezjscore_extension.ezpkg
ezgmaplocation_extension.ezpkg
ezwt_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

From the Repository drop-down box choose eZ-system then click “Change repository” button. From the list of available packages remove following packages:

ezflow_extension
ezwebin_extension

Next change repository again to the “eZ-systems” and click on “Import new package” button. In the next view select ezflow_extension and click “Import package” button. Once the ezflow_extension is imported click on “Install package”. In the next view choose “Replace extension” option and click “Continue” button. Repeat these steps for rest of new extensions (ezwebin_extension, ezstarrating_extension, ezjscore_extension, ezgmaplocation_extension and ezwt_extension).

Once all new extensions are imported they need to be activated in the proper order under the [ExtensionSettings] block in the settings/site.ini.append.php:

[ExtensionSettings]
[...]
ActiveExtensions[]=ezjscore
ActiveExtensions[]=ezstarrating
ActiveExtensions[]=ezgmaplocation
ActiveExtensions[]=ezflow
ActiveExtensions[]=ezwt
ActiveExtensions[]=ezwebin
[…]

Autoload update

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

$ php bin/php/ezpgenerateautoloads.php -e -p

Content classes

eZ Flow 2.0 provides a new Geo Article content class which uses a eZ GMap Location extension for storing geo located content. You can import Geo Article content class using package manager in the Administration Interface. This can be done via the Setup-tab, where you can click on the "Packages"-link in the left menu.

First change repository to “eZ-systems”. Next click “Import new package” button. Geo Article class package is located in eZ Publish root directory in subfolder extension/ezwebin/packages/geo_article-1.5-0.ezpkg.

eZ Star Rating

This extension requires new database tables in order to store ratings.
Execute following command to create database tables in MySQL:

mysql -u[datbase_user] -p[database-password] [databasename] < extension/ezstarrating/sql/mysql/mysql.sql

Sql files are also provided for postgressql and oracle - refer to the database documentation on how to execute queries from a command-line clients.

For the user roles that are allowed to vote, add in the "roles and policies" page in the administration interface policy on module "ezjscore", function call", with limitation "ezstarrating_rate".

To enable users to rate your content simply add a Star Rating attribute to the content class you want to be rated.

For more information about installation please read the eZ Star Rating README file located in in the extension/ezstarrating in the eZ Publish root directory.

eZ GMap Location

eZ GMap Location extension requires Google Maps API key which you can obtain for your domain following instructions mention in http://www.google.com/apis/maps

Once you have generated your key add it to the settings/override/site.ini.append.php under [SiteSettings] block like so:

[SiteSettings]
GmapsKey=<Google Maps API Key>

This extension requires new database tables in order to store locations information.
Execute following command to create database tables in MySQL:

mysql -u[datbase_user] -p[database-password] [databasename] < extension/ezgmaplocation/sql/mysql/mysql.sql

Sql files are also provided for postgressql and oracle - refer to the database documentation on how to execute queries from a command-line clients.

With Geo Article class you can use this feature immediately. However If you want extend your current content classes with eZ GMap Location attribute simply add new attribute.

For more information about installation please read the eZ GMAP Location README file located in the extension/ezgmaplocation in the eZ Publish root directory.

INI settings

Update settings/siteaccess/(public_site_name)/override.ini.append.php:

[block_gmap]
Source=block/view/view.tpl
MatchFile=block/gmap.tpl
Subdir=templates
Match[type]=GMap
Match[view]=gmap
 
[block_online_users]
Source=block/view/view.tpl
MatchFile=block/online_users.tpl
Subdir=templates
Match[type]=OnlineUsers
Match[view]=onlineusers
 
[block_keyword]
Source=block/view/view.tpl
MatchFile=block/keyword.tpl
Subdir=templates
Match[type]=Keyword
Match[view]=keyword
 
[block_multimediacarousel]
Source=block/view/view.tpl
MatchFile=block/multimediacarousel.tpl
Subdir=templates
Match[type]=MultimediaCarousel
Match[view]=multimediacarousel
 
[block_search]
Source=block/view/view.tpl
MatchFile=block/search.tpl
Subdir=templates
Match[type]=Search
Match[view]=search
 
[block_ads]
Source=block/view/view.tpl
MatchFile=block/ads.tpl
Subdir=templates
Match[type]=Ads
Match[view]=ads
 
[block_latest_content]
Source=block/view/view.tpl
MatchFile=block/latest_content.tpl
Subdir=templates
Match[type]=LatestContent
Match[view]=latest_content
 
[block_top_rated]
Source=block/view/view.tpl
MatchFile=block/top_rated.tpl
Subdir=templates
Match[type]=TopRated
Match[view]=toprated
 
[block_gmapitems_geo_located_content]
Source=block/view/view.tpl
MatchFile=block/geo_located_content.tpl
Subdir=templates
Match[type]=GMapItems
Match[view]=geo_located_content
 
[block_feed_reader]
Source=block/view/view.tpl
MatchFile=block/feed_reader.tpl
Subdir=templates
Match[type]=FeedReader
Match[view]=feed_reader
 
[block_item_comment]
Source=node/view/block_item.tpl
MatchFile=block_item/comment.tpl
Subdir=templates
Match[class_identifier]=comment
 
[full_geo_article]
Source=node/view/full.tpl
MatchFile=full/geo_article.tpl
Subdir=templates
Match[class_identifier]=geo_article
 
[line_geo_article]
Source=node/view/line.tpl
MatchFile=line/geo_article.tpl
Subdir=templates
Match[class_identifier]=geo_article
 
[embed_flash_player]
Source=content/view/embed.tpl
MatchFile=embed/flash_player.tpl
Subdir=templates
Match[class_identifier]=flash_player
 
[flash_player_galleryline]
Source=node/view/galleryline.tpl
MatchFile=galleryline/flash_player.tpl
Subdir=templates
Match[class_identifier]=flash_player

Clear Cache

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

php bin/php/ezcache.php --clear-all --purge