附件下载前缀插件
为论坛附件下载自动添加可配置前缀,支持自定义分隔符与实时预览,下载时自动应用规则。
功能概述
用户下载附件时,系统自动在原文件名前拼接管理员配置的前缀
仅修改下载时的输出文件名,不改动服务器存储的源文件名称与路径
支持两种前缀格式:
包装模式:括号包裹前缀,如
【前缀名】文件名.rar、[前缀名]文件名.rar分隔符模式:分隔符连接,如
前缀名_文件名.rar、前缀名-文件名.rar
自动过滤前缀中的非法文件名字符(\ / : * ? " < > |)
后台实时预览最终下载文件名效果
配置即时生效,无需清理缓存
安装与卸载
安装
将
navgcn_attach_prefix目录上传至plugin/目录进入后台 → 插件管理 → 找到「附件下载前缀插件」→ 点击安装
安装完成后,插件默认前缀为空,不影响现有下载功能
卸载
进入后台 → 插件管理 → 找到「附件下载前缀插件」→ 点击卸载
卸载将清除所有插件配置数据,不影响附件文件
后台配置
进入后台 → 插件管理 → 附件下载前缀插件 → 设置
下载前缀:输入前缀内容,支持中文、英文、数字及常规符号
包装样式:选择是否用括号包裹前缀(如
【前缀名】、[前缀名]),选择"无包装"则使用分隔符分隔符:无包装时,选择前缀与文件名之间的分隔符,支持自定义输入
效果预览:实时展示当前配置下的下载文件名效果
点击「保存设置」即时生效
注意事项
前缀为空时,附件下载保持原始文件名,不影响论坛正常下载功能
前缀中的非法文件名字符(\ / : * ? " < > |)会自动过滤
分隔符若选择「自定义」,需在右侧输入框中填写自定义分隔符
选择包装样式后,分隔符设置自动隐藏(包装模式下不使用分隔符)
仅拥有管理权限的用户(gid=1 或 gid=2)可访问配置页面
常见问题
Q: 配置前缀后,旧附件下载是否也会生效? A: 是的,配置即时生效,所有附件下载(包括旧附件)都会自动应用前缀规则。
Q: 前缀是否会影响服务器上存储的文件? A: 不会,仅修改下载时浏览器收到的文件名(Content-Disposition 头),服务器存储的源文件名称和路径完全不变。
Q: 支持哪些下载方式? A: 同时支持附件下载(attach-download)和附件提取(attach-fetch)两种方式。
更新日志
v1.0.0 (2026-07-23)
初始版本发布
支持下载文件名自动添加前缀
支持两种前缀格式:包装模式(【前缀】文件名)和分隔符模式(前缀_文件名)
支持多种分隔符选择与自定义输入
后台实时预览效果
自动过滤非法文件名字符