feat(float): rebuild right floating buttons 1:1 with reference theme
- Storage: aksrt_floating_buttons now uses reference float_btn shape (fixed 8 sortable types, more-buttons group); single source of defaults/sanitize in AKSRT\Settings\FloatButtons - Admin SPA: CSF-parity page split into components/floating/* - Frontend: aksrt_float_right() on wp_footer mirrors zib_float_right() (wp_is_mobile, PC tooltip, toggle-theme, ontop/scrollTopTo, qrcode, wechat/qq, pay_vip, add, more) - CSS: floating-buttons.css rewritten from reference rules; legacy float rules removed from main/part/shell/overlay-primitives - Remove dead code: reorder route/API, get_floating_buttons_items, floatingSchema, floatActionsId, float-theme-toggle bindings, common/floating.css, aksrt-runtime-win.php, .aksrt-float-btn
This commit is contained in:
kate522 committed
1 parent
7f60071460
commit
6f2adfaef1
32 files changed
+1338
-3111
No files matched your search
@@ -0,0 +1,227 @@
|
||||
<?php
|
||||
/**
|
||||
* 右侧悬浮按钮：唯一的默认值 + 规范化来源（读取与保存共用）。
|
||||
*
|
||||
* 结构对齐参考主题 float_btn（sortable，固定类型，数组顺序即显示顺序）。
|
||||
*
|
||||
* @package AKSRT
|
||||
*/
|
||||
|
||||
namespace AKSRT\Settings;
|
||||
|
||||
defined('ABSPATH') || exit;
|
||||
|
||||
class FloatButtons {
|
||||
|
||||
public const OPTION = 'aksrt_floating_buttons';
|
||||
|
||||
/** 固定按钮类型（默认显示顺序）。 */
|
||||
public const TYPES = ['more', 'pay_vip', 'add', 'service_qq', 'service_wechat', 'theme_mode', 'qrcode', 'back_top'];
|
||||
|
||||
/** 发布按钮可选类型。 */
|
||||
public const ADD_BTNS = ['post'];
|
||||
|
||||
/**
|
||||
* 默认配置。
|
||||
*/
|
||||
public static function defaults(): array {
|
||||
$empty_color = ['color' => '', 'bg' => ''];
|
||||
return [
|
||||
'style' => 'round',
|
||||
'position' => 'bottom',
|
||||
'filter_blur' => ['m_s'],
|
||||
'scroll_hide' => false,
|
||||
'scroll_down_hide' => true,
|
||||
'items' => [
|
||||
[
|
||||
'type' => 'more',
|
||||
'buttons' => [self::default_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, 'btns' => ['post'], '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],
|
||||
],
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 默认「更多按钮」子项。
|
||||
*/
|
||||
public static function default_more_button(): array {
|
||||
return [
|
||||
'desc' => '',
|
||||
'icon' => 'fa fas fa-heart',
|
||||
'link' => ['url' => '', 'target' => ''],
|
||||
'hover' => '',
|
||||
'hover_width' => 200,
|
||||
'pc_s' => false,
|
||||
'm_s' => false,
|
||||
'color' => ['color' => '', 'bg' => 'rgba(255, 111, 6, 0.2)'],
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 读取已规范化的配置。
|
||||
*/
|
||||
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::default_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':
|
||||
$btns = [];
|
||||
foreach ((array) ($item['btns'] ?? []) as $btn) {
|
||||
$btn = (string) $btn;
|
||||
if (in_array($btn, self::ADD_BTNS, true) && !in_array($btn, $btns, true)) {
|
||||
$btns[] = $btn;
|
||||
}
|
||||
}
|
||||
$out['btns'] = $btns;
|
||||
$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' => self::sanitize_color((string) ($group['color'] ?? '')),
|
||||
'bg' => self::sanitize_color((string) ($group['bg'] ?? '')),
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 允许 #hex（3/4/6/8 位）与 rgb()/rgba()。
|
||||
*/
|
||||
public static function sanitize_color(string $value): string {
|
||||
$value = trim($value);
|
||||
if ($value === '') {
|
||||
return '';
|
||||
}
|
||||
if (preg_match('/^#(?:[0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/', $value)) {
|
||||
return $value;
|
||||
}
|
||||
if (preg_match('/^rgba?\(\s*\d{1,3}\s*,\s*\d{1,3}\s*,\s*\d{1,3}\s*(?:,\s*(?:0|1|0?\.\d+)\s*)?\)$/', $value)) {
|
||||
return $value;
|
||||
}
|
||||
return '';
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user