剑侠批量本地音乐播放器（JxPlayer）v4.0.0-ZBlogPHP原创插件

【插件介绍】

为 Z-BlogPHP 站点装上「会听歌、能互动」的左下角悬浮中枢——歌单、留言、签到、外链，

后台一站式配置，前台即装即用，让资源站、博客、社区站立刻更有氛围与粘性。

【产品定位】

  · 不是单一 MP3 播放器，而是「前台体验增强套件」：音乐 + 会员留言 + 可扩展悬浮菜单。

  · 面向希望提升停留时长、互动反馈与品牌感的站长，无需改主题、无需写代码。

  · 本地曲库与外链音频并存，适合教程站、素材站、个人博客、源码下载站等场景。

  · 与剑侠用户系统（签到）可联动，形成「听曲—签到—留言」的闭环运营触点。

【核心卖点】

  ✦ 左下角悬浮胶囊菜单，可拖拽贴边、自动收起，不挡正文阅读

  ✦ 批量上传本地 MP3/WAV/OGG/M4A，一键扫描 music 目录同步歌单

  ✦ 支持外链音频，MP3 可读取 ID3 歌名/歌手，列表展示更专业

  ✦ 真实播放满 10 秒才计次，后台可看每首歌播放次数并排序

  ✦ 内置会员留言面板：分类、频率限制、后台查看与邮件回复入口

  ✦ 悬浮菜单可自由组合：音乐 / 留言 / 签到 / 自定义链接，支持 iconfont

  ✦ 独立后台管理界面，与 Z-Blog 后台风格统一，上手零学习成本

  ✦ 兼容旧版 MyPlayer 数据迁移，老站升级不换配置

【前台体验】

  · 悬浮主按钮：Emoji 或 iconfont 矢量图标，可自定义背景色

  · 音乐面板：歌单搜索、切歌、进度与音量记忆、当前曲目高亮

  · 留言面板：登录后提交，自动带出昵称与邮箱；未登录引导登录

  · 签到入口：对接剑侠用户系统时可一键签到（可选）

  · 自定义菜单项：外链、新窗口、仅登录可见、排序与配色

  · 整体 UI 暗色霓虹风格，适配多数主题，移动端可用

【音乐管理（后台）】

  · 批量上传多首音频到插件目录

  · 「同步音乐」：扫描文件夹自动写入列表，MP3 尝试读取标签显示「歌名-歌手」

  · 列表试听、按时间/大小/播放次数排序、关键词搜索

  · 单删 / 批删、删除本地文件同步清理

  · 失效本地记录自动 prune，避免删文件后列表残留

  · 原始数据文本框：每行「地址|歌名」，方便批量维护与外链混排

  · 可选自动播放；支持「同步前台」刷新缓存

【留言反馈（后台）】

  · 自定义面板标题与反馈分类（一行一个）

  · 提交限制：最短间隔、每日次数、最少字数（0 为不限制）

  · 留言列表倒序展示，批量删除，一键 mailto 回复

  · 同邮箱仅提交一次、同 IP 时间窗限流，减轻刷留言

【前台开关（后台）】

  · 总开关：启用/关闭整个悬浮菜单

  · 仅登录用户可见（整组菜单）

  · 子菜单项：类型（音乐/留言/签到/链接）、图标、文案、背景色、排序

  · 支持 iconfont 在线 CSS + class，打造站点专属图标体系

【技术亮点】

  · 纯 PHP + 前端原生 JS，无重型依赖，对服务器压力小

  · 配置写入 Z-Blog 插件配置表，升级站点可平滑迁移旧 MyPlayer 数据

  · 播放统计、留言数据独立存储，逻辑清晰、便于备份

  · 适配 PHP 5.6+ / 现代 PHP 8 环境（已处理配置读取与迁移兼容）

【适用场景举例】

  · 源码/素材站：边浏览边听歌，播放数据辅助判断热门资源

  · 个人博客：营造氛围 BGM + 读者留言反馈通道

  · 教程/文档站：长文阅读不枯燥，外链音频与本地曲库混用

  · 会员社区站：悬浮菜单聚合签到、音乐、反馈，提高日活触点

【环境要求】

  · Z-BlogPHP（建议较新版本）

  · PHP 5.6 及以上，开启常规文件上传

  · 可选：剑侠用户系统（用于签到菜单项）

================================================================================

源码官网：https://www.jianxiaym.com/

版本信息：剑侠批量本地音乐播放器 v4.0.0

Copyright © 剑侠君 All Rights Reserved.

================================================================================