=== Yoone Snow ===
Contributors: yoone
Tags: snow, snowfall, christmas, effects, canvas
Requires at least: 5.6
Tested up to: 6.6
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

== Description ==
Yoone Snow 是一个在站点页面顶部绘制雪花效果的插件 使用 canvas 在前端生成不同形状的飘落元素 并提供后台设置页面进行配置 支持默认形状 emoji 字符 媒体图片以及文本作为雪花元素 每个元素都可以单独设置权重用来控制出现概率 插件同时提供尺寸范围 漂移速度范围 摆动幅度范围 最大在屏数量和首页显示时长等参数 便于在性能和效果之间做平衡

主要特性
- 形状类型支持 dot flake yuanbao coin santa hat candy cane christmas sock christmas tree reindeer christmas berry
- 支持添加 emoji 作为雪花元素 支持别名搜索与直接输入
- 支持添加媒体图片包括普通图片和 SVG 作为雪花元素
- 支持文本元素作为雪花元素
- 每类元素支持权重设置 权重为非负整数 权重为 0 时禁用该元素
- 提供尺寸范围 漂移速度范围 摆动幅度范围 最大在屏数量和首页显示时长等设置
- 后台形状选择下拉带内嵌预览 每项左侧显示绘制图案 便于直观选择

== Installation ==
手动安装
- 将插件文件夹上传到 `wp-content/plugins` 目录
- 在后台插件页面启用 Yoone Snow 插件
- 打开后台 `Settings -> Yoone Snow` 进入设置页进行配置

== Usage ==
- 在设置页的 Shapes 字段卡片区域管理所有雪花元素 支持 Default Emoji Media Text 四种类型
- Default 类型下可从下拉内嵌列表选择默认形状 左侧有图案预览 点击后会添加到下方卡片列表
- Emoji 类型可通过别名下拉或直接输入字符加入元素 别名示例 snow tree bell 等
- Media 类型通过按钮从媒体库选择图片或 SVG 并加入元素列表
- Text 类型输入文本并加入元素列表
- 每个元素卡片包含一个权重输入框 权重为非负整数 非法值会在保存时被矫正

== Settings ==
- Shapes 卡片列表 管理默认形状 emoji 媒体和文本元素 每个元素支持权重输入
- Display Duration Seconds 主页显示时长 单位秒 0 表示无限
- Max Snowflakes On Screen 在屏最大数量 0 表示根据视口面积自动控制 上限为 1000
- Snow Size 最小与最大半径 随机范围 在前端根据此范围生成不同尺寸
- Drift Speed Random Range 垂直漂移速度的随机范围 控制落下速度基线
- Swing Amplitude Random Range 水平摆动幅度随机范围 控制左右摆动基线

== FAQ ==
问 如何控制某个形状出现概率
答 在对应形状卡片的权重输入框设置权重 权重越大出现概率越高 权重为 0 时禁用该形状

问 如何添加自定义图片或 SVG 作为雪花
答 在 Media 面板点击 Add Images 按钮 从媒体库选择图片或 SVG 将自动添加到卡片列表并可设置权重

问 Emoji 如何快速添加
答 在 Emoji 面板通过下拉选择常用别名或在输入框中直接输入 emoji 字符 支持别名搜索和粘贴识别

问 性能如何设置
答 通过 Max Snowflakes On Screen 限制在屏数量 通过尺寸 漂移和摆动范围控制动画强度 如需更节省资源可调小上限与范围值

== Screenshots ==
1 设置页形状选择下拉内嵌预览示例
2 元素卡片列表与权重输入示例
3 媒体元素与 emoji 元素示例

== Changelog ==
= 1.1.0 =
- 增加形状选择下拉内嵌预览 每项左侧显示图案
- 将权重输入整合到卡片列表中 支持默认形状 emoji 媒体和文本
- 增强后台交互 包括 emoji 别名选择与建议列表 媒体多选以及文本快速添加

= 1.0.0 =
- 初始版本 支持基础雪花效果与默认形状选择

== Upgrade Notice ==
= 1.1.0 =
升级后请在设置页检查各元素权重与在屏最大数量 以确保性能与效果符合预期

== Localization ==
- 文本域为 `yoone-snow` 插件已加载本地化文本 可在 `languages` 目录提供翻译文件