三、安装与使用步骤

  1. 把music_player 插件放在content/plugins/ 目录下 
  2. 进入后台 → 扩展 → 插件，找到【音乐播放器】点击启用
  3. 点击插件右侧的设置按钮，添加歌曲并配置播放器参数
  4. 必须操作：后台首页 → 右上角点击 更新缓存
  5. 刷新前台页面，底部即可出现音乐播放器

四、功能说明

  • ✅ 底部固定悬浮播放器，不随页面滚动消失
  • ✅ 支持多歌曲管理，可自由添加 / 删除歌曲
  • ✅ 播放列表展开 / 收起，支持列表循环、随机播放
  • ✅ 可自定义默认音量、自动播放、默认折叠状态
  • ✅ 移动端自动适配，隐藏播放列表仅保留控制条
  • ✅ 无需修改主题文件，启用插件即可使用
  • ✅ 基于 APlayer 开源播放器，界面美观、性能稳定

五、常见问题

1. 播放器不显示

  • 确认插件已启用、已更新缓存
  • 检查主题是否包含 index_footer 钩子，大部分主题默认都有；若没有，在主题 footer.php 的 </body> 前加上 <?php doAction('index_footer'); ?>

2. 歌曲无法播放

  • 确认音频链接是直链（打开直接下载 / 播放，不是跳转页面）
  • 确认音频格式是浏览器支持的 mp3 等格式
  • 检查是否有跨域限制，建议使用同域名或支持跨域的音频源

  • image.png

  • image.png