如何在CS-Cart中为Banner新增文件上传字段及配置数据库？

你已经完成了模板层的修改，接下来需要完成数据库配置、系统模型映射和上传逻辑处理三个核心环节，具体操作如下：

1. 数据库新增字段 #

Banner模块的核心数据存储在cscart_banners表中，需要先为该表添加存储文件路径的字段。执行以下SQL语句（可通过phpMyAdmin或数据库客户端运行）：

ALTER TABLE `cscart_banners` ADD `file_upload` VARCHAR(255) NULL DEFAULT NULL AFTER `image_path`;

• 字段类型选VARCHAR(255)足够存储文件路径；如果需要支持多语言，可考虑用TEXT类型或关联多语言表。

2. 配置CS-Cart实体映射 #

CS-Cart通过Schema文件识别数据库字段，需要添加字段的映射配置：

• 打开或创建文件app/addons/banners/schemas/banners/banners.post.php
• 添加以下代码，让系统将新增字段纳入Banner实体的处理逻辑：

<?php
$schema['banners']['fields']['file_upload'] = array(
    'type' => 'varchar',
    'is_lang' => false, // 如果不需要多语言支持，保持false；反之设为true
    'default_value' => null
);

3. 处理文件上传逻辑 #

需要在Banner的后台控制器中添加上传处理代码，确保提交表单时文件能被正确上传并保存路径到数据库：

• 打开文件app/addons/banners/controllers/backend/banners.php
• 在update方法（或add方法，根据需求）中，找到处理表单提交的逻辑，添加以下代码：

// 处理文件上传
if (!empty($_FILES['banner_data']['name']['file_upload'])) {
    $upload_path = fn_get_upload_dir('banners');
    $file_name = fn_upload_file('banner_data', 'file_upload', $upload_path, true, true);
    
    if ($file_name) {
        $banner_data['file_upload'] = $file_name;
    }
}

• 这段代码会调用CS-Cart内置的fn_upload_file函数处理上传，将文件保存到Banner的上传目录，并把文件名（含路径）赋值给新增字段。

4. 完善模板字段（补充验证） #

确保你在general_content.override.tpl中添加的上传字段name属性正确，示例代码如下：

<div class="control-group">
    <label class="control-label" for="file_upload">附加文件</label>
    <div class="controls">
        <input type="file" name="banner_data[file_upload]" id="file_upload" />
        {if $banner.file_upload}
            <p class="help-block">当前文件：{$banner.file_upload}</p>
        {/if}
    </div>
</div>

5. 清理系统缓存 #

完成以上修改后，登录CS-Cart后台，依次进入管理 → 存储 → 清除缓存，清除所有类型的缓存，确保新配置和代码生效。

内容的提问来源于stack exchange，提问作者user500665