EZ Publish/EZ Publish模块与视图
|
EZ Publish | EZ Publish安装与卸载 | EZ Publish的使用 | EZ Publish常见问题 | EZ Publish其他 |
模块提供了一种HTTP 接口可以用于在WEB 上与eZ Publish 互动。某些模块提供了调用内核功能的接口，其余的模块在不同程度上独立于内核存在。系统内建的一套模块可以满足典型的日常事务的需求。例如：
内容模块提供了通过WEB 浏览器管理内容的接口。通过开发自定义的模块，可以扩展系统来满足特定的业务需求。自定义的模块必须用PHP 开发。下表列出了一些常用的内建模块。
模块扩展[ ]
每次通过WEB 浏览器访问eZ Publish，客户端其实是在间接地与系统中的模个模块互动。请求的URL 告诉eZ Publish 应该执行哪个模块来处理客户端的请求。URL 的第一部分表明模块的名称。这通常是URL中"index.php"后面的第一部分（URI 访问方法除外）。下例演示了典型的eZ Publish URL：http://www.example.com/index.php/content/edit/13/03 这个URL 表明请求会调用content 模块。另外一个典型的eZ Publish URL 如下：http://www.example.com/index.php/user/login 这个URL 表明eZ Publish 会调用user 模块。显然，这两个URL 还包含附加的信息。在第一个例子中，模块名的后面追加了"/edit/13/03"。在第二个例子中，模块名的后面追加了"/login"。这些附加的信息控制被请求的模块的行为，将在下面解释。
模块视图[ ]
模块由一系列视图构成。视图可以被想象成为一种与模块的接口。通过使用视图，可以调用模块提供的各种功能。例如：除其它视图外，content 模块提供了用于显示，编辑，检索和翻译内容对象的视图。视图的名称在URL 中紧跟在模块名后面（由"/"分割）。在第一个例子中，eZ Publish 被要求访问content模块的"edit"视图。在第二个例子中，eZ Publish 被要求访问"user"模块的"login"视图。
当视图被调用时，eZ Publish 启动与那个视图相关的代码。执行结束后，视图把返回结果返回给模块，模块再把结果返回给系统的其余部分。结果被设置到一个模板变量中，变量名为$module_result.content。在主模板（pagelayout）中可以访问这个变量。另请参阅“EZ Publish的使用”中有关模板的使用介绍。
视图参数[ ]
某些视图支持一到多个参数。视图参数允许用户向视图传送信息从而通过URL 来控制视图。视图参数在URL 中被追加到视图名之后。在第一个例子中，以下的参数被传输给视图："13"和"03"。这些参数会要求content 模块的edit 视图提供一个界面用来编辑对象13 的版本3。第二个例子中的URL 并没有使用视图参数。视图机制支持两种类型的参数：
- 有序参数
- 无序参数
有序参数在URL 中必须用"/"分割且必须紧跟视图名之后。此外，他们的顺序必须与模块定义中的顺序相同。例如：如果第一个例子中的参数顺序对调，eZ Publish 会尝试去编辑对象3 的版本13（而不是对象13 的版本3）。
如同名字的含义，无序参数可以以任何参数提供。如果模块支持有序参数，无序参数必须排在有序参数之后。如果视图不支持有序参数，无序参数会跟随在视图名之后。无序参数必须成对出现。一个无序参数对有参数名和参数值构成（由"/"分割）。下例演示了如何在eZ Publish URL 中使用无序参数：http://www.example.com/index.php/video/dvd/button/play 上例中的地址告诉eZ Publish 运行"video"模块并且执行"dvd"视图。无序参数的名称为"button"，参数值为"play"。如何处理这些参数由"dvd"视图的PHP 代码决定。
POST 变量[ ]
某些视图会用到通过表单以HTTP POST 方式提交到服务器的参数。例如："content"模块的"action"视图支持可扩展的POST 变量。
GET 变量[ ]
视图也可以支持GET 变量。例如：content 模块的treemenu 视图的参数是通过GET 变量传输的。
默认的请求[ ]
为了生成合适的输出，eZ Publish 必须知道应该运行哪个模块与执行哪个视图。换言之，每个URL 都至少要包含模块名和视图名。如果输入了不完整的或错误的URL，eZ Publish 会显示一个出错页面表明错误的内容（缺失/错误的模块或视图）。如果在URL 中"index.php"后不包含任何内容（或许除了"/"），默认的模块/视图组合会被执行。默认的模块/视图组合可以在"site.ini"的重设文件中配置。配置的位置为："[SiteSettings]"下的"IndexPage"。默认的设置是"/content/view/full/2"。它要求eZ Publish 显示节点2（内容顶极节点）的全视图。换言之，如果请求以下URL：
http://www.example.com/index.php
与请求如下URL 的效果相同。
http://www.example.com/index.php/content/view/full/2
eZ Publish 不会重定向或是重载页面，这意味着浏览器的地址栏中的内容不会改变。