Joomla文档中文翻译 - 模板输出覆盖 - 模块布局的输出覆盖

joomla_documentation_168在前面的几篇文档中,我们学习了怎样对Joomla原生组件的布局输出进行覆盖;今天的文档将介绍怎样对Joomla原生模块的布局输出进行覆盖;由于方法与组件覆盖很相似,所以强烈D推荐阅读本文结尾列出的几篇关于组件输出覆盖的文档,以作参考。

模块布局的输出覆盖

和组件类似,Joomla的模块也有特定的文件目录结构:

/modules
/mod_latest_news
/tmpl
default.php (the layout)
helper.php (a helper file containing data logic)
mod_latest_news.php (the main module file)
mod_latest_news.xml (the installation XML file)

在模块的根路径下(例如上面结构示意中的mod_latest_news,最新文章模块),有一个/tmpl/文件夹,这个文件夹中包含该模块的一个布局文件通常,模块只有一个布局文件,但某些特殊的模块中会有例外。

和组件相同,用来覆盖Joomla模块输出的布局文件必须被放在特定的路径中我们使用Beez模板做示例,来看看它的文件结构:

/templates
/beez
/html
/mod_latest_news (this directory matches the module directory name)
default.php (this file matches the layout file name)

相应的,我们也要在当前自定义模板中的对应路径中使用同名文件进行自定义修改。

复制与创建模块的布局文件

和组件的状况相似,rhuk_milkyway模板本身没有任何的模块布局覆盖(其html文件夹中没有模块路径),我们仍然需要手动复制Joomla原生的模块布局文件来做自定义修改。找到下面这个文件:

Joomla根路径/modules/mod_latest_news/tmpl/default.php

复制并粘帖到下面这个路径中(需要我们自己创建):

Joomla根路径/templates/rhuk_milkyway/html/mod_latest_news/default.php

然后,我们就可以在这些复制过来的新文件中进行自定义编辑了,它们会覆盖掉Joomla原生的模块输出,以我们自定义的方式来进行输出。

推荐参考阅读:

在明天的文档中,我们将学习怎样自定义模块结构(Module Chrome)

译者:Viiiix7210

如需转载,请注明官方英文文档及本人译文的出处,谢谢。查看官方英文文档: Understanding Output Overrides


收藏与分享

添加评论


Security code
换一张图