ExtMail Template Intro

ExtMail模板系统是以Perl的HTML::KTemplate模块为核心（HTML::KTemplate是由Kasper Dziurdz先生开发的一款功能强大的HTML代码解析模块，详细信介绍参见http://search.cpan.org/~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/extmail/libs/Ext

Ext::Lang
/var/www/extsuite/extmail/libs/Ext/App

Ext::Lang::<LANG>
/var/www/extsuite/extmail/lang

Ext:: CGI：
/var/www/extsuite/extmail/cgi

ExtMail模板变量基础介绍

变量
模板变量是形如:<%VARFOO%>的标签，VARFOO如果是大写变量则为程序变量，包含的是由程序输出的内容，小写变量为语言包中的变量，主要用于多语言环境、翻译等。

块（blocks）

在模板中，还存在大量的诸如IF … ELSE … END 这样的逻辑块（blocks），这些块可以实现某些特定需求，比如根据用户不同，显示不同的文字内容，或者循环显示、打印一些内容，如表格或段落等。每个块以开始，以大家可以发现，块的起始和结束其实就是HTML代码中的注释:)

Extmail模板中支持的块名目前有：

 A. IF ELSE END （条件选择1）;

 B. BEGIN END （循环）;

 C. UNLESS END （条件选择2）;

 D. IF END （条件选择3）;

条件选择1

<!-- IF VARFOO -->
如果VARFOO为真，则显示这段文字
<!-- ELSE VARFOO -->
VARFOO为假，显示这段文字
<!-- END VARFOO -->

在程序中，VARFOO这个变量如果为真，则显示蓝色的内容，否则显示红色的内容。

条件选择2

<!-- UNLESS VARFOO -->
只有VARFOO为假才显示这段内容
<!-- END VARFOO -->

在程序中，VARFOO这个模板变量只有为假时，才显示上面块之间的内容。

条件选择3

<!-- IF VARFOO -->
如果VARFOO为真则显示这段内容
<!-- END VARFOO -->

在程序中，模板变量VARFOO如果为真，就显示上面这段文字内容

循环

<!-- BEGIN LOOPVAR -->
这个是循环<%COUNT%>
<!-- END LOOPVAR -->

循环是一个特殊的块，它能循环显示内容，并且每次循环内还可以嵌套变量。如上面的例子中，如果程序在循环时改变COUNT的内容，则可以看到诸如：

这个是循环1
这个是循环2
这个是循环3

这样的内容。在目前系统模板里，大量使用了循环，以显示如：邮箱列表，邮件列表，帐户列表等可变的信息。

建议：

包含（Include）
模板引擎还支持包含特性，即通过INCLUDE指令，将另一个模板包含进来，合成一个大模板。在建立页面时，会有一些部分每个页面都需要的，比如说邮箱列表，或者导航条等，利用这个特性，可以将公共部分放到一个小模板里，然后在其他模板里INCLUDE就可以了。

语法：

例: 在模板中的 就是包含了顶部的导航条。

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

模板HTML文件、Ext::Lang和Ext::Lang::<LANG>之间的对应关系如下（其中*.html为模板HTML文件，*.pm为Ext::Lang，%*为Ext::Lang::<LANG>具体目录参见：模块相应存放位置）： 

index.html => Login.pm

abook.html => Abook.pm 

folders.html=> Folders.pm 

pref.html => Pref.pm 

compose.html=>Compose.pm 

filter.html => Filter.pm 

globabook.html=>GlobalAbook.pm 

netdisk.html => NetDisk.pm 

readmsg.html => Message.pm 

welcome.html => Folders.pm



Abook.pm => %lang_abook => 通讯录—个人地址本 

Folders.pm => %lang_folders => 首页、收件箱 

Pref.pm => %lang_pref => 偏好设置-常规设置、POP3取信帐号 

Compose.pm => %lang_compose => 写邮件 

Filter.pm => %lang_filter => 偏好设置-过滤器设置、自动回复设置、白名单、黑名单 

GlobalAbook.pm => %lang_globalabook => 通讯录-全局地址本 

NetDisk.pm => %lang_netdisk => 网络磁盘 

Message.pm => %lang_readmsg => 读邮件 

App.pm =>%lang_global 

模板的创建流程

目录结构

在ExtMail根目录的html文件夹下创建自己的模板文件夹mytemplate

必要文件

按照default模板的文件目录结构创建出相应的模板文件

开始创建

撰写html/JS/CSS等等文件

启用新模板

修改实例：ExtMail登陆页面

创建和修改ExtMail模板在技术上是一体的，但是如果不会修改模板，创建就无从谈起。下面我们通过修改ExtMail的登陆页和首页来说明如何修改。
注：
 本例中以修改简体中文语言为主，如果您使用的是改其他语言，请修改相应文件；
 本例均以ExtMail为说明，ExtMan的结构和修改大同小异，请自行对照修改；

1. 页面Title