- 在后台为内容模型添加新字段:定义字段名、类型等。
- 修改模板文件:在前台发布页和内容页中调用这个新字段。
下面我将为你提供详细的图文步骤说明。

(图片来源网络,侵删)
第一步:在后台添加附件字段
假设我们要给“文章”模型(通常是 article)添加一个名为 source_file 的附件字段。
进入字段管理
- 登录你的DedeCMS后台。
- 在顶部菜单栏,找到 【系统】 -> 模型管理】,模型管理页面,找到你想要修改的模型,【普通文章】,点击后面的 【字段管理】。
添加新字段
-
进入字段管理页面后,点击右上角的 【添加新字段】 按钮。
-
在弹出的字段编辑页面中,填写以下信息:
- 字段名称:这是在数据库中存储的字段名,建议使用英文或拼音,
source_file。注意: 这是你之后在模板中调用的标识符,务必记好。 - 字段别名:这是在后台发布页面显示给用户看的名称,
源文件下载或相关附件。 - 字段类型:这是最关键的一步! 请选择 【附件】。
- 字段长度:附件字段的长度通常不需要修改,保持默认即可。
- 默认值:可以留空。
- 字段的提示信息:在后台发布页面,当鼠标悬停或点击字段时显示的提示文字,请上传相关的源文件或资料”。
- 是否为必填项:根据你的需求选择,如果必须上传则勾选。
- 是否为纯文本:附件字段无需勾选。
- 在列表页(内容模板)显示:选择“是”,这样你就可以在文章列表中显示这个附件的下载链接。
- 会员投稿是否使用:根据需要选择。
- 字段名称:这是在数据库中存储的字段名,建议使用英文或拼音,
-
填写完毕后,点击 【保存】 按钮。
(图片来源网络,侵删)
至此,后台的字段添加工作已经完成,你现在可以去 【核心】 -> 发布管理】 -> 【添加文档】 中,选择“普通文章”模型,你应该能看到新添加的“源文件下载”字段了。
第二步:修改模板文件以调用字段
后台添加了字段,但前台页面还无法显示,你需要修改两个地方的模板:
- 发布页模板:让用户可以上传附件。
- 内容页模板:让访客可以下载附件。
修改发布页模板
发布页模板通常位于 /templets/plus/post_article.htm。
-
用FTP或文件管理器打开这个文件。
(图片来源网络,侵删) -
找到你希望放置上传附件控件的位置(比如在“文章内容”编辑框下方)。
-
在该位置添加以下代码:
<tr> <td height="25" align="right">源文件下载:</td> <td> <input type="file" name="source_file" id="source_file" class="alltxt" style="width:250px" /> {dede:field.source_file function='GetAttachment(@me)'/} </td> </tr>代码解释:
name="source_file":这里的source_file必须和你在后台添加的字段名称完全一致。id="source_file":与name保持一致,方便JavaScript调用。{dede:field.source_file function='GetAttachment(@me)'/}:这是DedeCMS的调用标签。{dede:field.source_file/}会直接输出附件的路径,而function='GetAttachment(@me)'会将其转换成一个完整的下载链接,格式通常是<a href="附件地址">附件名</a>。强烈推荐使用这种方式。
-
保存文件并上传回服务器,现在用户在发布文章时就可以上传附件了。
页模板
页模板通常位于 /templets/default/article_article.htm(具体路径取决于你使用的模板)。
-
打开你的文章内容页模板文件。
-
找到你希望显示附件下载链接的位置(比如文章标题下方、正文上方或下方)。
-
添加以下调用代码:
{dede:field.source_file function='GetAttachment(@me)'/}代码解释:
- 这行代码会直接输出后台转换好的下载链接,如果该文章没有上传附件,则什么都不显示。
- 如果你想要更美观或更可控的显示,可以使用
if判断:
{dede:field.source_file runphp='yes'} if(@me != ''){ @me = '<div class="source-file"><strong>相关附件:</strong> '.GetAttachment(@me).'</div>'; }else{ @me = ''; } {/dede:field.source_file}这段代码的意思是:
source_file字段不为空,就输出一个带有样式的div容器和下载链接;如果为空,则什么都不输出。 -
保存文件并上传。
第三步:清理缓存并测试
- 清理缓存:在DedeCMS后台,进入 【系统】 -> 【一键更新网站】 -> 更新缓存,确保所有模板缓存都被刷新。
- 测试:
- 前往网站前台,发布一篇新文章,尝试上传一个附件,然后保存。
- 进入文章内容页,检查是否显示了下载链接。
- 点击下载链接,检查是否能正常下载文件。
常见问题与注意事项
- 字段名大小写:DedeCMS的字段名通常是区分大小写的,请确保所有地方的调用都与后台定义的完全一致。
- 权限问题:确保你的网站目录(
/uploads/等)有正确的写入权限,否则附件无法上传。 - 前台无法上传:检查发布页模板中的
name属性是否正确,以及是否启用了会员投稿功能。 - 附件下载路径错误:如果下载链接指向的地址不对,可以检查后台的“附件设置”,确保附件保存目录和访问URL配置正确。
通过以上三个步骤,你就可以成功地为DedeCMS添加并使用一个附件字段了。
