Joomla文档中文翻译 - MVC组件开发:基础 - 创建组件(5) XML文件

thumb-joomla-doc-viiiix昨天我们学习了怎样为组件创建视图及对应的模板,今天我们来看看怎样将之前创建的控制器、视图及模板通过一个XML文件进行整合打包,成为一个真正的组件。

实际上,当我们创建了组件的入口点、控制器、视图及模板等文件之后,可以直接通过FTP上传到Joomla系统对应的路径中来完成组件的安装但更有效灵活的办法,是将组件打包成为安装文件包,通过系统的安装器进行安装。

安装包信息文件,即我们要创建的XML文件,通常包括组件的如下信息:

  • 组件的基本信息,例如名称、描述、版权声明及许可证信息等。
  • 入口点、控制器、视图及模板等相关文件。
  • 一个可选的PHP文件,用来控制安装及卸载的相关操作。
  • 一个可选的SQL文件,用来在安装或卸载的过程中提供相关数据信息。

下面是我们的hello组件所需要的XML文件代码:

<?xml version="1.0" encoding="utf-8"?>
<install type="component" version="1.5.0">
<name>Hello</name>
<!-- The following elements are optional and free of formatting constraints -->
<creationDate>2007-02-22</creationDate>
<author>John Doe</author>
<authorEmail> This e-mail address is being protected from spambots. You need JavaScript enabled to view it </authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>
<!-- The version string is recorded in the components table -->
<version>1.01</version>
<!-- The description is optional and defaults to the name -->
<description>Description of the component ...</description>

<!-- Site Main File Copy Section -->
<!-- Note the folder attribute: This attribute describes the folder
to copy FROM in the package to install therefore files copied
in this section are copied from /site/ in the package -->
<files folder="site">
<filename>controller.php</filename>
<filename>hello.php</filename>
<filename>index.html</filename>
<filename>views/index.html</filename>
<filename>views/hello/index.html</filename>
<filename>views/hello/view.html.php</filename>
<filename>views/hello/tmpl/default.php</filename>
<filename>views/hello/tmpl/index.html</filename>
</files>

<administration>
<!-- Administration Menu Section -->
<menu>Hello World!</menu>

<!-- Administration Main File Copy Section -->
<files folder="admin">
<filename>hello.php</filename>
<filename>index.html</filename>
</files>

</administration>
</install>

在文件列表(files)中,我们可以看到有一些index.html文件并不是我们曾经创建过的;这些文件的作用是防止该路径被用户直接访问;虽然在功能上不是必需的,但是通常在组件或模板等文件路径中最好都保存一个这样的index.html文件;它的代码很简单:

<html><body bgcolor="#FFFFFF"></body></html>

另外,<files folder="admin">中的hello.php是我们的组件在站点管理后台中的入口点文件;由于目前我们还没有学习到相关知识,所以目前这个文件的代码可以暂时使用index.html的代码。

到此,“Joomla文档中文翻译 - MVC组件开发:基础”部分就告一段落了;明天开始进入第二部分的学习,即为组件创建模型(Model)及相关扩展。

  • Joomla文档中文翻译 - MVC组件开发:基础
  • Joomla文档中文翻译 - MVC组件开发:创建模型及相关扩展
  • Joomla文档中文翻译 - MVC组件开发:使用数据库
  • Joomla文档中文翻译 - MVC组件开发:创建后台管理界面
  • Joomla文档中文翻译 - MVC组件开发:后台基本框架
  • Joomla文档中文翻译 - MVC组件开发:添加后台行为

译者:Viiiix7210

如需转载,请注明官方英文文档及本人译文的出处,谢谢。查看官方英文文档: Developing a Model-View-Controller Component - Part 1

收藏与分享

添加评论


Security code
换一张图