kate522/wordpress-theme-aksrt
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

导入 AKSRT 主题开发源码

Browse Source
This commit is contained in:
Claude Code committed 2026-07-03 22:50:34 +08:00
1 parent 9681dd3d48
commit 1268a55dd0
595 files changed
+127705
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

inc/classes/admin/global-ctrl-traits/trait-aksrt-admin-global-controller-part-1.php
+264
View File
@@ -0,0 +1,264 @@
<?php
defined('ABSPATH') || exit;
trait AKSRT_Admin_Global_Controller_Part_1 {
public function rest_reorder_footer_tabbar(WP_REST_Request $request): WP_REST_Response {
$params = $this->get_json_params($request);
$ordered_ids = $params['ids'] ?? [];
if (!is_array($ordered_ids)) {
return new WP_REST_Response(['code' => 'error', 'message' => __('参数错误', 'aksrt')], 400);
}
if (count($ordered_ids) > 5) {
return new WP_REST_Response(['code' => 'error', 'message' => __('Footer tabbar supports at most 5 items.', 'aksrt')], 400);
}
$tabbar = get_option('aksrt_footer_tabbar', []);
$items = $tabbar['items'] ?? [];
$order_map = array_flip($ordered_ids);
usort($items, function ($a, $b) use ($order_map) {
$idx_a = $order_map[($a['id'] ?? '')] ?? 999;
$idx_b = $order_map[($b['id'] ?? '')] ?? 999;
return $idx_a <=> $idx_b;
});
foreach ($items as $index => &$item) {
$item['sort_order'] = $index;
}
$tabbar['items'] = $items;
update_option('aksrt_footer_tabbar', $tabbar);
return rest_ensure_response(['code' => 'success', 'message' => __('Order saved.', 'aksrt')]);
}
private function sanitize_tabbar_item(array $item): array {
$valid_types = ['home', 'category', 'link', 'user', 'auth', 'search', 'add'];
$type = sanitize_text_field($item['type'] ?? 'link');
if (!in_array($type, $valid_types, true)) {
$type = 'link';
}
$badge_mode = sanitize_text_field($item['badge_mode'] ?? 'static');
if (!in_array($badge_mode, ['static', 'dynamic'], true)) {
$badge_mode = 'static';
}
$add_items = [];
if (!empty($item['add_items']) && is_array($item['add_items'])) {
foreach ($item['add_items'] as $sub_item) {
$label = sanitize_text_field($sub_item['label'] ?? '');
$icon = sanitize_text_field($sub_item['icon'] ?? 'fas fa-pen');
$url = esc_url_raw($sub_item['url'] ?? '');
if ($label === '') {
continue;
}
$add_items[] = [
'id' => sanitize_text_field($sub_item['id'] ?? uniqid('add_')),
'label' => $label,
'icon' => $icon,
'url' => $url,
];
}
}
return [
'id' => sanitize_text_field($item['id'] ?? uniqid('tab_')),
'type' => $type,
'icon' => sanitize_text_field($item['icon'] ?? ''),
'text' => sanitize_text_field($item['text'] ?? ''),
'link' => esc_url_raw($item['link'] ?? ''),
'badge' => sanitize_text_field($item['badge'] ?? ''),
'badge_mode' => $badge_mode,
'category_id' => absint($item['category_id'] ?? 0),
'search_default_type' => (function() use ($item) {
$v = $item['search_default_type'] ?? 'post';
return in_array($v, ['post', 'category', 'tag'], true) ? $v : 'post';
})(),
'new_window' => !empty($item['new_window']),
'add_items' => $add_items,
'enabled' => !empty($item['enabled']),
'sort_order' => (int) ($item['sort_order'] ?? 0),
'ontop' => !empty($item['ontop']),
];
}
public function rest_handle_floating_buttons(WP_REST_Request $request): WP_REST_Response {
if ($request->get_method() === 'GET') {
$settings = class_exists('AKSRT_Settings')
? AKSRT_Settings::get_floating_buttons_settings()
: [
'enabled' => true,
'style' => 'round',
'position' => 'bottom',
'scroll_hide' => false,
'scroll_down_hide' => true,
'filter_blur' => [],
'items' => [],
];
return rest_ensure_response(['code' => 'success', 'data' => $settings]);
}
$params = $this->get_json_params($request);
$items = isset($params['items']) ? array_map([$this, 'sanitize_floating_button_item'], (array) $params['items']) : [];
$filter_blur = [];
if (!empty($params['filter_blur']) && is_array($params['filter_blur'])) {
foreach ($params['filter_blur'] as $device) {
$device = sanitize_text_field((string) $device);
if (in_array($device, ['pc', 'mobile'], true)) {
$filter_blur[] = $device;
}
}
$filter_blur = array_values(array_unique($filter_blur));
}
$settings = [
'enabled' => !empty($params['enabled']),
'style' => in_array($params['style'] ?? '', ['round', 'square'], true) ? $params['style'] : 'round',
'position' => in_array($params['position'] ?? '', ['bottom', 'center'], true) ? $params['position'] : 'bottom',
'scroll_hide' => !empty($params['scroll_hide']),
'scroll_down_hide' => !empty($params['scroll_down_hide']),
'max' => max(1, min(10, (int) ($params['max'] ?? 5))),
'size' => max(32, min(64, (int) ($params['size'] ?? 44))),
'spacing' => max(4, min(24, (int) ($params['spacing'] ?? 10))),
'shadow' => !empty($params['shadow']),
'animation' => !empty($params['animation']),
'opacity' => max(30, min(100, (int) ($params['opacity'] ?? 100))),
'active_color' => sanitize_hex_color($params['active_color'] ?? '') ?: '',
'bg_color' => sanitize_hex_color($params['bg_color'] ?? '') ?: '',
'pc_show' => !empty($params['pc_show']),
'm_show' => !empty($params['m_show']),
'filter_blur' => $filter_blur,
'items' => $items,
];
update_option('aksrt_floating_buttons', $settings);
if (class_exists('AKSRT_Settings')) {
AKSRT_Settings::flush_settings_cache();
}
return rest_ensure_response(['code' => 'success', 'message' => __('Floating button settings saved.', 'aksrt')]);
}
public function rest_reorder_floating_buttons(WP_REST_Request $request): WP_REST_Response {
$params = $this->get_json_params($request);
$ordered_ids = $params['ids'] ?? [];
if (!is_array($ordered_ids)) {
return new WP_REST_Response(['code' => 'error', 'message' => __('参数错误', 'aksrt')], 400);
}
$settings = get_option('aksrt_floating_buttons', []);
$items = $settings['items'] ?? [];
$order_map = array_flip($ordered_ids);
usort($items, function ($a, $b) use ($order_map) {
$idx_a = $order_map[($a['id'] ?? '')] ?? 999;
$idx_b = $order_map[($b['id'] ?? '')] ?? 999;
return $idx_a <=> $idx_b;
});
foreach ($items as $index => &$item) {
$item['sort_order'] = $index;
}
unset($item);
$settings['items'] = $items;
update_option('aksrt_floating_buttons', $settings);
if (class_exists('AKSRT_Settings')) {
AKSRT_Settings::flush_settings_cache();
}
return rest_ensure_response(['code' => 'success', 'message' => __('Order saved.', 'aksrt')]);
}
private function sanitize_floating_button_item(array $item): array {
$valid_types = ['back_top', 'theme_mode', 'qrcode', 'service_qq', 'service_wechat', 'pay_vip', 'custom', 'add', 'shop_cart'];
$type = sanitize_text_field($item['type'] ?? 'custom');
if (!in_array($type, $valid_types, true)) {
$type = 'custom';
}
$hover_width = (int) ($item['hover_width'] ?? 200);
if ($hover_width < 120) {
$hover_width = 120;
}
if ($hover_width > 480) {
$hover_width = 480;
}
$qq = preg_replace('/\D+/', '', (string) ($item['qq'] ?? ''));
$action_mode = sanitize_text_field($item['action_mode'] ?? 'link');
if (!in_array($action_mode, ['link', 'qrcode'], true)) {
$action_mode = 'link';
}
$qr_size = (int) ($item['qr_size'] ?? 120);
if ($qr_size < 80) {
$qr_size = 80;
}
if ($qr_size > 240) {
$qr_size = 240;
}
$add_items = [];
if (!empty($item['add_items']) && is_array($item['add_items'])) {
foreach ($item['add_items'] as $add_item) {
if (!is_array($add_item)) {
continue;
}
$label = sanitize_text_field($add_item['label'] ?? '');
$url = esc_url_raw($add_item['url'] ?? '');
$icon_item = sanitize_text_field($add_item['icon'] ?? '');
if ($label === '' && $url === '') {
continue;
}
$add_items[] = [
'id' => sanitize_text_field($add_item['id'] ?? uniqid('add_')),
'label' => $label,
'url' => $url,
'icon' => $icon_item,
];
}
}
$icon = sanitize_text_field($item['icon'] ?? '');
$icon_dark = sanitize_text_field($item['icon_dark'] ?? '');
$icon_light = sanitize_text_field($item['icon_light'] ?? '');
if ($type === 'theme_mode') {
$icon = 'fas fa-sun';
$icon_dark = '';
$icon_light = '';
}
return [
'id' => sanitize_text_field($item['id'] ?? uniqid('float_')),
'type' => $type,
'icon' => $icon,
'icon_dark' => $icon_dark,
'icon_light' => $icon_light,
'text' => sanitize_text_field($item['text'] ?? ''),
'desc' => sanitize_text_field($item['desc'] ?? ''),
'action_mode' => $action_mode,
'qq' => $qq,
'qrcode_img' => esc_url_raw($item['qrcode_img'] ?? ''),
'wechat_img' => esc_url_raw($item['wechat_img'] ?? ''),
'link' => esc_url_raw($item['link'] ?? ''),
'add_items' => $add_items,
'hover' => wp_kses_post($item['hover'] ?? ''),
'qr_size' => $qr_size,
'hover_width' => $hover_width,
'pc_s' => !empty($item['pc_s']),
'm_s' => !empty($item['m_s']),
'color' => sanitize_text_field($item['color'] ?? ''),
'bg' => sanitize_text_field($item['bg'] ?? ''),
'enabled' => !empty($item['enabled']),
'sort_order' => (int) ($item['sort_order'] ?? 0),
];
}
}
inc/classes/admin/global-ctrl-traits/trait-aksrt-admin-global-controller-part-2.php
+258
View File
@@ -0,0 +1,258 @@
<?php
defined('ABSPATH') || exit;
trait AKSRT_Admin_Global_Controller_Part_2 {
public function rest_handle_homepage_settings(WP_REST_Request $request): WP_REST_Response {
$option_key = 'aksrt_settings';
if ($request->get_method() === 'GET') {
$data = AKSRT_Settings::get_homepage_fixed_settings();
$data['homepage_modules'] = AKSRT_Settings::get_homepage_modules();
return rest_ensure_response([
'code' => 'success',
'data' => $data,
]);
}
$params = $this->get_json_params($request);
if (empty($params)) {
$params = $request->get_params();
}
$allowed_sorts = AKSRT_Settings::homepage_allowed_sorts();
$settings = [
'homepage_card_style' => in_array($params['homepage_card_style'] ?? '', ['default', 'style2', 'style3'], true)
? $params['homepage_card_style']
: 'default',
'homepage_multi_thumb_enabled' => !isset($params['homepage_multi_thumb_enabled']) || !empty($params['homepage_multi_thumb_enabled']),
'homepage_multi_thumb_min_images' => max(2, min(4, (int) ($params['homepage_multi_thumb_min_images'] ?? 3))),
'homepage_sidebar_mini_enabled' => !isset($params['homepage_sidebar_mini_enabled']) || !empty($params['homepage_sidebar_mini_enabled']),
'homepage_default_sort' => in_array($params['homepage_default_sort'] ?? '', $allowed_sorts, true)
? $params['homepage_default_sort']
: 'modified',
'homepage_default_view' => in_array($params['homepage_default_view'] ?? '', ['list', 'card'], true)
? $params['homepage_default_view']
: 'list',
'homepage_sort_ajax_enabled' => !isset($params['homepage_sort_ajax_enabled']) || !empty($params['homepage_sort_ajax_enabled']),
'homepage_sticky_tabs_enabled' => !isset($params['homepage_sticky_tabs_enabled']) || !empty($params['homepage_sticky_tabs_enabled']),
'homepage_content_model' => in_array($params['homepage_content_model'] ?? '', ['post', 'mixed'], true)
? $params['homepage_content_model']
: 'mixed',
'home_posts_list_enabled' => !isset($params['home_posts_list_enabled']) || !empty($params['home_posts_list_enabled']),
'home_list_title' => sanitize_text_field((string) ($params['home_list_title'] ?? __('Latest Posts', 'aksrt'))),
'home_list_sort_enabled' => !isset($params['home_list_sort_enabled']) || !empty($params['home_list_sort_enabled']),
'home_list_sort_dropdown' => !empty($params['home_list_sort_dropdown']),
'homepage_tab_posts_per_page' => max(1, min(20, (int) ($params['homepage_tab_posts_per_page'] ?? 6))),
'homepage_tab_limit' => max(1, min(12, (int) ($params['homepage_tab_limit'] ?? 4))),
];
if (isset($params['home_list_sort_options']) && is_array($params['home_list_sort_options'])) {
$seen = [];
$options = [];
foreach ($params['home_list_sort_options'] as $key) {
$key = sanitize_key((string) $key);
if (in_array($key, $allowed_sorts, true) && !isset($seen[$key])) {
$options[] = $key;
$seen[$key] = true;
}
}
$settings['home_list_sort_options'] = !empty($options) ? $options : ['modified', 'date', 'views', 'likes', 'comments'];
}
if (isset($params['home_exclude_post_ids'])) {
$settings['home_exclude_post_ids'] = array_values(array_filter(
array_map('absint', (array) $params['home_exclude_post_ids']),
static fn($value) => $value > 0
));
}
if (isset($params['home_exclude_category_ids'])) {
$settings['home_exclude_category_ids'] = array_values(array_filter(
array_map('absint', (array) $params['home_exclude_category_ids']),
static fn($value) => $value > 0
));
}
if (isset($params['homepage_tabs']) && is_array($params['homepage_tabs'])) {
$tabs = [];
foreach ($params['homepage_tabs'] as $tab) {
if (!is_array($tab)) {
continue;
}
$term_id = absint($tab['term_id'] ?? 0);
if ($term_id <= 0) {
continue;
}
$term = get_term($term_id, 'category');
if (!$term || is_wp_error($term)) {
continue;
}
$orderby = sanitize_key($tab['orderby'] ?? 'date');
if (!in_array($orderby, $allowed_sorts, true)) {
$orderby = 'date';
}
$tabs[] = [
'term_id' => $term_id,
'title' => sanitize_text_field($tab['title'] ?? ''),
'orderby' => $orderby,
'enabled' => !empty($tab['enabled']),
];
}
$settings['homepage_tabs'] = $tabs;
}
if (isset($params['homepage_modules']) && is_array($params['homepage_modules'])) {
$modules = [];
$allowed_types = [
'hero', 'banner', 'category', 'tabs', 'ranking', 'recent',
'tag_cloud', 'friend_links', 'html', 'hotspot',
'category_recommend_cards', 'text_title', 'button_group',
'spacing', 'faq', 'data_grid', 'highlight_cards',
'partner_marquee', 'product_showcase',
];
foreach ($params['homepage_modules'] as $module) {
if (!is_array($module) || !in_array($module['type'] ?? '', $allowed_types, true)) {
continue;
}
$modules[] = [
'id' => sanitize_text_field($module['id'] ?? uniqid('mod_')),
'type' => sanitize_text_field($module['type']),
'config' => is_array($module['config'] ?? null) ? $module['config'] : [],
'enabled' => !empty($module['enabled']),
'title' => sanitize_text_field($module['title'] ?? ''),
];
}
$settings['homepage_modules'] = $modules;
}
$current = get_option($option_key, []);
if (!is_array($current)) {
$current = [];
}
foreach ($settings as $key => $value) {
$current[$key] = $value;
}
update_option($option_key, $current);
AKSRT_Settings::flush_settings_cache();
update_option('aksrt_homepage_schema_version', gmdate('Y-m-d'));
delete_transient('aksrt_homepage_cached_images');
delete_transient('aksrt_homepage_modules_cache');
do_action('aksrt_homepage_settings_changed');
return rest_ensure_response([
'code' => 'success',
'message' => __('Homepage settings saved.', 'aksrt'),
'data' => $settings,
]);
}
public function rest_handle_category_recommend(WP_REST_Request $request): WP_REST_Response {
if ($request->get_method() === 'GET') {
$settings = AKSRT_Settings::get_category_recommend_settings();
return rest_ensure_response(['code' => 'success', 'data' => $settings]);
}
$params = $this->get_json_params($request);
$category_ids = array_map('absint', (array) ($params['category_recommend_category_ids'] ?? []));
$category_ids = array_filter($category_ids, fn($id) => $id > 0);
$category_ids = array_values(array_unique($category_ids));
$settings = [
'enable_category_recommend' => !empty($params['enable_category_recommend']),
'category_recommend_title' => sanitize_text_field($params['category_recommend_title'] ?? ''),
'category_recommend_category_ids' => $category_ids,
'category_recommend_posts_per_category' => max(1, min(10, (int) ($params['category_recommend_posts_per_category'] ?? 5))),
'category_recommend_columns' => max(1, min(4, (int) ($params['category_recommend_columns'] ?? 2))),
'category_recommend_show_description' => !empty($params['category_recommend_show_description']),
'category_recommend_show_dates' => !empty($params['category_recommend_show_dates']),
'category_recommend_show_more_link' => !empty($params['category_recommend_show_more_link']),
];
update_option('aksrt_category_recommend', $settings);
AKSRT_Settings::flush_category_recommend_cache();
return rest_ensure_response(['code' => 'success', 'message' => __('Category recommendation settings saved.', 'aksrt')]);
}
public function rest_get_categories(WP_REST_Request $request): WP_REST_Response {
$categories = get_categories([
'orderby' => 'count',
'order' => 'DESC',
'hide_empty' => false,
]);
$data = array_map(function ($cat) {
return [
'term_id' => (int) $cat->term_id,
'name' => $cat->name,
'slug' => $cat->slug,
'count' => (int) $cat->count,
'description' => $cat->description,
'cover_id' => (int) get_term_meta($cat->term_id, 'aksrt_category_cover_id', true),
'cover_url' => AKSRT_Settings::get_category_cover_url((int) $cat->term_id),
'recommend_desc' => (string) get_term_meta($cat->term_id, 'aksrt_category_recommend_desc', true),
];
}, $categories);
return rest_ensure_response(['code' => 'success', 'data' => array_values($data)]);
}
public function rest_search_users(WP_REST_Request $request): WP_REST_Response {
$search = (string) $request->get_param('search');
$number = max(1, min(50, (int) $request->get_param('number')));
$args = [
'number' => $number,
'orderby' => 'display_name',
'order' => 'ASC',
'fields' => ['ID', 'display_name', 'user_login'],
];
if ($search !== '') {
$args['search'] = '*' . $search . '*';
$args['search_columns'] = ['display_name', 'user_login', 'user_email'];
}
$users = get_users($args);
$data = array_map(function ($user) {
return [
'id' => (int) $user->ID,
'display_name' => $user->display_name,
'user_login' => $user->user_login,
];
}, $users);
return rest_ensure_response(['code' => 'success', 'data' => array_values($data)]);
}
public function rest_update_category_meta(WP_REST_Request $request): WP_REST_Response {
$id = (int) $request->get_param('id');
$term = get_term($id, 'category');
if (!$term || is_wp_error($term)) {
return new WP_REST_Response(['code' => 'error', 'message' => __('Category does not exist.', 'aksrt')], 404);
}
$params = $this->get_json_params($request);
$cover_id = absint($params['cover_id'] ?? 0);
$recommend_desc = sanitize_textarea_field($params['recommend_desc'] ?? '');
if ($cover_id > 0) {
update_term_meta($id, 'aksrt_category_cover_id', $cover_id);
} else {
delete_term_meta($id, 'aksrt_category_cover_id');
}
if ($recommend_desc !== '') {
update_term_meta($id, 'aksrt_category_recommend_desc', $recommend_desc);
} else {
delete_term_meta($id, 'aksrt_category_recommend_desc');
}
AKSRT_Settings::flush_category_recommend_cache();
return rest_ensure_response(['code' => 'success', 'message' => __('分类元数据已保存', 'aksrt')]);
}
}