编辑“EZ Publish/EZ Publish使用扩展”

{{EZ Publish top}}
[[eZ Publish]] 的[[插件]]被称为扩展。扩展可以提供附加的功能。eZ Publish 可以安装多种扩展。所有的eZPublish 扩展都具有统一的安装方法。本条目会说明如何安装扩展：

1. 解压扩展压缩文件

2. 激活扩展

某些扩展需要额外的操作才可以正常工作，如：创建新的[[数据库]]表，添加若干eZ Publish 内容类等等。类似的操作会在每个扩展自己的文档中说明。

本条目只涉及扩展安装的基本步骤。出于演示的目的，会尝试安装一个称为"ezfoo"的扩展。

==解压文件==
每个扩展都以一个压缩文件的形式发布。压缩文件的文件名由扩展的名称和版本构成。此外，压缩文件的类型由文件的后缀名表示。[[后缀名]]可能为"[[tgz]]","tar.gz","[[bz2]]",或"[[zip]]"。例如：

• ezfoo-extension-1.0.tgz

• ezfoo-extension-1.0.tar.gz

• ezfoo-extension-1.0.bz2

• ezfoo-extension-1.0.zip

[[Windows]] 用户应该下载"zip"格式的压缩文件。对于[[Linux]]/[[UNIX]] 用户，只要对应的解压工具已安装，可以下载任何格式的文件。

扩展的基本目录

复制下载的压缩文件至eZ Publish 安装目录下的"[[extension]]" 目录。如果这个目录还不存在，可以创建同名目录。（不要用复数"extensions"作为目录名。）

在linux/UNIX 平台，可以用以下的命令行创建目录并复制压缩文件。
<pre>
mkdir /opt/ezp/extension/
cp /home/myuser/download/ezfoo-extension-1.0.tar.gz /opt/ezp/extension/
</pre>

用真实的eZ Publish 安装目录替换"/opt/ezp/"，用真实的压缩文件下载目录替换"/download/ezfoo-extension-1.0.tar.gz"。

解压缩压缩文件

在"extension"目录中解压缩压缩文件。如果操作无误，在"extension"目录中会创建一个"ezfoo“目录。

参阅下表了解Linux/UNIX 平台上正确的解压命令行，取决于要解压的文件格式：
<table width="639" height="176" border="1" align="center">
  <tr>
    <td width="254" align="center" style="background-color:#00CC99"><font size="+2">压缩文件格式</font></td>
    <td width="297" align="center" style="background-color:#00CC99"><font size="+2">解压命令行</font></td>
  </tr>
  <tr>
    <td height="55" align="center">tar.gz或tgz</td>
    <td align="center">tar -zxvf ezfoo-extension-1.0.tar.gz或tar -zxvf zfoo-extension-1.0.tgz</td>
  </tr>
  <tr>
    <td align="center">bz2</td>
    <td align="center">tar -jxvf ezfoo-extension-1.0.bz2</td>
  </tr>
  <tr>
    <td align="center">zip</td>
    <td align="center">unzip ezfoo-extension-1.0.zip</td>
  </tr>
</table>

在windows 平台，可以用系统内建的zip 特性来解压"zip"文件。文件会因该被解压至"extension/ezfoo"。

==激活扩展==
每个扩展都需要被激活，这意味者需要将扩展注册到eZ Publish 框架中。每个扩展可以通过eZ Publish管理界面或配置文件激活。此外，可以将扩展注册为全局扩展或某些站点入口的扩展。

'''管理界面'''
登录到eZ Publish 管理界面，点击“设置”标签，然后点击左侧的“扩展”菜单。可以看到一个显示所有可用扩展的列表与对应的复选框。要激活示例扩展，勾选下图中的复选框然后点击“应用”按钮。
[[image:ezpublishkz.jpg|center|500px|thumb|这会将示例扩展激活为全局扩展]]

'''配置文件'''

除了管理界面外，扩展也可以在"site.ini"中手动激活。

'''激活为全局扩展'''

要将示例扩展激活为全局扩展，编辑"settings/override/site.ini.append.php"。在"[ExtensionSettings]"下添加以下内容：

  ActiveExtensions[]=ezfoo

"[ExtensionSettings]"中可以添加多个扩展。如果文件或配置章节不存在，需要手动创建文件和/或配置章节。

'''激活为站点入口扩展'''

要将示例扩展激活为"example"站点入口的扩展，编辑"settings/siteaccess/example/site.ini.append.php"文件。在"[ExtensionSettings]"中添加以下内容：

  ActiveAccessExtensions[]=ezfoo

<font color="red">注意：激活扩展的这一行为"ActiveAccessExtensions"，而不是"ActiveExtensions"。如果文件和/配置章节不存在，可以手动创建。</font>

==参考来源==
*http://wenku.baidu.com/view/8cf795b665ce05087632138a.html
*http://ez.no/eZPublish/New-Release

[[category:EZ Publish|E]]
{{EZ Publish}}