【XiunoX插件】附件下载前缀 1.1.0

管理员组

附件下载前缀插件

为论坛附件下载自动添加可配置前缀,支持自定义分隔符与实时预览,下载时自动应用规则。

功能概述

  • 用户下载附件时,系统自动在原文件名前拼接管理员配置的前缀

  • 仅修改下载时的输出文件名,不改动服务器存储的源文件名称与路径

  • 支持两种前缀格式:

    • 包装模式:括号包裹前缀,如 【前缀名】文件名.rar[前缀名]文件名.rar

    • 分隔符模式:分隔符连接,如 前缀名_文件名.rar前缀名-文件名.rar

  • 自动过滤前缀中的非法文件名字符(\ / : * ? " < > |)

  • 后台实时预览最终下载文件名效果

  • 配置即时生效,无需清理缓存

安装与卸载

安装

  1. navgcn_attach_prefix 目录上传至 plugin/ 目录

  2. 进入后台 → 插件管理 → 找到「附件下载前缀插件」→ 点击安装

  3. 安装完成后,插件默认前缀为空,不影响现有下载功能

卸载

  1. 进入后台 → 插件管理 → 找到「附件下载前缀插件」→ 点击卸载

  2. 卸载将清除所有插件配置数据,不影响附件文件

后台配置

  1. 进入后台 → 插件管理 → 附件下载前缀插件 → 设置

  2. 下载前缀:输入前缀内容,支持中文、英文、数字及常规符号

  3. 包装样式:选择是否用括号包裹前缀(如 【前缀名】[前缀名]),选择"无包装"则使用分隔符

  4. 分隔符:无包装时,选择前缀与文件名之间的分隔符,支持自定义输入

  5. 效果预览:实时展示当前配置下的下载文件名效果

  6. 点击「保存设置」即时生效

注意事项

  • 前缀为空时,附件下载保持原始文件名,不影响论坛正常下载功能

  • 前缀中的非法文件名字符(\ / : * ? " < > |)会自动过滤

  • 分隔符若选择「自定义」,需在右侧输入框中填写自定义分隔符

  • 选择包装样式后,分隔符设置自动隐藏(包装模式下不使用分隔符)

  • 仅拥有管理权限的用户(gid=1 或 gid=2)可访问配置页面

常见问题

Q: 配置前缀后,旧附件下载是否也会生效? A: 是的,配置即时生效,所有附件下载(包括旧附件)都会自动应用前缀规则。

Q: 前缀是否会影响服务器上存储的文件? A: 不会,仅修改下载时浏览器收到的文件名(Content-Disposition 头),服务器存储的源文件名称和路径完全不变。

Q: 支持哪些下载方式? A: 同时支持附件下载(attach-download)和附件提取(attach-fetch)两种方式。

更新日志

v1.0.0 (2026-07-23)

  • 初始版本发布

  • 支持下载文件名自动添加前缀

  • 支持两种前缀格式:包装模式(【前缀】文件名)和分隔符模式(前缀_文件名)

  • 支持多种分隔符选择与自定义输入

  • 后台实时预览效果

  • 自动过滤非法文件名字符

最新回复

请先登录后再回复 登录

uid:1 管理员组
关注
这个人很懒,什么都没留下来...
发帖 13
评论 48
粉丝 0
关注 2
发新帖
目录
【XiunoX插件】附件下载前缀 1.1.0