如何自定义WooCommerce购物车/结账区块HTML模板？替换特定角色结账按钮

开发基于WooCommerce的WordPress主题时，需为特定角色替换购物车区块中的“Proceed to checkout”按钮为带自定义链接的按钮，用于执行主题内自定义操作。旧版WooCommerce或使用购物车短码时可通过PHP模板覆盖实现，但新版区块基于JS/React开发，无法找到修改HTML结构的方法，且已基于区块结构完成样式开发，不能切换到短码购物车。

尝试使用render_block钩子覆盖内容时，仅添加了自定义按钮，原有按钮未被移除，修改$block['innerHTML']、$block['innerContent']和$block['render_callback']也未成功。需求是找到覆盖区块内容自定义HTML的方法，或条件禁用该区块以便添加自定义按钮/短码。

方案1：完全替换区块内容（移除原有按钮，替换为自定义内容） #

方法A：使用WooCommerce专属钩子精准替换 #

WooCommerce为proceed-to-checkout-block提供了专门的渲染钩子woocommerce_blocks_proceed_to_checkout_render，可直接替换整个区块内容：

add_filter('woocommerce_blocks_proceed_to_checkout_render', 'custom_proceed_to_checkout_button', 10, 1);

function custom_proceed_to_checkout_button($content) {
    // 检查当前用户角色，示例为针对"customer"角色替换
    $user = wp_get_current_user();
    if (in_array('customer', $user->roles)) {
        // 保留原区块CSS类以继承现有样式，替换为自定义链接和文本
        $content = '<a href="' . esc_url(home_url('/custom-action/')) . '" class="wp-block-button__link wc-block-components-button">我的自定义按钮</a>';
    }
    return $content;
}

方法B：优化render_block钩子的替换逻辑 #

如果专属钩子不生效，可提高钩子优先级，确保完全覆盖原有内容：

add_filter('render_block', 'handle_proceed_to_checkout_button', 20, 2); // 提高优先级到20，晚于默认渲染执行

function handle_proceed_to_checkout_button($block_content, $block) {
    if ('woocommerce/proceed-to-checkout-block' !== $block['blockName']) {
        return $block_content;
    }

    $user = wp_get_current_user();
    // 针对特定角色替换，示例为"subscriber"角色
    if (in_array('subscriber', $user->roles)) {
        // 直接返回自定义按钮HTML，完全覆盖原有内容
        return '<a href="' . esc_url(home_url('/custom-checkout/')) . '" class="wp-block-button__link wc-block-components-button">自定义结算</a>';
    }

    return $block_content;
}

方案2：条件禁用“Proceed to checkout”区块 #

如果需要完全移除该区块，再手动添加自定义按钮/短码，可使用allowed_block_types_all钩子条件禁用：

add_filter('allowed_block_types_all', 'disable_proceed_to_checkout_block_for_roles', 10, 2);

function disable_proceed_to_checkout_block_for_roles($allowed_blocks, $block_context) {
    // 仅在购物车页面生效，避免全局禁用
    if (is_cart()) {
        $user = wp_get_current_user();
        // 针对特定角色禁用，示例为"editor"角色
        if (in_array('editor', $user->roles)) {
            $block_key = array_search('woocommerce/proceed-to-checkout-block', $allowed_blocks);
            if ($block_key !== false) {
                unset($allowed_blocks[$block_key]);
            }
        }
    }
    return $allowed_blocks;
}

禁用后，即可在区块编辑器中添加自定义按钮区块或短码区块，实现自定义操作。

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