Modoer2.0_模板制作手册

Modoer2.0 模板制作手册惠生活优惠券网（）2010年7月18日制模板结构Modoer模板分为主站模板，主题模板，空间模板，助手模板和后台模板其中，助手模板和后台模板为分布式存放，每个模块都有自己的模块内，助手模板存放在core/modules/[moduleflag]/assistant/templates，后台模板存放在core/modules/[moduleflag]/admin/templates，助手模板使用了模板引擎，可以使用模板标签。

而后台模板则没有只用模板引擎，需要直接进行php语法操作。

主站模板：templates/main主题模板：templates/item空间模板：templates/space测试版首先提供主站模板的设计：主站模板文件夹下面，每一套模板为1个文件夹，不能直接将文件放在templates/main下面。

模板文件由【模块_文件名】组成，例如：modoer_index，表示modoer框架的首页。

主站模板的组成一般为：头部文件+主题文件+尾部文件，头部文件为：modoer_header，尾部文件为：modoer_footer。

首页的组成为：modoer_header+modoer_index+modoer_footer ，每个主体文件同时可能有多个子模板组成，子模板的名称一般为：模块_文件名_part_*模板的CSS组成：主站的CSS分类：公共CSS，首页CSS和模块CSS。

公共CSS：负责显示统一的图标，样式等，例如点评的星星。

公共CSS是为了在各个不同的。

板CSS的样式名称为：css_common.css首页CSS：负责首页单独的风格，名称为css_index.css，所有首页单独使用的css都存放在这里模块CSS：每个模块内独立需要用到的布局CSS，当用户访问某个模块的页面时，则会自动加载这个模块的CSS，模板CSS的样式名称为：css_模块标识.css全局变量全局变量表示通不用过任何的标签和函数，可在程序任意页面使用的变量。

{URLROOT}：表示URL的相对路径，如果是一级域名或者2及域名，此变量的值为空，如果是二级目录，例如/modoer，则此变量的值为/modoer，在使用path_info的URL改写时尤为重要。

{SCRIPTNAV}：表示当前页的标记，配合菜单的tab当前页高亮显示，SCRIPTNAV对应的值介绍∙index：首页∙article：新闻模块∙item-x：表示主题列表页，x是一个catid，即主分类的id∙coupon：优惠券模块∙exchange：积分兑换模块∙member：助手模块$_G：包含了程序需要用到的所有配置信息和逻辑信息，这里简单说一下前台需要用到的信息∙$_G[charset]：表示当前系统编码，有gb2312和utf-8∙$_G[tplurl]：系统当前使用的主站目录路劲，例如templates/main/default/，配合{URLROOT}使用，例如载入css（例如：{URLROOT}/{$_G[tplurl]}css_inex.css）∙$_G[ip]：表示访问用户的ip地址∙$_G[timestamp]：表示系统时间的unix时间戳，配合模板标签date使用$_CFG：这是一个关于Modoer核心设置的全部数组，里面存放了网站名称，网址等信息∙$_CFG[siteurl]：网址地址∙$_CFG[sitename]：网站名称∙$_CFG[icpno]：备案号∙$_CFG[subname]：网站副标题∙$_CFG[meta_keywords]：系统网页keywords∙$_CFG[meta_description]：系统网页description∙$_CFG[titlesplit]：系统分隔符∙$_CFG[main_menuid]：头部菜单组id∙$_CFG[foot_menuid]：底部菜单组id$_HEAD：这个变量是存储关于网页的标题(title)，关键字和描述∙$_HEAD[title]：当前网页的标题∙$_HEAD[keywords]：当前网页的关键字∙$_HEAD[description]：当前网页的description$_C：这是Modoer相关的COOKIE数组，一般模板设计不会使用到$user：这是一个php形式的类，存储了当前登录会员的信息∙$user->isLogin 这是一个布尔型值，表示是否已经登录，可配置if标签使用∙$user->uid 表示当前登录用户的uid，没有登录时，为0∙$user->username 当前登录用户的用户名，未登录是为空∙$user->email 会员的电子邮件∙$user->groupid 当前登录的用户会员组id∙$user->point 会员积分∙$user->coin 会员金币∙$user->reviews 会员点评数量∙$user->subjects 添加主题数量∙$user->pictures 上传图片数量∙$user->flowers 收到的鲜花数判断标签：ifif是模板标签中最常用的，也是最重要的标签之一，他的作用是在页面中判断显示数据，例如：∙ <!--{if $i=='a'}-->∙ i的值是a∙ <!--{/if}-->从上面这段代码可以看到if是对等标签，已<!--{if $i=='a'}-->开始，<!--{/if}-->结束。

中间部分就是判断条件成立时，在页面中显示的内容。

if总共有三种方式组成，第一种已经在上面演示，第二种是两者选其一的方式，例如：∙ <!--{if $i=='a'}-->∙ i的值是a∙ <!--{else}-->∙ i的值不是a∙ <!--{/if}-->两者选其一就是，2条判断，必须显示一条。

例如我们在modoer模板中判断用户是否登录：∙ <!--{if $user->isLogin}-->∙欢迎你回来，$user->username∙ <!--{else}-->∙请先登录。

∙ <!--{/if}-->第三种则是，多条中选择一条，例如：∙ <!--{if $i=='a'}-->∙ i的值是a∙ <!--{elseif $i=='b'}-->∙ i的值是b∙ <!--{elseif $i=='c'}-->∙ i的值是b∙ <!--{else}-->∙ i的值我也不能确定∙ <!--{/if}-->从上到下，一个个对$i进行判断，如果一旦有符合的，就结束本次条件判断，如果都没有，则在最后显示“i 的值我也不能确定”。

循环标签：loop在设计模板时，循环显示数组里的内容，以达到在页面显示信息列表时，我们就会用到loop标签。

下面说一下loop的标准用法：例如一个数组，他的名称是$list，在这个数组变量中，存放了5条数组，格式如下：接着我们要在模板里以列表的方式显示这些数据，打开页面执行后，查看HTML代码会变成：可以看到<ul>和</ul>标签是在循环体外面的，整个循环是对<li>$val</li>的5次循环。

在循环以<!--{loop $list $val}-->开始，<!--{/loop}-->结束，其中$list 就是要进行循环数组，$val 则是每次循环时赋予的单条数据值。

上面是最简单的一维数组的循环并显示，下面做一个2维数组的用法：接着，我们还是同样的显示打开页面执行后，查看HTML代码会变成：上面的代码基本和前者是一致的，唯一不同的是$val 变量的用法，这是因为我们使用了二维数组，即二维数组是有5个一维数组组成的，当loop标签开始循环时，每次$val 赋值的是一个一维数组，我们在使用一维数组时，没有用循环的方式来读取，这时我们可以根据数组的下标需要来读取数组中的单条内容，php的数组下标需要都是从0 开始的，所以我们要获得数组的第一条数据时，就是$val[0]，同样第2条就是$val[1]。

上面说到我们的默认数组下标，都是数字0开始的，但是实际操作中，我们一般都是对键名（下标）赋值的，例如下面的二维维数组这时，我们的键名（下标）不再是默认的数字序号，而是手动赋值的，在modoer中是从数据库读取的基本就是这种形式。

我们把她模板实现时，我们就不能用数字下标了而是用键名：假如我们要在列表前加上序号，如：我们有2种方法来实现，第一种，我们利用数组的序号来实现，例如：在loop 标记中，中间多了$index ，这个$index 就是我们数组的下标序号，因为默认从0开始，所以我们在使用时，需要手动计算+1，当然要使用print标签，如果不使用，模板标记是无法识别这是一个计算表达式，从而无法进行+1操作。

这个方法仅限于我们的下标都是默认的没有赋值，如果我们对这个数组一开始就加了键名的话，就不能使用这个方法了，例如：在上面这个情况下，我们就要用eval 标签来实现，eval 标签就是执行php 代码，代码如下从上面的代码看到，我们在循环体外面加上一句代码<!--{eval $index=1;}-->，这句代码的意思就是我初始化一个数字类型的变量，赋值为1，同时我们又在loop结束标记前加上& lt;!--{eval $index++;}-->，这句就是对$index 变量进行一次+1操作。

这样我们在loop 进行一次循环后$index 就会自动+1，从而实现了序号显示的效果。

最后我们还需要一种效果，就是对获取的数据，并非全部都显示出来，假如我们只要前面的2条数据，循环体该怎么写？看下面的代码，我们还是用下标的方法，当然也可以用第二种不使用下标序号的方法。

这段代码中，我们只加入了一句代码<!--{eval if($index>1) break;}-->，代码的意思就是假如$index 大于1时，就跳出循环体。

要记住$index起始只是0，所以当他大于1时，就是已经经历了2次循环，我们就要跳出循环，break 表示跳出循环。

有时候，我们不需要头2条，而是要从第3条开始显示，代码就应该是这样：这段代码中，我们也修改了一句代码<!--{eval if($index<2) continue;}-->，代码的意思就是假如$index 小于2，就中断本次循环，进入下一次循环，continue 表示中断本次循环，进入下一次循环，这样我们就跳过了前面2次循环，从第3条开始显示。