标签&函数

样式引入

{$bd.sitetplpath}

//例如:引入bootstrap样式<link href="{$bd.sitetplpath}/static/css/bootstrap.css" type="text/css" rel="stylesheet" />//例如:引入jQuery<script src="{$bd.sitetplpath}/static/js/jQuery-2.2.4.js" type="text/javascript"></script>

模板引用

//例如:引入头部文件{include file="comm/head" /}

首页链接

#可以直接使用 /<a href="/">首页</a>#使用函数<a href="{:url('/')}">首页</a>#2.1.1新增<a href="{$bd.homeurl}">首页</a>

语言包

开发多语言网站时，可以将常用的文字放进语言包内。

语言包的位置：app/index/lang/zh-cn/cms

其中zh-cn对应中文语言包,英文语言包则为en

# 语言包调用函数 __('Home') 模版中的写法 {:__('Home')}<a href="/">{:__('Home')}</a>

HTML 转实体

模版中的变量默认都会被这个函数转义，防止 XSS 攻击

htmlspecialchars

//  例如：html字段//  "<p>转义之前 </p>"//  "<p>转义之后 </p>"{$item.html|htmlspecialchars}

实体转 HTML

可以将模版中的变量还原成 HTML 格式,不过需要注意 XSS 安全问题，需要根据实际情况使用

html_entity_decode

//  例如：html字段//  "<p>转义之前 </p>"//  "<p>转义之后 </p>"{$item.html|html_entity_decode}

时间格式化

date='Y-m-d H:i:s'

//例如：crate_time字段{$item.crate_time|date='Y-m-d H:i:s'}

HTML 去除

drophtml

//例如：去掉内容的html{$content.content|drophtml}

内容截取

bd_substr=0,10

//参数1：开始截取的位置，第一个就写0//参数2：截取的长度{$content.content|bd_substr=0,10}

自定义标签

{$bd.xx变量}

站点地图

{$bd.sitemap}

<a href="{$bd.sitemap}">{:__('Sitemap')}</a>

搜索路径

{$bd.scaction}

<form method="get" action="{$bd.scaction}">    <input name="keyword"  type="text">    <button>搜索</button></form>

验证码地址

{$bd.checkcode}

<img src="{$bd.checkcode}" width="100" height="31"/>

面包屑

#默认{bd:position  /}#自定义属性{bd:position separator='>>' separatoricon='fa fa-angle-double-right' indextext='首页' indexicon='fa fa-home' /}

当前网址

{$bd.httpurl}

当前页面

{$bd.pageurl}

二维码生成

{bd:qrcode string=***}

分割字符串成数组

explode(分隔符，字符串)

比如：在调用多图时，多图存储的是以逗号分隔的字符串，这时就需要将字符串分割成数组再进行遍历

#原字符串"/uploads/20251118/9237jpg,/uploads/20251118/b43aef.jpg"#分割字符串explode(',',$content.pics)# 完整调用{foreach :explode(',',$content.pics) as $pic}

<img src="{$pic}" />

{/foreach}

JSON转换为数组

json_decode(字符串，true)

比如：使用自定义字段使用了数组格式，存储时是以字符串存储的，这时就需要将json转换为数组进行遍历

#原字符串"[{"key":"键名","value":"键值"},{"key":"键名","value":"键值"}]"#转换成数组json_decode(字符串,true)# 完整调用{foreach :json_decode($content['ext_arr'],true) as $arr}

{$arr.key}

{$arr.value}

{/foreach}

获取数组中指定元素的值

支持版本 >= v2.1.1

/**

 * 获取数组中指定元素的值

 * @param mixed $array  数组

 * @param mixed $index  下标（默认为0）

 */array_to_value($array,$index)// 比如获取第二logo{$bd.logo2|array_to_value}