'; $index = 0; while ($query->have_posts()) { $query->the_post(); $index++; $rank_class = $index <= 3 ? ' rank-top' : ''; $views = (int) get_post_meta(get_the_ID(), 'aksrt_post_views', true); ?> '; wp_reset_postdata(); } else { echo '

' . esc_html__('暂无热门文章', 'aksrt') . '

'; } echo $args['after_widget']; } public function form($instance): void { $title = $instance['title'] ?? __('热门文章', 'aksrt'); $count = (int) ($instance['count'] ?? 5); $order_by = $instance['order_by'] ?? 'views'; $days = (int) ($instance['days'] ?? 30); ?>

> > > > >

sanitize_text_field($new_instance['title'] ?? ''), 'count' => absint($new_instance['count'] ?? 5), 'order_by' => in_array($new_instance['order_by'] ?? '', ['views', 'comments', 'likes', 'favorites', 'downloads'], true) ? $new_instance['order_by'] : 'views', 'days' => absint($new_instance['days'] ?? 30), ]; } } // ============================================================ // 2. 多栏目 Tab 切换文章列表小工具 // ============================================================ class AKSRT_Tab_Posts_Widget extends WP_Widget { public function __construct() { parent::__construct( 'aksrt_tab_posts', esc_html__('AKSRT 多栏目文章', 'aksrt'), [ 'description' => esc_html__('Tab 切换显示不同分类的文章列表', 'aksrt'), 'customize_selective_refresh' => true, ] ); } /** * Normalize tabs from legacy comma-separated string or structured array. * * @param mixed $tabs Raw tabs data. * @return array Normalized structured tabs. */ private function normalize_tabs($tabs): array { // Legacy comma-separated format if (is_string($tabs) && $tabs !== '') { $legacy_keys = array_map('trim', explode(',', $tabs)); $legacy_defs = [ 'latest' => ['title' => '最新', 'orderby' => 'date'], 'comments' => ['title' => '热评', 'orderby' => 'comments'], 'random' => ['title' => '随机', 'orderby' => 'rand'], 'views' => ['title' => '热门', 'orderby' => 'views'], ]; $result = []; foreach ($legacy_keys as $key) { if (isset($legacy_defs[$key])) { $result[] = [ 'title' => __($legacy_defs[$key]['title'], 'aksrt'), 'category_id' => 0, 'orderby' => $legacy_defs[$key]['orderby'], 'count' => 0, 'enabled' => true, ]; } elseif (is_numeric($key) && absint($key) > 0) { $term = get_term(absint($key), 'category'); $result[] = [ 'title' => ($term && !is_wp_error($term)) ? $term->name : '', 'category_id' => absint($key), 'orderby' => 'date', 'count' => 0, 'enabled' => true, ]; } } return $result; } // Structured array format if (is_array($tabs)) { $allowed_orderby = ['date', 'modified', 'views', 'likes', 'comments', 'favorites', 'downloads', 'rand']; $result = []; foreach ($tabs as $tab) { if (!is_array($tab)) continue; $orderby = sanitize_key($tab['orderby'] ?? 'date'); if (!in_array($orderby, $allowed_orderby, true)) $orderby = 'date'; $result[] = [ 'title' => sanitize_text_field($tab['title'] ?? ''), 'category_id' => absint($tab['category_id'] ?? 0), 'orderby' => $orderby, 'count' => max(0, min(20, (int) ($tab['count'] ?? 0))), 'enabled' => !empty($tab['enabled']), ]; } return $result; } return []; } /** * Build WP_Query args for a tab's orderby. */ private function build_tab_query_args(array $tab, int $default_count): array { $count = $tab['count'] > 0 ? $tab['count'] : $default_count; $args = [ 'post_type' => 'post', 'post_status' => 'publish', 'posts_per_page' => $count, 'ignore_sticky_posts' => true, 'no_found_rows' => true, ]; if ($tab['category_id'] > 0) { $args['cat'] = $tab['category_id']; } switch ($tab['orderby']) { case 'views': $args['meta_key'] = 'aksrt_post_views'; $args['orderby'] = 'meta_value_num'; $args['order'] = 'DESC'; break; case 'likes': $args['meta_key'] = '_aksrt_like_count'; $args['orderby'] = 'meta_value_num'; $args['order'] = 'DESC'; break; case 'favorites': $args['meta_key'] = '_aksrt_favorite_count'; $args['orderby'] = 'meta_value_num'; $args['order'] = 'DESC'; break; case 'downloads': $args['meta_key'] = '_aksrt_res_download_count'; $args['orderby'] = 'meta_value_num'; $args['order'] = 'DESC'; break; case 'comments': $args['orderby'] = 'comment_count'; $args['order'] = 'DESC'; break; case 'rand': $args['orderby'] = 'rand'; break; case 'modified': $args['orderby'] = 'modified'; $args['order'] = 'DESC'; break; case 'date': default: $args['orderby'] = 'date'; $args['order'] = 'DESC'; break; } return $args; } public function widget($args, $instance): void { echo $args['before_widget']; $title = apply_filters('widget_title', $instance['title'] ?? '', $instance, $this->id_base); $count = absint($instance['count'] ?? 5); $tabs = $this->normalize_tabs($instance['tabs'] ?? 'latest,comments,random'); // Filter enabled tabs $tabs = array_filter($tabs, fn($t) => !empty($t['enabled'])); if (empty($tabs)) { echo $args['after_widget']; return; } if ($title) { echo $args['before_title'] . esc_html($title) . $args['after_title']; } $widget_id = $this->id; $use_shared = function_exists('aksrt_render_mini_list'); ?> normalize_tabs($instance['tabs'] ?? 'latest,comments,random'); $orderby_options = [ 'date' => __('最新', 'aksrt'), 'modified' => __('更新', 'aksrt'), 'views' => __('浏览', 'aksrt'), 'likes' => __('点赞', 'aksrt'), 'comments' => __('评论', 'aksrt'), 'favorites' => __('收藏', 'aksrt'), 'downloads' => __('下载', 'aksrt'), 'rand' => __('随机', 'aksrt'), ]; ?>

---

'', 'category_id' => 0, 'orderby' => 'date', 'count' => 0, 'enabled' => false]; } foreach ($tabs as $i => $tab) : ?> " value=""> sanitize_text_field($new_instance['title'] ?? ''), 'count' => max(1, min(20, (int) ($new_instance['count'] ?? 5))), ]; $tabs = []; if (isset($new_instance['tabs']) && is_array($new_instance['tabs'])) { $allowed_orderby = ['date', 'modified', 'views', 'likes', 'comments', 'favorites', 'downloads', 'rand']; foreach ($new_instance['tabs'] as $tab) { if (!is_array($tab)) continue; $orderby = sanitize_key($tab['orderby'] ?? 'date'); if (!in_array($orderby, $allowed_orderby, true)) $orderby = 'date'; $tabs[] = [ 'title' => sanitize_text_field($tab['title'] ?? ''), 'category_id' => absint($tab['category_id'] ?? 0), 'orderby' => $orderby, 'count' => max(0, min(20, (int) ($tab['count'] ?? 0))), 'enabled' => !empty($tab['enabled']), ]; } } $result['tabs'] = !empty($tabs) ? $tabs : sanitize_text_field($new_instance['tabs'] ?? 'latest,comments,random'); return $result; } }