ExtMai首页模版修改说明.docx

ExtMailTemplate（首页模板修改）本文版权归作着全部，如其他个人、第三方网站或媒体报刊等需转拿全文或节选，为支持我们的工作，请务必注明如下信息： 文档全部齐：EXtBailDevTeam： 文章原始出处： 项目首页：假如因此而给您带来麻烦，请您宽恕，感谢合作。变更说明关于此文 版本：1.00 作者：Ray<raykingecs(at)extmail(dot)org>,Hezhiqiang<hzqbbc(at)CXtmail(dot)or> 项目主页： 最终更新：2008-05-31本文档主要讲解并描述Extmai1的模板原理和Extmail模板的修改方法、语有包对应关系等.最终给出修改实例.编写本文的初史，是给希望修改EXt三ail界面元素或编写新的EXtmaiI模板的网管/用户参考，本文采纳了部分王昭蟀2007-06-17讲座资料。本文档假设读者安装EJ(OSl.3(即EXtmail安装书目为:var>.并具有件定的UniX平台/1.inux平台系统阅历，懂得常规的系统操作，如文件的刷除,书目创建、改名和Vi编辑潺的基本运用以及具有HW1.基础学问.本文档全部内容均在EYOSl.3系统安装、刑试通过，其它系统的情修改对应文件的路径，本文档由EXtmail项目组负贵说明,并依据EXtmail项目的建设和发展,适时予以更新.如手册及实际项目状况有冲突.以文档听从实际为原则.文档书目 EXtMaiI极板系统介绍 EXtMail模板系块组成部分 EXIMail模板变景基础介绍变一块（MoCkS）循环包含（Include HTM1.页面、Perl狎序和语言包对应关系模板的创建涌火 修改实例：EXtYail登陆页面页面TitIe1.ogO以标指向IQK。的U东，术支持和H般捐助连接欢迎词页面底部伯息设定一城名修改IPSeCUritv为默认不选择欢迎运用FW3和SMTP设附信息提示特点介绍去除免费注明按钮 改实例：ExtXail首页退舟.关于、将助链接页底部信项目新闻天气一报Extlfail模板系统介绍为了能让不同国家的用户运用系统并且能充分呆现运用者的特性化需求，Extmuil在设计之初就充分考虑到了诺言及界面的切换问题,发展至今已成为一个真正的多谙音系统.并且能膨便利的支持主阳（界面）和多语吉界面的更换功能.ExtYail模板系统是以Perl的HTM1.:KTemPIate模块为核心（HTM1.:KTeInPItIte是由KasperDZiUrdZ先生开发的一款功能强大的HTM1.代码解析模块,具体信介绍参见），加上及之协作的多语言系统及模板文件，构成了完整的EXIMail模板系统，此结构设计大大简化了模板开发的册度和压力，您无需驾驭Perl、无需拥有太多的编程阅历，只需依照现有的涮码规则编制模板文件，就可以做出自1.i的特性化界面.页面生成示意图故据处理模板侪息流程网复模板信息流程模板况动海程模板的兴动在业务层起先,当个页面褥到总求的时候，业务层通过数据层取得产生页面所须要的数据，然后从多语言系统中取得相应语言的翔译，加上此页面上相应的逻辑，全部信息通过ExlKTcmplaic及HTM1.nKTcniplatc传递给模板文件统一替换执行，生成最终可见的页面.ExtMail模板系统组成部分 ExliTcmplalcExt:TeIlPIat。模块供应/HTM1.:KTeInPIate的EXtMilil接口并且定义了HTMIz:KTemplateEExtMai1中的Options： Ext:1.angExt:1.ang是EXtNHil的诏右模块，作为多语古处理的接11,负通加教语言文件(Ext:1.ang:<1.ANG>>模块，并且供应一些方法和变量。 Ext:l.ang:<1.NG>Ext:1.ang:<1.ANG>为EXtMniI多语言IH洋文件包，以HHSh在结构存储,定义了语言、编码、翻译字段等； Html书目模板的HTV1.文件 Ext:CGl模块相应存放位 模板HTM1.文件：var注：默认HTV1.模板：八ar Ext:Template：var Ext:l.angvar Ext:l.ang:<I.ANG>var Ext:CGhvarExtlfail模板变量基础介绍如模板变修是形如:rARFOO的标签，VARFOO假如是大写变业则为程序变依，包含的是由程序输出的内容，小写变限为语言包中的变量，主要用于多语言环境、翻洋等。例：abookhtml«|'：<TITl.EX%meta_title><TIT1.E>此处即为模板受此，因为小写所以是语言包变用。该变量在ZhCN语言包文件中被赋值为:BClajilIe=>'IebMail通讯录'：在en_US谱才包中被赋值为:metatitle=>'Personalbook'：由此不问语古环境在abook.ht.l中看到的TIT1.E有所不同：块（blocks）在模板中，还存在大价的诸如IF-E1.SE-END这样的逻辑块（blocks）,这些块可以SEfii特定簿求,比如依据用户不同，显示不同的文字内容，或者循环显示、打卬此内容如表格或段落等.每个块以起先,以大家可以发觉,块的起始和结束其实就是ImI1.代码中的注择：）Ext三al模板中支持的块名目前侪A. IFE1.SEEND-I(条件选择1);B. BEGINEND(循环)；-C. UN1.ESSEND(条件选择2；rrD.IFEND(条件选择3);<!IFVARFO()>假如VARFoo为真，则显示这段文字<!E1.SEVARIOO->VARFOo为假，显示这段文字<!ENDVARF(X)>在程序中，VARFOO这个变呆假如为我，则显示蓝色的内容，否则显示红色的内容，条件选界2<!UN1.ESSVRFOO>只有VARFOO为假才显示这段内容<!ENDVARFOO>在程序中，VARFOo这个模板变量只有为假时，才显示上面块之间的内容。条件选界3<!IFVARFOO>假如VARFOO为真则显示这段内容<!ENDVARF(X)>在程序中，模板变埴VARFoo假如为真,就显示上面这段文字内容循环<!BEGIN1.00PVAR>这个是循环GCOUNT%><!_END1.OOPVAR">循环是一个特别的块，它能循环显示内容，并且斑次循环内还可以战食变量，如上面的例子中.假如程序在循环时变更CoUNT的内容.则可以存到诸如：这个是循环1这个是循环2这个是循环3这样的内容。在目前系统模板里，大出运用了循环，以显示如：邮箱列表，邮件列表，帐户列表等可变的信息，建由对于不熟识这些块(blocks)的用户，不要随就修改块逻辑，而仅仅每改InM1.或一般变质(这种形式。并且修通时还应当保用一份能用的backup,包含(Include)模板引繁还支持包含特性,即通过IN：UJDE指令，将另一个模板包含进来,合成一个大模板.在建立页面时，会有一些部分班个页面都须要的，比如说邮箱列表，或者导航条等，利用这个特性，Ur以将公共部分放到一个小模板里，然后在其他模板里INC1.UDE就可以了。语法：<!INC1.UDE,other,tpl'>例：在模板中的!一INCwDE'T0P_BAN.html,->就是包含了顶部的导航条.HTK1.页面、Perl程序和语言包对应关系模板InM1.文件、Ext:1.ang和Ext:1.ang3<1.ANG>之间的对应关系如下(其中Hhlml为模板HTM1.文件，.pm为Ext:1.angFolders,po=>%lang_foldersPref,m=>%lang_prcfCompose,pm->%langcomposeFilter,pm=>%lang_fi1ter白名单、黑名单GlobalAbook,Piii=>%larlobalabkNetDisk.pm->%lang_netdiskMessage.p(n=>%langreadmsg%*为Ext:1.ang:X1.ANGR具体书目参见:模块相应存放位置)：l.ogin.pmAl>ok.paFolders,pPref.pn index,html abk.html=>- folders.ht«l=>-) pref,html=>-> compose.ht三l->"o<11pose.Pn fiIter,html=>-11FiIter,pa globabook.htl=>-lol>alAbook.Pm netdisk.ht三l readmsg.htnl welcome,ht三l=>rNetDisk.pm=>-Uessage.pm=>Folders,pm1.ogin,p<11->%lang-login->"登陆或面AbOOk.p<n=>%lang_alx)ok=>"通讯录一个人地址本首页、收件箱偏好设置-常规设置、POP3取信帐号写掘件偏好设置-过港涔谀置、自动网及设置、=>”通讯录-全局地址本网络磁盘该邮件 APP.pm=>-»%lang_gIobal模板的创建流程 书目结构三ExtMail根书目的ht三l文件夹下创建自己的模板支件夹InyteInPIaS 必要文件依据default模板的文件书目结构创建出相应的模板文件起先创建攫写html/JS/CSS等等文件启用新模板修改wcbnal.cfSVSUSERTEMP1.ATE=myte11plate修改实例IEXtMaiI登陆页面创建和修改EXtMaiI模板在技术上是一体的，但是假如不会修改模板,创建就无从谈起，T面我们通过修改ExtHail的登砧页和首页来说明如何修改，注：r本例中以蟋改简体中文语言为主,假如您运用的是改其他语音，请修改相应文件：r本例均以EXtMail为说明,EXtMan的结构和修改大同小异,请自行比照修改:页面Title3欢迎使用EXtMailMicrosoftInternetExplorer悻改文件：var强改位置：TlaneJogin=（eta-title=>'欢迎运用EXnlai】',2. 1.ogQ修改文件：var修改内容：背换成须要的1.ogo图片文件留意：替换图片之后须要重新设置权限.Koot5读取，root：只读.只读.3. 双标指向1.or。的显示修改文件:Zvar/修改位固.：<DIVclass=lg><href=""targeI=J）IankxlMGaIt=ExtMai1>4. 技术支持和自愿捐助连接技术支持|叫自岳拓1助修改文件：Zvar/修改位置：<divclass=donate><ahref="<%1.ANG%>index.ht三l,target=*blank"><b><%spport-link><b><a><igstyle=*verticl-alin:middle"src*/extmai1/i三