视频增强插件 安装使用说明书

Nex-video-loader 是一款专为 WordPress 网站设计的专业级视频加载增强插件。它通过零侵入的方式，为页面上的 <video> 标签自动添加优雅的加载进度动画，有效提升用户在视频等待期间的体验。

核心特性：

零侵入集成：无需修改任何代码或短代码，插件会自动检测并作用于页面内的视频元素。

多种动画风格：内置环形进度条、声波动画、脉冲光晕和旋转加载器四种样式，并可显示加载百分比。

智能性能优化：支持移动端独立控制、视口延迟初始化、已加载视频缓存，确保不牺牲网站性能。

高度可定制：可自定义加载/完成提示文字、遮罩透明度、毛玻璃强度，并支持通过CSS类名排除特定视频。

完善的调试工具：内置调试日志系统，方便开发者追踪视频加载事件和排查问题。

上传安装

在 WordPress 后台，前往 插件 > 安装插件，点击“上传插件”按钮，选择本插件的 .zip 压缩包并上传安装。

或者，将解压后的 nex-video-loader 文件夹通过FTP上传到 /wp-content/plugins/ 目录。

激活插件
安装完成后，在 插件 列表中找到 Nex-video-loader，点击 启用。

配置设置（可选）

启用后，请前往 WordPress 后台的 设置 > Nex视频加载读条 进行配置。

您可以在设置页面中：

选择喜欢的动画风格。

自定义加载中和加载完成的提示文字。

调整遮罩透明度和毛玻璃强度等视觉效果。

启用 性能模式、缓存优化 等高级功能。

开启 调试模式 以记录加载日志。

验证效果
访问网站前端包含 <video> 标签的页面，视频加载时即可看到您配置的动画效果。

1. 插件为什么没有效果？

请检查视频是否为 <video> 标签，目前不支持 YouTube 或 Vimeo 等嵌入式播放器。

确认视频或其父级容器没有使用您在“排除的视频类名”中设置的类。

检查视频宽度是否小于“最小视频尺寸”设置值。

如果是移动设备，请确认“移动端启用”选项已开启。

2. 如何排除某个视频，不让它显示加载动画？
给该视频的HTML标签添加一个CSS类名，例如 no-loader，然后在插件设置页面的 “排除的视频类名” 输入框中添加该类名（多个类名用英文逗号分隔）。

3. 为什么百分比进度有时候会卡住或跳变？
视频的加载进度依赖于浏览器的 progress 事件和 buffered 属性。在某些网络环境或视频编码格式下，浏览器报告的缓冲进度可能不是完全平滑的，这属于正常现象，不影响视频的最终加载。

4. 插件会影响页面加载速度吗？
插件本身非常轻量，并内置了多项性能优化措施，如延迟初始化和缓存。前端仅输出必要的 CSS 和 JavaScript，且动画通过硬件加速，对页面性能影响极小。

5. 如何更新插件？
当有新版本时，您会在WordPress后台的插件列表页看到更新提示。点击 “立即更新到 X.X.X” 链接即可完成更新。插件会自动通过授权服务器获取更新包。

6. 为什么后台显示“授权Token未获取”？
这通常意味着您的服务器无法连接到我们的授权服务器 license.orientalnexus.cn。请检查服务器的网络设置、防火墙或DNS解析，确保其能够正常发出HTTPS请求。Token获取成功后会自动续期。