如何在主题中获取WooCommerce后台配置的商品目录排序选项值？

嘿，我来帮你搞定这个WooCommerce排序集成的事儿！要把后台管理员配置的商品目录排序选项无缝用到自定义主题里，其实分几个关键步骤，一步步来就很简单：

1. 获取后台管理员启用的排序选项 #

WooCommerce自带了读取后台配置的函数，你可以直接拿到管理员在「WooCommerce设置→产品→显示」里勾选的允许的排序方式，代码如下：

// 获取后台启用的商品排序选项（键为排序参数，值为显示文本）
$enabled_orderby = get_option('woocommerce_catalog_orderby_options', array());

// 兜底：如果后台没配置任何选项，使用WooCommerce默认排序列表
if (empty($enabled_orderby)) {
    $enabled_orderby = array(
        'menu_order' => __('Default sorting', 'woocommerce'),
        'popularity' => __('Sort by popularity', 'woocommerce'),
        'rating' => __('Sort by average rating', 'woocommerce'),
        'date' => __('Sort by latest', 'woocommerce'),
        'price' => __('Sort by price: low to high', 'woocommerce'),
        'price-desc' => __('Sort by price: high to low', 'woocommerce'),
    );
}

这段代码会返回一个键值对数组，比如'popularity' => 'Sort by popularity'，完全匹配后台管理员的配置。

2. 在自定义主题中渲染排序下拉菜单 #

拿到排序选项后，你可以在产品列表的合适位置（比如顶部、侧边栏）渲染一个下拉选择菜单，让用户切换排序方式。这里要注意保留当前页面的筛选参数（比如分类、搜索词、分页），避免切换排序时丢失筛选状态：

// 输出排序下拉菜单表单
if (!empty($enabled_orderby)) {
    echo '<form class="woocommerce-ordering" method="get">';
    echo '<select name="orderby" class="orderby" aria-label="' . esc_attr__('Shop order', 'woocommerce') . '">';
    
    // 遍历渲染每个排序选项
    foreach ($enabled_orderby as $key => $label) {
        // 标记当前选中的排序方式
        $selected = (isset($_GET['orderby']) && $_GET['orderby'] === $key) ? 'selected="selected"' : '';
        echo '<option value="' . esc_attr($key) . '" ' . $selected . '>' . esc_html($label) . '</option>';
    }
    
    // 保留其他查询参数（比如分类、搜索、分页）
    foreach ($_GET as $key => $value) {
        if ($key !== 'orderby' && $key !== 'submit') {
            echo '<input type="hidden" name="' . esc_attr($key) . '" value="' . esc_attr($value) . '">';
        }
    }
    
    echo '</select>';
    echo '<button type="submit" class="screen-reader-text">' . esc_html__('Apply sorting', 'woocommerce') . '</button>';
    echo '</form>';
}

提示：你可以给这个表单添加自定义CSS类，让它适配你的主题样式。

3. 确保排序逻辑生效 #

如果你的主题用的是WooCommerce默认的产品查询，那上面的代码已经足够——WooCommerce会自动处理orderby参数的排序逻辑。但如果你用了自定义WP_Query来获取产品，就需要手动把排序参数传入查询：

// 获取当前排序参数（默认用后台设置的默认排序）
$orderby = isset($_GET['orderby']) ? sanitize_text_field($_GET['orderby']) : get_option('woocommerce_default_catalog_orderby', 'menu_order');
$order = 'asc'; // 默认升序
$meta_key = '';

// 根据不同排序类型调整查询参数
switch ($orderby) {
    case 'price-desc':
        $orderby = 'price';
        $order = 'desc';
        break;
    case 'popularity':
        $orderby = 'meta_value_num';
        $meta_key = 'total_sales';
        $order = 'desc';
        break;
    case 'rating':
        $orderby = 'meta_value_num';
        $meta_key = '_wc_average_rating';
        $order = 'desc';
        break;
    // 其他自定义排序类型可以在这里添加
}

// 构建自定义产品查询参数
$args = array(
    'post_type' => 'product',
    'post_status' => 'publish',
    'orderby' => $orderby,
    'order' => $order,
    // 其他查询参数（比如分类、数量限制等）
);

// 如果排序需要依赖元字段，添加meta_key参数
if (!empty($meta_key)) {
    $args['meta_key'] = $meta_key;
}

$product_query = new WP_Query($args);

4. 进阶：添加自定义排序选项 #

如果需要扩展默认没有的排序方式（比如按库存数量排序），可以通过WooCommerce的过滤器实现：

// 步骤1：添加自定义排序选项到后台设置列表
add_filter('woocommerce_catalog_orderby', 'add_custom_stock_orderby');
function add_custom_stock_orderby($orderby_options) {
    $orderby_options['stock'] = __('Sort by stock quantity', 'your-theme-text-domain');
    return $orderby_options;
}

// 步骤2：让WooCommerce识别并处理自定义排序参数
add_filter('woocommerce_get_catalog_ordering_args', 'handle_stock_ordering_args');
function handle_stock_ordering_args($args) {
    $selected_orderby = isset($_GET['orderby']) ? wc_clean($_GET['orderby']) : get_option('woocommerce_default_catalog_orderby');
    
    if ('stock' === $selected_orderby) {
        $args['orderby'] = 'meta_value_num';
        $args['order'] = 'desc'; // 库存多的在前
        $args['meta_key'] = '_stock';
    }
    
    return $args;
}

添加这段代码后，后台设置里会多出「按库存数量排序」的选项，用户在前端也能选择这个排序方式啦！

内容的提问来源于stack exchange，提问作者aslamdoctor