iCMS:config 配置标签

# iCMS 配置标签技术文档

## 配置标签 (config)

配置标签用于在模板中获取系统配置数据。

### iCMS:config 标签

#### 支持参数

| 参数名 | 类型   | 默认值 | 说明     |
| ------ | ------ | ------ | -------- |
| name   | 字符串 | -      | 配置名称 |
| key    | 字符串 | -      | 配置键名 |

#### 返回值

返回指定的配置数据。如果指定了 name 参数，则返回该配置组的数据；如果同时指定了 key 参数，则返回该配置组中特定键的值。

#### 使用示例

```html

<title></title>
<meta name="keywords" content="" />
<meta name="description" content="" />

<title></title>
```

### 常见应用场景

#### 1. 网站头部信息配置

```html

<!DOCTYPE html>
<html>
<head>
  <title></title>
  <meta charset="utf-8">
  <meta name="keywords" content="" />
  <meta name="description" content="" />
  <link rel="icon" href="" type="image/x-icon">
</head>
<body>
  <header>
    <div class="logo">
      <a href="/"><img src="" alt=""></a>
    </div>
  </header>
  
</body>
</html>
```

#### 2. 联系方式配置

```html

<div class="contact-info">
  <h3>联系我们</h3>
  <ul>
    <li><i class="fa fa-phone"></i> 电话：</li>
    <li><i class="fa fa-envelope"></i> 邮箱：</li>
    <li><i class="fa fa-map-marker"></i> 地址：</li>
  </ul>
</div>
```

#### 3. 社交媒体配置

```html

<div class="social-links">
  <h3>关注我们</h3>
  <ul>
    
    <li><a href="" target="_blank"><i class="fa fa-weibo"></i> 微博</a></li>
    
    
    <li><a href="javascript:;" class="wechat-btn"><i class="fa fa-wechat"></i> 微信
      <div class="qrcode"><img src="" alt="微信二维码"></div>
    </a></li>
    
    
    <li><a href="http://wpa.qq.com/msgrd?v=3&uin=&site=qq&menu=yes" target="_blank"><i class="fa fa-qq"></i> QQ</a></li>
    
  </ul>
</div>
```

#### 4. 系统设置

```html

<script>
var iCMS = {
  COOKIE_DOMAIN: "",
  COOKIE_PATH: "",
  URL: "",
  CHARSET: "",
  TPLDIR: ""
};
</script>
```

### 注意事项

1. 配置标签获取的是系统配置数据，这些数据通常在后台管理界面设置
2. 如果指定的配置名称不存在，将返回 null
3. 如果指定的配置键名不存在，将返回 null
4. 配置数据可能是多层嵌套的数组，可以通过多次调用标签获取深层数据
5. 在模板中使用配置数据前，建议先检查数据是否存在，避免出现错误

### 高级用法

#### 条件判断

```html

<footer>
  
  <p>备案号：</p>
  
</footer>
```

#### 配置数据遍历

```html

<div class="links">
  <h3>友情链接</h3>
  <ul>
    
    <li><a href="" target="_blank"></a></li>
    
  </ul>
</div>
```

最后更新 2025-03-07 17:14.

iCMS:cahce 缓存标签

iCMS:debug 调试标签