ExtMai首页模版修改说明.doc

ExtMai首页模版修改说明

ExtMai首页模版修改说明

PAGE/NUMPAGESPAGE1/NUMPAGES3

ExtMai首页模版修改说明

ExtMailTemplate（首页模板修改）

版权声明：

本文版权归作者所有，如其他个人、第三方网站或媒体报刊等需转载全文或节选，为支持我们的工作，请务必注明如下信息：

文档所有者：ExtmailDevTeam;

文章原始出处：

项目首页：

如果因此而给您带来麻烦，请您原谅，谢谢合作。

变更说明

关于此文

版本：1.00

作者：Rayraykingecs(at)extmail(dot)org,Hezhiqianghzqbbc(at)extmail(dot)org

项目主页：

最后更新：2008-05-31

本文档主要讲述Extmail的模板原理和Extmail模板的修改方法、语言包对应关系等，最后给出修改实例。编写本文的初衷，是给希望修改Extmail界面元素或编写新的Extmail模板的网管/用户参考，本文采用了部分王鹏辉2007-06-17讲座资料。

本文档假设读者安装EMOS1.3（即Extmail安装目录为：/var/），并具有一定的Unix平台/Linux平台系统经验，懂得常规的系统操作，如文件的删除、目录创建、改名和vi编辑器的基本使用以及具有HTML基础知识。

本文档所有内容均在EMOS1.3系统安装、测试通过，其它系统酌情修改对应文件的路径。

本文档由Extmail项目组负责解释，并根据Extmail项目的建设和发展，适时予以更新。如手册及实际项目情况有冲突，以文档服从实际为原则。

文档目录

ExtMail模板系统介绍

ExtMail模板系统组成部分

ExtMail模板变量基础介绍

变量

块（blocks）

循环

包含（Include）

HTML页面、Perl程序和语言包对应关系

模板的创建流程

修改实例：ExtMail登陆页面

页面Title

Logo

鼠标指向Logo的显示

技术支持和自愿捐助连接

欢迎词

页面底部信息

设定默认域名

修改IPsecurity为默认不选择

欢迎使用

POP3和SMTP设置信息提示

特点介绍

去除免费注册按钮

修改实例：ExtMail首页

退出、关于、帮助链接

页底部信

项目新闻

天气预报

ExtMail模板系统介绍

为了能让不同国家的用户使用系统并且能充分展现使用者的个性化需求，Extmail在设计之初就充分考虑到了语言及界面的切换问题，发展至今已成为一个真正的多语言系统，并且能够方便的支持主题（界面）和多语言界面的更换功能。

ExtMail模板系统是以Perl的HTML::KTemplate模块为核心（HTML::KTemplate是由KasperDziurdz先生开发的一款功能强大的HTML代码解析模块，详细信介绍参见），加上及之配合的多语言系统及模板文件，构成了完整的ExtMail模板系统。

此结构设计大大简化了模板开发的难度和压力，您无需掌握Perl、无需拥有太多的编程经验，只需依照现有的编码规则编制模板文件，就可以做出自己的个性化界面。

页面生成示意图

模板驱动流程

模板的驱动在业务层开始，当一个页面得到请求的时候，业务层通过数据层取得产生页面所需要的数据，然后从多语言系统中取得相应语言的翻译，加上此页面上相应的逻辑，所有信息通过Ext::Template及HTML::KTemplate传递给模板文件统一替换执行，生成最终可见的页面。

ExtMail模板系统组成部分

?Ext::Template

???Ext::Template模块提供了HTML::KTemplate的ExtMail接口，并且定义了HTML::KTemplate在ExtMail中的Options；

?Ext::Lang

???Ext::Lang是ExtMail的语言模块，作为多语言处理的接口，负责加载语言文件（Ext::Lang::LANG）模块，并且提供一些方法和变量。

?Ext::Lang::LANG

???Ext::Lang::LANG为ExtMail多语言翻译文件包，以Hash表结构存储，定义了语言、编码、翻译字段等；

?Html目录

???模板的HTML文件

?Ext::CGI

模块相应存放位置

?模板HTML文件：

???/var/

???注：默认HTML模板：/var/

?Ext::Template：

???/var/

?Ext::Lang

???/var/

?Ext: