插件介绍
帝国 CMS 自定义多值字段增强插件,扩展原生多值字段支持图片上传,后台可直接上传图片并填入多值列,无需手动填写图片地址;模板可正常循环读取图片与文本数据,满足图文混合录入场景。
功能特点
- 表格化数据录入
多值字段以表格形式呈现,支持多列多行结构化数据录入,替代原生表单,操作直观高效
- 列内图片上传
在表格列内直接点击上传图片,自动填充图片地址到对应单元格,无需手动填写或复制图片路径
- 批量图片上传
支持一次性选择多张图片批量上传,自动按顺序填充到表格行,实时显示上传进度与结果统计
- 图片预览与放大
单元格内图片显示缩略图预览,点击可查看大图,方便录入时核对图片内容
- 动态列配置
表格列数由字段配置决定,编辑时按原始行数初始化,新增时按默认行数生成空行
- 灵活行管理
支持自定义添加行数(一次可添加多行)、单行删除,满足不定量数据录入需求
- 附件自动记录
上传的图片自动写入帝国 CMS 附件表(enewsfile),与原生附件管理体系无缝集成
- 图片水印开关
上传工具栏提供"添加水印"复选框,用户可自主控制是否对上传图片打水印,勾选状态自动持久化到本地
安装插件
1、操作前请务必备份数据库及程序文件。
2、上传插件程序文件,若未修改过站点原版对应程序文件,可直接复制覆盖;若已有自定义修改,需对照插件文件手动安装
使用插件
添加插件入口
后台 → 数据表与系统模型 → 管理数据表 → 管理字段 → 新闻正文(newstext)
在「输入表单替换html代码」文本框最前面添加以下代码:
<?php
require_once(ECMS_PATH.'e/extend/multiValueFieldEnhancement/views/addNews.php');
?>
添加、修改多值字段
第一步:创建字段
后台 → 数据表与系统模型 → 管理数据表 → 管理字段 → 添加字段
- 在「多值字段元素格式」中配置列数和行数,例如
4,3表示 4 列 3 行(第1个数字=列数,第2个数字=默认行数)

- 填写其他必要信息后提交
第二步:配置输入表单
字段添加成功后,再次编辑该字段,找到「输入表单替换html代码」,将其内容替换为:
<div
data-multi-value-field="house"
data-image="2,3"
data-edit="<?= !$ecmsfirstpost ?>"
data-raw="<?= ehtmlspecialchars(stripSlashes($r['house'])) ?>"
>
</div>
各属性说明:
| 属性 | 说明 |
| `data-multi-value-field` | 多值字段名称,与字段名一致(如 `house`) |
| `data-image` | 图片列索引(从1开始),逗号分隔。标记哪些列启用图片上传功能 |
| `data-edit` | 按示例代码保持不变 |
| `data-raw` | 替换字段名称 |
配置完成后,添加/编辑信息时该字段将渲染为交互式表格,图片列支持点击上传和批量上传。
表格操作说明
表格效果
字段按「多值字段元素格式」配置的列数和行数渲染,图片列支持点击上传和批量上传。

批量上传
点击工具栏「批量上传」按钮,可一次性选择多张图片,系统自动按顺序逐行填充到图片列中,并实时显示上传进度。

图片预览
图片列显示缩略图预览,点击缩略图可放大查看大图,方便录入时核对图片内容。

卸载插件
- 删除插件目录
e/extend/multiValueFieldEnhancement
作者:fhqdgv.cn





