1. 业务开发
2. 专题列表 ms:topicchannel
2.1. 适用模版
首页模版、列表模版、内容模版、自定义页面模版
2.2. 格式
{ms:topicchannel 参数1=值1 参数2=值2}
${field.*}
{/ms:topicchannel}
2.3. 参数
| 参数名称 | 类型 | 必须 | 示例值 | 默认值 | 描述 |
|---|---|---|---|---|---|
| type | 字符串 | 否 | self | self: 取当前指定typeid本身； |
|
| typeid | 整型 | 否 | >0 | 所有父级专题 | typeid有值时，取所指专题的板块 |
| size | 整型 | 否 | >0 | 所有专题 | 返回既定条件下的专题或者板块个数，不使用则默认返回全部 |
| orderby | 字符串 | 否 | date 更新时间 sort 排序 |
id | 专题排序,sort排序需要在自定义顺序设置才能看到效果 |
| order | 字符串 | 否 | 升序 | desc:按照倒序排列，asc:按照正序排列 |
[!tip] order参数必须要与orderby一起使用才有效 属性类型为字符串，使用需要使用引号 例如 type="son" order="desc"
2.4. 输出字段
具体输出字段参考文章列表标签
2.5. 范例
下面列举一些常用的使用场景
2.5.1. 在首页展示全部专题
{ms:topicchannel}
<a href="{ms:global.html/}${field.typelink}">
${field.typetitle}
</a>
{/ms:topicchannel}
[!tip] 如果在专题模版中使用，则会获取当前专题的子板块且子版块不支持超链接点击（子版块不允许取${field.typelink}值）。
2.5.2. 展示指定专题
{ms:topicchannel typeid="1"}
<a href="{ms:global.html/}${field.typelink}">
${field.typetitle}
</a>
{/ms:topicchannel}
2.5.3. 展示专题下板块
{ms:topicchannel}
+${field.typetitle}<br>
{ms:topicchannel }
++${field.typetitle}<br>
{/ms:topicchannel}
{/ms:topicchannel}
[!tip] 其他用法，大体可以参考栏目列表标签
3. 板块列表 ms:topicarclist
读取板块引入的文章列表数据
3.1. 适用模版
首页模版、专题列表模版
[!tip]主页面模版使用：如果不设置 typeid 会取出所有的专题下的数据，推荐增加 typeid 值，且相同引用的文章数据只会展示一次；
列表模版使用: 可以不设置 typeid 参数，默认为当前访问的栏目 ID，建议指定相关板块的ID。
3.2. 格式
{ms:topiclist 参数1=值1 参数2=值2}
${field.*}
{/ms:topiclist}
[!tip]可以嵌套在
topicchannel里面来实现专题动态获取文章列表
3.3. 参数
| 名称 | 类型 | 必须 | 示列值 | 默认值 | 描述 |
|---|---|---|---|---|---|
| typeid | 整型 | 否 | >0 | 无 | 专题或者板块ID,在列表模板默认获取当前专题ID |
| size | 整型 | 否 | >0 | 20 | 返回文档列表总数,默认为 20 条 |
| orderby | 字符串 | 否 | date | content_datetime | 根据时间排序:date，根据更新时间排序:updatedate，根据文章自定义顺序排序:sort，根据文章点击数排序:hit(如果点击量增加了，需要重新生成排序才会变化)，不填则显示默认顺序，支持多个参数值，以英文逗号分隔，例如：orderby='sort,date'(多个参数值，仅5.4.2及以上版本支持) |
| order | 字符串 | 否 | asc | desc | desc:按照倒序（降序）排列，asc:按照正序（升序）排列，必须与 orderby 一起使用，默认为创建时间; |
3.4. 输出字段
具体输出字段参考文章列表标签
[!tip] 不支持获取文章自定义模型字段数据。
3.5. 范例
3.5.1. 基础使用格式
获取 typeid=62 下面size=5 五篇 文章
{ms:topiclist size=5 typeid=62}
<img src="{@ms:file field.litpic/}" />
<a href="{ms:global.html/}${field.link}" target="_self">${field.title}</a>
{/ms:topiclist}
[!tip] 其他用法，大体可以参考文章列表标签 ，需要把arclist改成topiclist。