WordPress短代码函数页面仅生效一次问题求助（WooCommerce场景）

看起来你遇到了多短代码实例冲突的典型问题——单个短代码正常，多个就空白，大概率是变量污染或者未处理的致命错误导致的。我帮你重构了代码，解决了这个问题，同时优化了逻辑和稳定性：

修复后的完整代码 #

// 课程访问权限检查短代码 [checkpurchase course="" url="" img=""]
function checkpurchase_shortcode( $atts, $content = null ) {
    // 提取并验证短代码属性，设置默认值
    $atts = shortcode_atts( array(
        'course' => '', // 必填：对应WooCommerce产品ID
        'url'    => '', // 课程访问链接
        'img'    => '', // 课程入口图片URL
    ), $atts, 'checkpurchase' );

    // 1. 校验必填参数：产品ID不能为空
    if ( empty( $atts['course'] ) ) {
        return '<p class="error">⚠️ 请指定课程对应的产品ID</p>';
    }

    // 2. 检查用户登录状态
    $current_user = wp_get_current_user();
    if ( ! $current_user->exists() ) {
        return '<p>请先登录账号，再查看课程内容</p>';
    }

    $user_id = $current_user->ID;
    $has_purchased = false;

    // 3. 用WooCommerce官方API检查购买状态（高效且可靠）
    if ( class_exists( 'WooCommerce' ) ) {
        // 官方函数：检查用户是否购买过指定产品（自动过滤已完成/有效的订单）
        $has_purchased = wc_customer_bought_product( 
            $current_user->user_email, 
            $user_id, 
            $atts['course'] 
        );
    } else {
        return '<p>⚠️ WooCommerce未启用，无法验证课程购买状态</p>';
    }

    // 4. 根据购买状态返回对应内容
    if ( $has_purchased ) {
        if ( ! empty( $atts['img'] ) && ! empty( $atts['url'] ) ) {
            return sprintf( 
                '<a href="%s" class="course-entry"><img src="%s" alt="课程入口" /></a>', 
                esc_url( $atts['url'] ), 
                esc_url( $atts['img'] ) 
            );
        } elseif ( ! empty( $atts['url'] ) ) {
            return sprintf( 
                '<a href="%s" class="course-link">立即访问课程</a>', 
                esc_url( $atts['url'] ) 
            );
        } else {
            return '<p>✅ 您已购买该课程，但未设置访问链接，请联系管理员</p>';
        }
    } else {
        return '<p>❌ 您尚未购买该课程，请先完成购买</p>';
    }
}
add_shortcode( 'checkpurchase', 'checkpurchase_shortcode' );

关键改进点（解决多实例冲突的核心） #

• 局部变量完全隔离：所有变量（比如$current_user、$has_purchased）都是函数内部的局部变量，多个短代码执行时不会互相干扰。
• 使用官方API替代自定义查询：用wc_customer_bought_product这个WooCommerce内置函数，比自己写订单查询更高效，也避免了重复查询的逻辑冲突。
• 增加错误友好提示：每个可能出错的环节（参数缺失、未登录、WooCommerce未启用）都返回明确的提示，不会直接抛出致命错误导致页面空白。
• 安全过滤：用esc_url()处理链接和图片地址，避免XSS安全问题。

使用示例 #

现在你可以放心地在页面中添加多个不同产品ID的短代码了：

[checkpurchase course="123" url="/course-html/" img="/wp-content/uploads/html-course.jpg"]
[checkpurchase course="456" url="/course-css/" img="/wp-content/uploads/css-course.jpg"]

如果还是空白？试试这两步排查 #

1. 开启WordPress调试：在wp-config.php中添加以下代码，查看wp-content/debug.log里的具体错误信息：

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

2. 验证产品ID：确认短代码里的course值是WooCommerce产品的ID（不是课程插件的自定义ID，如果用了第三方课程插件的话）。

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