ExtMail Template 模版修改说明.docx
- 文档编号:18584853
- 上传时间:2023-08-19
- 格式:DOCX
- 页数:18
- 大小:141.55KB
ExtMail Template 模版修改说明.docx
《ExtMail Template 模版修改说明.docx》由会员分享,可在线阅读,更多相关《ExtMail Template 模版修改说明.docx(18页珍藏版)》请在冰点文库上搜索。
ExtMailTemplate模版修改说明
ExtMailTemplateIntro
版权声明:
本文版权归作者所有,如其他个人、第三方网站或媒体报刊等需转载全文或节选,为支持我们的工作,请务必注明如下信息:
∙文档所有者:
ExtmailDevTeam;
∙文章原始出处:
http:
//www.extmail.org/docs/Extmail_Template_Intro/
∙项目首页:
http:
//www.extmail.org
如果因此而给您带来麻烦,请您原谅,谢谢合作。
变更说明
∙
关于此文
∙版 本:
1.00
∙作 者:
Ray
∙项目主页:
http:
//www.extmail.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的显示
技术支持和自愿捐助连接
欢迎词
页面底部信息
设定默认域名
修改IPsecurity为默认不选择
欢迎使用
POP3和SMTP设置信息提示
特点介绍
去除免费注册按钮
∙修改实例:
ExtMail首页
退出、关于、帮助链接
页底部信
项目新闻
天气预报
ExtMail模板系统介绍
为了能让不同国家的用户使用系统并且能充分展现使用者的个性化需求,Extmail在设计之初就充分考虑到了语言与界面的切换问题,发展至今已成为一个真正的多语言系统,并且能够方便的支持主题(界面)和多语言界面的更换功能。
ExtMail模板系统是以Perl的HTML:
:
KTemplate模块为核心(HTML:
:
KTemplate是由KasperDziurdz先生开发的一款功能强大的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:
:
Ext:
:
Lang:
:
Ext:
:
Lang:
:
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:
:
/var/www/extsuite/extmail/lang
Ext:
:
CGI:
/var/www/extsuite/extmail/cgi
ExtMail模板变量基础介绍
变量
模板变量是形如:
<%VARFOO%>的标签,VARFOO如果是大写变量则为程序变量,包含的是由程序输出的内容,小写变量为语言包中的变量,主要用于多语言环境、翻译等。
例:
abook.html中:
此处即为模板变量,因为小写所以是语言包变量。
该变量在zh_CN语言包文件中被赋值为:
meta_title=>'WebMail通讯录';
在en_US语言包中被赋值为:
meta_title=>'PersonalAbook';
由此不同语言环境在abook.html中看到的TITLE有所不同;
块(blocks)
在模板中,还存在大量的诸如IF…ELSE…END这样的逻辑块(blocks),这些块可以实现某些特定需求,比如根据用户不同,显示不同的文字内容,或者循环显示、打印一些内容,如表格或段落等。
每个块以开始,以大家可以发现,块的起始和结束其实就是HTML代码中的注释:
)
Extmail模板中支持的块名目前有:
A. IFELSEEND(条件选择1);
B. BEGINEND(循环);
C. UNLESSEND(条件选择2);
D. IFEND(条件选择3);
条件选择1
--IFVARFOO-->
如果VARFOO为真,则显示这段文字
--ELSEVARFOO-->
VARFOO为假,显示这段文字
--ENDVARFOO-->
在程序中,VARFOO这个变量如果为真,则显示蓝色的内容,否则显示红色的内容。
条件选择2
--UNLESSVARFOO-->
只有VARFOO为假才显示这段内容
--ENDVARFOO-->
在程序中,VARFOO这个模板变量只有为假时,才显示上面块之间的内容。
条件选择3
--IFVARFOO-->
如果VARFOO为真则显示这段内容
--ENDVARFOO-->
在程序中,模板变量VARFOO如果为真,就显示上面这段文字内容
循环
--BEGINLOOPVAR-->
这个是循环<%COUNT%>
--ENDLOOPVAR-->
循环是一个特殊的块,它能循环显示内容,并且每次循环内还可以嵌套变量。
如上面的例子中,如果程序在循环时改变COUNT的内容,则可以看到诸如:
这个是循环1
这个是循环2
这个是循环3
这样的内容。
在目前系统模板里,大量使用了循环,以显示如:
邮箱列表,邮件列表,帐户列表等可变的信息。
建议:
对于不熟悉这些块(blocks)的用户,不要随便修改块逻辑,而仅仅修改HTML或普通变量(这种形式)。
并且修改时还应该保留一份能用的backup。
包含(Include)
模板引擎还支持包含特性,即通过INCLUDE指令,将另一个模板包含进来,合成一个大模板。
在建立页面时,会有一些部分每个页面都需要的,比如说邮箱列表,或者导航条等,利用这个特性,可以将公共部分放到一个小模板里,然后在其他模板里INCLUDE就可以了。
语法:
--INCLUDE‘other.tpl’-->
例:
在模板中的
--INCLUDE‘TOP_BAN.html’-->就是包含了顶部的导航条。
HTML页面、Perl程序和语言包对应关系
模板HTML文件、Ext:
:
Lang和Ext:
:
Lang:
:
:
Lang,%*为Ext:
:
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
Login.pm=>%lang_login => 登陆页面
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等等文件
启用新模板
修改webmail.cf
SYSUSERTEMPLATE=mytemplate
修改实例:
ExtMail登陆页面
创建和修改ExtMail模板在技术上是一体的,但是如果不会修改模板,创建就无从谈起。
下面我们通过修改ExtMail的登陆页和首页来说明如何修改。
注:
本例中以修改简体中文语言为主,如果您使用的是改其他语言,请修改相应文件;
本例均以ExtMail为说明,ExtMan的结构和修改大同小异,请自行对照修改;
1. 页面Title
修改文件:
/var/www/extsuite/extmail/lang/zh_CN
修改位置:
%lang_login=(
meta_title=>'欢迎使用ExtMail',
2. Logo
修改文件:
/var/www/extsuite/extmail/html/default/images/logo.gif
修改内容:
替换成需要的Logo图片文件
注意:
替换图片之后需要重新设置权限。
Root:
读取,root:
只读,只读。
3. 鼠标指向Logo的显示
修改文件:
/var/www/extsuite/extmail/html/default/index.html
修改位置:
//www.extmail.org/"target=_blank> 4. 技术支持和自愿捐助连接 修改文件: /var/www/extsuite/extmail/html/default/index.html 修改位置: //www.extmail.org/support/<%LANG%>/index.html"target="_blank"><%support_link%>| middle"src="/extmail/images/donate.png"> //www.extmail.org/donate/"target="_blank"> #5678A6"><%donate%>
5. 欢迎词e
修改文件:
/var/www/extsuite/extmail/lang/zh_CN
修改位置:
%lang_login=(
wsplash=>'快速可靠,高性能I/O
开源MAIL开足马力迈进中...',
6. 页面底部信息
修改文件:
/var/www/extsuite/extmail/html/default/index.html
修改位置:
bold;color: #000"><%VERSION%>©2004-2006ExtMail.OrgRuntime: <%TIME%>
7. 设定默认域名
修改文件:
/var/www/extsuite/extmail/html/default/index.html
修改位置:
修改结果:
8. 修改IPsecurity为默认不选择
修改文件:
/var/www/extsuite/extmail/lang/zh_CN
修改位置:
修改结果:
9. 欢迎使用
修改文件:
/var/www/extsuite/extmail/lang/zh_CN
修改位置:
%lang_login=(
welcome_index=>'欢迎使用ExtMail!
',
10. POP3和SMTP设置信息提示
修改文件:
/var/www/extsuite/extmail/html/default/index.html
修改位置:
POP3:
SMTP:
11. 特点介绍
修改文件:
/var/www/extsuite/extmail/lang/zh_CN
修改位置:
%lang_login=(
intro2=>'快速而可靠
引入索引缓存(Cache)技术和高效核心,WebMail操作疾步如飞',
intro3=>'多语言同屏读写
全面支持UTF8,实现同屏读写多国语言,真正做到国际邮、无乱码',
intro4=>'真正模板化设计
MVC设计+高速模板引擎,实现了内容数据完全分离,轻松修改模板',
intro5=>'高性能I/O
;轻松应付>1GB邮箱/200M附件,远强于流行的各式phpwebmail',
12. 去除免费注册按钮
修改文件:
/var/www/extsuite/extmail/webmail.cf
修改位置:
SYS_SHOW_SIGNUP=1
修改结果:
SYS_SHOW_SIGNUP=0
修改实例:
ExtMail首页
1. 退出、关于、帮助链接
修改文件:
/var/www/extsuite/extmail/html/default/TOP_BAN.html
修改位置:
__mode=logout&sid=<%SID%>"><%logout%>| //www.extmail.org/support/<%LANG%>/about.html"><%about%>| //www.extmail.org/support/<%LANG%>/help.html"><%help%> 2. 页底部信息 修改文件: /var/www/extsuite/extmail/html/default/BOTTOM.html 修改位置: <%TIME%> <%extmail_whatis%> 3. 项目新闻 修改文件: /var/www/extsuite/extmail/html/default/welcome.html 修改位置: 5px;padding-right: 5px"> 4. 天气预报 修改文件: /var/www/extsuite/extmail/html/default/welcome.html 修改位置: --INCLUDE'../plugins/weather.html'--> 修改实例: ExtMan后台界面 1. 页面Title 修改文件: /var/www/extsuite/extman/lang/zh_CN 修改位置: %lang_login=( meta_title=>'欢迎使用ExtMail', 2. Logo 修改文件: /var/www/extsuite/extman/html/default/images/logo.gif 修改内容: 替换成需要的Logo图片文件 注意: 替换图片之后需要重新设置权限。 Root: 读取,root: 只读,只读。 3. 欢迎使用 修改文件: /var/www/extsuite/extman/lang/zh_CN 修改位置: %lang_login=( welcome_index=>'欢迎使用ITOKIWebMail管理后台', 4. 去除用户名显示 修改文件: /var/www/extsuite/extman/html/default/index.html 修改位置: 修改为: 5. 去除效验码 修改文件: /var/www/extsuite/extman/webman.cf 修改位置: SYS_CAPTCHA_ON=1 将此行添加#号注释即可 6.登录按钮下方信息修改 修改文件: /var/www/extsuite/extman/html/default/index.html 修改位置: 5px;padding-right;0px;font-size: 10px"> Powerby<%VERSION%> 修改为: 5px;padding-right;0px;font-size: 10px"> PowerbyMinYouWebMail 7. 去除邮件用户辅助功能 修改文件1: /var/www/extsuite/extman/lang/zh_CN 修改位置1: hint_aux=>'邮件用户辅助工具', hint_aux_forgetpwd=>'忘记密码? ', hint_aux_changepwd=>'修改密码', 将此3行删除 修改文件2: /var/www/extsuite/extman/html/default/index.html 修改位置2: 10px"> 如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。<%hint_aux%>