kate522
5fa902304b
Expose REST /shop/frontend/widgets/products, shared query_payload, ajax-list load-more markup, and product widget styles.
338 lines
16 KiB
PHP
338 lines
16 KiB
PHP
<?php
|
|
/**
|
|
* @package AKSRT
|
|
*/
|
|
|
|
namespace AKSRT\Widgets;
|
|
|
|
defined('ABSPATH') || exit;
|
|
|
|
/**
|
|
* Shop product list widget — zibll `zib_shop_widget_ui_product_lists` lite.
|
|
*
|
|
* Supports: include/exclude category, discount, tag; sort order; list style;
|
|
* AJAX load-more (via rest widget list endpoint); per-page count.
|
|
*/
|
|
class WidgetProductList extends \WP_Widget {
|
|
|
|
public function __construct() {
|
|
parent::__construct(
|
|
'aksrt_product_list',
|
|
__('商品列表', 'aksrt'),
|
|
['description' => __('AKSRT 商品列表组件：筛选、排序、AJAX 翻页。', 'aksrt')]
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Build WP_Query args from instance + page.
|
|
*
|
|
* @param array $instance
|
|
* @param int $paged
|
|
* @return array
|
|
*/
|
|
public static function build_query_args(array $instance, int $paged = 1): array {
|
|
$per_page = max(1, min(50, (int) ($instance['per_page'] ?? 8)));
|
|
$orderby = sanitize_key($instance['orderby'] ?? 'date');
|
|
$order = in_array(strtoupper((string) ($instance['order'] ?? '')), ['ASC', 'DESC'], true)
|
|
? strtoupper((string) $instance['order'])
|
|
: 'DESC';
|
|
$cat_ids = array_values(array_filter(array_map('intval', explode(',', (string) ($instance['cat_ids'] ?? '')))));
|
|
$tag_ids = array_values(array_filter(array_map('intval', explode(',', (string) ($instance['tag_ids'] ?? '')))));
|
|
$discount_ids = array_values(array_filter(array_map('intval', explode(',', (string) ($instance['discount_ids'] ?? '')))));
|
|
$exclude_cat = !empty($instance['exclude_cat']);
|
|
|
|
$query_args = [
|
|
'post_type' => 'aksrt_product',
|
|
'post_status' => 'publish',
|
|
'posts_per_page' => $per_page,
|
|
'paged' => max(1, $paged),
|
|
'orderby' => $orderby === 'sales' ? 'meta_value_num' : ($orderby === 'views' ? 'meta_value_num' : $orderby),
|
|
'order' => $order,
|
|
'ignore_sticky_posts' => true,
|
|
];
|
|
|
|
if ($orderby === 'sales') {
|
|
$query_args['meta_key'] = '_aksrt_sales';
|
|
} elseif ($orderby === 'views') {
|
|
$query_args['meta_key'] = 'aksrt_post_views';
|
|
}
|
|
|
|
$tax_query = [];
|
|
if (!empty($cat_ids)) {
|
|
$tax_query[] = [
|
|
'taxonomy' => 'aksrt_product_cat',
|
|
'field' => 'term_id',
|
|
'terms' => $cat_ids,
|
|
'operator' => $exclude_cat ? 'NOT IN' : 'IN',
|
|
];
|
|
}
|
|
if (!empty($tag_ids)) {
|
|
$tax_query[] = [
|
|
'taxonomy' => 'aksrt_product_tag',
|
|
'field' => 'term_id',
|
|
'terms' => $tag_ids,
|
|
];
|
|
}
|
|
if (!empty($discount_ids)) {
|
|
$tax_query[] = [
|
|
'taxonomy' => 'shop_discount',
|
|
'field' => 'term_id',
|
|
'terms' => $discount_ids,
|
|
];
|
|
}
|
|
if (!empty($tax_query)) {
|
|
$query_args['tax_query'] = $tax_query;
|
|
}
|
|
return $query_args;
|
|
}
|
|
|
|
/**
|
|
* Render product cards HTML for a query.
|
|
*/
|
|
public static function render_items_html(\WP_Query $products, string $style = 'default'): string {
|
|
if (!$products->have_posts()) {
|
|
return '';
|
|
}
|
|
ob_start();
|
|
while ($products->have_posts()) {
|
|
$products->the_post();
|
|
$pid = get_the_ID();
|
|
$card = class_exists('\AKSRT\Shop\Shop')
|
|
? \AKSRT\Shop\Shop::get_instance()->build_product_card_view($pid)
|
|
: [];
|
|
if (function_exists('get_template_part') && !empty($card['id'])) {
|
|
get_template_part('templates/parts/shop/product', 'card', [
|
|
'product' => $card,
|
|
'show_sales' => true,
|
|
]);
|
|
continue;
|
|
}
|
|
// Fallback mini card.
|
|
$price = (float) ($card['price'] ?? 0);
|
|
$image = (string) ($card['image'] ?? '');
|
|
echo '<div class="aksrt-product-widget__item ajax-item">';
|
|
if ($image !== '') {
|
|
echo '<a href="' . esc_url(get_permalink($pid)) . '" class="aksrt-product-widget__thumb">';
|
|
echo '<img src="' . esc_url($image) . '" alt="' . esc_attr(get_the_title($pid)) . '" loading="lazy">';
|
|
echo '</a>';
|
|
}
|
|
echo '<div class="aksrt-product-widget__info">';
|
|
echo '<a href="' . esc_url(get_permalink($pid)) . '" class="aksrt-product-widget__title">' . esc_html(get_the_title($pid)) . '</a>';
|
|
echo '<div class="aksrt-product-widget__meta">';
|
|
echo '<span class="aksrt-product-widget__price">¥' . esc_html(number_format_i18n($price, 2)) . '</span>';
|
|
if (!empty($card['sales'])) {
|
|
echo '<span class="aksrt-product-widget__sales">' . esc_html((string) $card['sales']) . esc_html__(' 已售', 'aksrt') . '</span>';
|
|
}
|
|
echo '</div></div></div>';
|
|
}
|
|
wp_reset_postdata();
|
|
return (string) ob_get_clean();
|
|
}
|
|
|
|
/**
|
|
* Shared payload for REST widget list.
|
|
*
|
|
* @param array $instance
|
|
* @param int $page
|
|
* @return array{html:string,paginate_html:string,has_more:bool,page:int,max_pages:int,total:int}
|
|
*/
|
|
public static function query_payload(array $instance, int $page = 1): array {
|
|
$page = max(1, $page);
|
|
$args = self::build_query_args($instance, $page);
|
|
$style = sanitize_key((string) ($instance['style'] ?? 'default'));
|
|
$paginate = sanitize_key((string) ($instance['paginate'] ?? 'ajax'));
|
|
$products = new \WP_Query($args);
|
|
$html = self::render_items_html($products, $style);
|
|
if ($html === '' && $page === 1) {
|
|
$html = function_exists('aksrt_get_ajax_null')
|
|
? aksrt_get_ajax_null(__('暂无商品', 'aksrt'))
|
|
: '<p class="aksrt-product-widget__empty ajax-item">' . esc_html__('暂无商品', 'aksrt') . '</p>';
|
|
}
|
|
$max_pages = max(1, (int) $products->max_num_pages);
|
|
$total = (int) $products->found_posts;
|
|
$has_more = $page < $max_pages;
|
|
$paginate_html = '';
|
|
if ($paginate === 'ajax' && $has_more) {
|
|
$next = add_query_arg(
|
|
array_filter([
|
|
'page' => $page + 1,
|
|
'per_page' => max(1, (int) ($instance['per_page'] ?? 8)),
|
|
'orderby' => sanitize_key((string) ($instance['orderby'] ?? 'date')),
|
|
'order' => sanitize_key((string) ($instance['order'] ?? 'DESC')),
|
|
'cat_ids' => (string) ($instance['cat_ids'] ?? ''),
|
|
'tag_ids' => (string) ($instance['tag_ids'] ?? ''),
|
|
'discount_ids' => (string) ($instance['discount_ids'] ?? ''),
|
|
'exclude_cat' => !empty($instance['exclude_cat']) ? 1 : 0,
|
|
'style' => sanitize_key((string) ($instance['style'] ?? 'default')),
|
|
'paginate' => 'ajax',
|
|
], static function ($v) {
|
|
return $v !== '' && $v !== null;
|
|
}),
|
|
rest_url('aksrt/v1/shop/frontend/widgets/products')
|
|
);
|
|
if (function_exists('aksrt_get_ajax_next_paginate')) {
|
|
$paginate_html = aksrt_get_ajax_next_paginate(
|
|
$total,
|
|
$page,
|
|
max(1, (int) ($instance['per_page'] ?? 8)),
|
|
$next
|
|
);
|
|
} else {
|
|
$paginate_html = '<div class="text-center theme-pagination ajax-pag"><div class="next-page ajax-next"><a href="' . esc_url($next) . '">' . esc_html__('加载更多', 'aksrt') . '</a></div></div>';
|
|
}
|
|
} elseif ($paginate === 'number' && $max_pages > 1) {
|
|
$paginate_html = '<div class="aksrt-product-widget__pagination">' . paginate_links([
|
|
'base' => add_query_arg('aksrt_product_page', '%#%'),
|
|
'format' => '',
|
|
'current' => $page,
|
|
'total' => $max_pages,
|
|
'prev_text' => '«',
|
|
'next_text' => '»',
|
|
]) . '</div>';
|
|
} else {
|
|
$paginate_html = '<div class="ajax-pag hide"><div class="next-page ajax-next"><a href="#"></a></div></div>';
|
|
}
|
|
|
|
return [
|
|
'html' => $html,
|
|
'paginate_html' => $paginate_html,
|
|
'has_more' => $has_more,
|
|
'page' => $page,
|
|
'max_pages' => $max_pages,
|
|
'total' => $total,
|
|
];
|
|
}
|
|
|
|
public function widget($args, $instance): void {
|
|
$title = apply_filters('widget_title', (string) ($instance['title'] ?? ''), $instance, $this->id_base);
|
|
$style = sanitize_key((string) ($instance['style'] ?? 'default'));
|
|
$paginate = sanitize_key((string) ($instance['paginate'] ?? 'ajax'));
|
|
$page = max(1, (int) ($_GET['aksrt_product_page'] ?? 1)); // phpcs:ignore WordPress.Security.NonceVerification.Recommended
|
|
|
|
$cfg = [
|
|
'per_page' => max(1, min(50, (int) ($instance['per_page'] ?? 8))),
|
|
'orderby' => sanitize_key((string) ($instance['orderby'] ?? 'date')),
|
|
'order' => in_array(strtoupper((string) ($instance['order'] ?? '')), ['ASC', 'DESC'], true) ? strtoupper((string) $instance['order']) : 'DESC',
|
|
'cat_ids' => (string) ($instance['cat_ids'] ?? ''),
|
|
'tag_ids' => (string) ($instance['tag_ids'] ?? ''),
|
|
'discount_ids' => (string) ($instance['discount_ids'] ?? ''),
|
|
'exclude_cat' => !empty($instance['exclude_cat']) ? 1 : 0,
|
|
'style' => $style,
|
|
'paginate' => $paginate,
|
|
];
|
|
|
|
$payload = self::query_payload($instance, $page);
|
|
$ajax_url = rest_url('aksrt/v1/shop/frontend/widgets/products');
|
|
|
|
echo $args['before_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
|
if ($title !== '') {
|
|
echo $args['before_title'] . esc_html($title) . $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
|
}
|
|
|
|
$style_class = 'aksrt-product-widget--' . $style;
|
|
echo '<div class="aksrt-product-widget ' . esc_attr($style_class) . '" data-aksrt-product-widget data-aksrt-product-config="' . esc_attr(wp_json_encode($cfg)) . '">';
|
|
// Items sit directly under .ajaxpager so ajax-list inject/append works (zibll product-lists-row).
|
|
echo '<div class="ajaxpager aksrt-product-widget__grid product-lists-row" data-aksrt-ajaxpager data-aksrt-ajax-url="' . esc_url($ajax_url) . '">';
|
|
echo $payload['html']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped — cards escaped upstream
|
|
echo $payload['paginate_html']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
|
echo '<div class="post_ajax_loader" data-aksrt-ajax-loader data-aksrt-ajax-loader-hide hidden></div>';
|
|
echo '</div></div>';
|
|
|
|
echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
|
}
|
|
|
|
public function form($instance): void {
|
|
$defaults = [
|
|
'title' => __('商品推荐', 'aksrt'),
|
|
'per_page' => 8,
|
|
'orderby' => 'date',
|
|
'order' => 'DESC',
|
|
'cat_ids' => '',
|
|
'tag_ids' => '',
|
|
'discount_ids' => '',
|
|
'exclude_cat' => false,
|
|
'style' => 'default',
|
|
'paginate' => 'ajax',
|
|
];
|
|
$instance = wp_parse_args($instance, $defaults);
|
|
?>
|
|
<p>
|
|
<label for="<?php echo esc_attr($this->get_field_id('title')); ?>"><?php esc_html_e('标题:', 'aksrt'); ?></label>
|
|
<input class="widefat" type="text" id="<?php echo esc_attr($this->get_field_id('title')); ?>" name="<?php echo esc_attr($this->get_field_name('title')); ?>" value="<?php echo esc_attr((string) $instance['title']); ?>">
|
|
</p>
|
|
<p>
|
|
<label for="<?php echo esc_attr($this->get_field_id('per_page')); ?>"><?php esc_html_e('每页数量:', 'aksrt'); ?></label>
|
|
<input class="tiny-text" type="number" min="1" max="50" id="<?php echo esc_attr($this->get_field_id('per_page')); ?>" name="<?php echo esc_attr($this->get_field_name('per_page')); ?>" value="<?php echo esc_attr((string) $instance['per_page']); ?>">
|
|
</p>
|
|
<p>
|
|
<label for="<?php echo esc_attr($this->get_field_id('orderby')); ?>"><?php esc_html_e('排序:', 'aksrt'); ?></label>
|
|
<select class="widefat" id="<?php echo esc_attr($this->get_field_id('orderby')); ?>" name="<?php echo esc_attr($this->get_field_name('orderby')); ?>">
|
|
<option value="date" <?php selected($instance['orderby'], 'date'); ?>><?php esc_html_e('最新', 'aksrt'); ?></option>
|
|
<option value="sales" <?php selected($instance['orderby'], 'sales'); ?>><?php esc_html_e('销量', 'aksrt'); ?></option>
|
|
<option value="views" <?php selected($instance['orderby'], 'views'); ?>><?php esc_html_e('热度', 'aksrt'); ?></option>
|
|
<option value="title" <?php selected($instance['orderby'], 'title'); ?>><?php esc_html_e('标题', 'aksrt'); ?></option>
|
|
<option value="rand" <?php selected($instance['orderby'], 'rand'); ?>><?php esc_html_e('随机', 'aksrt'); ?></option>
|
|
</select>
|
|
</p>
|
|
<p>
|
|
<label for="<?php echo esc_attr($this->get_field_id('order')); ?>"><?php esc_html_e('方向:', 'aksrt'); ?></label>
|
|
<select class="widefat" id="<?php echo esc_attr($this->get_field_id('order')); ?>" name="<?php echo esc_attr($this->get_field_name('order')); ?>">
|
|
<option value="DESC" <?php selected($instance['order'], 'DESC'); ?>><?php esc_html_e('降序', 'aksrt'); ?></option>
|
|
<option value="ASC" <?php selected($instance['order'], 'ASC'); ?>><?php esc_html_e('升序', 'aksrt'); ?></option>
|
|
</select>
|
|
</p>
|
|
<p>
|
|
<label for="<?php echo esc_attr($this->get_field_id('cat_ids')); ?>"><?php esc_html_e('分类ID(逗号分隔):', 'aksrt'); ?></label>
|
|
<input class="widefat" type="text" id="<?php echo esc_attr($this->get_field_id('cat_ids')); ?>" name="<?php echo esc_attr($this->get_field_name('cat_ids')); ?>" value="<?php echo esc_attr((string) $instance['cat_ids']); ?>">
|
|
</p>
|
|
<p>
|
|
<label>
|
|
<input type="checkbox" name="<?php echo esc_attr($this->get_field_name('exclude_cat')); ?>" value="1" <?php checked(!empty($instance['exclude_cat'])); ?>>
|
|
<?php esc_html_e('排除上述分类', 'aksrt'); ?>
|
|
</label>
|
|
</p>
|
|
<p>
|
|
<label for="<?php echo esc_attr($this->get_field_id('tag_ids')); ?>"><?php esc_html_e('标签ID(逗号分隔):', 'aksrt'); ?></label>
|
|
<input class="widefat" type="text" id="<?php echo esc_attr($this->get_field_id('tag_ids')); ?>" name="<?php echo esc_attr($this->get_field_name('tag_ids')); ?>" value="<?php echo esc_attr((string) $instance['tag_ids']); ?>">
|
|
</p>
|
|
<p>
|
|
<label for="<?php echo esc_attr($this->get_field_id('discount_ids')); ?>"><?php esc_html_e('优惠活动ID(逗号分隔):', 'aksrt'); ?></label>
|
|
<input class="widefat" type="text" id="<?php echo esc_attr($this->get_field_id('discount_ids')); ?>" name="<?php echo esc_attr($this->get_field_name('discount_ids')); ?>" value="<?php echo esc_attr((string) $instance['discount_ids']); ?>">
|
|
</p>
|
|
<p>
|
|
<label for="<?php echo esc_attr($this->get_field_id('style')); ?>"><?php esc_html_e('列表样式:', 'aksrt'); ?></label>
|
|
<select class="widefat" id="<?php echo esc_attr($this->get_field_id('style')); ?>" name="<?php echo esc_attr($this->get_field_name('style')); ?>">
|
|
<option value="default" <?php selected($instance['style'], 'default'); ?>><?php esc_html_e('默认', 'aksrt'); ?></option>
|
|
<option value="card" <?php selected($instance['style'], 'card'); ?>><?php esc_html_e('卡片', 'aksrt'); ?></option>
|
|
<option value="list" <?php selected($instance['style'], 'list'); ?>><?php esc_html_e('列表', 'aksrt'); ?></option>
|
|
<option value="mini" <?php selected($instance['style'], 'mini'); ?>><?php esc_html_e('迷你', 'aksrt'); ?></option>
|
|
<option value="oneline" <?php selected($instance['style'], 'oneline'); ?>><?php esc_html_e('横滑', 'aksrt'); ?></option>
|
|
</select>
|
|
</p>
|
|
<p>
|
|
<label for="<?php echo esc_attr($this->get_field_id('paginate')); ?>"><?php esc_html_e('分页:', 'aksrt'); ?></label>
|
|
<select class="widefat" id="<?php echo esc_attr($this->get_field_id('paginate')); ?>" name="<?php echo esc_attr($this->get_field_name('paginate')); ?>">
|
|
<option value="ajax" <?php selected($instance['paginate'], 'ajax'); ?>><?php esc_html_e('AJAX 加载更多', 'aksrt'); ?></option>
|
|
<option value="number" <?php selected($instance['paginate'], 'number'); ?>><?php esc_html_e('数字分页', 'aksrt'); ?></option>
|
|
<option value="none" <?php selected($instance['paginate'], 'none'); ?>><?php esc_html_e('无', 'aksrt'); ?></option>
|
|
</select>
|
|
</p>
|
|
<?php
|
|
}
|
|
|
|
public function update($new_instance, $old_instance): array {
|
|
return [
|
|
'title' => sanitize_text_field((string) ($new_instance['title'] ?? '')),
|
|
'per_page' => max(1, min(50, (int) ($new_instance['per_page'] ?? 8))),
|
|
'orderby' => sanitize_key((string) ($new_instance['orderby'] ?? 'date')),
|
|
'order' => in_array(strtoupper((string) ($new_instance['order'] ?? '')), ['ASC', 'DESC'], true) ? strtoupper((string) $new_instance['order']) : 'DESC',
|
|
'cat_ids' => sanitize_text_field((string) ($new_instance['cat_ids'] ?? '')),
|
|
'tag_ids' => sanitize_text_field((string) ($new_instance['tag_ids'] ?? '')),
|
|
'discount_ids' => sanitize_text_field((string) ($new_instance['discount_ids'] ?? '')),
|
|
'exclude_cat' => !empty($new_instance['exclude_cat']) ? 1 : 0,
|
|
'style' => sanitize_key((string) ($new_instance['style'] ?? 'default')),
|
|
'paginate' => sanitize_key((string) ($new_instance['paginate'] ?? 'ajax')),
|
|
];
|
|
}
|
|
}
|