WordPress多ID产品短代码开发求助：WP_Query与explode使用故障

我来帮你修复这个产品短代码的问题，你的代码里有几个关键错误导致它无法正常工作，下面是修正后的完整代码，以及对每个问题的详细解释：

<?php
add_shortcode('product_data', 'custom_product_shortcode');

function custom_product_shortcode($atts) {
    // 统一处理短代码属性，兼容id和ids两种调用方式
    $atts = shortcode_atts(array(
        'id' => '',
        'ids' => ''
    ), $atts, 'product_data');

    // 整理产品ID数组：优先使用多产品的ids参数，单产品用id参数
    $product_ids = array();
    if (!empty($atts['ids'])) {
        $product_ids = array_map('trim', explode(',', $atts['ids']));
    } elseif (!empty($atts['id'])) {
        $product_ids = array(trim($atts['id']));
    }

    // 如果没有传入任何ID，直接返回空内容
    if (empty($product_ids)) {
        return '';
    }

    // 正确配置WP_Query查询参数
    $productData = new WP_Query(array(
        'post_type' => 'product',
        'post_status' => 'publish',
        'post__in' => $product_ids,
        'posts_per_page' => -1, // 显示所有传入的产品
        'orderby' => 'post__in' // 保持传入的ID顺序
    ));

    ob_start();

    if ($productData->have_posts()) : ?>
        <section id="courses" class="courses-slider">
            <div class="courses-list">
                <?php while ($productData->have_posts()) : $productData->the_post(); 
                    // 使用get_前缀函数获取内容（返回值而非直接输出）
                    $productImage = get_the_post_thumbnail(get_the_ID(), 'woocommerce_thumbnail');
                    $productTitle = get_the_title();
                    $productPrice = get_post_meta(get_the_ID(), '_price', true);
                    $productLink = get_the_permalink();
                    $productId = get_the_ID();
                ?>
                    <div class="coursebox">
                        <div class="coursebox-header">
                            <a href="<?php echo esc_url($productLink); ?>" class="course-img">
                                <?php echo $productImage; ?>
                            </a>
                        </div>
                        <div class="course-info">
                            <a href="<?php echo esc_url($productLink); ?>">
                                <h4 class="course-title"><?php echo esc_html($productTitle); ?></h4>
                            </a>
                        </div>
                        <div class="pop-package-footer">
                            <div class="price-after-discount">
                                <span><?php echo wc_price($productPrice); ?></span>
                            </div>
                            <a href="<?php echo esc_url(add_query_arg('add-to-cart', $productId, wc_get_cart_url())); ?>" class="buy-link">
                                <span class="buy-link-img"><img src="<?php echo esc_url(get_theme_file_uri('/images/GeneralRetailStore-Icon-v1.png')); ?>"></span>
                                <span class="course-entry-text">buy</span>
                            </a>
                            <a href="<?php echo esc_url($productLink); ?>" class="product-link">
                                <span class="product-link-img"><img src="<?php echo esc_url(get_theme_file_uri('/images/White document icon.png')); ?>"></span>
                                <span class="course-entry-text">Intro</span>
                            </a>
                        </div>
                    </div>
                <?php endwhile; ?>
            </div>
        </section>
    <?php endif;

    // 重置文章数据，恢复原始查询状态
    wp_reset_postdata();

    $content = ob_get_clean();
    return $content;
}
?>

关键修改说明： #

• 属性兼容处理：用shortcode_atts()统一管理id和ids参数，避免未定义索引错误，同时支持你需要的单/多产品两种调用格式。
• WP_Query参数修正：把错误的field参数换成post__in（这是WordPress指定多个文章ID的标准参数），添加orderby=post__in保证产品顺序和你传入的ID顺序一致。
• 模板函数使用错误修复：the_post_thumbnail()、the_title()这类函数是直接输出内容的，无法赋值给变量，换成对应的get_前缀函数（如get_the_post_thumbnail()）才能正确获取内容。
• 安全输出加固：用esc_url()、esc_html()对链接和文本进行转义，避免XSS安全风险，这是WordPress开发的最佳实践。
• 购物车链接优化：改用wc_get_cart_url()和add_query_arg()生成标准的添加到购物车链接，避免硬编码URL和空格导致的参数失效问题。
• 查询重置修正：用wp_reset_postdata()替代wp_reset_query()，因为我们用的是自定义WP_Query，前者才是恢复原始文章数据的正确方法。

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