ExtMai首页模版修改说明.doc

ExtMail Template（首页模板修改） 版权声明： 本文版权归作者所有，如其他个人、第三方网站或媒体报刊等需转载全文或节选，为支持我们的工作，请务必注明如下信息： 文档所有者：Extmail Dev Team; 文章原始出处：/docs/Extmail_Template_Intro/ 项目首页： 如果因此而给您带来麻烦，请您原谅，谢谢合作。 变更说明 关于此文 版　　本：1.00 作　　者：Ray raykingecs (at) extmail (dot) org , He zhiqiang hzqbbc (at) extmail (dot) org 项目主页： 最后更新：2008-05-31 本文档主要讲述Extmail的模板原理和Extmail模板的修改方法、语言包对应关系等，最后给出修改实例。编写本文的初衷，是给希望修改Extmail界面元素或编写新的Extmail模板的网管/用户参考，本文采用了部分王鹏辉2007-06-17讲座资料。 本文档假设读者安装EMOS1.3（即Extmail安装目录为：/var/www/extsuite/extmail），并具有一定的Unix平台 / Linux平台系统经验，懂得常规的系统操作，如文件的删除、目录创建、改名和vi编辑器的基本使用以及具有HTML基础知识。 本文档所有内容均在EMOS1.3系统安装、测试通过，其它系统酌情修改对应文件的路径。 本文档由Extmail项目组负责解释，并根据Extmail项目的建设和发展，适时予以更新。如手册与实际项目情况有冲突，以文档服从实际为原则。 文档目录 ExtMail模板系统介绍 ExtMail模板系统组成部分 ExtMail模板变量基础介绍 变量 块（blocks） 循环 包含（Include） HTML页面、Perl程序和语言包对应关系 模板的创建流程 修改实例：ExtMail登陆页面 页面Title Logo 鼠标指向Logo的显示 技术支持和自愿捐助连接 欢迎词 页面底部信息 设定默认域名 修改IP security为默认不选择 欢迎使用 POP3和SMTP设置信息提示 特点介绍 去除免费注册按钮 修改实例：ExtMail首页 退出、关于、帮助链接 页底部信 项目新闻 天气预报 ExtMail模板系统介绍 为了能让不同国家的用户使用系统并且能充分展现使用者的个性化需求，Extmail在设计之初就充分考虑到了语言与界面的切换问题，发展至今已成为一个真正的多语言系统，并且能够方便的支持主题（界面）和多语言界面的更换功能。 ExtMail模板系统是以Perl的HTML::KTemplate模块为核心（HTML::KTemplate是由Kasper Dziurdz先生开发的一款功能强大的HTML代码解析模块，详细信介绍参见/~kasper/HTML-KTemplate-1.33/KTemplate.pm），加上与之配合的多语言系统与模板文件，构成了完整的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/www/extsuite/extmail/html ??? 注：默认HTML模板：/var/www/extsuite/extmail/html/default ? Ext:: Template：??? /var/www/extsuite/extm