'', 'bg' => '']; return [ 'style' => 'round', 'position' => 'bottom', 'filter_blur' => ['m_s'], 'scroll_hide' => false, 'scroll_down_hide' => true, 'items' => [ [ 'type' => 'more', 'buttons' => [self::gift_more_button()], ], ['type' => 'pay_vip', 'pc_s' => true, 'm_s' => true, 'color' => ['color' => '#f2c97d', 'bg' => 'rgba(62,62,67,0.9)']], ['type' => 'add', 'pc_s' => true, 'm_s' => false, 'color' => $empty_color, 'icon' => 'fa fas fa-pencil-alt'], ['type' => 'service_qq', 'pc_s' => false, 'm_s' => false, 'color' => $empty_color, 'qq' => ''], ['type' => 'service_wechat', 'pc_s' => true, 'm_s' => true, 'color' => $empty_color, 'wechat_img' => ''], ['type' => 'theme_mode', 'pc_s' => false, 'm_s' => false, 'color' => $empty_color], ['type' => 'qrcode', 'pc_s' => true, 'm_s' => false, 'color' => $empty_color, 'desc' => __('在手机上浏览此页面', 'aksrt')], ['type' => 'back_top', 'pc_s' => true, 'm_s' => true, 'color' => $empty_color], ], ]; } /** * 「更多按钮」出厂默认项（对齐参考主题 float_btn.more 默认值）。 */ public static function gift_more_button(): array { $img = get_template_directory_uri() . '/assets/img/logo.png'; return [ 'desc' => '本站同款主题模板', 'icon' => 'zibsvg-gift-color', 'link' => ['url' => '', 'target' => ''], 'hover' => '

', 'hover_width' => 240, 'pc_s' => true, 'm_s' => true, 'color' => ['color' => '', 'bg' => 'rgba(255, 111, 6, 0.2)'], ]; } /** * 「添加按钮」新增项默认值（参考主题 group 字段默认值）。 */ public static function new_more_button(): array { return [ 'desc' => '', 'icon' => 'fa fas fa-heart', 'link' => ['url' => '', 'target' => ''], 'hover' => '', 'hover_width' => 200, 'pc_s' => true, 'm_s' => true, 'color' => ['color' => '', 'bg' => ''], ]; } /** * 读取已规范化的配置。 */ public static function get(): array { $saved = get_option(self::OPTION, []); if (!is_array($saved) || $saved === []) { return self::defaults(); } return self::sanitize($saved); } /** * 规范化完整配置（REST 保存与读取共用）。 */ public static function sanitize(array $raw): array { $defaults = self::defaults(); $filter_blur = []; foreach ((array) ($raw['filter_blur'] ?? []) as $device) { $device = (string) $device; if (in_array($device, ['pc_s', 'm_s'], true) && !in_array($device, $filter_blur, true)) { $filter_blur[] = $device; } } return [ 'style' => in_array($raw['style'] ?? '', ['round', 'square'], true) ? $raw['style'] : 'round', 'position' => in_array($raw['position'] ?? '', ['bottom', 'center'], true) ? $raw['position'] : 'bottom', 'filter_blur' => $filter_blur, 'scroll_hide' => !empty($raw['scroll_hide']), 'scroll_down_hide' => !empty($raw['scroll_down_hide']), 'items' => self::sanitize_items((array) ($raw['items'] ?? []), $defaults['items']), ]; } /** * 按提交顺序保留已知类型，重复丢弃，缺失类型用默认值补到末尾。 */ private static function sanitize_items(array $raw_items, array $default_items): array { $default_map = []; foreach ($default_items as $item) { $default_map[$item['type']] = $item; } $out = []; $seen = []; foreach ($raw_items as $item) { if (!is_array($item)) { continue; } $type = (string) ($item['type'] ?? ''); if (!isset($default_map[$type]) || isset($seen[$type])) { continue; } $seen[$type] = true; $out[] = self::sanitize_item($type, $item, $default_map[$type]); } foreach ($default_items as $item) { if (!isset($seen[$item['type']])) { $out[] = $item; } } return $out; } private static function sanitize_item(string $type, array $item, array $default): array { if ($type === 'more') { $buttons = []; foreach ((array) ($item['buttons'] ?? []) as $button) { if (is_array($button)) { $buttons[] = self::sanitize_more_button($button); } } // 参考主题：至少保留一个。 if ($buttons === []) { $buttons[] = self::new_more_button(); } return ['type' => 'more', 'buttons' => $buttons]; } $out = [ 'type' => $type, 'pc_s' => !empty($item['pc_s']), 'm_s' => !empty($item['m_s']), 'color' => self::sanitize_color_group($item['color'] ?? []), ]; switch ($type) { case 'add': $out['icon'] = aksrt_sanitize_icon_value((string) ($item['icon'] ?? '')); break; case 'service_qq': $out['qq'] = (string) preg_replace('/\D+/', '', (string) ($item['qq'] ?? '')); break; case 'service_wechat': $out['wechat_img'] = esc_url_raw((string) ($item['wechat_img'] ?? '')); break; case 'qrcode': $out['desc'] = sanitize_text_field((string) ($item['desc'] ?? '')); break; } return $out; } private static function sanitize_more_button(array $button): array { $link = is_array($button['link'] ?? null) ? $button['link'] : []; $target = (string) ($link['target'] ?? ''); return [ 'desc' => sanitize_text_field((string) ($button['desc'] ?? '')), 'icon' => aksrt_sanitize_icon_value((string) ($button['icon'] ?? '')), 'link' => [ 'url' => esc_url_raw((string) ($link['url'] ?? '')), 'target' => $target === '_blank' ? '_blank' : '', ], 'hover' => wp_kses_post((string) ($button['hover'] ?? '')), 'hover_width' => max(50, min(500, (int) ($button['hover_width'] ?? 200))), 'pc_s' => !empty($button['pc_s']), 'm_s' => !empty($button['m_s']), 'color' => self::sanitize_color_group($button['color'] ?? []), ]; } /** * @param mixed $group * @return array{color:string,bg:string} */ private static function sanitize_color_group($group): array { $group = is_array($group) ? $group : []; return [ 'color' => \AKSRT\Core\Color::sanitize($group['color'] ?? '', true), 'bg' => \AKSRT\Core\Color::sanitize($group['bg'] ?? '', true), ]; } }