登录 注册

登录

这个问题的提出源自本站会员 szyyw08 在论坛的一个问题,简单来说就是:如何自定义组件的前台风格(原帖子中提到的“首页”应该理解为 com_content 组件的 frontpage 视图)?在 Joomla! 1.0 时代,AutoIt 介绍了一种方法可以完美解决这个问题。

现在到了 Joomla! 1.5 平台,前面这个方法不灵了。不过,Joomla! 开发团队早就给出了更好的方案,总结起来就是3个字母:MVC。

MVC in php Programming

 

MVC 等几个概念

MVC 是Model-View-Controller (模型-视图-控制器)的缩写。这是 Joomla! 1.5 采纳的一种新型的 Web 程序编写模式。MVC 这三个字同时也蕴含了一种理念:更加灵活的外观设计。其中的 V 字母就是完美解决外观布局问题的答案。

长期以来,Joomla! 就因为其外观布局无法自由设计而遭诟病。现在,得益于MVC的帮助,彻底控制网页外观风格的力量重新回到了模板设计人员的手中。

首先弄清楚两个概念:CSS 只能改变页面“样式”,例如颜色、字体、背景等等,它不能改变“布局”,也就是页面上各种组成部分的结构。这是由 HTML 的输出来控制的,例如文章展示为博客形式还是列表形式,就无法通过 CSS 来调整。以前如果要改变页面的布局,就必须手动修改Joomla! 核心文件的 HTML 代码。这样会引发一个潜在风险:当你网站核心升级时,新的文件可能会覆盖掉旧版本,从而使你的 Hack 结果消失。而 MVC 的出现,使得这个烦恼一去不复返。设计人员再也不需要修改 Joomla! 的核心文件了,也不必担心网站升级会抹杀个性化设计。

我们姑且称 MVC 中的 View 为“视图”,扩展套件在前台呈现各种不同类型数据的方式就是它的视图。但是它的外观表现不止一种,我们称之为不同的“布局”。举例来说,com_content 这个组件控制着文章系统,它能够呈现不同的数据:文章,或者类别,或者单元。前台形式可以是单篇文章展示,可以是多篇文章的标题列表,可以是多篇文章的 Blog 形式排列。这就是说,com_content 组件的视图有多种布局。也就是说,真正在前台展示的是布局。

那么,我们如果要改变前台的 HTML 输出,就只需修改布局。在进行这个操作之前,我们必须记住:一个组件可以有多种视图,每个视图又可以有多种布局。视图包含了一系列固定的信息,而布局可以通过不同的形式来展示这些信息。例如:文章组件(com_content)的“类别”视图包含很多文章,这些文章可以用列表来显示,也可以用表格来显示(可能还有其它形式),这就是说,类别视图既有“列表”这种布局,也有“表格”这种布局。

模块就相对简单多了。模块一般都是以一种方式展示一种信息。因此模块没有视图,它们只有布局。有些模块作者甚至可以在后台参数中为他的模块提供几种布局来供选择。例如:登录模块的“姓名”和“密码”输入框是垂直排列,还是水平排列,这就无法通过 CSS 来实现,只能是不同的“布局”。

模板与布局

接下来还要区分一下“模板”与“布局”的关系。模板主要是为网页设定一个结构框架。在这个框架之内,指定了组件和模块的显示位置。而在这些位置上,具体如何展示信息,是由布局(模块)或者视图与布局的组合(组件)来决定的。

Frontpage Template Positions of Joomla! 1.5
Frontpage Template Positions of Joomla! 1.5

 

上图是 Joomla! 默认模板 rhuk_milkyway 的结构外观(通过访问 http://域名/index.php?tp=1 就能看到这些模块位置)。你可以清楚地看到哪些模块在哪个位置,以及组件在什么位置输出。然而,“实际上”这些位置将来输出什么内容,不是模板决定的,而是由“布局”决定的。

{mospagebreak_scroll title=组件的输出类型及布局的优先性&heading=MVC等几个概念}

组件的输出类型及布局的优先性

要理解布局的优先性,我们先要理解组件的文件结构。尽管一个组件有多个部分,分别负责不同的功能,我们只需要看看 /views 目录下的文件。下面是 com_content 组件视图目录的一部分:

 

/components
     /com_content
         /views
            /articles
                 /tmpl
                      default.php    (这是一个布局)
                      form.php     (这是一个布局)
                   view.html.php (这是输出HTML的视图)
                   view.pdf.php  (这是输出PDF的视图)
          /category
               /tmpl
                      blog.php    (布局)
                      blog_items.php (子布局)
                     default.php (布局)
                  view.html.php (HTML 视图)
                  view.feed.php (RSS feed 视图)

 

在 /views 目录中,每一种视图都有自己的目录。com_content 组件还有另外三个视图我们没有列出来,它们是存档(archive)、首页(frontpage)和单元(section)。

输出类型

继续上面的例子。在 /articles 目录中有很多文件。与 /category 视图目录比较一下,就会发现都有一个共同文件就是 view.html.php。这就是我们所说的视图文件。由于输出类型不同,可以有多个不同的视图文件。这些视图文件的命名规律是:view.output_type.php,这里 output_type 就是输出类型,可以是 html、feed、pdf、raw 或者 error。当我们需要该视图的HTML输出时,就会调用 view.html.php 文件;当我们需要该视图的 RSS 输出时,就会调用 view.feed.php 文件。

如果将全局设置中的SEF启用、同时启用Apache的 mod_rewrite 、启用给URL添加后缀,那么这些不同输出类型的影响就能从 URL 中看出来:

 

http://domain/sports.html
http://domain/sports.feed
http://domain/sports/rowing.html
http://domain/sports/rowing.pdf

你网站上实际的 URL 可能与这些稍有不同,不过我们的重点是想说明:sports.html 结尾的URL 将调用 category 视图的 view.html.php 文件来展示;sports.feed 结尾的URL 将调用 category 视图的 view.feed.php 文件来展示 RSS 供稿内容。提醒一下:目前还不能自定义 feed 和 pdf 输出类型。但是你可以自定义 HTML 输出类型,这正是布局起效的地方。

布局

在每一个视图目录中,都有一个 /tmpl 目录,这里面就是布局文件。这个目录中的每一个 php 文件都代表一种布局。例如, article/tmpl/default.php 就代表文章的默认布局; article/tmpl/form.php 就代表文章的编辑表单布局;category/tmpl/default.php 代表类别的默认布局;category/tmpl/blog.php 代表该类别中的文章以博客形式展示的布局。

当添加新的菜单项目时,就能明显看出组件的视图与布局的关系。还用文章组件来举例,当我们创建新菜单项目时,点击“文章”(其实就是 com_content 组件),就会看到如下的画面。树形分支显示了每一种视图以及该视图的若干布局:

Menu Item Type of Articles

 

你可能注意到了,尽管 /tmpl 目录中还有其它文件,但是没有在这个列表上出现,例如 article 视图的 pagebreak.php 文件。这是因为该布局的 XML 文件(本例中是 pagebreak.xml)中的命令隐藏了该布局(甚至可以是该视图),不在这个列表中出现。关于这种隐藏命令另有教程介绍,此处不赘述。

在理解并掌握了上述知识后,我们现在来实战一下:创建自定义的优先输出的布局。

{mospagebreak_scroll title=创建优先输出的布局文件}

复制或者创建布局文件

布局的优先性只在当前模板有效,而且想要优先输出的布局文件必须位于该模板的 /html 目录中。例如,对于 rhuk_milkyway 模板来说,就位于 /templates/rhuk_milkyway/html/ 目录中;对于 JA Purity 模板来说,就位于 /templates/ja_purity/html/ 目录中;对于 Beez 模板来说,就位于 /templates/beez/html/ 目录中。

(译者注:本文所谓的“优先输出”是指,对于某个符合 MVC 设计结构的组件来说,它已经自带若干布局;如果我们在当前模板中重新设计了该组件的某些布局,则 Joomla! 1.5 会优先使用模板文件夹中定义的布局,忽略组件自带的布局。这就是“优先输出”。)

再次强调:当你为某个模板创建了“优先输出”,该优先性只在这个模板上有效,对其它模板就无效。例如,rhuk_milkyway 模板没有任何组件的优先输出,当你使用此模板时,所看到的前台是各个组件的原样输出(组件作者所设定的);当你使用 Beez 模板时,前台几乎每一个组件的外观都已被该模板中定义的优先输出所控制(模板设计者个性化了);JA Purity 模板介于上述两者之间,只有部分组件被创建了优先输出,而且也只是这些组件的部分视图。

布局优先性的实现要求布局文件必须按照特定的方式来上传。以 Beez 模板为例,我们可以在它目录中看到下面的文件结构:

 

/templates
     /beez
          /html
            /com_content         (此目录与组件目录名称相同)
                 /articles                (此目录与视图目录名称相同)
                      default.php          (此文件与布局文件名称相同)
                      form.php

从这里可以看出组件“优先输出”的文件结构很简单:/模板名称//html/com_组件_名称/视图_名称/布局_文件_名称.php 。我们来看一个例子:

rhuk_milkyway 模板没有任何组件的优先输出,如果我们想要对文章的默认布局进行优先输出设计,就这样做:

首先将 /components/com_content/views/article/tmpl/default.php 这个文件复制到这个模板的目录中(需要创建 html 目录因为原来没有),最后实现 /templates/rhuk_milkyway/html/com_content/article/default.php 这个结构。

如果我们还想要对类别视图的博客布局进行优先输出设计,就需要将 /components/com_content/views/category/tmpl/blog.php 这个文件复制到 /templates/rhuk_milkyway/html/com_content/category/blog.php 这个位置。

在完成了文件复制之后,你就可以按照需求来修改这些文件,以实现你的个性化设计方案。

子布局的优先输出

在某些视图目录中,可以看到某些布局拥有一些文件名前半部分相同的文件。以 category 视图为例,其 blog 布局实际上由三部分组成:一个主布局 blog.php ,两个子布局 blog_item.php 和 blog_links.php。研究一下 blog.php 文件的代码,就能发现它是如何通过 loadTemplate 方法来调用这两种子布局的:

 

echo $this->loadTemplate('item');

 // or

echo $this->loadTemplate('links'); 

 

在加载子布局时,视图已经知道你所处的上层布局是什么,因此无需写全前缀(在本例中,你只需在代码中写 item,而不用写 blog_item)。

我们在这里专门讨论子布局是想说明:当你只想对某个子布局实现优先输出时,无需完全复制那一系列文件。例如,你对 Joomla! 本身的 blog 布局很满意,但是想自定义 item 这个子布局的输出样式,那么就只需复制 /components/com_content/views/category/tmpl/blog_item.php 这个文件到 /templates/rhuk_milkyway/html/com_content/category/blog_item.php 这里即可。当 Joomla! 1.5 处理该视图时,会自动从组件本身的目录(com_content)中读取 blog 布局定义,同时从当前模板的目录中读取 blog_item.php  定义的子布局。

本文基本上是官方文档《理解 Joomla! 1.5 的 模板输出优先性》(作者:Andrew Eddie)的翻译,如果你喜欢看英文原版,可以点击这个链接去阅读。该文档中还提到对模块的布局进行“优先输出”处理的方法,本文未转载。有兴趣的用户可以去看原版。

用优先输出来解决我们的问题

本文开始提到的 szyyw08 在论坛的那个问题,就可以通过对 com_content 组件的 frontpage 视图进行“优先输出”设计来解决。

另外,我还想起来很多人在论坛都寻找一种“中国式风格”的首页布局:新闻按照类别列出标题,头条新闻标题的左侧有缩略图(或者每一个标题左侧都有);在同一个类别中列出指定数量的标题之后,显示“更多……”链接;首页上按分栏排列多个这样的新闻列表模块,或者通过“标签页”的形式组合属于相同大类别的小类别;等等……

这样的问题,同样可以通过自己设计 frontpage 视图来实现。采用“优先输出”的方法,我们可以设计好自己喜欢的视图布局,然后可以上传到任何一个 Joomla! 1.5 网站去实现同样的风格,也不用担心核心升级会影响这种个性化风格。

最后我提醒想要开发 Joomla! 扩展的高手:强烈建议你在开发组件或者模块时遵照MVC 模式来编程。Please respect the rule! 谢谢!

  1. 评论 (13)

  2. Add Yours

评论 (13)

这里还没有人发表评论
  1. blackhole2783

請問這是翻譯的嗎?<br />如果可以,能否附上原文網址,<br />很多名詞的翻譯,都不大明白它原文指的對象是哪一個<br />希望有原文可看

  附件
您无权查看附件
 
  1. blackhole2783    blackhole2783

:-x <br />喔~抱歉~看到第二頁時~就先發言了~<br />原來參考連結發佈在第三頁 XD<br />發了篇廢文~真不好意思~<br />謝謝分享此文

  附件
您无权查看附件
 
  1. fudesheng2008

这篇文章对我这个新手来说太棒,一下子解决了我困惑好久的问题,但是白大哥,我还是不懂的怎么修改里面的代码,比如我想插入一个globenews 模块,如果您能再写篇文章作为补充,那就更完美了。非常感谢。<br />http://www.superha.com

  附件
您无权查看附件
 
  1. yooyooh

这篇文章看了三遍,每次感觉都不一样,现在是都明白了。这才是真正的精品文章,值得newbie们再三体会。

  附件
您无权查看附件
 
  1. eblise

对我来说,真的难以理解........囧!!

  附件
您无权查看附件
 
  1. eblise    eblise

太好了,虽然看的似是而非,但经过自己动手试验,再结合文章解释的方法,我终于把联系人模块给改到居中对齐了,哈哈<br />太好了,谢谢老白,这篇文章真是帮了大忙了

  附件
您无权查看附件
 
  1. Joomla之门    eblise

没有关系,你总有自己能够掌握的那部分知识。其他不能理解的部分交给其他人去处理吧。<br /><br />这个方法其实我也不会操作。但是翻译过来可以供模板设计人员来借鉴——他们当然能看懂。

  附件
您无权查看附件
 
  1. 北北

希望这样的中文教程多写一些,对我们这些新手来说,实在是精华文章啊 :P

  附件
您无权查看附件
 
  1. Joomla之门    北北

感谢你的支持! :-) <br /><br />希望多在论坛回帖帮助新手,这样我就有更多时间撰写更多教程了。

  附件
您无权查看附件
 
  1. webouse

拜读,第二页的显示有些混乱,忘站长调整一下

  附件
您无权查看附件
 
  1. Joomla之门    webouse

感谢提醒!第二页的混乱状况已经修正,原来是粘贴代码时没有处理好。<br /><br />现在好了。 :-)

  附件
您无权查看附件
 
  1. mrnets

修改 Joomla! 1.5 的 HTML 输出的相关资料能否写的再详细些?

  附件
您无权查看附件
 
  1. Joomla之门    mrnets

如果你想自定义前台布局 HTML 输出,那么就要懂一些 HTML 语言 —— Joomla! 就是这样,安装、使用很简单,但是要想“个性化”,就要付出一些。

  附件
您无权查看附件
 

免费下载最新Joomla!核心中文版

扫描此二维码,立即开始下载 Joomla 3 核心中文版

付费下载汉化版扩展

付费后即可下载独家海量

Joomla! CMS 扩展汉化版

了解付费会员制度

点击这里给我发消息

了解 joomlagate.com 网站的付费会员制度