From 6618f67be2eda3455d6bdee2a84e5089f6f71fee Mon Sep 17 00:00:00 2001
From: tikkhun <tikkhun@163.com>
Date: Sat, 13 Dec 2025 10:19:47 +0800
Subject: [PATCH] =?UTF-8?q?feat(=E8=B7=AF=E7=94=B1=E6=98=BE=E7=A4=BA):=20?=
 =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E8=B7=AF=E7=94=B1=E5=8C=B9=E9=85=8D=E6=A8=A1?=
 =?UTF-8?q?=E5=BC=8F=E8=AE=BE=E7=BD=AE=E5=92=8C=E5=8A=9F=E8=83=BD=E5=AE=9E?=
 =?UTF-8?q?=E7=8E=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

新增路由显示模式选项，支持首页显示、全站显示和URL路径匹配三种模式
在路径匹配模式下，可以通过规则列表配置需要显示雪花的URL路径
更新翻译文件和版本号至1.9.0
---
 languages/yoone-snow-zh_CN.mo | Bin 3838 -> 4635 bytes
 languages/yoone-snow-zh_CN.po |  29 +++++++++-
 readme.txt                    |  78 ++++++++++++++++++++++++++
 yoone-snow.php                | 101 +++++++++++++++++++++++++++++++++-
 4 files changed, 204 insertions(+), 4 deletions(-)
 create mode 100644 readme.txt

diff --git a/languages/yoone-snow-zh_CN.mo b/languages/yoone-snow-zh_CN.mo
index cd1a4a9519d9c0181329a2f897895a86d25d1df3..acefc5707d8f4e5635c57e59599bce9d35ca77bf 100644
GIT binary patch
delta 2055
zcmZwH?{5@E7{Ku<Efq>BwNwQaIwArhQhq2Fr6@*&ni5EjCZaFgw%hj7yW8{b8mPRu
z2HJ!IrN(Qem7+NyP-4P?O)UsL)R>6A@eeT3kaX{dl2l(1Bk|YwxgD@1PHy(I^X%-*
zGqbz*_oAaqV?S0D4Jb-2^+9UU45ePh>xCRBH8YiZ0ykm_25|{?7>98-?JKwpzr|ww
z6{Y|0ScNkP&ch{GhU+|IY6~Yz3GBd!vE4X?MYJby0e*!G@dvyMZ(sobGS}M(&Zpgl
zlKUXaeZ%-9jv=|IUr-kM8y2Y;+00U^l)!wH%rwdX)hGk3N4c@i#OpCc`*qxk-{1<I
z$2L5UHAqM`<05pB991v!Q~ewk<40J^{Az-eO8ia&_!G(i*HLb~fphUs<fls5SFsXh
zYZs%eXfw)=y=i<KWk+oM89R`lYMSHipo6go2<+ly55{p7&Lay+WD|#n@MV;Y+f4ib
z%EU)d5*$ZKD20;9RnvBjQ^r5c^+Hx7{q$V+UruTX$Ur+$p0R}$xW~i~V}SMmmSZ8$
zNv>C-+_xO%QLV<cxE1A*b)YOThSKjSl7l*qcVn`Q{g(@05|9C|nvU0uS@aX1!a975
zSNJJBgB$P~%KZz-N)oR^X>UZ?k>^kr_zKFzEhvv9YTEl_oX8CW#$j{egz=n-PoNC+
zHA<q_O#G&?faTmvd=`F>RVdGT3T6D8C<zv@Z3QTWHK~}aLW+EP>+)xJ9%N9tQJ#M_
zRaS97Rf_y)$Qv$+t*6R6Auk|v-7b%D#wO*zsI|D<TzM4v0%Q3%dm|0`4_HIx|0iFb
z=J*Izz6@FM^dgTy{)D8g_D~w-o!}kL7x{wZ<&`3TV4JA-QCCsr(cD8VSI>IiEa&-c
zl9#52x{N9>j%=a)c}RK2BY%`<xRSae-d%KH_7=Zi@330z$Y|Nj4Fv(a*=qMk^-E5`
z*4u;r4&B)5I1yXl?xv%Twu4rK-_|XDr@`|7*Jqm*ZEV%A)z>j#v~^lXM+Rzk!a5*5
z>?R#{+M{+v#S_H~=fB{Kg#1>AuFuExHmAvsKVQ7F_Ql;+AjB-yRs&Z`svG=HOZCc<
z>PV{-Qj(wY=JW0|ja!q)FBY$eZ4cTy+|CdoJFNXaT8&O1WQA>QwOGDjB&x&qJMA`x
zBwyQ1h>a%X&8<UWyV<wf%U<vD$=bq}j}cpRBx;4V$xYQ;!6ql5Tb;1)T_-p?RXkQ$
zn(paL5BKB}W4U9;<0ne~iRCU0X3w6SywsgL^#S4ZU@CL+bDit#Ngq5jy|a6{(|s@L
zc8_E}8M>pBd+1`WyEnhj+3}>C>S8Q+c*F~5KJ4;>-Yv=_edM#;z!jZ2{l2R3B6Q01
zpHGh@+{=CO#GE&_ki=x_;Q#Nom#Ok*$e!+U_YaxIv@GJ~rEA)fec8mJ$qSw7V+pUH
zp1g24n;cJ{-)quJ_GeT3G*h{!_GUg!WfEt-3ub2R_Vi|0d47#<UvhHdN~V9rJ(tSu
U8%Ym-?Dmb{+U?QJrC-eW7mvlakN^Mx

delta 1243
zcmXxjOGs2v9LMqF=;)L>qgJM+Ii@*IIX<c}A)-Z#5oy(;+yp^Hfjw4%6f|urjW%_0
zENoFB4J~RTMHoy`10gMhAY4rm49ZliXww7f`y2mr;D0~o+<VTs=Q-24+M4{_P%-65
zaiWFDmN}Qev*kQU6BW+w#YtR`8QhKw<`3+m9P&F?iG!$m2e1u?F@$F@h~wrB>~t>a
zQe-;#@XGvx^y$j!tqB9zjO|#3`%z;%WZx60!Jj~yx)iqJeN?@9R6iN}zGUxnnBf2J
zE17O8MCm<-M=*d_Q5{VpRa_d^;WONZFR=!fa3kie{2SH2l84%buofFp?K{n0Y~%lK
zh>Vtg6gBgU<|W)fIf>uULoMwUdf^{#61U=Qyo^t=2cuNdz>Z=&o<t4!8fr^sQ3K0j
zk~Z!G84chQs{GUZXI56PeXlcP<_M~z)2J;vj}16s?`O<Ms4aMc1NauTRlllP|3)%@
ztYSUGR>dY%#{=dN9;SQ{_u(xZ#4M`bU(^76th353sEKr-CKf}gxDnKf9<%aTE$goa
z<Gheb`*7X#?EM2&M`_dmv-Un`=1~**j*IBysIz$PBdXsVYJhp<f)&#yJ+=Q4qMuNO
zFrlR7(T`$;t{YolOgiaGUBpg8v(gzTC0$ki;d%+}y>6D$?lqhbcUWE|dw6J1bVs!`
zI#`+s6Dg)$Jhi8#qyt(<uw%uUafjVzLN`S--a=^U>xn)>H$y8|N>R(`YIbX^d&uZi
z>V!Hk?!P&=;E$Ji_o_zy!xzq-3VUN!&0b$1GWS04uH2ihS@j~p(Z<5#RN>+C<-3`c
Z+4<$^7lo<U;g$3q?@h3O?szEU`wyrra|HkZ

diff --git a/languages/yoone-snow-zh_CN.po b/languages/yoone-snow-zh_CN.po
index d2524d9..708351f 100644
--- a/languages/yoone-snow-zh_CN.po
+++ b/languages/yoone-snow-zh_CN.po
@@ -128,8 +128,8 @@ msgid "Weight controls relative probability Weight is a non negative integer Wei
 msgstr "权重用于控制随机生成的相对概率 权重为非负整数 权重为 0 表示禁用 某形状概率等于其权重除以所有形状权重之和 例如 dot 1 flake 4 flake 概率约为 dot 的四倍"
 
 # Other settings
-msgid "Home Display Duration Seconds"
-msgstr "首页显示时长 秒"
+msgid "Display Duration Seconds"
+msgstr "显示时长 秒"
 
 msgid "Duration in seconds for snow on home 0 means infinite"
 msgstr "首页雪花显示时长 单位秒 0 表示无限"
@@ -166,3 +166,28 @@ msgstr "水平摆动幅度基值在最小与最大之间随机 应用偏移缩
 
 msgid "Select images or SVG"
 msgstr "选择图片或 SVG"
+
+# Route display mode
+msgid "Display Routes Mode"
+msgstr "显示路由模式"
+
+msgid "Home"
+msgstr "首页"
+
+msgid "All Pages"
+msgstr "所有页面"
+
+msgid "Match URL Path"
+msgstr "匹配 URL 路径"
+
+msgid "Default Home Only choose All Pages to enable globally choose Match URL Path to enable only for matched routes"
+msgstr "默认仅首页显示 选择所有页面开启全站显示 选择匹配 URL 路径仅在匹配的路径显示"
+
+msgid "Match Routes"
+msgstr "匹配规则"
+
+msgid "One rule per line compare against request path example exact path /about prefix match with trailing star /blog/*"
+msgstr "每行一条规则 与请求路径比较 例如精确路径 /about 前缀匹配可使用尾部星号 /blog/*"
+
+msgid "Example /about\n/blog/*\n/shop"
+msgstr "示例 /about\n/blog/*\n/shop"
diff --git a/readme.txt b/readme.txt
new file mode 100644
index 0000000..d3a3aa7
--- /dev/null
+++ b/readme.txt
@@ -0,0 +1,78 @@
+=== 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` 目录提供翻译文件
+
diff --git a/yoone-snow.php b/yoone-snow.php
index 4ab1d5a..86700f6 100644
--- a/yoone-snow.php
+++ b/yoone-snow.php
@@ -2,13 +2,44 @@
 /*
 Plugin Name: Yoone Snow
 Description: 首页 canvas 雪花效果
-Version: 1.7.0
+Version: 1.9.0
 Author: Yoone
 */
 
 if (!defined('ABSPATH')) { exit; }
 
 function yoone_snow_is_enabled() {
+    $mode = get_option('yoone_snow_display_routes_mode', 'home');
+    if ($mode === 'all') {
+        return true;
+    }
+    if ($mode === 'match') {
+        $routes = get_option('yoone_snow_display_routes', array());
+        if (is_string($routes)) {
+            $routes = array_filter(array_map('trim', explode("\n", $routes)));
+        }
+        if (!is_array($routes)) {
+            $routes = array();
+        }
+        $requestUri = isset($_SERVER['REQUEST_URI']) ? (string)$_SERVER['REQUEST_URI'] : '';
+        $path = parse_url($requestUri, PHP_URL_PATH);
+        $path = is_string($path) ? $path : '';
+        foreach ($routes as $rule) {
+            $r = trim((string)$rule);
+            if ($r === '') { continue; }
+            if (substr($r, -1) === '*') {
+                $prefix = substr($r, 0, -1);
+                if ($prefix === '' || strpos($path, $prefix) === 0) {
+                    return true;
+                }
+            } else {
+                if ($path === $r) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
     return function_exists('is_front_page') ? is_front_page() : false;
 }
 
@@ -64,6 +95,14 @@ function yoone_snow_enqueue_assets() {
     $script_ver = @filemtime(plugin_dir_path(__FILE__) . 'js/snow-canvas.js');
     $deps = array($shape_index_handle);
     $needs_utils = false;
+    $mixed_items_option = get_option('yoone_snow_mixed_items', array('dot','flake'));
+    if (is_string($mixed_items_option)) {
+        $mixed_items_option = array_filter(array_map('trim', explode(',', $mixed_items_option)));
+    }
+    $allowed_shapes = array('dot','flake','yuanbao','coin','santa_hat','candy_cane','christmas_sock','christmas_tree','reindeer','christmas_berry');
+    $mixed_items_sanitized = array_values(array_unique(array_intersect(is_array($mixed_items_option) ? $mixed_items_option : array('dot','flake'), $allowed_shapes)));
+    if (empty($mixed_items_sanitized)) { $mixed_items_sanitized = array('dot','flake'); }
+    $media_urls = array();
     foreach ($mixed_items_sanitized as $key) {
         if ($key === 'dot') { $deps[] = $shape_dot_handle; }
         if ($key === 'flake') { $deps[] = $shape_flake_handle; }
@@ -726,7 +765,7 @@ function yoone_snow_register_settings() {
     // 添加首页显示时长字段 输入为数字最小值为 0
     add_settings_field(
         'yoone_snow_home_duration',
-        esc_html__('Home Display Duration Seconds', 'yoone-snow'),
+        esc_html__('Display Duration Seconds', 'yoone-snow'),
         function() {
             // 读取当前设置值 并渲染数字输入框
             $current = intval(get_option('yoone_snow_home_duration', 0));
@@ -861,6 +900,64 @@ function yoone_snow_register_settings() {
         'yoone_snow',
         'yoone_snow_section'
     );
+
+    // 路由显示模式设置
+    register_setting('yoone_snow_options', 'yoone_snow_display_routes_mode', array(
+        'type' => 'string',
+        'sanitize_callback' => function($value) {
+            $val = strtolower(trim((string)$value));
+            $allowed = array('home','all','match');
+            return in_array($val, $allowed, true) ? $val : 'home';
+        },
+        'default' => 'home',
+    ));
+    add_settings_field(
+        'yoone_snow_display_routes_mode',
+        esc_html__('Display Routes Mode', 'yoone-snow'),
+        function() {
+            $current = get_option('yoone_snow_display_routes_mode', 'home');
+            echo '<label style="margin-right:12px;"><input type="radio" name="yoone_snow_display_routes_mode" value="home" ' . checked($current, 'home', false) . ' /> ' . esc_html__('Home', 'yoone-snow') . '</label>';
+            echo '<label style="margin-right:12px;"><input type="radio" name="yoone_snow_display_routes_mode" value="all" ' . checked($current, 'all', false) . ' /> ' . esc_html__('All Pages', 'yoone-snow') . '</label>';
+            echo '<label><input type="radio" name="yoone_snow_display_routes_mode" value="match" ' . checked($current, 'match', false) . ' /> ' . esc_html__('Match URL Path', 'yoone-snow') . '</label>';
+            echo '<p class="description">' . esc_html__('Default Home Only choose All Pages to enable globally choose Match URL Path to enable only for matched routes', 'yoone-snow') . '</p>';
+        },
+        'yoone_snow',
+        'yoone_snow_section'
+    );
+    // 路由匹配规则列表设置
+    register_setting('yoone_snow_options', 'yoone_snow_display_routes', array(
+        'type' => 'array',
+        'sanitize_callback' => function($value) {
+            if (is_string($value)) {
+                $value = preg_split('/\\r?\\n/', $value);
+            }
+            if (!is_array($value)) { $value = array(); }
+            $out = array();
+            foreach ($value as $item) {
+                $s = trim((string)$item);
+                if ($s !== '') { $out[] = $s; }
+            }
+            return array_values(array_unique($out));
+        },
+        'default' => array(),
+    ));
+    add_settings_field(
+        'yoone_snow_display_routes',
+        esc_html__('Match Routes', 'yoone-snow'),
+        function() {
+            $current = get_option('yoone_snow_display_routes', array());
+            if (is_string($current)) {
+                $current = preg_split('/\\r?\\n/', $current);
+            }
+            if (!is_array($current)) { $current = array(); }
+            $text = implode("\n", array_map('strval', $current));
+            $placeholder = esc_attr__("Example /about\n/blog/*\n/shop", 'yoone-snow');
+            echo '<textarea name="yoone_snow_display_routes" rows="6" style="width:420px;" placeholder="' . $placeholder . '">' . esc_textarea($text) . '</textarea>';
+            echo '<p class="description">' . esc_html__('One rule per line compare against request path example exact path /about prefix match with trailing star /blog/*', 'yoone-snow') . '</p>';
+        },
+        'yoone_snow',
+        'yoone_snow_section'
+    );
 }
 
 // 添加设置页面到后台菜单 条目在设置菜单下