Datalife Engine 文章模板所用的标签
官方文档此部分分为两段介绍的,其实是通用的,在这里,我把标签集中介绍。
文章模板分为shortstory.tpl和fullstory.tpl两部分,
shortstory.tpl中的内容显示在首页和分类列表里,以及自定义部分、搜索结果、相关文章等页面;
fullstory.tpl中的内容是点击阅读更多或全文链接时显示的内容。
在我们发布文章的时候,如果fullstory.tpl字段中,没有输入内容,点击查看全文的时候显示的内容则是shortstory.tpl中的内容,为了在列表中不将全部内容展示出来恐怕也是为了避免占用分类页大篇篇幅的原因吧。
和文章模板关联的模板标签如下,内容过多请使用Ctrl+F搜索。
- {title}:文章标题。
- {title limit="x"}:限制文章标题长度,其中x为数值,但实际测试并不是以汉字字数计算,使用时需注意。
- {full-story}:文章全文内容,使用fullstory.tpl模板。
- {short-story}:文章简介内容,使用shortstory.tpl模板。
- {short-story limit="x"}:限制文章简介输入长度,其中x为数值,但实际测试并不是以汉字字数计算,使用时需注意。
- {full-story limit="x"}:限制文章全文输入长度,意义不大,其中x为数值,但实际测试并不是以汉字字数计算,使用时需注意。
- {author}:文章作者。
- {date}:文章发布日期,日期格式默认继承网站设置,但也可以自定义显示格式。
- {rating}:评分。
- [rating] text [/rating]:评分部分起始与结束标识。
- [rating-type-1] text [/rating-type-1]:评分类型1,后台如果设置此类型的评分,则用此代码显示评分样式。
- [rating-type-2] text [/rating-type-2]:评分类型2,后台如果设置此类型的评分,则用此代码显示评分样式。
- [rating-type-3] text [/rating-type-3]:评分类型3,后台如果设置此类型的评分,则用此代码显示评分样式。
- [rating-type-4] text [/rating-type-4]:评分类型4,后台如果设置此类型的评分,则用此代码显示评分样式。
- [rating-minus] text [/rating-minus]:与第三种评分类型搭配使用。
- [rating-plus] text [/rating-plus]:与第三种评分类型搭配使用。
- {likes}:评分喜欢总数。
- {dislikes}:评分不喜欢总数。
- {vote-num}:显示评价这篇文章的用户数。
- {ratingscore}:显示平均评级数字,包含从1到5的分数部分。
- {comments-num}:显示文章评论数量。
- {category}:显示文章所在分类名称。
- {category-icon}:显示文章所在分类的图标(后台分类管理中设置分类图标)。
- [category-icon] text [/category-icon]:如果设置了分类图标,将显示预置文本。
- [not-category-icon] text [/not-category-icon]:如果没有设置分类图标,将显示预置文本。
- {views}:文章查看次数,这里的查看次数并不是按刷新一次计一次访问次数的。
- {favorites}:添加或删除收藏文章。
- [add-favorites] text [/add-favorites]:收藏文章标签。
- [del-favorites] text [/del-favorites]:从收藏夹中移除已收藏文章。
- [edit] text [/edit]:快速编辑文章时使用。
- {link-category}:分类链接地址。
- [full-link] and [/full-link]:文章全文地址,可以和{title}搭配使用。
- [com-link] and [/com-link]:评论链接。
- [xfvalue_x]:自定义字段。
- [xfvalue_X limit="X2"]:限制自定义字段输出长度。
- [xfgiven_x] [xfvalue_x] [/xfgiven_x]:如果不为空,则显示自定义字段“x”。 如果该字段没有值,则不会显示文本。
- [xfnotgiven_X] [/xfnotgiven_X]:如果发布文章时未设置额字段,则显示预置文本,其中“х”是字段的名称。
- [ifxfvalue tagname="demo"] Text [/ifxfvalue]:如果tagname的值为demo则显示预置文本。
- [ifxfvalue tagname!="demo"] Text [/ifxfvalue]:如果gagname的值不是demo则显示预置文本。
- [xfvalue_thumb_url_X]:仅当自定义字段的类型为“图像”时才能使用此标记。 该标签仅显示上传图像缩略图的 URL,其中“х”是字段的名称。
- [xfvalue_image_url_X]:仅当自定义字段的类型为“图像”时才能使用此标记。 该标签仅显示上传图片的全尺寸图片的 URL,其中“х”是字段的名称。
- [xfvalue_image_description_X]:
- [xfvalue_X image="Nr"]:
- [xfvalue_X image-url="Nr"]:
- [xfvalue_X image-thumb-url="Nr"]:
- [xfvalue_X image-description="Nr"]:
- [xfgiven_X image="NR"] текст [/xfgiven_X image="NR"]:
- [xfnotgiven_X image="NR"] Текст [/xfnotgiven_X image="NR"]:
- [group=X]text[/group]:向指定用户组显示预置内容,其中x为用户组id,多个用户组请使用半角逗号分隔。
- [category=X]text[/category]:在文章中判断分类是否为指定分类,如果是,则显示预置内容。
- [has-category] text [/has-category]:如果文章为任意分类,则显示预置内容。
- [not-has-category] text [/not-has-category]:如果文章没有选择类别,则显示预置内容。
- [tags] text [/tags]:文章标签起始与终止标签。
- {tags}:显示文字包含的标签(tags)
- {full-link}:文章全文链接。
- {edit-date}:如果在编辑文章的时候勾选了编辑原因,此标签显示文章最后被修改的时间。
- [edit-date] text [/edit-date]:如果文本或文章已被编辑,则显示文本。
- {editor}:显示文章由谁编辑。
- [edit-reason] text [/edit-reason]:如果已指定编辑原因,则显示文本。
- {edit-reason}:如果在编辑文章的时候在编辑器下方勾选了显示文章被编辑的相关提示,则显示编辑原因。
- {date=date fromat}:自定义日期格式。以指定格式显示日期。 它允许您显示完整日期及其单独的部分。 日期格式按照 PHP 格式设置。 例如,{date=d} 标签显示文章或评论发表的日期,{date=F} 标签显示月份的名称。 {date=d-m-Y H:i} 显示完整的日期和时间。
- {approve}:仅在用户查看 他/她的 个人资料并显示 他/她 正在等待审核的新闻状态时显示。
- [fixed] text [/fixed]:当文章置顶时显示的文字,例如[fixed] 置顶 [/fixed]。
- [not-fixed] text [/not-fixed]:非置顶时显示的内容,这个基本用不上,因为未置顶也无需显示什么。
- [day-news] text [/day-news]:显示与给定文章同一天发表的所有新闻的链接。这个标签可以和{date}一起使用。
- [catlist=1,2....] text [/catlist]:如果文章属于指定的类别,则显示所包含的文本。
- [not-catlist=1,2....] text [/not-catlist]:如果文章不属于指定的类别,则显示所包含的文本。
- {login}:显示文章作者的名字,是一个简单的文本,没有链接到他的个人资料。此处使用要与首页模板标签解读 的 {login} 区分开。
- [poll] text [/poll]:如果该文章有投票,则显示预置文本。
- {poll}:显示这篇文章的投票。
- [not-poll] text [/not-poll]:如果该文章没有投票,则显示预置文本。这个标签同样意义不大,没投票内容,不显示即可。
- [profile] text [/profile]:显示文章作者简介的链接,不使用弹出的迷你简介窗口。
- [complaint]text[/complaint]:用于报文章投诉&举报的链接。
- [comments]text[/comments]:如果这篇文章有评论,则显示预置文本。
- [not-comments]text[/not-comments]:如果这篇文章没有评论,则显示预置文本。
- {image-x}:显示文章中的图片的URL,其中x是文章中图片的数量。例如,{image-1}将显示文章中第一张图片的URL。可用于提取文章封面。
- [image-x] text [/image-x]:只有在文章中存在图片编号为X的情况下,才会显示所预置的文本。
- [not-image-x] text [/not-image-x]:如果文章中没有包含x编号的图片,显示的内容。避免因无图造成排版错误。
- [tags=tag1,tag2,tag3] text [/tags]:当访问者用标签云中列出的关键词浏览网页时,显示所包围的文本,其中标签1、标签2、标签3是标签云中的关键词。
- [not-tags=tag1,tag2,tag3] text [/not-tags]:显示任何页面上的文本,除了指定的那些。
- [declination=X] text [/declination]:根据指定的数字改变词尾。X是一个数字,"text "是一个单词及其尾音。结尾由"|"符号分隔。这个标签可以和其他标签一起使用,例如,显示文章的浏览量或评论数。例如,[declination={comments-num}]commen|t|ts[/declination]根据评论的数量,显示如下。"评论","评论"。基本上中文情况下用不到,单数复数的问题。
- [newscount=x] text [/newscount]:如果文章编号X被显示,则显示预置文本,其中X是所显示文章编号。例如,[newscount=1] text [/newscount] 在显示页面上的第一篇文章时显示该文本。
- [not-newscount=X] text [/not-newscount]:用法同上,但作用相反。
- {banner_x}:在置顶位置显示后台添加的广告,其中x为添加广告时设置名称。
- [not-news] текст [/not-news]:如果没有符合给定条件的文章,则显示预置的文本。因此,如果网站的某个分类没有文章,你可以使用你自己的信息而不是标准的信息。你可以为每个分类制作独特的信息。
- [if field = "value"] text [/if]:如果该字段的值等于指定的值,则显示该字段所包含的文本,和php中的if用法相似。其中包含如下用法:
- [if field = "value"] text [/if] -如果字段等于'value'参数,则显示该文本
- [if field != "value"]text[/if] - 如果该字段不等于参数'value',则显示该文本
- [if field > "1"] text [/if] - 如果字段大于'值'参数,则显示文本
- [if field >= "2"] text [/if] - 如果字段大于或等于参数'value',则显示该文本
- [if field < "3"] text [/if] - 如果该字段小于'value'参数,则显示该文本
- [if field <= "4"] text [/if] - 如果字段小于或等于参数'value',则显示该文本
- [if field ~ "value"] text [/if] - 如果字段中有'value'字样,则显示该文本
- [if field !~ "value"] text [/if] - 如果 "值 "字不在该字段中,则显示该文本。
组合使用:- [if field > "3" AND field2 < "5"] text [/if]:如果 "field "字段大于3,且field2小于5,则显示文本。
- [if field > "3" OR field2 < "5"] text [/if] :如果 "field "字段大于3或field2小于5,则显示文本,也就是说,如果任何条件匹配
字段用到的名称:
id - 文章的唯一ID号(数字)。
autor -文章作者(文本)
date - 文章日期(日期为英国格式,例如 "2020-09-01 "或 "2020年9月10日",或 "下周四",或 "+1天",或unix格式;如果使用等号,那么文章日期将被四舍五入到分钟。)
short_story - 文章简介文本(文本)
full_story - 文章全文
title - 文章标题文本(文本)
descr - 描述文章的元标签(文本)
keywords - "关键词 "元标签(文本)
category - 属于哪个类别的列表(文本,用逗号分隔)
alt_name - 使用数控系统时,用拉丁字母表示的标题,形成页面地址。(文本)
comm_num - 评论的数量(数字)
allow_comm - 允许或不允许评论(数字,1或0)
allow_main - 文章是否发布在主页上(数字,1或0)
approve - 文章是否被发布在网站上或被审核中(数字,1或0)
fixed - 文章是否被置顶(数字,1或0)
symbol - 符号代码(文本)
tags - 标签云中的标签列表(文本,用逗号分隔)
news_read - 浏览次数(数字)
allow_rate - 允许或不允许故事评级(数字,1或0)
rating - 文章评分,所有数值的总和(数字)
vote_num - 在评级中投票的人数(数字)
votes - 文章中允许的投票(数字,1或0)
view_edit - 显示编辑或不编辑的原因(数字,1或0)
disable_index - 允许或不允许网络索引(数字,1或0)
editdate - 文章编辑日期(日期为英国格式,例如 "2020-09-01 "或 "2020年9月10日",或 "下周四",或 "+1天",或unix格式;如果使用等号,则日期被四舍五入到分钟内)
editor - 该文章的最后一位编辑的用户名(文本)
reason - 编辑文章的原因(文本)
user_id - 文章作者的ID(数字)
xfield_x - 文章中附加字段的值,其中x是附加字段的名称。例如,xfield_test附加 "测试 "字段的值
- [if field = "value"] text [/if] -如果字段等于'value'参数,则显示该文本
- 如果在你的网站设置中启用了输出作者简介的所有信息,你可以额外使用以下标签,此部分标签个别和个人资料页标签重叠。
- {profile-link}:显示帖子作者简介的链接。
- {foto}:显示帖子作者头像的链接。
- {fullname}:显示帖子的作者全名
- [fullname] text [/fullname]:如果作者的全名在简介中被指定,则显示嵌入标签的文本。
- [not-fullname] text [/not-fullname]:如果作者的全名没有在简介中指定,则显示嵌入标签的文本。
- {land}:显示作者的国家。
- [land] текст [/land]:显示嵌入标签的文本,如果在作者的个人资料中指定了国家的话
- [not-land] текст [/not-land]:如果作者的资料中没有指定国家,则显示嵌入标签的文本
- {signature}:显示作者的签名
- [signature] текст [/signature]:显示嵌入标签的文本,如果在作者的资料中指定了签名的话
- [not-signature] текст [/not-signature] :如果作者的资料中没有指定签名,则显示嵌入标签的文本
- {user-info} :显示作者用的户信息
- [user-info] текст [/user-info]:显示嵌入标签的文本,如果在作者的资料中指定了用户信息的话
- [not-user-info] текст [/not-user-info] :如果作者的资料中没有指定用户信息,则显示嵌入标签的文本
- [online] текст [/online] :如果帖子的作者在线,显示嵌入标签的文本。
- [offline] текст [/offline] :如果帖子的作者不在线,显示嵌入标签的文本
- {mail}:显示用户的电子邮件
- [pm] Текст [/pm]:用于向作者发送站内信息的文本
- {group}:显示用户所在的用户组
- {registration}:显示用户注册时间
- {lastdate}:显示用户最近登录时间
- {group-icon}:显示用户所在用户组图标
- {time_limit}:显示临时群组的访问到期日
- [time_limit] текст [/time_limit]:如果一个用户是临时组的成员,显示嵌入标签的文本
- {comm-num}:显示用户评论数量
- {comments-url} :显示用户评论的链接,作为用户评论汇总的超链接地址使用
- [comm-num] текст [/comm-num]:如果用户在网站上发表评论,显示嵌入标签的文本
- [not-comm-num] текст [/not-comm-num]:如果用户没有在网站上发表评论,则显示嵌入标签的文本
- {news} :显示用户的文章链接
- {rss}:显示用户的RSS订阅链接
- {news-num}:显示用户的文章数量
- [news-num] текст [/news-num] :如果用户在网站上发表了文章,显示嵌入标签的文本。
- [not-news-num] текст [/not-news-num]:如果用户没有在网站上发表文章,显示嵌入标签的文本。
- {all-pm}:显示用户的私人信息总数。
- {favorite-count}:显示用户添加到书签中的文章总数。
- [profile_xfvalue_X] :显示用户资料中的附加字段 "X "的值
- [profile_xfgiven_X] текст [/profile_xfgiven_X] :如果用户资料有额外的字段 "X",显示嵌入标签的文本。
- [profile_xfnotgiven_X] текст [/profile_xfnotgiven_X]:如果用户资料没有额外的字段 "X",显示嵌入标签的文本。
- [author-group=X] текст [/author-group]:如果文章的作者是指定的 "X "用户组的成员,则显示预置的文本。用户组id可以用逗号隔开,例如:1,2,3
- [not-author-group=X] текст [/not-author-group]:如果文章的作者不是指定的 "X "用户组成员,则显示预置的文本。用户组id可以用逗号隔开,例如:1,2,3
以下是fullstory.tpl中使用到的标签
- {pages}:全文分页标签
- [pages] text [/pages]:如果文章由几页组成,则使用{PАGEBREAK}标签显示所包含的文本,如果文章由一页组成,则删除其中的文本。
- [print-link] and [/print-link]:打印当前页面的链接。
- {comments}:显示对这篇文章的评论。这个标签对那些需要在完整文章的页面上发表评论的人很有用。这个标签并不是必需的。如果没有这个标签,评论将自动位于完整文章的下面。
- {addcomments}:显示添加评论的表格。结合{comments}标签,你可以在评论的上方和下方放置添加评论表单。这个标签是不需要的。如果没有这个标签,评论将自动位于文章全文的下面。
- {navigation}:如果有几个页面有评论,则显示评论导航。结合新的{comments}标签,你可以在评论的上方和下方放置导航。这个标签并不是必需的。如果没有这个标签,导航将自动位于全文的下面。
- [related-news]text[/related-news]:只有当这篇文章有相关的新闻时,才会显示所包围的文本。否则,该信息将从模板中删除。
- {custom}:参考 首页模板标签解读
- [comments-subscribe]text[/comments-subscribe]:订阅文章评论的链接
- [next-url] Text [/next-url]:如果文章有下一篇文章,则显示预置文本
- {next-url}:显示下一篇文章的URL
- {next-title}:显示下一篇文章的标题
- [prev-url] Text [/prev-url]:如果文章有上一篇文章,则显示预置文本
- {prev-url}:显示上一篇文章的URL
- {prev-title}:显示上一篇文章的标题