基本模版和站点设计
概述
Mambo 模版系统是内容管理系统当中最容易学习的。
模版位于 /templates目录。模版典型的目录结构为:
这是你创建一个模版需要的最少的文件,文件名必须和代码里面的名称保持一致。 注意在 /images目录中没有写出图像的名称,这里一般放置任何的你模版需要的图片, 像背景,banners,等等。让我们大略看一下这些文件。
index.php: 这是模版布局文件。
template_css.css: 模版的 css 样式表。
templateDetails.xml: XML 格式的 metadata 文件。
template_thumbnail.png: 模版的缩略图, 通常大约为 140x90 像素。
布局文件
模版布局文件是一个 PHP 文件,不过大部分是HTML代码,只有少数的PHP代码片段。你不一定精通PHP才能写一个模版文件,你需要的就是能够知道该在哪里引用 Mambo的模版引擎。
模版布局文件主要由 HTML代码组成。在 HTML 框架里面你放入一些可以引用你的网站的数据库的“窗口”。 通常是几个小的“窗口”用来放模块,一个大的“窗口”用来放(类似frontdoor的)组件。
鼓励使用 xHTML 语言来写模版。虽然大家还在争论 xHTML是否是未来的主流,但是它很好的符合 XML 标准, 而HTML 是一个更加宽松的标准。未来 Mambo 的版本将会越来越多的建立在 XML 上,因此现在使用xHTML也许是明智的。
典型的 3栏的布局的index.php 文件一般是:
让我们大略看一下主要的功能。假设你已经知道一点有关 HTML页面制作的知识,像head tags,body tags,tables,等等。
第 1 行: 定义一个有效的 XML 文件。
第 3 行: 避免直接的访问这一个文件,你的模版必须包含这一行。
第 5-6 行: 为页面建立 xHTML 标准。
第 8 行: 配置文件中的站点名称,显示到标题中。
第 9 行: _ISO 是一个特定的常量,用来定义网页的编码方式,它在你的语言文件定义。
第 10-15 行: $my-> id:如果一个用户登录到你的网站,它就是是一个非零的变量。 一个用户登录后,WYSIWYG 编辑器就预先装载。 你可以,如果你愿意, 总是预装载编辑器,但是通常匿名访客不需要添加内容。 这对于你的站点正常浏览在减少了一点代码运行负担。
第 16 行: 插入一些 metadata 区段。
第 17 行: 装载 CSS 样式表。 $mosConfig_live_site 是一个站点绝对网址配置变量。
第 23 行: 在一个表格单元显示站点名字(跨越三栏)。
第 28 行: 载入在 "top" 位置中发布的任何模块。 第二个参数的含义:"-1",不依模板CSS的tablemodule定义,而以模块内部的风格定义显示; "0"或无参数:默认的而已方式(模板CSS) "1", 表示模块是水平排列。
第 33 行: 载入在 " left " 位置中发布的任何模块。 这些模块将会在一栏中显示。
第 36 行: 载入组件到你的模版之内,组件由URL来定,例如 index.php?option=com_content将显示内容组件到这个区域中。
第 39 行: 载入在 "right" 位置中被发布的任何模块,这些模块将会在一栏中显示。
CSS样式表
TODO
XML 配置文件
TODO test
缩略图
当你已经完成你的模版, 通过管理后台中的模版管理来安装它。预览站点,做一个屏幕截图,用你喜欢的图形编辑软件编辑,只保留浏览器中看到的部分。 保持成png格式,大小大概140×90象素,保存到你的模版目录(/templates/basic_template)。
模版进阶
概述
这一个章包括一些高级功能,比方说隐藏模版栏和管理员模版设计。
隐藏模块
有时如果没有指定给某个区域任何模块,我们应该隐藏这一区域。可以用 mosCountModules 功能隐藏某些区域。
如果 mosCountModules 函数返回大于 1 的值,表格单元格将会被显示。对于某些页面,如果" right" 位置没有放置任何模块,那“right”栏将不显示,这是一个很好的技术,可以增加特定页的水平宽度。
使用CSS类后缀
TODO
文件和函数参考
模版开发人员可以使用下列函数。
mosLoadComponents
语法:
装载一个组件,例如 "横幅广告"。
mosCountModules
语法:
计算在 " position_name" 位置中显示模块的个数。
mosLoadModules
语法:
在当前页显示所有指定给 " position_name" 位置的模块。 " style " 参数可以是:
0=( 默认显示) 模块在栏中被显示。 例子如下:
1= 模块水平显示。 每个模块在包装(wrapper)表格的单元格里面显示。例子如下:
-1= 模块原始输出显示,没有标题。 例子如下
-2= 模块以 X- Mambo 的格式显示。 例子如下:
注意,在所有的情形中,可选择的类 " 后缀 " 可以通过模块参数来应用。
mosShowHead
语法:
包含各种不同的header 标签,包括标题标签和一些 meta 标签。
mosMainBody
语法:
显示由URL的option所决定的组件。
后台管理模版
现在管理员模版仍然正在编写。将来的版本中,站点和管理员的模版系统将会合并成同一个API。 然而,下面一些注释作为叁考放在这里。
模块支持
你可以在管理后台模版里面,直接用mosLoadAdminModule载入模块,或在组(group)中, 向网站模版中一样,使用mosLoadAdminModules。举例来说:
mosLoadAdminModule 函数有一个参数, 模块名加上" mod_" 前缀。 例子表格的第一个单元格载入Full Menu模块( 也就是,mod_fullmenu)
在第二个表格单元格里,载入所有的被指定给 " header " 的模块,第二个参数是风格设定:
0= 顺序地显示模块输出
1= 在"Tab " 中显示每个模块
2= 每个模块放在
标签显示
"header" 模块的格式完全由css控制。举例来说," wrapper1" 风格被定义为:
模块放在简单的 div 标签中。为了在某一栏显示模块,你可以增加一个“宽度属性”并将“显示属性”换成 " inline " 。
下列的模块对包含在Mambo发行包里面。
- mod_fullmenu
完整的菜单模块显示传统的 DHTML 后台管理菜单。内容部分和组件动态添加,其他菜单静态地定义。
- mod_components
组件模块显示组件和其子菜单的完整列表。 当安装了许多组件,多于DHTML菜单可以显示的时候,这个就有用了。
- mod_latest
最新模块,显示最近添加内容条目。
- mod_mosmsg
信息模块,显示URL传入的信息。
- mod_online
用户在线模块,显示登录的用户的数目。
- mod_pathway
路径模块,显示管理员所在位置。
- mod_popular
最流行模块,显示最热门的内容条目列表。
- mod_stats
菜单统计模块,显示一些关于菜单使用的统计。
- mod_toolbar
工具栏模块,显示图标工具栏。
- mod_unread
未读信息,显示尚未阅读的私人信息数目。
控制面板
管理后台的控制面板是一个单独的文件, cpanel.php,在模版里面引用。这是一个独立的文件,让你根据不同站点和用户的不同需要,定制个性化屏幕布局配置。
控制面板文件不是必须被引用。 那样的话,控制面板将会只显示任何在 " cpanel" 位置的管理员模块。
cpanel.php 文件可像下列的例子一样的简单: