自定义模型创建后前台不显示，如何快速排查？
昨天刚给客户建了一个“产品评测”模型，数据都录入好了，结果前台死活不显示，这种问题我遇到过不下十次,排查路径其实很固定。
第一步：检查模型是否绑定栏目 进入“系统” -> “模型管理” -> 找到你的自定义模型，点击“绑定栏目”，如果模型没有绑定任何栏目,前台当然不会显示。
第二步：检查栏目设置 进入“栏目管理”，编辑对应栏目,确认：
- 栏目类型选择的是“模型列表”
- 绑定的模型确实是你的自定义模型
- 栏目状态为“显示”
第三步：检查模板调用 在列表模板中,需要明确指定模型ID：
帝国CMS二次开发，数据表同步与模板调用的深度实战指南
[e:loop={"select * from [!db.pre!]ecms_product where checked=1 order by id desc",10,24,0}]
<li><a href="<?=$bqsr[titleurl]?>"><?=$bqr[title]?></a></li>
[/e:loop]
关键参数：最后一个数字“24”就是模型ID，如果你不知道模型ID，去“模型管理”页面，鼠标悬停在模型名称上，浏览器状态栏会显示?mid=24。
灵动标签SQL调用的正确写法
灵动标签(e:loop)的本质是封装了数据库查询,但很多开发者写SQL时容易犯低级错误。
错误示例：
[e:loop={"select * from phome_ecms_article where classid=1",10,24,0}]
正确写法：
[e:loop={"select * from [!db.pre!]ecms_article where classid='1' and checked=1 order by id desc",10,24,0}]
四个参数含义：
- 参数1：SQL查询语句（表名前务必加
[!db.pre!]） - 参数2：调用条数
- 参数3：模型ID
- 参数4：操作类型（0普通列表，1分页，2下拉,3上下篇）
高级用法：多表联查
[e:loop={"select a.*,b.titlepic from [!db.pre!]ecms_article a left join [!db.pre!]ecms_article_data_1 b on a.id=b.id where a.classid in(1,2,3) group by a.id order by a.newstime desc",8,24,0}]
注意：使用group by时，要确保所有select的字段都在group by中或使用了聚合函数。
列表模板和内容模板变量调用方法深度解析
很多新手分不清列表页和内容页的变量体系,导致调用数据张冠李戴。
列表模板变量（$bqr）：
发布时间：<?=$bqr[newstime]?>
所属栏目：<?=$bqr[classname]?>
自定义字段：<?=$bqr[my_author]?>模板变量（$navinfor）：**
相关链接：<?=$navinfor[titleurl]?>重要区别： 列表模板中$bqr只能获取主表字段,要获取附表字段必须用以下技巧：
<?php
$r=$empire->fetch1("select * from [!db.pre!]ecms_article_data_".$bqr[mid]." where id='$bqr[id]'");
echo $r[my_field]; //自定义附表字段
?>
万能标签与智能标签的区别及选择策略
我见过太多开发者在这两个标签上纠结,其实逻辑很简单。
万能标签(e:万能标签)：
- 原理：直接执行SQL语句
- 优点：灵活，支持任意查询
- 缺点：需要懂SQL，容易写错
- 适用场景：复杂查询、多表联查、需要排序或条件过滤
[e:万能标签]select * from [!db.pre!]ecms_article where classid in(1,2) and firsttitle=1 order by id desc limit 0,5[/e:万能标签]
智能标签(e:智能标签)：
- 原理：通过参数配置生成SQL
- 优点：傻瓜式操作，无需写SQL
- 缺点：灵活性受限
- 适用场景：简单列表、翻页、热门排行
[e:loop={"select * from [!db.pre!]ecms_article where checked=1",5,24,0}]
我的选择原则：
- 只需要简单调文章列表 -> 智能标签
- 需要按特定字段排序、多表联查、条件筛选 -> 万能标签
- 需要在非内容模型页面调用数据 -> 万能标签
全站搜索配置与自定义字段索引
客户反映“产品颜色”这个自定义字段搜不到,排查发现帝国CMS默认只索引主表字段。
解决步骤：
-
确认字段索引设置 进入“系统” -> “数据表管理” -> 选择你的模型数据表 -> 查看字段属性，确保自定义字段的“检索”选项为“是”。
-
重建搜索索引 进入“系统” -> “数据更新” -> “批量更新数据索引” -> 选择对应模型并执行。
-
修改搜索模板 在
/e/search/result/index.php中找到搜索SQL：$query="select * from [!db.pre!]ecms_".$tbname." where 1=1"; // 添加自定义字段搜索条件 if($keyboard){ $query.=" and (title like '%$keyboard%' or my_color like '%$keyboard%' or my_brand like '%$keyboard%')"; } -
优化搜索性能 如果数据量大,建议对自定义字段建立索引：
ALTER TABLE [!db.pre!]ecms_product_data_1 ADD INDEX idx_color (my_color);
模板中调用附表字段的实现技巧
这是帝国CMS开发中最容易踩坑的地方，主表存储高频字段，附表存储大文本和自定义字段，在列表页直接$bqr[my_field]是取不到值的。
实时查询（推荐小站点）
<?php
//在列表模板循环中
$data_r=$empire->fetch1("select * from [!db.pre!]ecms_article_data_".$bqr[mid]." where id='$bqr[id]'");
$my_value=$data_r['my_field'];
?>
<div>自定义字段：<?=$my_value?></div>
预查询优化（推荐大数据量） 在列表模板开头先批量查询：
<?php
$ids=array();
// 先收集所有ID
while($r=$empire->fetch($sql)){
$ids[]=$r['id'];
}
// 批量查询附表
if(!empty($ids)){
$id_str=implode(',',$ids);
$data_sql=$empire->query("select * from [!db.pre!]ecms_article_data_".$mid." where id in($id_str)");
$data_arr=array();
while($dr=$empire->fetch($data_sql)){
$data_arr[$dr['id']]=$dr;
}
}
// 在循环中直接取
$my_field_value=$data_arr[$bqr['id']]['my_field'];
?>
利用帝国自带函数
<?=sys_ReturnAddFieldData($bqr['mid'],'my_field',$bqr['id'])?>
这个函数会自动判断是否附表字段并查询,但频繁调用会影响性能。
数据表同步的核心在于理解帝国CMS的“主表+附表”架构，主表负责标题、时间等高频查询字段，附表存放正文、自定义字段,任何跨表操作都要考虑性能问题。
最后给各位同行一个建议：在二次开发时，尽量在模型设计阶段就明确哪些字段放主表、哪些放附表，主表字段控制在15个以内，附表字段按业务模块分组,这样能避免后期大量联表查询的性能噩梦。
