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

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 /opt/ezp/extension/
cp /home/myuser/download/ezfoo-extension-1.0.tar.gz /opt/ezp/extension/

Replace "/opt/ezp/" 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:

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

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".