正在加载文档...
iCMS:config 配置标签
``` ### 注意事项 1. 配置标签获取的是系统配置数据,这些数据通常在后台管理界面设置 2. 如果指定的配置名称不存在,将返回 null 3. 如果指定的配置键名不存在,将返回 null 4. 配置数据可能是多层嵌套的数组,可以通过多次调用标签获取深层数据 5. 在模板中使用配置数据前,建议先检查数据是否存在,避免出现错误 ### 高级用法 #### 条件判断 ```html ``` #### 配置数据遍历 ```html ```iCMS 配置标签技术文档
配置标签 (config)
配置标签用于在模板中获取系统配置数据。
iCMS:config 标签
支持参数
参数名 | 类型 | 默认值 | 说明 |
---|---|---|---|
name | 字符串 | - | 配置名称 |
key | 字符串 | - | 配置键名 |
返回值
返回指定的配置数据。如果指定了 name 参数,则返回该配置组的数据;如果同时指定了 key 参数,则返回该配置组中特定键的值。
使用示例
<!-- 获取所有配置 -->
<!--{iCMS:config}-->
<!--{$config|print_r}-->
<!-- 获取站点配置 -->
<!--{iCMS:config name="site"}-->
<title><!--{$config.title}--></title>
<meta name="keywords" content="<!--{$config.keywords}-->" />
<meta name="description" content="<!--{$config.description}-->" />
<!-- 获取特定配置项 -->
<!--{iCMS:config name="site" key="title"}-->
<title><!--{$config}--></title>
常见应用场景
1. 网站头部信息配置
<!--{iCMS:config name="site"}-->
<!DOCTYPE html>
<html>
<head>
<title><!--{$config.title}--></title>
<meta charset="utf-8">
<meta name="keywords" content="<!--{$config.keywords}-->" />
<meta name="description" content="<!--{$config.description}-->" />
<link rel="icon" href="<!--{$config.favicon}-->" type="image/x-icon">
</head>
<body>
<header>
<div class="logo">
<a href="/"><img src="<!--{$config.logo}-->" alt="<!--{$config.title}-->"></a>
</div>
</header>
<!-- 页面内容 -->
</body>
</html>
2. 联系方式配置
<!--{iCMS:config name="contact"}-->
<div class="contact-info">
<h3>联系我们</h3>
<ul>
<li><i class="fa fa-phone"></i> 电话:<!--{$config.phone}--></li>
<li><i class="fa fa-envelope"></i> 邮箱:<!--{$config.email}--></li>
<li><i class="fa fa-map-marker"></i> 地址:<!--{$config.address}--></li>
</ul>
</div>
3. 社交媒体配置
<!--{iCMS:config name="social"}-->
<div class="social-links">
<h3>关注我们</h3>
<ul>
<!--{if $config.weibo}-->
<li><a href="<!--{$config.weibo}-->" target="_blank"><i class="fa fa-weibo"></i> 微博</a></li>
<!--{/if}-->
<!--{if $config.wechat}-->
<li><a href="javascript:;" class="wechat-btn"><i class="fa fa-wechat"></i> 微信
<div class="qrcode"><img src="<!--{$config.wechat_qrcode}-->" alt="微信二维码"></div>
</a></li>
<!--{/if}-->
<!--{if $config.qq}-->
<li><a href="http://wpa.qq.com/msgrd?v=3&uin=<!--{$config.qq}-->&site=qq&menu=yes" target="_blank"><i class="fa fa-qq"></i> QQ</a></li>
<!--{/if}-->
</ul>
</div>
4. 系统设置
<!--{iCMS:config name="system"}-->
<script>
var iCMS = {
COOKIE_DOMAIN: "<!--{$config.cookie_domain}-->",
COOKIE_PATH: "<!--{$config.cookie_path}-->",
URL: "<!--{$config.url}-->",
CHARSET: "<!--{$config.charset}-->",
TPLDIR: "<!--{$config.tpl_dir}-->"
};
</script>
注意事项
- 配置标签获取的是系统配置数据,这些数据通常在后台管理界面设置
- 如果指定的配置名称不存在,将返回 null
- 如果指定的配置键名不存在,将返回 null
- 配置数据可能是多层嵌套的数组,可以通过多次调用标签获取深层数据
- 在模板中使用配置数据前,建议先检查数据是否存在,避免出现错误
高级用法
条件判断
<!--{iCMS:config name="site" key="icp"}-->
<footer>
<!--{if $config}-->
<p>备案号:<!--{$config}--></p>
<!--{/if}-->
</footer>
配置数据遍历
<!--{iCMS:config name="links"}-->
<div class="links">
<h3>友情链接</h3>
<ul>
<!--{foreach key="key" value="value" from="$config"}-->
<li><a href="<!--{$value.url}-->" target="_blank"><!--{$value.name}--></a></li>
<!--{/foreach}-->
</ul>
</div>