kate522
3cf0c08969
PSR-4 split left GatewayInterface/Gateway duplicated across files; loading BalanceGateway redeclared the interface. Strip sibling types from polluted files (payment + widgets) so each path owns one type.
235 lines
11 KiB
PHP
235 lines
11 KiB
PHP
<?php
|
|
/**
|
|
* @package AKSRT
|
|
*/
|
|
|
|
namespace AKSRT\Widgets;
|
|
|
|
defined('ABSPATH') || exit;
|
|
|
|
/**
|
|
* Homepage category recommend cards widget.
|
|
*/
|
|
class CategoryRecommendWidget extends \WP_Widget {
|
|
|
|
public function __construct() {
|
|
parent::__construct(
|
|
'aksrt_category_recommend',
|
|
esc_html__('AKSRT 分类推荐卡片', 'aksrt'),
|
|
[
|
|
'classname' => 'widget_aksrt_category_recommend',
|
|
'description' => esc_html__('分类推荐卡片区块，可挂载到首页内容挂载区。', 'aksrt'),
|
|
'customize_selective_refresh' => true,
|
|
]
|
|
);
|
|
}
|
|
|
|
public function widget($args, $instance): void {
|
|
$title = apply_filters('widget_title', $instance['title'] ?? '', $instance, $this->id_base);
|
|
$title = $title !== '' ? $title : __('分类推荐', 'aksrt');
|
|
$category_ids = aksrt_home_widget_normalize_category_ids($instance['category_ids'] ?? [], 4);
|
|
$posts_per_cat = max(1, min(8, (int) ($instance['posts_per_category'] ?? 5)));
|
|
$columns = max(1, min(4, (int) ($instance['columns'] ?? 2)));
|
|
$show_views = ! empty($instance['show_views']);
|
|
$show_description = ! empty($instance['show_description']);
|
|
$show_dates = ! empty($instance['show_dates']);
|
|
$show_more = ! empty($instance['show_more']);
|
|
|
|
if (empty($category_ids)) {
|
|
$category_ids = aksrt_home_widget_fallback_category_ids(4);
|
|
}
|
|
|
|
$cards = $this->build_cards($category_ids, $posts_per_cat, $show_views, $show_description);
|
|
|
|
echo $args['before_widget'];
|
|
echo '<section class="aksrt-home-widget aksrt-home-widget--recommend">';
|
|
|
|
aksrt_home_widget_render_header($title);
|
|
|
|
if (empty($cards)) {
|
|
echo function_exists('aksrt_get_widget_null') ? aksrt_get_widget_null(__('暂无推荐分类', 'aksrt')) : '<p class="widget-empty">' . esc_html__('暂无推荐分类', 'aksrt') . '</p>';
|
|
echo '</section>';
|
|
echo $args['after_widget'];
|
|
return;
|
|
}
|
|
|
|
$lazy = aksrt_home_widget_get_lazyload_args();
|
|
printf('<div class="aksrt-category-recommend__grid" style="--aksrt-recommend-columns:%d;">', (int) $columns);
|
|
|
|
foreach ($cards as $card) {
|
|
?>
|
|
<article class="aksrt-category-recommend__card">
|
|
<div class="aksrt-category-recommend__hero">
|
|
<a href="<?php echo esc_url($card['link']); ?>">
|
|
<?php if ($lazy['enabled']) : ?>
|
|
<span class="aksrt-skeleton"></span>
|
|
<img class="aksrt-category-recommend__cover aksrt-lazy" data-src="<?php echo esc_url($card['cover']); ?>" src="<?php echo esc_url($lazy['placeholder_url']); ?>" alt="<?php echo esc_attr($card['name']); ?>">
|
|
<?php else : ?>
|
|
<img class="aksrt-category-recommend__cover" src="<?php echo esc_url($card['cover']); ?>" alt="<?php echo esc_attr($card['name']); ?>">
|
|
<?php endif; ?>
|
|
</a>
|
|
<span class="aksrt-category-recommend__badge"><?php echo esc_html(sprintf(_n('%d 篇文章', '%d 篇文章', $card['count'], 'aksrt'), $card['count'])); ?></span>
|
|
<?php if ($show_views && $card['views'] > 0) : ?>
|
|
<span class="aksrt-category-recommend__views">
|
|
<i class="fas fa-eye" aria-hidden="true"></i>
|
|
<?php echo esc_html(function_exists('aksrt_format_number') ? aksrt_format_number($card['views']) : number_format_i18n($card['views'])); ?>
|
|
</span>
|
|
<?php endif; ?>
|
|
</div>
|
|
<div class="aksrt-category-recommend__body">
|
|
<div class="aksrt-category-recommend__meta">
|
|
<h4 class="aksrt-category-recommend__name">
|
|
<a href="<?php echo esc_url($card['link']); ?>"><?php echo esc_html($card['name']); ?></a>
|
|
</h4>
|
|
<?php if ($show_description && $card['description'] !== '') : ?>
|
|
<p class="aksrt-category-recommend__desc"><?php echo esc_html($card['description']); ?></p>
|
|
<?php endif; ?>
|
|
</div>
|
|
<ul class="aksrt-category-recommend__posts">
|
|
<?php foreach ($card['posts'] as $post_item) : ?>
|
|
<li class="aksrt-category-recommend__post">
|
|
<a class="aksrt-category-recommend__post-link" href="<?php echo esc_url($post_item['link']); ?>">
|
|
<?php echo esc_html($post_item['title']); ?>
|
|
</a>
|
|
<?php if ($show_dates && $post_item['date'] !== '') : ?>
|
|
<span class="aksrt-category-recommend__date"><?php echo esc_html($post_item['date']); ?></span>
|
|
<?php endif; ?>
|
|
</li>
|
|
<?php endforeach; ?>
|
|
</ul>
|
|
<?php if ($show_more) : ?>
|
|
<div class="aksrt-home-widget__footer">
|
|
<a class="aksrt-home-widget__more" href="<?php echo esc_url($card['link']); ?>">
|
|
<?php esc_html_e('查看更多', 'aksrt'); ?>
|
|
</a>
|
|
</div>
|
|
<?php endif; ?>
|
|
</div>
|
|
</article>
|
|
<?php
|
|
}
|
|
|
|
echo '</div>';
|
|
echo '</section>';
|
|
echo $args['after_widget'];
|
|
}
|
|
|
|
public function form($instance): void {
|
|
$title = (string) ($instance['title'] ?? __('分类推荐', 'aksrt'));
|
|
$category_ids = aksrt_home_widget_normalize_category_ids($instance['category_ids'] ?? [], 4);
|
|
$posts_per_cat = (int) ($instance['posts_per_category'] ?? 5);
|
|
$columns = (int) ($instance['columns'] ?? 2);
|
|
$show_views = ! empty($instance['show_views']);
|
|
$show_description = ! array_key_exists('show_description', $instance) || ! empty($instance['show_description']);
|
|
$show_dates = ! array_key_exists('show_dates', $instance) || ! empty($instance['show_dates']);
|
|
$show_more = ! array_key_exists('show_more', $instance) || ! empty($instance['show_more']);
|
|
$categories = aksrt_home_widget_available_categories();
|
|
?>
|
|
<p>
|
|
<label for="<?php echo esc_attr($this->get_field_id('title')); ?>"><?php esc_html_e('标题：', 'aksrt'); ?></label>
|
|
<input class="widefat" id="<?php echo esc_attr($this->get_field_id('title')); ?>" name="<?php echo esc_attr($this->get_field_name('title')); ?>" type="text" value="<?php echo esc_attr($title); ?>">
|
|
</p>
|
|
<p>
|
|
<label for="<?php echo esc_attr($this->get_field_id('category_ids')); ?>"><?php esc_html_e('分类（最多 4 个）：', 'aksrt'); ?></label>
|
|
<select class="widefat" id="<?php echo esc_attr($this->get_field_id('category_ids')); ?>" name="<?php echo esc_attr($this->get_field_name('category_ids')); ?>[]" multiple size="6">
|
|
<?php foreach ($categories as $category) : ?>
|
|
<option value="<?php echo (int) $category->term_id; ?>" <?php selected(in_array((int) $category->term_id, $category_ids, true)); ?>>
|
|
<?php echo esc_html($category->name); ?>
|
|
</option>
|
|
<?php endforeach; ?>
|
|
</select>
|
|
<small><?php esc_html_e('留空时自动选择热门分类。', 'aksrt'); ?></small>
|
|
</p>
|
|
<p>
|
|
<label for="<?php echo esc_attr($this->get_field_id('posts_per_category')); ?>"><?php esc_html_e('每个分类展示文章数：', 'aksrt'); ?></label>
|
|
<input class="tiny-text" id="<?php echo esc_attr($this->get_field_id('posts_per_category')); ?>" name="<?php echo esc_attr($this->get_field_name('posts_per_category')); ?>" type="number" min="1" max="8" value="<?php echo (int) $posts_per_cat; ?>">
|
|
</p>
|
|
<p>
|
|
<label for="<?php echo esc_attr($this->get_field_id('columns')); ?>"><?php esc_html_e('桌面列数：', 'aksrt'); ?></label>
|
|
<input class="tiny-text" id="<?php echo esc_attr($this->get_field_id('columns')); ?>" name="<?php echo esc_attr($this->get_field_name('columns')); ?>" type="number" min="1" max="4" value="<?php echo (int) $columns; ?>">
|
|
</p>
|
|
<p>
|
|
<input class="checkbox" type="checkbox" <?php checked($show_views); ?> id="<?php echo esc_attr($this->get_field_id('show_views')); ?>" name="<?php echo esc_attr($this->get_field_name('show_views')); ?>" value="1">
|
|
<label for="<?php echo esc_attr($this->get_field_id('show_views')); ?>"><?php esc_html_e('显示分类总浏览量', 'aksrt'); ?></label>
|
|
</p>
|
|
<p>
|
|
<input class="checkbox" type="checkbox" <?php checked($show_description); ?> id="<?php echo esc_attr($this->get_field_id('show_description')); ?>" name="<?php echo esc_attr($this->get_field_name('show_description')); ?>" value="1">
|
|
<label for="<?php echo esc_attr($this->get_field_id('show_description')); ?>"><?php esc_html_e('显示分类描述', 'aksrt'); ?></label>
|
|
</p>
|
|
<p>
|
|
<input class="checkbox" type="checkbox" <?php checked($show_dates); ?> id="<?php echo esc_attr($this->get_field_id('show_dates')); ?>" name="<?php echo esc_attr($this->get_field_name('show_dates')); ?>" value="1">
|
|
<label for="<?php echo esc_attr($this->get_field_id('show_dates')); ?>"><?php esc_html_e('显示文章时间', 'aksrt'); ?></label>
|
|
</p>
|
|
<p>
|
|
<input class="checkbox" type="checkbox" <?php checked($show_more); ?> id="<?php echo esc_attr($this->get_field_id('show_more')); ?>" name="<?php echo esc_attr($this->get_field_name('show_more')); ?>" value="1">
|
|
<label for="<?php echo esc_attr($this->get_field_id('show_more')); ?>"><?php esc_html_e('显示“查看更多”链接', 'aksrt'); ?></label>
|
|
</p>
|
|
<?php if (function_exists('aksrt_widget_render_location_help')) { aksrt_widget_render_location_help('homepage'); } ?>
|
|
<?php
|
|
}
|
|
|
|
public function update($new_instance, $old_instance): array {
|
|
return [
|
|
'title' => sanitize_text_field($new_instance['title'] ?? ''),
|
|
'category_ids' => aksrt_home_widget_normalize_category_ids($new_instance['category_ids'] ?? [], 4),
|
|
'posts_per_category' => max(1, min(8, absint($new_instance['posts_per_category'] ?? 5))),
|
|
'columns' => max(1, min(4, absint($new_instance['columns'] ?? 2))),
|
|
'show_views' => ! empty($new_instance['show_views']) ? 1 : 0,
|
|
'show_description' => ! empty($new_instance['show_description']) ? 1 : 0,
|
|
'show_dates' => ! empty($new_instance['show_dates']) ? 1 : 0,
|
|
'show_more' => ! empty($new_instance['show_more']) ? 1 : 0,
|
|
];
|
|
}
|
|
|
|
/**
|
|
* Build category recommend cards.
|
|
*
|
|
* @param array<int, int> $category_ids Category ids.
|
|
* @param int $posts_per_cat Post count per category.
|
|
* @param bool $show_views Whether to calculate views.
|
|
* @param bool $show_description Whether to fetch description.
|
|
* @return array<int, array<string, mixed>>
|
|
*/
|
|
private function build_cards(array $category_ids, int $posts_per_cat, bool $show_views, bool $show_description): array {
|
|
$cards = [];
|
|
|
|
foreach ($category_ids as $category_id) {
|
|
$term = get_term($category_id, 'category');
|
|
if (! $term || is_wp_error($term)) {
|
|
continue;
|
|
}
|
|
|
|
$posts = get_posts([
|
|
'post_type' => aksrt_home_widget_post_types(),
|
|
'cat' => $category_id,
|
|
'posts_per_page' => $posts_per_cat,
|
|
'post_status' => 'publish',
|
|
'orderby' => 'date',
|
|
'order' => 'DESC',
|
|
'no_found_rows' => true,
|
|
]);
|
|
|
|
$post_items = [];
|
|
foreach ($posts as $post) {
|
|
$post_items[] = [
|
|
'title' => get_the_title($post->ID),
|
|
'link' => get_permalink($post->ID),
|
|
'date' => function_exists('aksrt_time_ago') ? aksrt_time_ago($post->post_date) : get_the_date('Y-m-d', $post->ID),
|
|
];
|
|
}
|
|
|
|
$cards[] = [
|
|
'name' => $term->name,
|
|
'link' => get_category_link($category_id),
|
|
'cover' => class_exists('\AKSRT\Settings\Settings') ? \AKSRT\Settings\Settings::get_category_cover_url($category_id) : (get_template_directory_uri() . '/assets/img/placeholder.svg'),
|
|
'description' => $show_description && class_exists('\AKSRT\Settings\Settings') ? \AKSRT\Settings\Settings::get_category_recommend_desc($category_id) : ($show_description ? (string) $term->description : ''),
|
|
'count' => (int) $term->count,
|
|
'views' => $show_views && function_exists('aksrt_get_category_total_views') ? aksrt_get_category_total_views($category_id) : 0,
|
|
'posts' => $post_items,
|
|
];
|
|
}
|
|
|
|
return $cards;
|
|
}
|
|
}
|