前言

首先，很高心你能使用我开发的Splayer！我很乐意在接下来的篇幅中，向你介绍这个小而美的WordPress插件。你的使用和反馈是我最大的动力！

本插件旨在为Wordpress驱动的网站提供一个轻量化插件，实现后台音乐播放的效果。本项目完全开源，会在GitHub上发布源码，并且在未宣布停止维护之前，将会无限期更新及维护。

正文

一、插件概述

SPlayer 插件特点：

• 轻量化和简洁设计：前端圆形唱片小巧不影响网页布局，点击可展开成透明磨砂玻璃风格的控制面板。
• 前端交互自然流畅：
  1、播放时唱片旋转，未播放静止。
  2、点击唱片 → 面板从唱片位置自然扩展开 → 唱片消失。
  3、收起面板 → 面板缩回唱片 → 唱片恢复显示。
• 拖拽与吸附：圆形唱片可随意拖动，自动吸附屏幕左右边缘。
• 播放列表管理：
  1、支持多首歌曲。
  2、支持单曲循环、列表循环和随机播放模式。
  3、每首歌可以自定义封面。
• 后台管理简洁：通过 WordPress 后台图形化界面添加、删除歌曲 URL 和自定义封面。
• GitHub 自动更新：插件内置 GitHub 更新检测，可手动或自动更新到最新版本。
  

二、安装插件

1、下载插件 ZIP 文件：

可从 GitHub Release 下载对应版本，例如 v1.1.2。

2、上传至 WordPress：

登录 WordPress 后台 → 插件 → 安装插件 → 上传插件 → 选择 ZIP 文件 → 点击“立即安装”。

3、启用插件：

安装完成后点击“启用”，然后配置好后台（详见第三部分），SPlayer 将在页面上生成一个可拖拽的圆形唱片。

三、后台配置

1、打开后台设置

WordPress 后台 → 设置 → SPlayer 设置。

2、添加歌曲

• 点击“添加歌曲”按钮：
  歌曲 URL：输入 MP3 或其他支持格式的音频 URL。
  封面 URL：可自定义歌曲封面图片 URL，如果不填，将显示默认封面。
  标题：输入歌曲名称（可选）。
• 支持批量添加，多首歌曲可组成播放列表。

3、播放模式设置

Splayer支持以下几种播放模式：

• 单曲循环
• 列表循环
• 随机播放

选择后，前端播放器将按照你设置的模式播放歌曲。

4、GitHub自动更新

• 仓库配置已经封装至源代码，无需改动。
• 可选择手动检查更新或自动检测新版本。

四、前端使用指南

1、圆形唱片操作

• 初始状态为小圆形唱片。
• 点击唱片 → 展开成面板。
• 拖拽唱片 → 自动吸附左右边缘。

2、播放面板功能

• 播放/暂停：点击 ▶/⏸ 按钮。
• 上一曲/下一曲：点击 ⏮ 或 ⏭。
• 歌曲封面：显示当前播放歌曲的封面。

3、响应式体验

• 小圆盘在页面任何位置均可操作。
• 展开面板不会遮挡网页主要内容。
• 拖拽吸附保证界面整洁。

五、Q&A

1、播放列表无法显示封面怎么办？

• 确认在后台添加歌曲时，已填写有效封面 URL。

2、面板展开方向错误？

• SPlayer 会根据圆形唱片位置自动调整方向：左侧 → 展开到右边，右侧 → 展开到左边。

3、动画卡顿不流畅？

• 请确保浏览器支持 CSS3 transform 和 backdrop-filter。
• 使用现代浏览器（Chrome、Edge、Safari、Firefox）可获得最佳效果。
• 本插件使用硬件加速，可能带来极小的硬件压力，硬件不足的设备可能会有所卡顿。

4、如何进行插件更新？

• 后台设置中可手动检查 GitHub 新版本，也可启用自动更新。

5、初次进入网页未能加载插件？

• 服务器带宽可能不足，刷新或者进入网页子链接多次后可以解决。
• 后台配置未保存，或者尚未配置完毕，导致插件未能初始化。

附录

1、插件处于开发阶段，如有bug和改进建议，欢迎致信shirazunagisa@gmail.com。