Yezi.CMS 标签说明文档

date(format)

输出当前日期，或使用指定的格式化字符串格式化输出。

参数解析：

1. format 字符串，可选。表示格式化字符串。

${date()} //2019-07-10 20:22:22
${date("HH.mm.ss")} //20.22.22

具体格式化字符串参考：https://docs.microsoft.com/en-us/dotnet/api/system.datetime.tostring?view=netframework-4.8

---

isnull()

判断一个任意对象是否为空（或判断字符串是否为空）

${isnull("")} //True
${isnull(config)} //False (config 为内置的站点配置文件)
${isnull(config.notExists)} //True

---

md5(str)

MD5加密

md5("123456") //E10ADC3949BA59ABBE56E057F20F883E

---

json(obj)

JSON编码

---

left(str, len)

从字符串左边截取指定长度的字符串

${left("123456", 3)} //123

---

cms_banner_list(num)

该标签可以调用滚动图数据，根据显示顺序排序。

参数解析：

1. num 数字，可选。表示数据条数。

一、cms_banner_list() 调用所有滚动图

<ul>
${foreach(bn in cms_banner_list())}
    <li>
        <a href="${bn.jslink}" title="${bn.title}">
            <img src="${bn.image}" style="width:100%; height:300px;" />
        </a>
    </li>
${end}
</ul>

二、cms_banner_list(num) 调用指定数量的滚动图数据，只调用排序后的前 num 条数据（ num 为数字）。

<ul>
${foreach(bn in cms_banner_list(3))}
    <li>
        <a href="${bn.jslink}" title="${bn.title}">
            <img src="${bn.image}" style="width:100%; height:300px;" />
        </a>
    </li>
${end}
</ul>

支持的属性：

1. id 滚动图id
2. title 滚动图标题
3. link 滚动图链接
4. jslink 滚动图js链接（如果链接为空则会返回 javascript:;）
5. image 滚动图图片地址
6. index 滚动图排序顺序

---

cms_channel_list(parentId, num, orderBy)

该标签可以调用栏目数据，根据显示顺序排序。

注意：如果同时需要多个参数，前边的参数不可省略

参数解析：

1. parentId 数字，可选。表示父栏目ID，0为顶级栏目。
2. num 数字，可选。表示数据条数。
3. orderBy 数字，可选。（排序方式列表如下）

一、cms_channel_list() 调用所有栏目

<ul>
${foreach(cn in cms_channel_list())}
    <li>
        <a href="${cn.url}" title="${cn.name}">
            ${cn.name}
        </a>
        <span>浏览量：${cn.viewTotal}</span>
        <span>发文量：${cn.contentTotal}</span>
    </li>
${end}
</ul>

二、cms_channel_list(0) 调用所有顶级栏目
三、cms_channel_list(0,2) 调用前2个顶级栏目
四、cms_channel_list(1) 调用栏目ID为1的所有子栏目
五、cms_channel_list(1,2) 调用栏目ID为1的前2个子栏目
六、cms_channel_list(0,0,2) 调用所有顶级栏目，使用排序方式2

支持的属性：

1. id 栏目id
2. pid 栏目父id（如果为null，则为顶级栏目）
3. name 栏目名称
4. path 栏目访问路径
5. link 栏目外链
6. url 栏目最终的访问URL
7. desc 栏目描述
8. index 栏目排序
9. isNav 是否显示在导航
10. pageSize 栏目文章条数
11. viewTotal 栏目下文章浏览总次数
12. contentTotal 栏目总发布量
13. contentDay 栏目日发布量
14. contentMonth 栏目月发布量
15. contentWeek 栏目周发布量
16. contentYear栏目年发布量

栏目排序方式：
0：按照 index 顺序排列
1：按照 id 倒序排列
2：按照 id 顺序排列
3：按照 name 倒序排列
4：按照 name 顺序排列

---

cms_channel(id|name)

该标签可以调用指定ID或名称的栏目详情数据。

参数解析：

1. id 数字，id 和 name 必选其一。表示栏目ID。
2. name 字符串，id 和 name 必选其一。表示栏目名称。

${set(cn=cms_channel(1))}
<a href="${cn.url}" title="${cn.name}">更多关于“${cn.name}”的新闻</a>

支持的属性：

同 cms_channel_list 标签

---

cms_nav_list(num)

该标签可以调用导航栏数据（设置为导航栏显示的栏目数据），根据排序方式顺序排序。

参数解析：

1. num 数字，可选。表示数据条数。

一、cms_nav_list() 调用所有导航栏目

<ul>
${foreach(nav in cms_nav_list())}
    <li>
        <a href="${nav.url}" title="${nav.name}">${nav.name}</a>
    </li>
${end}
</ul>

二、cms_nav_list(num) 调用指定数量的导航栏目，只调用排序后的前
num 条数据。

<ul>
${foreach(nav in cms_nav_list(5))}
    <li>
        <a href="${nav.url}" title="${nav.name}">${nav.name}</a>
    </li>
${end}
</ul>

支持的属性：

同 cms_channel_list 标签

---