zb-wp-Music

插件简介

zb-wp-Music 是一款优雅且功能丰富的 Zb-Wp 音乐播放器插件，为您的网站提供流畅、精美的音乐播放体验。

主要功能

1. 音乐播放器

• 支持播放/暂停、上一首/下一首切换
• 三种循环模式：单曲循环、列表循环、不循环
• 随机播放功能
• 实时进度条显示，可拖动调整播放进度
• 平滑的动画过渡效果

2. 歌词显示

• 支持 LRC 格式歌词文件
• 自动滚动歌词，当前播放行高亮显示
• 兼容 GBK 和 UTF-8 编码的歌词文件

3. 界面设计

• 响应式设计，完美适配 PC 和移动端
• 明暗主题切换，适配不同用户喜好
• 半透明毛玻璃视觉效果
• 背景图片动态渲染，提升美观度

4. 播放列表管理

• 可折叠式播放列表，便捷管理音乐条目
• 支持添加、删除、编辑音乐
• 显示当前播放列表的总曲目数

安装要求

• WP 版本：5.0 及以上
• PHP 版本：7.0 及以上
• 兼容现代主流浏览器

使用指南

1. 后台设置

1. 进入 WP 后台
2. 在左侧菜单找到 “音乐播放器” 选项
3. 点击 “添加音乐” 按钮，新增音乐条目
4. 填写以下音乐信息：
   • 歌曲标题（必填）
   • 音乐 URL（必填，支持 MP3/WAV/OGG 格式）
   • 歌词 URL（可选，仅支持 LRC 格式）
5. 点击 “保存更改” 按钮完成设置

2. 前台使用

• PC 端：点击网站导航栏的音乐图标，打开播放器
• 移动端：点击菜单中的音乐图标，调出播放器

播放器功能：

• 播放/暂停：点击播放或暂停音乐
• 切换歌曲：点击上一首/下一首按钮
• 随机播放：开启/关闭随机播放模式
• 循环模式：切换单曲循环、列表循环或不循环
• 进度调整：拖动进度条快速跳转到指定时间点
• 列表播放：点击播放列表中的歌曲直接播放

特色功能

• 会话恢复：刷新页面后自动恢复上次播放状态
• 智能编码识别：自动检测歌词文件的 GBK/UTF-8 编码
• 流畅动画：播放器开关、歌词滚动等交互均带有平滑动画
• 自适应主题：根据网站主题自动适配明暗模式

使用注意事项

1. 仅支持 MP3、WAV、OGG 格式的音频文件
2. 歌词文件必须是标准 LRC 格式
3. 建议使用在线音频 URL，确保链接可访问
4. 移动端体验已优化，但部分功能可能与 PC 端略有不同

更新日志

v1.0

• 首次发布
• 实现基础播放功能
• 支持歌词显示
• 适配明暗主题
• 优化移动端体验