YulinCMS ContList标签说明

来自站长百科
跳转至: 导航、​ 搜索

导航: 上一页

功能说明[ ]

用于调用内容列表

适用范围[ ]

所有模板

语法格式[ ]

 {Yu:ContList 属性1="属性值1" 属性2="属性值2"......}
 {NormalTemplate} 普通项模板 + 底层变量......{/NormalTemplate}   // 普通项模板元素
 {AlterTemplate} 交替项模板 + 底层变量......{/AlterTemplate}   // 交替项模板元素(可选)
 {SeparTemplate} 分隔符模板......{/SeparTemplate}   // 分隔符模板元素(可选)
 {ConditionTemplate} 条件输出模板......{/ConditionTemplate}   // 条件输出模板元素(可选)
 {/Yu:ContList}

模版元素[ ]

  • NormalTemplate 在内容列表中的每一行都呈现一次的模板元素。
  • AlterTemplate 与 NormalTemplate 元素类似,但在内容列表中隔行(交替项)呈现一次。通过设置 AlterTemplate 元素的内容,可以为其指定不同的外观。
  • SeparTemplate 将呈现在内容列表行之间。如果不设置,则不呈现分隔符内容。
  • ConditionTemplate 当专题数量达到 num 的倍数时,输出该模板元素的内容(num 为标签属性 Condition 指定的数字值)

备注:如果没有使用任何模板元素,则标签中的内容被默认为 NormalTemplate 普通项模板的内容

标签属性[ ]

  • ListType 内容列表的类型

属性值可以是如下

  1. Normal 普通内容列表,用于所有模板。
  2. Category 栏目页内容列表,仅用于栏目页,可实现分页,使用Count属性来指定分页大小。
  3. Relation 相关内容列表,仅用于内容页模板。
  4. SpecRegion 专题区域页内容列表,仅用于专题区域页模板。可实现分页,使用Count属性来指定分页大小。
  5. SearchResult 高级搜索结果页内容列表,仅用于搜索结果页。

不指定该属性,则默认为 Normal 普通内容列表。

  • Count调用内容数量

不指定该参数,则默认调用10篇内容。

当属性 ListType = "Category" 或 "SpecRegion" 时该参数用来指定内容列表的分页大小

  • Cate 调用指定栏目下的内容

属性值可以是

  1. Current 调用当前栏目的内容(仅用于 栏目页、内容页)
  2. Rand 调用任意一个栏目下的内容
  3. Id 调用外层列表标签指定的栏目下的内容

调用指定栏目的内容 例如:Cate="13"

调用多个指定栏目的内容 例如 Cate="2|5|13"

不指定该属性则默认调用所有栏目的内容

当 ListType = "Category" 时该参数无效。

  • IsChildCate 是否调用所有子栏目内容

属性值为 True(是) 或 False(否) 默认为 True

当 ListType = "Category" 时该参数无效。

  • Class 调用指定栏目分类下的内容

属性值可以是

  1. Current 调用当前栏目分类的内容(仅用于 栏目页、内容页)
  2. Rand 调用任意一个栏目分类下的内容

调用指定栏目分类的内容 例如:Class="13"

调用多个指定栏目分类的内容 例如 Class="2|5|13"

不指定该属性则忽略该条件

当 ListType = "Category" 时该参数无效。

  • CateGroup 栏目组别

属性值可以是

Rand 调用任意一个栏目组别下的内容

调用指定栏目组的内容 例如:CateGroup = "1"

调用多个指定栏目组的内容 例如 CateGroup = "2|3|5"

如设置此属性,则只显示栏目组别等于 CateGroup 的内容列表。不指定该属性则忽略该条件

当 ListType = "Category" 时该参数无效。

  • CateGroupNot 非栏目组别

属性值可以是

Rand 调用除任意一个栏目组外的栏目下的内容

调用除指定栏目组外的栏目 例如:CateGroupNot = "1"

如设置此属性,则只显示栏目组不等于 CateGroupNot 的栏目列表。不指定该属性则忽略该条件

当 ListType = "Category" 时该参数无效。

  • ContGroup内容组别

调用指定内容组别的内容 例如:ContGroup = "1"

调用多个指定内容组的内容 例如 ContGroup = "2|3|5"

如设置此属性,则只显示内容组别等于 ContGroup 的内容列表。不指定该属性则忽略该条件

  • ContGroupNot非内容组别

调用除指定内容组别外的内容 例如:GroupNot = "1"

如设置此属性,则只显示内容组别不等于GroupNot的内容列表。不指定该属性则忽略该条件

  • Where 调用特定条件的内容

属性值如下所示

  1. SubTitle 调用带副标题的内容
  2. TitlePicture 调用带标题图片的内容
  3. TitleFile 调用带标题附件的内容
  4. TitleMedia 调用带标题媒体的内容
  5. Depict 调用带摘要内容
  6. Outer 调用指向外部链接的内容
  7. Top 调用已置顶内容

调用某种类型的内容。例如 Where = "TitlePicture" 调用带标题图片的内容

调用多种类型的内容。例如 Where = "TitlePicture|Depict" 调用带标题图片或着带摘要的内容

调用同时具有多种类型的内容.例如 Where = "TitlePicture&Depict" 调用同时带标题图片和摘要的内容

不指定参数则调用所有条件内容。

  • Flag 调用特定标记的内容

属性值如下所示 (可自定义)

  1. Hot 调用热点内容
  2. Recommend 调用推荐内容
  3. Topline 调用头条内容
  4. Picture 调用含图片的内容
  5. MultiPicture 调用含组图的内容
  6. File 调用带附件的内容
  7. Flash 调用带Flash的内容
  8. Audio 调用带音频的内容
  9. Video 调用带视频的内容

调用某种标记的内容。例如 Flag = "Picture" 调用含图片的内容

调用多种标记的内容。例如 Flag = "Hot|Picture" 调用热点内容或含图片内容

调用同时具有多种标记的内容.例如 Flag = "Hot&Picture" 调用同时具有热点和含图片的内容

不指定参数则忽略该条件

  • Spec 调用指定专题下的内容

属性值可以是

  1. Current 调用当前专题下的内容(仅用于 专题内容页、专题分区页)
  2. Id 调用外层专题列表标签指定专题下的内容

调用指定专题的内容 例如:Spec = "13"

调用多个指定专题的内容 例如 Spec = "12|13|15"

不指定该属性则忽略该条件

  • SpecRegion 调用指定专题区域下的内容

属性值可以是

Id 调用外层专题区域列表标签指定区域下的内容

调用指定专题区域的内容 例如:SpecRegion = "13"

调用多个指定专题的内容 例如 SpecRegion = "12|13|15"

不指定该属性则忽略该条件

当 ListType = "SpecRegion" 时该参数无效。

  • Date 调用指定日期的内容

属性值可以是

  1. Today 调用今天的内容
  2. ThisWeek 调用本周的内容
  3. ThisMonth 调用本月的内容
  4. ThisYear 调用本年的内容
  5. Yesterday 调用昨天的内容
  6. LastWeek 调用上周的内容
  7. LastMonth 调用上个月的内容
  8. LastYear 调用去年的内容

也可以调用给定日期值的内容,例如

调用指定日期的内容 Date = "2007-6-13"

调用指定的多个日期的内容 Date = "2007-6-13|2007-6-19"

调用指定日期段的内容 Date = "2007-6-13>2007-6-19"

不指定该参数则默认调用所有日期内容

  • LastDay 调用最近几天的内容

例如:LastDay = "7" 只调用最近7天的内容

  • Keyword 调用标题含有指定关键字的内容

给定一个关键字 调用满足条件的内容 例如: Keyword = "word1"

给定多个关键字 调用满足条件的内容 例如: Keyword = "word1|word2|word3" (满足任一关键字即调用)

给定多个关键字 调用满足条件的内容 例如: Keyword = "word1&word2&word3" (同时满足全部关键字才调用)

不指定该属性则忽略该条件

  • Sort 内容排序规则

属性值可以是

  1. AddTime 按录入时间排序
  2. ClickTotal 按点击量排序
  3. CommTotal 按评论数排序
  4. FileDownTotal 按标题附件下载数量排序
  5. UpTotal 按顶数量排序
  6. DownTotal 按踩数量排序
  7. Id 按内容编号排序
  8. Rand 随机排序,可随机获取指定条件的内容列表

不指定该属性默认以AddTime为排序规则

  • Order 内容排序方式

属性值可以是

  1. ASC 递增排序
  2. DESC 递减排序

不指定该属性默认以DESC方式排序。

  • Start调用内容时的起始位置,和Count配合使用

例如: {Yu:ContList Count="10" Start="30"}.......{/Yu:ContList}

上面例子正好调用了 从第30条 -- 第40条记录之间的 10条 记录

  • Cols内容显示列数

例如: Cols = "2"

不指定该属性则默认列数为1

  • TableStyle列表表格的样式,表示

    此属性和 Cols 属性配合使用,只有Cols大于1时有效。

    • TrStyle列表表格的行样式,表示

    此属性和 Cols 属性配合使用,只有Cols大于1时有效。

    • TdStyle 列表表格的单元格样式,表示

    此属性和 Cols 属性配合使用,只有Cols大于1时有效。

    • Condition条件输出

    例如 Condition = "num"

    num为数字。内容数量达到 num 的倍数时,输出 ConditionTemplate 模板元素的内容。

    • TitleLen内容标题的显示字符数量

    不指定该属性则默认显示完整的标题

    • TitleAddStr 设置内容标题超出部分显示的省略字串

    例如: TitleAddStr ="..."

    不指定该属性则默认为不追加任何省略字串

    • DepictLen内容摘要的显示字符数量

    不指定该属性则默认显示完整的摘要

    • DepictAddStr 设置内容摘要超出部分显示的省略字串

    例如: DepictAddStr ="..."

    不指定该属性则默认为不追加任何省略字串

    • BodyLen内容主体的显示字符数量

    不指定该属性则默认显示完整的内容主体

    • BodyAddStr 设置内容主体超出部分显示的省略字串

    例如: BodyAddStr ="..."

    不指定该属性则默认为不追加任何省略字串

    • NormalTemplateName 普通项模板名称
    • AlterTemplateName 交替项模板名称
    • SeparTemplateName 分隔符模板名称
    • ConditionTemplateName 条件输出模板名称

    底层变量[ ]

    • {@AutoId/} 自动Id。按照递增方式自动产生Id,从 1 开始。通常用来表示行号。
    • {@Id/} 内容编号
    • {@Title/} 内容标题
    • {@FullTitle/} 完整标题,此标题不会被截取,通常作为鼠标提示字串
    • {@SubTitle/} 副标题
    • {@PicPath/} 标题图片
    • {@SPicPath_1/} 标题缩略图 (1级 大小 300*200)
    • {@SPicPath_2/} 标题缩略图 (2级 大小 150*100)
    • {@SPicPath_3/} 标题缩略图 (3级 大小 90*60)
    • {@MediaPath/} 标题媒体
    • {@FilePath/} 标题附件
    • {@FileSize/} 附件大小
    • {@FileDownTotal/} 附件下载次数
    • {@Author/} 内容作者
    • {@Source/} 内容来源
    • {@Body/} 内容主体
    • {@Depict/} 内容摘要
    • {@Flag/} 内容标记
    • {@ClickTotal/} 内容点击数量
    • {@CommTotal/} 评论数量
    • {@UpTotal/} 顶数量
    • {@DownTotal/} 踩数量
    • {@ContPath/} 内容页路径
    • {@CommPath/} 评论路径
    • {@CateId/} 所属栏目的编号
    • {@CateTitle/} 所属栏目标题
    • {@CatePath/} 所属栏目路径
    • {@AddTime/} 内容录入时间
    • {@AdminId/} 管理员ID
    • {@AdminName/} 管理员名字

    使用示例[ ]

    查看ContList标签的使用示例

    相关条目[ ]

    参考来源[ ]