kate522
5a900d7385
Expose static HTML/query payloads for homepage category widgets, tag cloud, categories, and term card/aggregation remote refresh.
182 lines
7.1 KiB
PHP
182 lines
7.1 KiB
PHP
<?php
|
|
/**
|
|
* Taxonomy term cards (zibll zib_widget_ui_term_card lite).
|
|
*
|
|
* @package AKSRT
|
|
*/
|
|
|
|
namespace AKSRT\Widgets;
|
|
|
|
defined('ABSPATH') || exit;
|
|
|
|
class WidgetTermCards extends \WP_Widget {
|
|
|
|
public function __construct() {
|
|
parent::__construct(
|
|
'aksrt_term_cards',
|
|
esc_html__('AKSRT 分类/标签卡片', 'aksrt'),
|
|
[
|
|
'description' => esc_html__('以卡片展示分类或标签。', 'aksrt'),
|
|
'classname' => 'widget_aksrt_term_cards',
|
|
]
|
|
);
|
|
}
|
|
|
|
/** @return array<int,int> */
|
|
public static function parse_ids_static(string $raw): array {
|
|
if ($raw === '') {
|
|
return [];
|
|
}
|
|
$ids = [];
|
|
foreach (preg_split('/[\s,]+/', $raw) ?: [] as $p) {
|
|
$id = (int) $p;
|
|
if ($id > 0) {
|
|
$ids[] = $id;
|
|
}
|
|
}
|
|
return array_values(array_unique($ids));
|
|
}
|
|
|
|
public static function render_html(array $instance): string {
|
|
$taxonomy = sanitize_key((string) ($instance['taxonomy'] ?? 'category'));
|
|
if (!taxonomy_exists($taxonomy)) {
|
|
$taxonomy = 'category';
|
|
}
|
|
$number = max(1, min(30, (int) ($instance['number'] ?? 8)));
|
|
$orderby = sanitize_key((string) ($instance['orderby'] ?? 'count'));
|
|
$include = self::parse_ids_static((string) ($instance['include'] ?? ''));
|
|
$hide_empty = !isset($instance['hide_empty']) || !empty($instance['hide_empty']);
|
|
|
|
$term_args = [
|
|
'taxonomy' => $taxonomy,
|
|
'number' => $number,
|
|
'hide_empty' => $hide_empty,
|
|
];
|
|
if ($include) {
|
|
$term_args['include'] = $include;
|
|
$term_args['orderby'] = 'include';
|
|
} else {
|
|
$term_args['orderby'] = in_array($orderby, ['name', 'count', 'id'], true) ? $orderby : 'count';
|
|
$term_args['order'] = $orderby === 'name' ? 'ASC' : 'DESC';
|
|
}
|
|
|
|
$terms = get_terms($term_args);
|
|
if (is_wp_error($terms) || !$terms) {
|
|
return function_exists('aksrt_get_ajax_null')
|
|
? aksrt_get_ajax_null(__('暂无分类', 'aksrt'))
|
|
: '<p class="widget-empty ajax-item">' . esc_html__('暂无分类', 'aksrt') . '</p>';
|
|
}
|
|
|
|
$cols = max(1, min(4, (int) ($instance['columns'] ?? 2)));
|
|
ob_start();
|
|
echo '<div class="aksrt-term-cards ajax-item" style="--aksrt-tc-cols:' . esc_attr((string) $cols) . '">';
|
|
foreach ($terms as $term) {
|
|
$link = get_term_link($term);
|
|
if (is_wp_error($link)) {
|
|
continue;
|
|
}
|
|
$thumb = '';
|
|
if (function_exists('get_term_meta')) {
|
|
$img_id = (int) get_term_meta($term->term_id, 'thumbnail_id', true);
|
|
if (!$img_id) {
|
|
$img_id = (int) get_term_meta($term->term_id, '_aksrt_cover', true);
|
|
}
|
|
if ($img_id) {
|
|
$thumb = wp_get_attachment_image_url($img_id, 'medium') ?: '';
|
|
}
|
|
if ($thumb === '') {
|
|
$thumb = (string) get_term_meta($term->term_id, '_aksrt_cover_url', true);
|
|
}
|
|
}
|
|
echo '<a class="aksrt-term-card" href="' . esc_url($link) . '">';
|
|
if ($thumb !== '') {
|
|
echo '<div class="aksrt-term-card__cover" style="background-image:url(' . esc_url($thumb) . ')"></div>';
|
|
} else {
|
|
echo '<div class="aksrt-term-card__cover is-empty"></div>';
|
|
}
|
|
echo '<div class="aksrt-term-card__body">';
|
|
echo '<div class="aksrt-term-card__name">' . esc_html($term->name) . '</div>';
|
|
echo '<div class="aksrt-term-card__count">' . esc_html(sprintf(_n('%d 篇', '%d 篇', (int) $term->count, 'aksrt'), (int) $term->count)) . '</div>';
|
|
echo '</div></a>';
|
|
}
|
|
echo '</div>';
|
|
return (string) ob_get_clean();
|
|
}
|
|
|
|
public function widget($args, $instance): void {
|
|
$html = self::render_html($instance);
|
|
if ($html === '') {
|
|
return;
|
|
}
|
|
echo $args['before_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
|
$title = apply_filters('widget_title', (string) ($instance['title'] ?? ''), $instance, $this->id_base);
|
|
if ($title !== '') {
|
|
echo $args['before_title'] . esc_html($title) . $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
|
}
|
|
echo $html; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
|
echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
|
}
|
|
|
|
/** @return array<int,int> */
|
|
private function parse_ids(string $raw): array {
|
|
return self::parse_ids_static($raw);
|
|
}
|
|
|
|
public function form($instance): void {
|
|
$taxs = get_taxonomies(['public' => true], 'objects');
|
|
?>
|
|
<p>
|
|
<label><?php esc_html_e('标题', 'aksrt'); ?>
|
|
<input class="widefat" type="text" name="<?php echo esc_attr($this->get_field_name('title')); ?>" value="<?php echo esc_attr((string) ($instance['title'] ?? '')); ?>">
|
|
</label>
|
|
</p>
|
|
<p>
|
|
<label><?php esc_html_e('分类法', 'aksrt'); ?>
|
|
<select class="widefat" name="<?php echo esc_attr($this->get_field_name('taxonomy')); ?>">
|
|
<?php foreach ($taxs as $tax) : ?>
|
|
<option value="<?php echo esc_attr($tax->name); ?>" <?php selected(($instance['taxonomy'] ?? 'category'), $tax->name); ?>><?php echo esc_html($tax->labels->name . ' (' . $tax->name . ')'); ?></option>
|
|
<?php endforeach; ?>
|
|
</select>
|
|
</label>
|
|
</p>
|
|
<p>
|
|
<label><?php esc_html_e('数量', 'aksrt'); ?>
|
|
<input class="tiny-text" type="number" min="1" max="30" name="<?php echo esc_attr($this->get_field_name('number')); ?>" value="<?php echo esc_attr((string) ((int) ($instance['number'] ?? 8))); ?>">
|
|
</label>
|
|
<label><?php esc_html_e('列数', 'aksrt'); ?>
|
|
<input class="tiny-text" type="number" min="1" max="4" name="<?php echo esc_attr($this->get_field_name('columns')); ?>" value="<?php echo esc_attr((string) ((int) ($instance['columns'] ?? 2))); ?>">
|
|
</label>
|
|
</p>
|
|
<p>
|
|
<label><?php esc_html_e('排序', 'aksrt'); ?>
|
|
<select name="<?php echo esc_attr($this->get_field_name('orderby')); ?>">
|
|
<option value="count" <?php selected(($instance['orderby'] ?? 'count'), 'count'); ?>><?php esc_html_e('文章数', 'aksrt'); ?></option>
|
|
<option value="name" <?php selected(($instance['orderby'] ?? ''), 'name'); ?>><?php esc_html_e('名称', 'aksrt'); ?></option>
|
|
<option value="id" <?php selected(($instance['orderby'] ?? ''), 'id'); ?>><?php esc_html_e('ID', 'aksrt'); ?></option>
|
|
</select>
|
|
</label>
|
|
</p>
|
|
<p>
|
|
<label><?php esc_html_e('包含 term ID（逗号）', 'aksrt'); ?>
|
|
<input class="widefat" type="text" name="<?php echo esc_attr($this->get_field_name('include')); ?>" value="<?php echo esc_attr((string) ($instance['include'] ?? '')); ?>">
|
|
</label>
|
|
</p>
|
|
<p>
|
|
<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('hide_empty')); ?>" value="1" <?php checked(!isset($instance['hide_empty']) || !empty($instance['hide_empty'])); ?>> <?php esc_html_e('隐藏空分类', 'aksrt'); ?></label>
|
|
</p>
|
|
<?php
|
|
}
|
|
|
|
public function update($new_instance, $old_instance): array {
|
|
return [
|
|
'title' => sanitize_text_field((string) ($new_instance['title'] ?? '')),
|
|
'taxonomy' => sanitize_key((string) ($new_instance['taxonomy'] ?? 'category')),
|
|
'number' => max(1, min(30, (int) ($new_instance['number'] ?? 8))),
|
|
'columns' => max(1, min(4, (int) ($new_instance['columns'] ?? 2))),
|
|
'orderby' => in_array(($new_instance['orderby'] ?? ''), ['count', 'name', 'id'], true) ? $new_instance['orderby'] : 'count',
|
|
'include' => sanitize_text_field((string) ($new_instance['include'] ?? '')),
|
|
'hide_empty' => !empty($new_instance['hide_empty']) ? 1 : 0,
|
|
];
|
|
}
|
|
}
|