Snowstorm 飘雪插件（emlog 版）使用说明（v1.0.1）
1. 运行环境要求
- PHP： 5.6 及以上（推荐 7.4+）
- emlog： 需支持 Storage 组件（用于保存插件配置）
- 主题： 需在页面底部保留挂载点
doAction('index_footer')（通常位于主题footer.php的</body>前）
2. 安装步骤
- 解压插件压缩包，得到目录：
snowstorm/ - 上传整个
snowstorm文件夹到你的站点：站点根目录/content/plugins/ - 登录 emlog 后台 → 插件 → 找到 Snowstorm 飘雪 → 启用
- 点击插件右侧 设置 进入配置页
3. 启用范围说明（全站/部分页面）
插件通过 index_footer 挂载点输出脚本：
- 如果你的主题在所有页面都执行
doAction('index_footer')，则飘雪效果默认全站生效。 - 如果某些页面模板未调用该挂载点，则这些页面不会显示飘雪。
4. 后台配置项说明
进入：后台 → 插件 → Snowstorm 飘雪 → 设置
4.1 雪花颜色（HEX）
- 格式支持：
#fff或#ffffff - 示例：
#ffffff（白色）、#8fd3ff（淡蓝）
4.2 雪花样式（多种可选）
- 原版雪花（WebFont）： 默认选项，效果与原版一致
- 混合雪花（原版 + Unicode，多种形态）
- Unicode 雪花（❄❅❆）
- 冰晶雪花（❄❅❆✻✼✽✾）
- 雪点粒子（•·○◦）
- 星光飘落（✦✧★☆）
- *极简飘落（+·）**
- 自定义字符集（手动输入）
4.3 自定义字符集（仅在“自定义字符集”样式下生效）
- 支持分隔符：逗号、空格、
| - 建议每个元素为 1 个字符
- 示例：
❄,❅,❆,✻,✼ • | · | ○ | ◦ - 特殊说明：
- 输入包含
j可调用 WebFont 原版雪花（与默认原版一致） - 在不支持 WebFont 的环境下，系统会自动过滤
j，避免显示字母
- 输入包含
4.4 启用随机色雪花
- 开启后雪花颜色会随机变化
- “雪花颜色”会作为初始色/基础色
4.5 雪花跟随鼠标
- 开启后雪花会受鼠标移动影响产生横向漂移
- 漂移强度（可调）
- 范围：
0 ~ 5（步进 0.1） - 默认：
1.1（与原版一致的跟随手感） - 建议：
0：几乎不跟随（更“自然下落”）0.8 ~ 1.5：轻微跟随（推荐区间）2 ~ 5：跟随明显（更“互动化”）
- 范围：
4.6 页面失焦时暂停
- 开启后，当你切换到其他标签页/窗口时暂停飘雪，减少资源消耗
4.7 雪花飘动速度
三档固定（与原版一致）：
- 快： 20ms
- 中（推荐）： 30ms
- 慢： 40ms
5. 常见问题排查
5.1 启用后前台没效果
按以下顺序检查：
- 主题
footer.php是否包含：<?php doAction('index_footer'); ?> - 查看页面源代码底部是否出现注释：
<!-- Snowstorm (emlog plugin) --> - 浏览器控制台（F12）是否有 JS 报错（与其他特效脚本冲突时常见）
5.2 雪花样式不生效/字体不对
- 确认插件目录存在：
/content/plugins/snowstorm/res/ - 确认站点
BLOG_URL配置正确（影响资源加载路径）
6. 升级与卸载
覆盖升级
直接用新版 snowstorm/ 覆盖：/content/plugins/snowstorm/
后台无需重新启用，进入设置确认参数即可。
卸载
- 后台停用插件
- 删除目录：
/content/plugins/snowstorm/
插件在删除时会清理自身配置存储（如你的 emlog 支持回调清理）。
最新评论