# 5uCMS CS(ASP UTF-8) by 凌陈亮-帮助手册

【更新日期】2016.6.23 【咨询QQ】57404811 【官方网址】www.lingchenliang.com

关于程序
- 更新日志
- 程序简介及下载
- 运行环境
- 安装协议

标签使用详解
- 自定义标签
- 系统标签
- 列表标签
- 分页标签
- 判断标签
- 底层标签
- 特殊标签

常用代码收录
- 常用日期时间格式调用代码
- channel.html大类模板页推荐与热门文章调用代码
- 文章总数调用代码
- 评论总数调用代码
- 调用一周内的文章
- 文章页带预览形象图的上一篇,下一篇

- 模板设计
- 插件开发说明
- 关于帮助手册

## 标签使用详解

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

### 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、列表标签↑

基本语法：<!--标签名称:{标签属性}--> ###（底层标签）### <!--标签名称-->
标签名称：标签名称可以自由设置，但最好使用英文字符，方便阅读。
例如：
<!--List:{ $Row=15 $Cid=5 $order=[Commend] desc,[Order] Desc,[id] asc }-->
<a href="[List:aurl]" title="[List:title]">[List:titlex]</a>
<!--List-->
标签属性：

公用标签属性：

$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、分页标签↑

基本语法：<!--Page:{标签属性}--> ### innerText（底层标签）### <!--Page-->
例如：
<!--page:{$Size=15 $Order=[ID] Desc}-->
<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>
<!--page-->
新增固定列表和分页列表中可直接调用content和扩展content字段内容。
例-固定列表：
<!--List:{ $Row=10 $Cid=2 $Order=[id] desc }-->
[List:content] [List:content1]
<!--List-->
例-分页列表：
<!--page:{$size=10 $Order=[ID] Asc}-->
[page:content] [page:content1]
<!--page-->

#### 标签属性

$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}
统计栏目的文章数量：
本系统的栏目表里没有统计某个栏目下文章数量的字段，所以要实现这个功能需要自己通过标签来搞定。
<!--list:{ $Row=10 $Table=Channel $Order=[Order] Desc $Field=[id],[name] }-->
<li><a href="[list:curl]">[list:cname]</a>(<!--count:{ $Row=1 $Sql=Select Count([ID]) as cc From [5U_Content] Where [Cid]=[list:id] And [Display]=1 }-->[count:cc]<!--count-->)</li>
<!--list-->
<!--count:{ $Row=1 $Sql=Select Count([ID]) as cc From [5U_Content] Where [Cid]=[list:id] And [Display]=1 }-->[count:cc]<!--count-->
这里是关键，用独立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=字段名=关键词(多个用,分隔)组合条件符(||[或]、&&[且]，一条语句中只能出现一种条件符)字段名=关键词...
例如（固定列表，原来的可继续使用）：
原来的：<!--List:{ $Row=5 $Cid=4 $Mode=about $keys={field:keywords} $Order=Rnd(ID) }-->
现在可用：<!--List:{ $Row=5 $Cid=4 $Mode=about $about=keywords={field:keywords} $Order=Rnd(ID) }-->
<!--List:{ $Row=5 $Cid=4 $Mode=about $about=aboutkws={field:aboutkws} $Order=Rnd(ID) }-->
<!--List:{ $Row=5 $Cid=4 $Mode=about $about=title={field:aboutkws} $Order=Rnd(ID) }-->
<!--List:{ $Row=5 $Cid=4 $Mode=about $about=keywords={field:aboutkws}||aboutkws={field:aboutkws}||title={field:aboutkws} $Order=Rnd(ID) }-->
<!--List:{ $Row=5 $Cid=4 $Mode=about $about=keywords={field:aboutkws}&&aboutkws={field:aboutkws}&&title={field:aboutkws} $Order=Rnd(ID) }-->
若 aboutkws 相关文章关键词/ID 填的是文章ID号，则可如下调用：
<!--List:{ $Row=5 $Cid=4 $where=id in ({field:aboutkws}) $Order=ID desc }-->
例如（分页列表，原来没有现新增的）：
现在可用：<!--page:{$size=12 $cid=10,4 $mode=about $about=keywords={field:aboutkws} $Order=[ID] desc}-->
其它形式和固定列表相同
若 aboutkws 相关文章关键词/ID 填的是文章ID号，则可如下调用：
<!--page:{$size=12 $cid=10,4 $where=id in ({field:aboutkws}) $Order=[ID] desc}-->

#### 底层标签扩展属性：

使用扩展属性时的基本语法：{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}