chore: 重写初始提交(清空历史,整理后全量提交)

2026-08-16 16:54:14 +08:00
commit 6c1a106bc1
1808 changed files with 238144 additions and 0 deletions
@@ -0,0 +1,105 @@
+<?php
+// +----------------------------------------------------------------------
+// | YwxApp [ WE CAN DO IT JUST THINK ]
+// +----------------------------------------------------------------------
+// | Copyright (c) 2026-2036 http://ywxapp.cn All rights reserved.
+// +----------------------------------------------------------------------
+// | Author: ywxapp <admin@ywxapp.cn>
+// +----------------------------------------------------------------------
+
+namespace ywxapp\library;
+
+/**
+ * 皮肤变量/配色层（Discuz 式风格变量，无需改 HTML）。
+ *
+ * 模板在 template.json 声明 variables（如主色/背景/字体），后台可覆盖并写入
+ * config/template.php 的 settings.variables[<模板名>]。渲染时由 Addon 基类的
+ * fetch 钩子把变量注入为 <style id="ywx-skin-vars">:root{--primary:...}</style>，
+ * 皮肤 CSS 用 var(--primary) 即可生效，无需改动任何视图文件。
+ */
+class SkinVariables
+{
+    /**
+     * 读取模板声明的变量定义（已归一化为 {key:{label,default,type}}）。
+     * 支持简写：variables: { "primary": "#2d8cf0" } 等价于 { "primary": {"default":"#2d8cf0"} }。
+     */
+    public static function definitions(string $name): array
+    {
+        $file = root_path() . 'templates' . DIRECTORY_SEPARATOR . $name . DIRECTORY_SEPARATOR . 'template.json';
+        if (! is_file($file)) {
+            return [];
+        }
+        $meta = json_decode(file_get_contents($file), true) ?? [];
+        $vars = $meta['variables'] ?? [];
+        if (! is_array($vars)) {
+            return [];
+        }
+        $out = [];
+        foreach ($vars as $key => $def) {
+            if (is_string($def)) {
+                $def = ['default' => $def];
+            }
+            if (! is_array($def)) {
+                continue;
+            }
+            $out[$key] = [
+                'label'   => $def['label'] ?? $key,
+                'default' => $def['default'] ?? '',
+                'type'    => $def['type'] ?? 'color',
+            ];
+        }
+        return $out;
+    }
+
+    /**
+     * 当前生效的变量值（默认 + 后台覆盖）。
+     * 返回带 -- 前缀的 CSS 变量名 => 值（仅返回非空值）。
+     */
+    public static function values(string $name): array
+    {
+        $defs      = self::definitions($name);
+        $settings  = TemplateManager::getSettings();
+        $overrides = $settings['variables'][$name] ?? [];
+        if (! is_array($overrides)) {
+            $overrides = [];
+        }
+        $out = [];
+        foreach ($defs as $key => $d) {
+            $val = $overrides[$key] ?? $d['default'];
+            if ($val === '' || $val === null) {
+                continue;
+            }
+            $out['--' . ltrim($key, '-')] = (string) $val;
+        }
+        return $out;
+    }
+
+    /**
+     * 生成 :root 内的 CSS 变量声明字符串（不含 :root{} 包裹），如无变量返回空串。
+     */
+    public static function declaration(string $name): string
+    {
+        $vals  = self::values($name);
+        $parts = [];
+        foreach ($vals as $k => $v) {
+            $parts[] = $k . ':' . $v;
+        }
+        return implode(';', $parts);
+    }
+
+    /**
+     * 针对某插件/区域，返回可直接注入页面的 <style> 标签；无激活皮肤或无变量返回空串。
+     */
+    public static function styleTag(string $addon, string $area): string
+    {
+        $name = SkinOverlay::templateOf($addon);
+        if ($name === null) {
+            return '';
+        }
+        $decl = self::declaration($name);
+        if ($decl === '') {
+            return '';
+        }
+        return '<style id="ywx-skin-vars">:root{' . $decl . '}</style>';
+    }
+}