页面的基本布局在名为 main.tpl 的模板文件中。该文件首先由 DLE 脚本加载,所有其他引擎组件都与之相连。让我们来看看主要的组件: {AJAX}、{info}、{content}、{custom}。这些标签负责正确显示新闻。
{AJAX} 标签用于显示 jаvascript 服务标签,这些标签对于整个引擎的正常运行,尤其是 AJAX 技术的正常运行十分必要。建议将其放在模板开头的 <body> 标签之后。
{info} 标签显示有关错误和已执行操作的服务信息(如 "登录失败,密码不正确 "或 "您必须填写所有字段")。建议将其放在 {content} 标签之前。
{content}标签负责直接显示文章和其他引擎模块。
{tags}标签负责显示标签云(文章中指定的特殊关键词)
[sort]{sort}[/sort]标签负责在脚本设置允许的情况下为用户显示新闻排序选择。
{custom} 标签负责以自定义格式显示文章。它有以下参数:
{custom id="1,2,5-8" category="2,3,5-8" subcat="yes" author="x" days="x" template="custom" available="global" navigation="no" from="0" limit="10" fixed="yes" order="date" sort="desc" cache="yes"}
其中:
id - 是要显示的文章 ID 列表,用逗号分隔,不留空格。您也可以使用破折号指定文章 ID 的范围。例如,1,4-8,11 显示 ID 为 1 的文章、ID 为 4 至 8 的文章以及 ID 为 11 的文章。
idexclude - 与参数 id="文章 ID 列表 "完全相反,允许您显示不属于指定文章 ID 的新闻。例如,{custom idexclude="5-10"} 将显示所有不属于 5 至 10 ID 范围的新闻。
category 是要显示的类别 ID 列表,用逗号分隔,不留空格。您也可以使用破折号指定类别 ID 的范围。例如,1,4-8,11 显示 ID 为 1 的类别、ID 为 4 至 8 的类别以及 ID 为 11 的类别。
categoryexclude - 与参数 category="类别列表 "完全相反,允许您显示不属于指定类别的新闻。 例如,{custom categoryexclude="2,7"} 将显示所有不属于 ID 为 2 和 7 的类别的新闻。
subcat 表示是否也应包含来自子类别的文章。该参数可取以下值之一:subcat="yes "表示将选择类别及其子类别中的所有文章;subcat="only "表示只选择子类别中的文章,而不选择类别中的文章。例如,网站只有 ID 为 1、2 和 3 的类别。1 是一个类别,2 和 3 是其子类别。如果使用 {custom category="1" subcat="yes"} 标签,那么类别 1、2 和 3 中的所有帖子都会被选中。
tags - 是分配给新闻的标签云中的关键字列表。例如,标签 {custom tags="news,templates"} 将显示包含标签云 "news "和 "templates "关键词的所有新闻。
template - 用于显示新闻的模板文件。本例中为 custom.tpl。如果在网站上使用多个模板,则每个模板中都必须有该文件。该模板使用的标签与文章注释模板类似。
available - 是显示申请新闻的部分。它可以有以下值:
global - 在所有部分
main - 在主页上
date - 查看特定时期的新闻时
cat - 查看类别时
showfull - 查看全文时
search - 查看搜索结果时
userinfo - 查看用户资料时
register - 注册时
stats - 查看统计数据时
pm - 查看个人信息时
feedback - 查看反馈时
favorites - 当查看收藏夹时
newposts - 查看新帖时
addnews - 添加新闻时
lastnews - 观看网站上的最新消息时
lastcomments - 查看最新评论时
lostpassword - 恢复网站账户密码时
static - 查看静态页面时
catalog - 查看页面目录时
alltags - 查看标签云时
tags - 从标签云中查看新闻时
allnews - 查看网站上的所有新闻或任何用户的所有新闻时
您可以使用"|"组合栏目,例如,如果 available="userinfo|register|main" 将在主页、注册时和查看用户资料时显示您的新闻。
from - 您想开始显示的文章编号。
limit - 显示的新闻数量
order - 新闻排序的标准。可以有以下值:
date - 按日期排序新闻
editdate - 按编辑日期排序
rating - 按评分排序新闻
reads - 按浏览量排序新闻
comments - 按评论数量对新闻排序
title - 按文章标题排序新闻
rand - 对新闻进行随机排序
id_as_list - 按 ID 列表中的文章排序。例如,标签 {custom id = "3,4,1,2" order = "id_as_list"} 将首先显示 ID 为 3 的文章,然后是 4、1 和 2。
lastviewed - 显示用户最后浏览的文章
sort - 指定文章的排序顺序。使用 desc 按降序排序文章,使用 asc 按升序排序文章。
author - 文章作者的登录名。如果使用此参数,则只显示指定作者的新闻。可以列出作者的用户名,并用逗号分隔。例如,{custom author="admin" limit="5"} 标签将显示使用 "admin "登录名的作者的 5 篇文章。
authorexclude 可以显示除指定作者以外的所有文章的文章。可以列出作者的用户名,并用逗号分隔。例如,{custom authorexclude="admin,test"} 将显示除用户名为 "admin "和 "test "的作者之外的所有作者的文章。
xfields 允许显示包含参数中指定的符号代码的文章。符号代码可以在参数中列出,并用逗号分隔。例如,{custom catalog="a,b"} 显示包含符号代码 "a "和 "b "的文章。
catalogexclude 允许显示不包含指定符号代码的文章,其中 X 是分配给文章的符号代码。符号代码可以在参数中列出,用逗号分隔。例如,{custom catgealoxclude="a,b"} 显示不包含符号代码 "a "和 "b "的文章。
xfields 用于显示包含参数中指定文章的额外字段值的文章。参数也可以用逗号分隔。例如,{custom xfields="value 1, value 2"}可显示包含 "value 1 "和 "value 2 "的额外字段的文章。
xfieldsexclude 允许显示不包含参数中指定的文章额外字段值的文章。参数也可以用逗号分隔。例如,{custom xfieldsexclude=" value 1, value 2"}显示不包含 "value 1 "和 "value 2 "的额外字段的文章。
days - 为时间段,其中 x 为应显示新闻的天数。例如,{custom days="2" limit="5"} 显示最近 2 天的 5 条新闻。
横幅广告启用或禁用指定在文章之间输出的广告材料。该参数有两个值: 是 "表示启用输出,"否 "表示禁用输出。默认情况下,如果标签中不包含此参数,则文章之间的广告材料显示将被禁用。例如,标签 {custom banners="yes" limit="5"} 可根据广告材料的设置,在文章之间输出广告材料。
futureannounce 取值为 yes 或 no。该参数与天数="X "参数配合使用,用于指定从未来日期开始的文章。例如,{custom futureannounce="yes "days="1"} 标签表示必须显示发布日期设置为明天(+1 天)的文章。{custom futureannounce="yes" days="2"}标记表示显示发布日期设置为明天和后天的文章,等等。对于那些想在网站上显示即将发布的公告的人来说,这个参数可能很有用。
cache - 取值为 yes 或 no,用于设置是否缓存显示的数据。建议缓存以减少负载。可以分钟、小时或天为单位指定时间段。后缀为 "m"、"h "和 "d "的值用于指定缓存时间。例如,如果指定 {custom cache="30m"....},区块将被强制缓存 30 分钟;如果指定 {custom cache="2h"....},区块将被缓存 2 小时;如果指定 {custom cache="1d" ....},区块将被缓存一天。
navigation - 取值为 yes 或 no,用于设置是否使用页面导航。导航仅在{content}标签支持导航的页面上显示。例如,主页、分类页面等。如果页面不支持导航,如完整文章或静态页面,那么无论指定的值是多少,导航都将自动禁用。
fixed - 取值为 yes、no、only 或 without。它用于选择是否在发布时考虑新闻已固定的事实。如果指定 "是",则固定新闻将显示在开头;如果指定 "否",则固定新闻将显示在新闻列表中,而不考虑该选项。如果指定只显示,则只显示固定新闻。如果指定不显示,则根本不显示固定新闻。
sortbyuser="yes "如果启用此参数,网站访问者将可以自行为本部分设置一种方便的新闻排序方式 [sort]{sort}[/sort]
注意!此标签的所有参数均为可选参数。只有一个参数是必需的。所有其他参数如果未指定,将从脚本的常规设置中获取。例如
{custom id="1,2" order="date"} - 显示 ID 从 1 到 2 的新闻,并按日期排序。
{custom category="2,7" from="5" cache="yes"} - 显示 ID 从 1 到 2 的新闻,并按日期排序。- 显示类别 2 和类别 7 中的新闻,新闻数量取自脚本设置。新闻将从 ID 为 5 的文章开始显示。
{custom order="date" from="9" limit="5"} - 显示最近 5 条新闻,从第 10 条开始。
请记住 每次使用该标记都会给数据库带来额外的负载,因为会有额外的选择。因此,如果您想节省资源,请明智地使用它。
[available=section] text [/available]标签会在浏览网站指定部分时显示标签中的文本:
该标签使用的参数与 {custom} 标签的 available 参数相同。您可以使用"|"符号将版块组合起来,例如:userinfo|register|main
例如:
[available=userinfo|register|main] text [/available] 文本
将在注册和查看用户配置文件时在主页上显示用标签括起来的文本。
注意,您也可以指定 [not-available=userinfo|register|main] text [/not-available] 标签,它与可用标签完全相反,除了指定的部分外,其他地方都会显示文本。
[category=X]text[/category] 标签会在查看指定类别时显示用标签括起来的文本:
该标记以类别 ID 为参数,允许指定多个类别。
[category=1,2,3,7-10]文本[/category]
如果访问者浏览了 ID 为 1 或 2 或 3,以及 7 至 10 的类别,则会显示用标签括起来的文本。
注意,您也可以指定 [not-category=1,2,3,7-10] text [/not-category] 标签,它与类别标签完全相反,除了指定的类别外,其他地方都会显示文本。
如果用户属于指定的用户组,[group=X]text[/group] 标签会显示标签中的文本:
该标记以组 ID 为参数,允许指定多个组。
[group=1,2,3] text [/group] (组=1,2,3
如果用户是管理员、主编或记者,将显示用标签括起来的文本。
请注意,您也可以指定 [not-group=1,2,3] text [/not-group] 标签,它与组标签完全相反,除了指定的组之外,其他地方都会显示文本。
[page-count=1,2,3] text [/page-count] 文本
如果用户处于某个新闻导航页面,则无论网站属于哪个部分,都将显示其中包含的文本,其中 1、2、3 是导航页面的数量。使用该标签可以调整特定页面的信息显示方式,对信息块和广告非常有用。您可以将此标签与其他确定网站部分和类别的标签结合使用。
例如,[aviable=cat][category=1][page-count=1]文本[/page-count][/category][/aviable]标签组合只有在用户浏览 ID 为 1 的类别的第一页新闻时才会显示文本,这些是文章注释。当用户转到其他页面时,将看不到这些文本。
[not-page-count=1,2,3] 文本 [/not-page-count] (不显示页数
在除标签中指定的页面以外的任何页面上显示标签中发布的文本。
{banner_name} 该标记用于在网站上显示广告信息。标语名称在管理面板的一个特殊模块中设置。
如果页面上显示了指定的横幅,则显示其中包含的文本。
{inform_name}用于显示 RSS 信息和其他网站的新闻。标签的名称和所有设置均在管理面板中设置。
[static=页面名] text [/static] 文本
如果访问者浏览的是指定名称的静态页面,则会显示用标签括起来的文本。允许在标签中用逗号分隔指定页面。例如,[static=test1,test2,test3] text [/static] 将在以下页面显示括起来的文本:test1、test2 和 test3
[not-static=page name] text [/not-static] 文本
如果访问者不查看指定名称的静态页面,则显示标签括起来的文本。页面可在标签中指定,并用逗号分隔。
[smartphone] 文本 [/smartphone]
如果访问者使用智能手机浏览网站,则将显示标签中的文本。
[not-smartphone] 文本 [/not-smartphone]
如果访问者不是使用智能手机浏览您的网站,将显示标签中的文字。
[tablet] 文本 [/tablet]
如果访问者使用平板电脑浏览网站,则会显示标签中的文字。
[not-tablet] 文本 [/not-tablet]
如果访问者不是使用平板电脑浏览网站,则将显示标签中的文本。
[desktop] 文本 [/desktop]
如果访客使用台式电脑或笔记本电脑浏览您的网站,将显示标签中的文字。
文本 [/not-desktop] 文本 [/not-desktop]
如果访问者不是使用台式电脑或笔记本电脑浏览您的网站,则会显示标签中的文本。
[ios] 文本 [/ios]
如果用户的设备使用的是苹果公司的 iOS 系统,则会显示标签内的文字
[not-ios] 文本 [/not-ios] 将显示标签内的文本。
如果网站用户的设备不使用 iOS 系统,将显示标签内的文本
[android] 文本 [/android]
如果用户的设备使用谷歌的 Android 系统,则会显示标签内的文字
[not-android] 文本 [/not-android] 将显示标签内的文本。
如果网站用户的设备不使用安卓系统,将显示标签内的文字
您还可以使用 {include file="my_block.tpl"} 标签将一个模板包含到另一个模板中。该标签将指定的 my_block.tpl 文件包含到模板中。使用该标记的目的是在使用带有多个标记的复杂布局时简化结构模板。
{customcomments id="1,2,5-8" newsid="1,2,5-8" category="2,3,5-8" author="x" days="x" template="custom" available="global" from="0" limit="10" order="date" sort="desc" cache="yes"}
该标签允许在网站的任何位置以自定义形式显示评论。该标签用于额外显示评论,例如在网站主页上显示最后一条评论等。
该标签可以使用以下参数:
id - 要显示的评论 ID 列表,用逗号分隔,不留空格。您还可以使用破折号指定评论 ID 的范围。例如,1,4-8,11 显示 ID 为 1 的评论、ID 为 4 至 8 的评论以及 ID 为 11 的评论。
newsid - 要显示的文章 ID 列表,用逗号分隔,不留空格。您也可以使用破折号指定文章 ID 的范围。例如,1,4-8,11 显示来自 ID 为 1 的文章的评论、来自 ID 为 4 至 8 的文章的评论以及来自 ID 为 11 的文章的评论。
newsidexclude - 不想显示的文章 ID 列表,用逗号分隔,不留空格。您也可以使用破折号指定文章 ID 的范围。例如,1,4-8,11 不显示 ID 为 1 的文章的评论、ID 为 4 至 8 的文章的评论以及 ID 为 11 的文章的评论。
category - 您要从中选择评论的文章类别 ID 列表,用逗号分隔,不留空格。您还可以使用破折号指定类别范围。例如,1,4-8,11 显示来自 ID 为 1 的类别、来自 ID 为 4 至 8 的类别以及来自 ID 为 11 的类别的评论。
categoryexclude - 与参数 category="类别列表 "完全相反,允许显示不属于参数值指定类别的文章评论。例如,{customcomments categoryexclude="2,7"}将显示所有不属于 ID 为 2 和 7 的类别的文章评论。
author - 显示评论作者的用户名。使用此参数时,将显示指定作者的评论。您可以用逗号分隔列举多个作者。例如,{customcomments author="admin" limit="5"}标记将显示用户名为 "admin "的作者的 5 条评论。
authorexclude - 不应显示其评论的作者用户名。作者的登录名可以逗号分隔。例如,{customcomments authorexclude="admin,test"} 标记会显示除 "admin "和 "test "用户外所有作者的评论。
days - 以天为单位的时间段,其中 x 是应显示评论的天数。例如,{customcomments days="2" limit="5"} 标签显示最近 2 天的 5 条评论。
template - 用于显示评论的模板文件。本例中为 custom.tpl 。如果在网站上使用多个模板,则每个模板中都必须有该文件。该模板使用的标记与评论显示模板 (comments.tpl) 中使用的标记类似。
available - 是显示评论请求的部分。它可以有以下值:
global - 在所有部分
main - 在主页上
date - 查看特定时期的新闻时
cat - 查看类别时
showfull - 查看全文时
search - 查看搜索结果时
userinfo - 查看用户资料时
register - 注册时
stats - 查看统计数据时
pm - 查看个人信息时
feedback - 查看反馈时
favorites - 当查看收藏夹时
newposts - 查看新帖时
addnews - 添加新闻时
lastnews - 观看网站上的最新消息时
lastcomments - 查看最新评论时
lostpassword - 恢复网站账户密码时
static - 查看静态页面时
catalog - 查看页面目录时
alltags - 查看标签云时
tags - 从标签云中查看新闻时
allnews - 查看网站上的所有新闻或任何用户的所有新闻时
您可以使用"|"组合栏目,例如,available="userinfo|register|main "将在主页、注册和查看用户资料时显示您的新闻。
from - 表示注释的编号,输出从该编号开始。注释编号从 0 开始。例如,如果要跳过符合条件的第一条注释,则需要指定 from = "1" 。
limit - 显示的注释数量。
order - 注释排序标准。可以使用以下值:
date - 按日期对评论进行排序。例如,{customcomments order="date" limit="5"} 标签显示五条最新评论。
rating - 按评分排序评论。例如,{customcomments order="rating" limit="5"}标记显示五条评分最高的评论。
rand - 按随机顺序对评论排序。例如,{customcomments order="rand" limit="5"} 标记以随机顺序显示五条评论。
id_as_list - 按出版物在 ID 列表中的显示顺序排序。例如,标签 {customcomments id = "3,4,1,2" order = "id_as_list"} 将首先显示 ID 为 3 的评论,然后是 4、1 和 2。
sort - 表示评论的排序顺序。如果值为 desc,则按降序排序;如果值为 asc,则按升序排序。
cache - 取值为 yes 或 no,指定是否缓存显示的信息。我们建议缓存显示的区块,以减少服务器负载。您可以指定以分钟、小时或天为单位的周期。后缀为 "m"、"h "和 "d "的值用于指定缓存时间。例如,如果指定 {customcomments cache="30m"....} ,那么评论区块将被强制缓存 30 分钟;如果指定 {customcomments cache="2h"....} ,那么评论区块将被缓存 2 小时;如果指定 {customcomments cache="1d"....} ,那么评论区块将被缓存一天。
该标签的所有参数都是可选的。只需指定一个参数即可。您也可以随意组合该标签的各种参数。
{*注释代码 *}
该标签用于注释代码。{*"和 "*}"之间的所有内容都会从模板中删除,不会显示在网站上。这些标签允许暂时注释掉代码的各个部分,对于模板开发人员调试代码的各个部分非常有用。该标签是全局性的,可在不同模板中使用。
{catmenu}
您可以在模板中制作并显示分类菜单。{catmenu} 标签用于显示分类菜单。该标签可在任何模板文件中使用,并且是全局性的。它使用并嵌入 categorymenu.tpl 模板文件。
{catmenu id="1,2,3-5" subcat="yes" template="custom" cache="yes"}
以自定义格式显示类别菜单,其中
id="1,2,3-5" - 是您希望在菜单中显示的 ID 类别列表。您可以列出用逗号分隔的多个类别,也可以用破折号指定 ID 的范围。
subcat="yes" - 该参数取值为 "yes"、"no "或 "only",与标签的 "id "参数一起使用。它为指定的类别列表定义了是否需要自动连接子类别。例如,如果有一个 ID 为 1 的类别,它有 ID 为 2 和 3 的子类别,那么 {catmenu id="1" subcat="yes"} 标签就会显示类别 1 及其子类别 2 和 3。如果使用 {catmenu id="1" subcat="no"} 标记,则只显示类别 1。值为 "only "表示只显示 ID 为 "1 "的类别的子类别。如果使用 {catmenu id = "1" subcat = "only"} 标签,则只显示 ID 为 "1 "的类别的子类别。例如,您可以使用简单表达式 [available = cat] {catmenu id = "{category-id}" subcat = "only"} 自动显示已查看类别的子类别列表。[/avalilable]
template="custom" - 是用作默认菜单模板的模板名称,而不是 categorymenu.tpl
cache="yes" - 该参数取值为 "yes "或 "no",表示是否需要缓存给定块。缓存激活时,使用模板中的 [active] 文本 [/ active] 标记控制当前查看类别的强调功能将自动失效。
{catnewscount id="X"}
它显示某个类别中的文章数量,其中 X 代表所需类别的 ID。该标签适用于在手动创建的菜单模板中显示类别数量。
{category-id}
显示访问者所浏览类别的 ID。编辑文章显示模板时,当您需要快速重新分配 CSS 类或模板文件名时,此标签在组织网站菜单时非常有用。
{category-title}
显示访问者浏览的类别名称。当您需要显示正在浏览的类别名称时,此标签将非常有用。
{category-description}
当用户查看类别时,在网站上显示类别描述。在显示完整描述时也可用。
[category-description] текст [/category-description]
如果正在查看的类别有给定的类别描述,则显示其中包含的文本
[not-category-description] текст [/not-category-description]
如果类别没有描述,则显示括在其中的文本。
{category-icon}
显示用户所浏览类别的图标,如果浏览的是全文,则显示新闻类别的图标
{category-url}
显示所浏览类别的 URL
{page-title}
显示 "标题、描述、元标签 "部分指定的页面标题
{page-description}
显示 "标题、描述、元标签 "部分指定的页面描述
{page-count}
显示用户正在查看的页面的编号
[script] код [/script]
全局标签,可以使用可执行的 jаvascript 代码。在这种情况下,数据代码将直接放置在其他 DataLife Engine JS 代码的可执行块中,在加载包含时使用的其他 JS 脚本后将立即启动。因此,您可以组织模板中的所有 JS 代码,规范它们的执行顺序,避免将来出现任何冲突。
{cache-id}
输出当前缓存 ID
用户配置文件:
{profile-link} - 显示用户配置文件的链接
{profile-login} - 显示用户配置文件的链接。- 显示用户名
{ip} - 显示用户的 IP 地址。- 显示用户的 IP
{foto} 显示用户头像链接
{fullname} - 显示用户的全名
[fullname]文本[/fullname]- 如果用户配置文件中指定了用户全名,则显示标签中包含的文本
{land} - 显示用户所在国家
[land] 文字 [/land] - 如果用户资料中指定了国家,则显示标签中包含的文字
{mail}:显示用户的电子邮件地址
{group} - 显示用户的群组
{registration} - 显示用户注册日期
{lastdate} - 显示用户上次访问的日期
{group-icon}:显示用户的群组图标
{time_limit}:如果群组是临时的,则显示用户在群组中的截止日期。
[time_limit]文本[/time_limit]:如果用户在临时群组中,则显示包含在标签中的文本
{comm-num}-显示用户评论的数量
{comments} - 显示用户评论的链接
[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]--如果用户在网站上没有新闻,则显示标签中包含的文本
{new-pm}-显示用户未读的私人信息数量
{all-pm}-显示用户的私人信息总数
{favorite-count} - 显示用户收藏的帖子总数
[profile_xfvalue_X]:显示个人档案中名为 "X "的可选字段的值
[profile_xfgiven_X]文本 [/profile_xfgiven_X] - 如果在个人档案中指定了名为 "X "的可选字段,则显示包含在标签中的文本
[profile_xfnotgiven_X]文本 [/profile_xfnotgiven_X] - 如果用户配置文件中未指定名为 "X "的可选字段,则显示包含在标签中的文本
{admin-link}-如果用户可以访问管理面板,则显示该面板的链接
[admin-link] 文本 [/admin-link] - 如果用户有访问管理面板的权限,则显示包含在标签中的文本