文档/文档列表

文档详情信息 cms:archives

文档详情标签仅用于文档详情展示页，不适用于其它页面。

使用范围

文档详情页

标签参数

调用示例

//显示文档查看次数
{cms:archives name="views" /}
//显示文档标题
{cms:archives name="title|htmlentities" /}
//显示文档标题样式style，包含粗体、文字颜色等样式，可运用于style样式
{cms:archives name="style_text" /}
//获取文档点赞率
{cms:archives name="likeratio" /}
//获取文档URL
{cms:archives name="url" /}
//获取文档完整URL (包含https://开头)
{cms:archives name="fullurl" /}

//主表字段(fa_cms_archives表)
{cms:archives name="主表字段名"}

//副表字段名(fa_cms_addonxxx表)
{cms:archives name="副表字段名"}

//文档归属栏目相关信息
{cms:archives name="channel.title|htmlentities"}
{cms:archives name="channel.url"}

//文档归属作用相关信息
{cms:archives name="user.nickname|htmlentities"}
{cms:archives name="user.url"}

文档列表 cms:arclist

使用范围

全局

标签参数

所有公共参数及以下特有参数

调用示例

{cms:arclist id="item" row="8" orderby="id" orderway="desc" empty="暂无数据"}
    //这里面可以调用cms_archives表的所有字段数据，如果启用了addon属性还可以调用副表数据
    //文章正文字段`content`位于副表，如需调用正文内容，请参考副表调用章节
    //文档标题
    {$item.title|htmlentities}
    //文档SEO标题
    {$item.seotitle|htmlentities}
    //文档图片
    {$item.image|htmlentities}
    //文档关键字
    {$item.keywords|htmlentities}
    //文档描述
    {$item.description|htmlentities}
    
    
    //标题样式style，包含粗体、文字颜色等样式，可运用于style样式
    {$item.style_text}
    //是否有预览图
    {$item.hasimage}
    //文档组合链接
    {$item.textlink}
    //文档链接
    {$item.url}
    //栏目组合链接
    {$item.channellink}
    //图片组合链接
    {$item.imglink}
    //图片HTML
    {$item.img}
    
    //获取所属发布者的相关信息，具体可以使用的字段为fa_user表的字段，调用时建议配合`with="user,channel"`属性来调用
    {$item.user.nickname|htmlentities}
    //获取所属栏目的相关信息，具体可以使用的字段请参考fa_channel表的字段
    {$item.channel.url}
    
    //获取图片字段原始字段数据
    {:$item->getData('image')}
{/cms:arclist}

//调用当前栏目下的文档
{cms:arclist id="item" row="8" orderby="id" orderway="desc" channel="__CHANNEL__.id"}
    //这里面可以调用cms_archives表的所有字段数据，如果启用了addon属性还可以调用副表数据
{/cms:arclist}

//调用关联指定标志的下的文档
{cms:arclist id="item" row="8" orderby="id" orderway="desc" flag="hot"}
    //这里面可以调用cms_archives表的所有字段数据，如果启用了addon属性还可以调用副表数据
{/cms:arclist}

//调用关联指定tag标签下的文档
{cms:arclist id="item" row="8" orderby="id" orderway="desc" tags="互联网,云计算"}
    //这里面可以调用cms_archives表的所有字段数据，如果启用了addon属性还可以调用副表数据
{/cms:arclist}

//调用指定模型的主表和副表数据
{cms:arclist id="item" model="1" row="8" orderby="id" orderway="desc" addon="true"}
    //这里面可以调用cms_archives表的所有字段数据，还可以调用模型为1的副表的数据
{/cms:arclist}

//调用并筛选指定副表的查询条件的文档
{cms:arclist id="item" model="1" row="8" orderby="id" orderway="desc" addon="true" condition="'test' = `author`"}
    //这里面可以调用cms_archives表的所有字段数据，还可以调用模型为1的副表的数据，同时根据模型对应的副表中的字段名(author)进行条件筛选值为`test`的数据
{/cms:arclist}

//分页展示
{cms:arclist id="item" row="8" orderby="id" orderway="desc" paginate="10"}
    //这里面可以调用cms_archives表的所有字段数据，如果启用了addon属性还可以调用副表数据
{/cms:arclist}
{$__LIST__->render()}

调用副表

如果需要在arclist调用副表字段的内容，必须配合model或channel属性才能完成调用，比如

//这里的true表示可调用副表所有字段，但排除id和content字段
{cms:arclist id="item" row="8" model="1" addon="true"}
    //支持调用副表除id和content字段以外的字段
    {$item.副表字段名}
{/cms:arclist}
//也可指定一个或多个副表字段，调用author字段
{cms:arclist id="item" row="8" model="1" addon="author"}
    {$item.author}
{/cms:arclist}
//也可指定一个或多个副表字段，调用author和content字段
{cms:arclist id="item" row="8" model="1" addon="author,content"}
    {$item.content}
{/cms:arclist}
//配合栏目ID来调用
{cms:arclist id="item" row="8" channel="4,5,6" addon="author"}
    {$item.author}
{/cms:arclist}
//筛选副表指定字段条件
{cms:arclist id="item" row="8" model="1" addon="author" condition="`n`.`author`='Github'"}
    {$item.author}
{/cms:arclist}

上下页标签 cms:prevnext

用于调用当前文档的上下篇文章

使用范围

文档详情页

标签参数

调用示例

//调用上一篇文章
{cms:prevnext id="prev" type="prev" archives="__ARCHIVES__.id" channel="__CHANNEL__.id"}
    //文章URL
    {$prev.url}
    //文章标题
    {$prev.title|htmlentities}
{/cms:prevnext}

//调用下一篇文章
{cms:prevnext id="next" type="next" archives="__ARCHIVES__.id" channel="__CHANNEL__.id"}
    //文章URL
    {$next.url}
    //文章标题
    {$next.title|htmlentities}
{/cms:prevnext}