作者:手机用户2502901925 | 来源:互联网 | 2024-12-22 20:00
本文详细介绍了SDCMS中的全局标签和循环标签。全局标签是在任何模板页面中均可调用的标签,而循环标签用于数据查询和展示。文章解释了这些标签的功能、使用方法及参数配置。
一、全局标签概述
全局标签是指可以在SDCMS系统内所有模板页面中直接使用的标签,无需额外配置或限定条件。
{webroot}
: 系统根路径,用于指向网站根目录。{weburl}
: 完整的网站URL地址。{webmode}
: 表示当前系统的运行模式(1为动态模式,2为伪静态模式,3为纯静态模式)。{htmldir}
: 在静态化模式下,指定生成HTML文件存放的目录。{sdcms[webname]}
: 显示网站名称。{sdcms[seotitle]}
: 设置SEO优化标题。{sdcms[seokey]}
: 指定SEO关键字。{sdcms[seodesc]}
: 描述SEO内容摘要。{sdcms[webicp]}
: 展示ICP备案信息。{sdcms[webcount]}
: 引入第三方流量统计代码。
二、特殊字段调用
除了上述标准全局标签外,还可以通过特定格式访问sd_config
表中的任意记录值,例如:{sdcms[agreement]}
可以获取设置键名为“agreement”的值。这里的agreement
可以根据需要替换为其他字段名。
三、循环标签介绍
循环标签允许开发者从数据库中提取并呈现多条记录的数据。其基本语法如下:
{sdcms:rs top="数量" field="字段列表" table="表名" group="分组依据" where="筛选条件" order="排序规则" var="变量定义" auto="自增标识" pagesize="每页条目数" iscache="缓存选项" isadminurl="HTML模式控制"}
{rs:eof}无结果时显示的内容{/rs:eof}
{$rs[字段1]} {$rs[字段2]}
{/sdcms:rs}
各参数说明:
参数 | 示例 | 描述 |
rs | rs | 每个循环体内的唯一标识符。 |
top | top="10" | 限制返回的最大记录数,默认为10;设为0则不限制。 |
field | field="id,title" | 指定要查询的字段,多个字段间用逗号分隔;留空表示查询所有字段。 |
table | table="sd_content" | 必填项,指明要查询的具体数据库表。 |
group | group="createdate,id" | 按指定字段进行分组聚合操作。 |
where | where="islock=1" | 设置SQL查询语句中的WHERE子句,用于过滤数据。 |
order | order="hits desc,id desc" | 确定记录的排序方式,支持多列排序。 |
var | var="sonid:id" | 创建一个新变量,并赋值为指定字段的内容。 |
auto | auto="j" | 提供一个自动递增的计数器,默认从1开始。 |
pagesize | pagesize="20" | 设定分页大小,即每页显示多少条记录。 |
iscache | iscache="true" | 是否开启缓存功能,默认关闭。 |
isadminurl | isadminurl="0" | 是否强制输出为HTML链接形式,默认启用。 |
四、注意事项
在编写循环标签时,请确保所有的rs
标记保持一致,否则可能导致解析错误。