如何在WooCommerce头部添加清除edit_order会话的链接？

方法1：AJAX异步清除会话（推荐，无页面跳转） #

这种方式体验更流畅，无需刷新页面。

1. 添加头部取消链接 #

通过钩子将链接插入头部导航或自定义位置，示例用导航菜单钩子：

add_action( 'wp_nav_menu_items', 'append_cancel_edit_order_link', 10, 2 );
function append_cancel_edit_order_link( $menu_items, $args ) {
    // 仅在前端且存在编辑订单会话时显示链接
    if ( !is_admin() && WC()->session->get( 'edit_order' ) ) {
        $cancel_url = admin_url( 'admin-ajax.php?action=cancel_edit_order' );
        $menu_items .= '<li><a href="' . esc_url( $cancel_url ) . '" class="cancel-edit-link">取消订单编辑</a></li>';
    }
    return $menu_items;
}

2. 注册AJAX处理逻辑 #

在主题functions.php或自定义插件中添加：

// 注册AJAX动作，支持登录/未登录用户
add_action( 'wp_ajax_cancel_edit_order', 'clear_edit_order_session' );
add_action( 'wp_ajax_nopriv_cancel_edit_order', 'clear_edit_order_session' );

function clear_edit_order_session() {
    // 确保WC会话已初始化（解决之前$_GET方式会话未加载的问题）
    if ( !WC()->session->has_session() ) {
        WC()->session->set_customer_session_cookie( true );
    }
    // 清除目标会话
    WC()->session->set( 'edit_order', null );
    // 重定向回原页面或首页
    wp_redirect( wp_get_referer() ?: home_url() );
    exit;
}

方法2：PHP同步处理（无AJAX） #

如果偏好传统GET请求方式，修复会话初始化问题即可：

1. 添加头部链接 #

add_action( 'wp_nav_menu_items', 'append_cancel_edit_order_link', 10, 2 );
function append_cancel_edit_order_link( $menu_items, $args ) {
    if ( !is_admin() && WC()->session->get( 'edit_order' ) ) {
        $cancel_url = add_query_arg( 'cancel_edit', '1', home_url() );
        $menu_items .= '<li><a href="' . esc_url( $cancel_url ) . '" class="cancel-edit-link">取消订单编辑</a></li>';
    }
    return $menu_items;
}

2. 处理GET请求 #

add_action( 'template_redirect', 'handle_cancel_edit_request' );
function handle_cancel_edit_request() {
    if ( isset( $_GET['cancel_edit'] ) && $_GET['cancel_edit'] === '1' ) {
        // 强制初始化WC会话
        if ( !WC()->session->has_session() ) {
            WC()->session->set_customer_session_cookie( true );
        }
        WC()->session->set( 'edit_order', null );
        wp_redirect( wp_get_referer() ?: home_url() );
        exit;
    }
}

为什么之前$_GET方式失败？ #

核心原因是WC会话未被正确初始化：直接通过前端GET请求触发时，WooCommerce的会话机制尚未加载，导致WC()->session操作无效。上述两种方法都通过提前初始化会话、使用WC生命周期钩子（template_redirect/AJAX钩子）确保会话可用，解决了这个问题。

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