标签使用详解-帮助手册-5uCMS CS(ASP UTF-8) by 随缘小居

标签使用详解

标签执行顺序：自定义标签 -> 系统标签 -> 列表标签 -> 分页标签 -> 判断标签

1、自定义标签↑

基本语法：{My:标签代码}
自定义标签可以在后台添加、修改，自定义标签可以调用比他优化级别低的标签。
自定义标签在修改时可以修改标签代码，且加入编辑器。（新增）

2、系统标签（也称变量标签）↑

网站名称：{sys:webname}
首页SEO标题：{sys:IndexTitle} （新增）
首页关键字：{sys:IndexKeywords}
首页描述：{sys:IndexDescription}
系统安装目录 {Sys:Installdir}
首页链接名称：{sys:indexname}
首页链接地址：{sys:indexview}
站内链接前缀：{sys:Httpurl} （假如一张图片会在多个页面出现，有时候可能会出现地址出错的情况，那么只需在模板或者自定义标签的地址最前面加上此标签即可解决）
插件调用路径：{sys:plusurl} 调用实例：<a href="{sys:plusurl}search/">搜索</a>
后台上传文件管理栏目是否开启：{sys:lcl_upload} （新增）
所有文件上传总路径：{sys:lcl_uploaddir} （新增）

3、列表标签↑

基本语法： ###（底层标签）### 
标签名称：标签名称可以自由设置，但最好使用英文字符，方便阅读。
例如：

<a href="[List:aurl]" title="[List:title]">[List:titlex]</a>

标签属性：

公用标签属性：

$Cache 标签缓存时间，只允许是数字，不设置则不使用缓存功能，单位秒。
$Row 返回记录的行数，只允许是数字，默认为10。
$Field 如果指定该值则可优化SQL查询语句，提供效率。

文章列表查询标签属性（用于调用文章列表信息）：

使用语法：{$Cache=值 $Row=值 Tid=值 $Aid=值 $Cid=值 $Type=值 $Mode=值 $Keys=值 $Order=值}
$Tid 文章ID编号，设置该值后，表示只显示该ID编号的文章。（新增）
$Aid 文章ID编号，设置该值后，表示该ID编号的文章不显示出来。
$Cid 调用指定栏目ID编号下的文章，默认将调用所有栏目的文章，需要调用多个栏目的文章可以使用英文状态下的逗名（，）分隔栏目ID编号。（修改为调用指定栏目ID下所有子栏目的文章）
$Type 输出类型，默认为所有文章，当$Type值为images时，将调用所有有形象图的文章
$Mode 文章类型，值commend表示调用推荐文章，值about表示调用相关文章（需要配置$Keys一起使用），值hot表示调用热门文章。
$Keys 通过设置的关键字获取相关文章，多个关键字可以使用英文状态下的逗名（，）分隔，需要配合$Mode=about一起使用。
$Order 文章排序方式，默认以文章权重大小及文章ID编号从大到小排序。

组合SQL查询标签属性：

使用语法：{ $Row=值 $Table=值 $Where=值 $Order=值}
$Table 指定表，表示从哪个表获取数据，各表名称如下：Content 文章表；Channel 栏目表；Diypage 自定义页面表；Label 自定义标签表；Sitelink 站点链接表；Tags 文章关键字（标签）表；Upload 上传文件表。
$Where 指定的表达式
$Order 排序方式

独立SQL查询标签属性：

使用语法：{$Row=值 $Sql=值}
$Sql 完整的SQL查询语句，如果对SQL查询语句比较熟悉的，可以使用。
标签属性的值不可以使用引号或单引号引起来，具体使用方法如下：
{ $Row=10 $Table=channel $Where=[fatherid]=0 $order=[order] desc}

4、分页标签↑

基本语法： ### innerText（底层标签）### 
例如：

<li>
<a href="[page:aurl]"><img src="[page:indexpic]" alt="[List:title]" /></a>
<h2><a href="[page:aurl]">[page:titlex]</a></h2>
<p>[page:shuoming $Replace=chr(13)##<br />]</p>
</li>

新增固定列表和分页列表中可直接调用content和扩展content字段内容。
例-固定列表：

[List:content] [List:content1]

例-分页列表：

[page:content] [page:content1]

标签属性

$Cid 分类ID编号，设置该值后，表示显示该分类及其所有子分类的文章。也可设置为多个分类ID，以英文逗号,分隔。（新增）
$Field 如果指定该值则可优化SQL查询语句,提供效率。（例：$Field=[id],[name] 只读取id和name字段）
$Size 每页记录数，默认为10。
$Table 分页表，默认为Content。
$Order 排列顺序。

5、判断标签↑

基本语法：{IF:表达式} ### 表达式成立的值 ### {Else} ### 表达式不成立的值 ### {End If}

6、底层标签↑

基本语法：
文章浏览页/栏目页 {field:字段名}
分页标签 {page:字段名}
列表标签 {标签名称:字段名}
（修正字符中间有空格时被替换为空的BUG，比如标题、关键词、说明中有空格，现在保留空格）

栏目字段名：

Cid 栏目ID
FatherID 父栏目ID
name 名称
Order 排序号
Domain 外部链接
Indexpic 形象图（新增）原字段Picture已删除
title 标题title （新增）
keywords 关键字keywords
description 描述description
aboutkws 栏目页相关文章关键词/ID （多个用,分隔）（新增）
shuoming 简介（多行文本框）（新增）
content 内容（编辑器内容）（新增）调用方式：{field:ccontent}
列表页增加以下两个底层标签（仅列表页可用）
{field:page} （调用当前页码数字）
{field:paget} （列表页title区页码显示）
列表页是第1页时为空，非第一页时，则在title标题处加入"/第N页"。
例如（栏目列表页中，网页title调用方式）：
{if:len("{field:title}")>0 and isnull("{field:title}")=false}
<title>{field:title}{field:paget}-{sys:webname}</title>
{else}
<title>{field:name}{field:paget}-{sys:webname}</title>
{end if}
统计栏目的文章数量：
本系统的栏目表里没有统计某个栏目下文章数量的字段，所以要实现这个功能需要自己通过标签来搞定。

<li><a href="[list:curl]">[list:cname]</a>([count:cc])</li>

[count:cc]
这里是关键，用独立SQL标签，因为无法用[count:0]获取COUNT的值，所以需要 Count([ID]) as cc，然后用[count:cc]输出个数

文章字段名：

Curl 栏目首页链接
Cname 栏目名称
Aurl 文章链接
Title 标题
Titlex 带标题属性的标签（颜色，样式）
seotitle SEO标题（新增）
Indexpic 形象图
shuoming 简介（多行文本框）（新增）
author 作者
source 来源
jumpurl 跳转地址
keywords 关键词keywords
aboutkws 相关文章关键词/ID （多个用,分隔）（新增）
description 描述description
createtime 发布时间
content 内容
content编号扩展内容（新增）调用方式：若编号为1，则{field:content1}
i 输出记录时的序号
扩展字段调用：ext扩展字段名
扩展字段原设置为250个字符（含所有扩展字段名+标记符+扩展字段内容的总和长度，超出自动截断），现已改为备注型，无需再担心扩展字段个数和长度。
新增固定列表和分页列表调用相关文章时可使用文章任何字段，且可以多条件。
此功能可更方便的定制栏目页的相关文章，更可以替代专题功能，以及产品有品牌时，品牌页面通过相关关键词调用此品牌的所有产品列表。（专题和品牌添加为单独的栏目即可）
使用方法：$about=字段名=关键词(多个用,分隔)组合条件符(||[或]、&&[且]，一条语句中只能出现一种条件符)字段名=关键词...
例如（固定列表，原来的可继续使用）：
原来的：
现在可用：




若 aboutkws 相关文章关键词/ID 填的是文章ID号，则可如下调用：

例如（分页列表，原来没有现新增的）：
现在可用：
其它形式和固定列表相同
若 aboutkws 相关文章关键词/ID 填的是文章ID号，则可如下调用：

底层标签扩展属性：

使用扩展属性时的基本语法：{field:字段名属性名称=属性值}
$Format 格式字时间，只对于时间格式的字段有效，如 $Format=yyyy-mm-dd hh:nn:ss，yy表示二位年份，yyyy表示四位年份，mm dd hh nn ss 都以二位表示。（修正以英文字母显示月份时的BUG）
　　例：[field:createtime $format=MONTHA. dd , yyyy] 显示为： May. 02 , 2015
　　日期以 th 方式显示（新增）
　　例：[field:createtime $format=MONTHA. day , yyyy] 显示为： May. 2th , 2015
$Clearhtml 值等于True时清除字段的HTML标签。
$Len 获取字段指定长度的值，一个中文算二个字符。（修正一个页面调用多个字段有位数限制输出时位数不一致的BUG）
$Lenext 表示在$Len截断后补上的字符。
$Replace 把字段值里的某些字符进行替换，如$Replace=a##A表示把字段值里的a替换成A，中间用##分隔。
　　后台多行文本框中的换行在前台默认为空格显示，可用如 [field:shuoming $Replace=chr(13)##<br />] 方式替换为<br />。（新增）
$Function 使用函数，值有urlencode/htmlencode/abs/trim/ucase/lcase，多个函数可以一起使用，用,号分隔。

7、特殊标签↑

（1）文章浏览页：

当前路径 {tag:sitepath} （修改首页链接文字为"首页"，不再是网站名称）
上一篇文章 {tag:pre}
下一篇文章 {tag:next}
上一篇自定义样式（下一篇自定义样式同理）
{tag:pre;innerText}
自定义样式里不要出现}，有两个扩展参数 [pre:title]（标题）、[pre:aurl]（链接）
文章分页链接 {tag:page}

（2）列表页：

当前路径 {tag:sitepath} （修改首页链接文字为"首页"，不再是网站名称）
列表分页链接 {tag:page}

5uCMS CS(ASP UTF-8) by 随缘小居-帮助手册