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
• ezfoo-extension-1.0.zip

Extension base directory

The archive must be copied into the "extension/" directory in the root of the eZ Publish installation. If this directory does not exist yet, then create it. Make sure that you do not create the folder with the plural naming "extension s/" - this is a common error.

For example, on a Linux system do

# create extension/ directory
mkdir /path/to/ezpublish/extension/
 
# copy the archive
cp /download/dir/ezfoo-extension-1.0.tar.gz /path/to/ezpublish/extension/

Unpack the archive

Next, unpack the files from the archive. See the following table for the correct command to chose on a Linux-like system, depending on the compression type:

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

tar -zxvf ezfoo-extension-1.0.tgz

tar -jxvf ezfoo-extension-1.0.bz2

unzip ezfoo-extension-1.0.zip

Windows users can extract an archive with common tools like WinZip, which preferably work with the "zip" file.

Extracting the archive will add the directory "ezfoo/" to the extension folder:

/path/to/ezpublish/extension/ezfoo/