joomla官方网站提供了一个helloworld组件的开发说明文档(全英文看得好痛苦),这里记录一些自己的理解。在Joomla原文档 中可以下载到helloworld的zip安装包。你也可以根据文档说明一步一步创建自己的helloworld组件。(这里我采用了Component-Creator快速的创建自己的组件,具体操作请参考快速创建自己的joomla组件)。
解压下载的zip包,开始一点一点的研究helloworld。helloworld组件的安装是这样的:
其中helloworld.xml和script.php文件是安装配置文件,暂时可以不管。site目录下是组件的前段代码,admin目录下是组件的后端代码,media下是组件用到的媒体文件(现在只有2张图片);下面我们就从前段开始研究。
helloworld组件安装好后,可以通过http://localhost/joomla(改为你自己的名称)/index.php?option=com_helloworld查看前段的显示效果,只有一个helloworld的简单视图。然后我们开始查看site目录下的代码,site目录是这样的:
其中index.html是索引文件,作用是防止整个目录被透视,我们不用做修改。helloworld.php是整个组件的入口,helloworld.php获取了组件主控制器并传递页面的任务请求(只有几行代码,就不详述了)。
control.php是主控制器,本例中control.php只是声明了一个集成于 JControllerLegacy的HelloWorldController 类,响应默认的display请求。models下的helloworld.php是组件的模块,负责对数据进行处理。模块中声明了一个继承于JModelItem的HelloWorldModelHelloWorld类,该类声明了Item属性保存数据;声明了三个方法:populateState();--传递模块的状态、getTable--获取数据库对象和getItem()--从数据库获取数据;
以下对getItem()简单说明:
<span style="background-color: rgb(192, 192, 192);"> $id = $this->getState('message.id');
$db = JFactory::getDbo();
$query = $db->getQuery(true);
$query->select('h.greeting, h.params, c.title as category')
->from('#__helloworld as h')
->leftJoin('#__categories as c ON h.catid=c.id')
->where('h.id=' . (int)$id);
$db->setQuery((string)$query);//以上构建了数据库查询语句(从#__helloworld和#__categories表中以message.id查询greeting、params、title)
if ($this->item = $db->loadObject()) //查询数据并构造数据的JSON串
{
// Load the JSON string
$params = new JRegistry;
$params->loadString($this->item->params, 'JSON');
$this->item->params = $params;
// Merge global params with item params
$params = clone $this->getState('params');
$params->merge($this->item->params);
$this->item->params = $params;</span>
SQL语句的学习可以参考SQL教程
views目录下是组件视图的代码,其中重要的是\views\helloworld\view.html.php、\views\helloworld\tmpl\default.xml和\views\helloworld\tmpl\default.php。
view.html.php负责显示视图,通过$this->item = $this->get('Item');从模块中获取数据并显示默认的模板(即tmpl\default.php),default.php中定义了要如何显示数据;default.xml定义了一个字段和查找该字段的路径(指向后端 )。
language目录下是语言支持文件,前端该目录无内容。