To do so, you will need to copy files from an eZ Publish 3.9 installation with the Website Interface 1.2-0 or higher, then edit a few files. You can then copy the new extension to your existing eZ Publish installation and make use of it.

Building the extension

Copying files from the Website Interface extension

First, we have to copy the Website Toolbar files from the Website Interface extension folder, which is located in extension/ezwebin under your eZ Publish root directory.

Make a new folder extension/ezwebsitetoolbar for the destination of the copy. Note that you will have to create all the subdirectories under the ezwebsitetoolbar directory in the following copy operations.

Copy:

extension/ezwebin/autoloads/ezcreateclasslistgroups.php
extension/ezwebin/autoloads/eztemplateautoload.php

to

extension/ezwebsitetoolbar/autoloads

Edit eztemplateautoload.php and leave the following content:

<?php

$eZTemplateOperatorArray = array();
$eZTemplateOperatorArray[] = array( 'script' => 'extension/ezwebsitetoolbar/autoloads/ezcreateclasslistgroups.php',
'class' => 'eZCreateClassListGroups',
'operator_names' => array( 'ezcreateclasslistgroups' ) );


?>

Then, copy all images from:

extension/ezwebin/design/ezwebin/images/websitetoolbar

to

extension/ezwebsitetoolbar/design/standard/images/websitetoolbar

Then, copy:

extension/ezwebin/design/ezwebin/stylesheets/websitetoolbar.css

to

extension/ezwebsitetoolbar/design/standard/stylesheets

Copy:

extension/ezwebin/design/ezwebin/templates/parts/website_toolbar.tpl
extension/ezwebin/design/ezwebin/templates/parts/website_toolbar_edit.tpl
extension/ezwebin/design/ezwebin/templates/parts/website_toolbar_versionview.tpl

to

extension/ezwebsitetoolbar/design/standard/templates/parts

Copy:

extension/ezwebin/modules/websitetoolbar

to

extension/ezwebsitetoolbar/modules/websitetoolbar

Note: The modules folder does not exist in Website Interface versions lower than 1.2-1. If you are using an earlier version, the ?ezwebsitetoolbar? extension will still work, but you will not be able to use the built-in eZ Publish permissions feature to manage the Website Toolbar. I will explain this further at the end of this post.

Copy:

extension/ezwebin/settings/design.ini.append.php
extension/ezwebin/settings/module.ini.append.php
extension/ezwebin/settings/site.ini.append.php
extension/ezwebin/settings/websitetoolbar.ini

to

extension/ezwebsitetoolbar/settings

Editing the configuration files

Next, update the configuration files in the extension/ezwebsitetoolbar/settings folder.

In extension/ezwebsitetoolbar/settings/design.ini.append.php put:

<?php /*

[ExtensionSettings]
DesignExtensions[]=ezwebsitetoolbar


*/ ?>

In extension/ezwebsitetoolbar/settings/module.ini.append.php put:

<?php /*

[ModuleSettings]
ExtensionRepositories[]=ezwebsitetoolbar

*/ ?>

In extension/ezwebsitetoolbar/settings/site.ini.append.php put:

<?php /*

[TemplateSettings]
ExtensionAutoloadPath[]=ezwebsitetoolbar

*/ ?>

Installation

Now you can copy the ?ezwebsitetoolbar? extension to your existing eZ Publish installation, then enable it in the Administration Interface (in the Extensions menu under the Setup tab).

Next, insert the following lines into your pagelayout.tpl file:

<style type="text/css">
@import url({"stylesheets/websitetoolbar.css"|ezdesign});
</style>

{include uri='design:parts/website_toolbar.tpl' current_node_id=$module_result.node_id}

In content/edit.tpl or its override file, include:

{include uri='design:parts/website_toolbar_edit.tpl'}

In content/view/versionview.tpl or its override file, include:

{include uri='design:parts/website_toolbar_versionview.tpl'}

If you used the Website Interface 1.2-1 or higher to generate the ?ezwebsitetoolbar? extension, you can use the built-in eZ Publish permission system to manage the Website Toolbar. To do so, add a policy to the ?websitetoolbar? module to the appropriate roles in the Roles and Policies menu under the User accounts tab in the Administration Interface. Otherwise, you will have to make sure the User group content class (in the Classes menu under the Setup tab in the Administration Interface) has a checkbox attribute with the identifier ?website_toolbar_access?, then edit the relevant User group objects and mark that checkbox.

Finally, clear all the caches (under the Cache window on the right of the Administration Interface) and you should now be able to use the Website Toolbar in your existing eZ Publish project. Of course, you will need to configure it a bit more (see extension/ezwebsitetoolbar/settings/websitetoolbar.ini).

This tutorial has explained how to extract the Website Toolbar from the Website Interface. You can find the latest version of the Website Toolbar extension in the eZ Publish contribution section.