Installation

Unpack the tar.gz archive and place the ezodf folder under the extension folder in the eZ Publish installation. Enable the eZODF extension in the eZ Publish Administration Interface under the Setup->Extensions menu.

Note: if you want to upload large documents you need to increase the upload memory limit in PHP. This is configured in the php.ini configuration file.

Microsoft Word import configuration

To install Microsoft Word import support you need to do the following on your web server:

1. Install OpenOffice.org 2.x
2. Install document conversion macros in OOo
3. Start the document conversion daemon

The reason you need to have OpenOffice.org installed is because eZ Publish uses it to first convert the Word file formats to OpenDocument Text format, which is then imported. Tested formats include .doc and .rtf.

Installation of OpenOffice.org macros

Go to the package manager interface in OpenOffice.org. This is found under Tools -> Package Manager.

Package Manager

Choose My Packages and click Add.

Then, select the file extension/ezodf/doc/eZconversion.zip. 

Starting the document conversion daemon

The document conversion daemon is a PHP script bundled with the extension. It communicates with OpenOffice.org and does the actual conversion of documents.

The script needs to be started with the CLI version of PHP, which means that you need to execute the following command from the command line:

$ php extension/ezodf/scripts/daemon.php

Note: PHP must have been compiled with the following switches:

--enable-cli
--enable-pcntl
--enable-sockets

Note: The document conversion daemon will only run under Linux. It requires the pcntl PHP extension, unsupported on windows platforms.