1.1. 文章列表 ms:arclist

读取文章列表数据

1.2. 适用模版

首页模版、列表模版、内容模版、自定义页面模版

[!tip]主页面模版使用:如果不设置typeid会取出所有的栏目下的数据,推荐增加typeid值;
列表模版使用: 不能设置typeid参数,默认为当前访问的栏目ID,分页列表必须使用ispaging属性,注意:每个列表模版只能有一个使用了ispaging属性的arclist标签;
内容模版使用: 不设置typeid,默认为当前文章的所属栏目id;

1.3. 格式

{ms:arclist [参数1=值1 参数2=值2]}
    ${field.*}
{/ms:arclist}

[!tip]可以嵌套在 channel 里面来实现栏目动态获取文章列表

1.4. 嵌套格式

多级栏目文章嵌套格式

{ms:channel type="nav"} <!--顶级栏目-->
    +${field.typetitle} <br> 

    {ms:channel} <!--二级栏目-->

        ++${field.typetitle} <br>

            {ms:arclist}<!--二级栏目下的文章-->
                ${field.title}<br>
            {/ms:arclist}


    {/ms:channel}

{/ms:channel}

1.5. 参数

名称 类型 必须 示列值 默认值 描述
typeid 整型 >0 栏目ID,在列表模板和内容模板会默认获取当前所属栏目ID,可以实现类似相关文章的效果
size 整型 >0 20 返回文档列表总数,默认为20条全部返回,也可以配合分页使用
flag 字符串 c,f,h,p, 指定显示某个属性的文章数据,幻灯f,图片p,推荐c,头条h,跳转 j;请按照示例值顺序设置,例如:flag=c,f
noflag 字符串 c,f,h,p, noflag=c,显示文章属性除c之外的所有文章;请按照示例值顺序设置,例如:noflag=c,f;c,p
orderby 字符串 date 根据时间排序:date,根据文章等级排序:sort,根据文章点击数排序:hit(如果点击量增加了,需要重新生成排序才会变化),不填则显示默认顺序
order 字符串 asc desc desc:按照倒序(降序)排列,,asc:按照正序(升序)排列,必须与orderby一起使用
ispaging 布尔型 true false 当文章列表出现分页标签时必须添加本属性
tableName 字符串 mdiy_model_mobile 自定义表名,使用代码生成器导入的模型表名

[!tip]属性类型为字符串使用需要使用引号 flag="c,h" order="desc";
flag可以通过后台自定义字典进行维护;
ispaging只能列表模版下使用;
tablename可以自定义模型决定,自定义模型创建流程:先在 代码生成器 拖出模型并下载模型代码 -> 打开系统后台自定义管理,进行自定义模型导入 -> 打开栏目管理,进行栏目绑定自定义模型 -> 打开文章管理,进行发布内容

1.6. 输出字段

字段名称 描述
${field.index} 序号,根据显示条数显示的序号1 2 …..10
${field.id} 文章id,对应文章在数据库里的自增长编号
${field.title} 文章标题,可以通过{@ms:len field.title 40/}控制标题显示长度,超出会省略号显示
${field.fulltitle} 完整文章标题,(显示完整的标题)
${field.author} 文章作者
${field.source} 文章来源
${field.content} 文章内容,获取文章全部内容
${field.typetitle} 文章所属分类的名称
${field.typeid} 文章所属分类的编号
${field.typelink} 文章分类链接,点击连接连接到当前分类的列表:{ms:global.host/}${field.typelink}
{@ms:file field.litpic/} 文章缩略图,上传文章的缩略图,调用缩略图地址:{ms:global.host/}/{@ms:file field.litpic/}
${field.link} 文章内容链接,点击显示文章具体的内容地址,一般配合文章标题使用:{ms:global.url/}${field.link}
${field.date?string("")} 根据用户指定的格式输出时间,${field.date?string("yyyy-MM-dd")}
${field.descrip} 文章摘要
${field.hit} 文章点击量
${field.flag} 文章flag属性
${field.keyword} 文章关键字
${field.*} 自定义标签,使用代码生成器拖拽的字段名

[!tip] filed.title 长度的控制通过{ms:len filed.title 长度 /}
field.litpic缩略图必须要使用 {@ms:file filed.litpic /};
field.data 日期格式通过 ?string("yyyy-MM-dd hh:mm:ss") 格式化
自定义模型字段 通过 ${field.扩展模型字段名} 获取

2. 范例

2.1. 基础使用格式

获取 typeid=62 下面size=5 五篇 flag="c" 推荐的文章

{ms:arclist flag="c" size=5  typeid=62}
<img src="{ms:global.url/}/{@ms:file field.litpic/}"/>
<a href='{ms:global.url/}${field.link}' target="_self">${field.title}</a>
{/ms:arclist}

2.2. 带自定模型基础使用格式

{ms:arclist typeid=70 tableName="自定义模型表名"}
    ${field.自定义模型表字段名称}
{/ms:arclist}

2.3. 多张图片获取方式

{ms:arclist typeid=70 tableName="自定义模型表名"}
<img src="{ms:global.url/}/{@ms:file field.litpic/}"/>
<a href='{ms:global.url/}${field.link}' target="_self">${field.title}</a>

    单张图片img1自定义模型多个图片字段
    <#if field.img1??>
        <#list field.img1?eval as img>
        ${img.path}
        </#list>
    </#if>
    单张图片img2自定义模型单张图片字段
    <#if field.img2??>
        ${field.img1?eval[0].path}
    </#if>
{/ms:arclist}
Copyright © mingsoft.net 2021 all right reserved,powered by Gitbook该文件修订时间: 2021-09-26 11:02:23

results matching ""

    No results matching ""

    results matching ""

      No results matching ""