Global navigation

   Documentation Center
   eZ Studio & eZ Platform
     User Manual
     Technical Manual
   eZ Publish 4.x / legacy

eZ Publish (5.x)

eZ Publish 5.x | For eZ Platform & eZ Studio topics see Technical manual and User manual, for eZ Publish 4.x and Legacy topics see eZ Publish legacy

Skip to end of metadata
Go to start of metadata


Each extension is distributed as a compressed archive. The name of the archive file includes the name of the extension and its release version. Furthermore, the compression type is indicated by the file ending, either "tgz", "tar.gz", "bz2", or "zip". For example:

  • ezfoo-extension-1.0.tgz
  • ezfoo-extension-1.0.tar.gz
  • ezfoo-extension-1.0.bz2

Windows users should download the "zip" archive. Linux/UNIX users may download any archive format as long as the necessary unpacking tools are available.

Extension base directory

Copy the downloaded archive into the "extension" directory of your eZ Publish installation. If this directory does not exist yet, then create it. (Do not create the directory with the plural naming "extensions" - this is a common error.)

The following shell commands can be used to create the "extension" directory and copy the archive on a Linux/UNIX system:

mkdir <eZ_Publish_root_folder>/ezpublish_legacy/extension/
cp /home/myuser/download/ezfoo-extension-1.0.tar.gz <eZ_Publish_root_folder>/ezpublish_legacy/extension/


Replace "<eZ_Publish_root_folder>" with the actual path to your eZ Publish installation and "/home/myuser/download/ezfoo-extension-1.0.tar.gz" with the actual path to the downloaded archive.

Unpack the archive

The archive should be unpacked inside the "extension" directory. When done correctly, an "ezfoo" directory will be created inside the "extension" directory.

See the following table for the correct shell command to use on a Linux/UNIX system, depending on the compression type:

Archive type

Command to extract

tar.gz or tgz

tar -zxvf ezfoo-extension-1.0.tar.gz


tar -zxvf ezfoo-extension-1.0.tgz


tar -jxvf ezfoo-extension-1.0.bz2



On Windows, you can just unzip the "zip" file using the built-in zip features.

At this point, the unpacked files should be available under "extension/ezfoo".

  • No labels