iCMS 配置与应用标签技术文档

配置标签 (ConfigFunc)

配置标签用于获取系统配置数据，支持获取整个配置或指定键值。

config:get 标签

获取系统配置数据。

支持参数

返回数据结构

根据配置的不同，返回的数据结构也不同，可能是数组或单个值。

使用示例

<!-- 获取整个站点配置 -->
<!--{iCMS:config:get name='site'}-->
<!--{$config_get.title}--> <!-- 输出网站标题 -->
<!--{$config_get.url}--> <!-- 输出网站URL -->

<!-- 获取指定配置项 -->
<!--{iCMS:config:get name='site' key='title'}-->
<!--{$config_get}--> <!-- 直接输出网站标题 -->

<!-- 获取多个指定配置项 -->
<!--{iCMS:config:get name='site' keys='title,url,icp'}-->
<!--{$config_get.title}--> <!-- 输出网站标题 -->
<!--{$config_get.url}--> <!-- 输出网站URL -->
<!--{$config_get.icp}--> <!-- 输出备案信息 -->

常用配置示例

站点配置

<!--{iCMS:config:get name='site'}-->
<title><!--{$config_get.title}--></title>
<meta name="keywords" content="<!--{$config_get.keywords}-->" />
<meta name="description" content="<!--{$config_get.description}-->" />

模块配置

<!--{iCMS:config:get name='article'}-->
<!--{if $config_get.enable}-->
  <!-- 文章模块已启用 -->
<!--{else}-->
  <!-- 文章模块已禁用 -->
<!--{/if}-->

应用标签 (AppsFunc)

应用标签用于获取系统中的应用列表数据。

apps:list 标签

获取应用列表数据。

支持参数

返回数据结构

[
    [
        'id' => 应用ID,
        'app' => 应用标识,
        'name' => 应用名称,
        'title' => 应用标题,
        'apptype' => 应用类型,
        'type' => 应用分类,
        'status' => 状态,
        'config' => [应用配置],
        'fields' => [应用字段],
        'addtime' => 添加时间,
        'table' => 数据表名
    ],
    // 更多应用...
]

使用示例

<!--{iCMS:apps:list apptype='1' cache='1'}-->
  <div class="app-item">
    <h3><!--{$apps_list.name}--></h3>
    <p><!--{$apps_list.title}--></p>
    <p>应用类型: <!--{$apps_list.apptype}--></p>
    <p>添加时间: <!--{$apps_list.addtime|date:'Y-m-d H:i:s'}--></p>
  </div>
<!--{/iCMS}-->

应用类型说明

常见应用场景

获取所有内容应用

  <div class="content-apps">
    <h2>内容应用列表</h2>
    <ul>
        <!--{iCMS:apps:list apptype='1' cache='1'}-->
        <li>
          <strong><!--{$apps_list.name}--></strong>: <!--{$apps_list.title}-->
        </li>
        <!--{/iCMS}-->
    </ul>
  </div>

获取所有分类应用

  <div class="category-apps">
    <h2>分类应用列表</h2>
    <ul>
      <!--{iCMS:apps:list apptype='2' cache='1'}-->
        <li>
          <strong><!--{$apps_list.name}--></strong>: <!--{$apps_list.title}-->
        </li>

      <!--{/iCMS}-->
    </ul>
  </div>

最佳实践

配置与应用结合使用

<!-- 获取文章应用配置 -->
<!--{iCMS:config:get name='article'}-->
<!--{if $config_get.enable}-->
  <!-- 获取文章应用信息 -->
  <!--{iCMS:apps:list app='article' row='1' cache='1'}-->
    <!--{if $apps_list}-->
      <div class="article-app-info">
        <h2>文章应用信息</h2>
        <p>应用名称: <!--{$apps_list.0.name}--></p>
        <p>应用标题: <!--{$apps_list.0.title}--></p>
        <p>应用状态: <!--{$apps_list.0.status}--></p>
      </div>
    <!--{/if}-->
  <!--{/iCMS}-->
<!--{/if}-->

性能优化建议

1. 合理使用缓存

   <!--{iCMS:apps:list cache='1' time='3600'}-->

   ⚠️ 应用列表数据变动不频繁，可以设置较长的缓存时间。

2. 按需获取配置

   只获取需要的配置项，减少数据处理：

   <!--{iCMS:config:get name='site' keys='title,url,keywords,description'}-->

调试技巧

1. 开启调试模式

   <!--{iCMS:apps:list db_debug='1'}-->

2. 查看SQL语句

   <!--{$apps_list_sql}-->

3. 输出变量结构

   <!--{$config_get|print_r}-->

注意事项

1. 配置安全

   ⚠️ 不要在前台模板中输出敏感配置信息，如数据库连接信息、邮箱密码等。

2. 应用状态检查

   在使用应用相关功能前，应先检查应用是否启用：

   <!--{iCMS:config:get name='article'}-->
   <!--{if $config_get.enable}-->
     <!-- 文章功能已启用 -->
   <!--{else}-->
     <!-- 文章功能已禁用 -->
   <!--{/if}-->

3. 缓存更新

   当配置或应用信息更新后，需要清除相关缓存。