本文详解如何在 woocommerce “我的账户”页面正确注册带参数（如订单 id）的自定义菜单端点，并通过 url 路由精准加载对应订单的专属内容，解决端点触发后始终显示默认主菜单内容的问题。
本文详解如何在 woocommerce “我的账户”页面正确注册带参数（如订单 id）的自定义菜单端点，并通过 url 路由精准加载对应订单的专属内容，解决端点触发后始终显示默认主菜单内容的问题。
在 WooCommerce 中扩展“我的账户”（My Account）页面功能时，常需为特定订单提供定制化操作入口（如“查看详情”“申请售后”），并跳转至带订单 ID 的专属页面（例如 /my-account/custom-menu/19651/）。但许多开发者会遇到一个典型问题：尽管 URL 正确生成，点击后页面仍渲染默认的 content_custom_menu() 主菜单内容，而非基于订单 ID 动态生成的内容——根本原因在于 WooCommerce 端点（Endpoint）机制不直接支持路径参数解析，add_rewrite_endpoint() 注册的端点仅匹配前缀（如 custom-menu），后续数字（如 /19651/）不会自动映射为查询变量，需手动解析。
✅ 正确实现步骤
1. 修正重写规则：启用路径参数捕获
原代码使用 add_rewrite_endpoint('custom-menu', EP_ROOT | EP_PAGES) 仅注册了基础端点，无法识别 /custom-menu/19651/ 中的 ID。应改用 add_rewrite_rule() 显式定义带捕获组的正则规则，并将 ID 映射为自定义查询变量：
public function rewrite_endpoint() {
// 移除旧规则（避免冲突）
flush_rewrite_rules(); // ⚠️ 仅开发时使用；上线后应移除或用插件激活钩子触发一次
// 新规则：匹配 /my-account/custom-menu/(\d+)/ 并传入 query_var 'custom_order_id'
add_rewrite_rule(
'^my-account/custom-menu/([0-9]+)/?$',
'index.php?pagename=my-account&custom_order_id=$matches[1]',
'top'
);
}2. 注册并验证查询变量
确保 custom_order_id 被 WordPress 识别为合法查询变量：
public function add_new_query_vars( $vars ) {
$vars[] = 'custom_order_id'; // ✅ 替换原 'custom-menu' 变量
return $vars;
}3. 构建带 ID 的安全链接
在订单操作按钮中，使用 wc_get_account_endpoint_url() 获取基础端点 URL 后，手动拼接订单 ID 路径段（非查询参数），确保符合重写规则：
public function order_custom_content_display_button( $actions, $order ) {
$url = wc_get_account_endpoint_url( 'custom-menu' ) . $order->get_id() . '/';
$actions['custom'] = [
'url' => esc_url_raw( $url ),
'name' => __( 'Display', 'a-text-domain' )
];
return $actions;
}✅ 注意：wc_get_account_endpoint_url('custom-menu') 返回 /my-account/custom-menu/，拼接 $order->get_id() . '/' 后形成标准格式 /my-account/custom-menu/19651/。
4. 在内容回调中解析并渲染订单专属内容
woocommerce_account_custom-menu_endpoint 钩子触发时，从 $wp->query_vars 中提取 custom_order_id，并据此加载订单数据与状态逻辑：
public function content_custom_menu() {
global $wp;
// 检查是否携带有效订单 ID 参数
$order_id = isset( $wp->query_vars['custom_order_id'] )
&& is_numeric( $wp->query_vars['custom_order_id'] )
? absint( $wp->query_vars['custom_order_id'] )
: 0;
if ( $order_id ) {
$order = wc_get_order( $order_id );
if ( ! $order || ! current_user_can( 'view_order', $order_id ) ) {
wc_print_notice( __( 'Invalid order or insufficient permissions.', 'a-text-domain' ), 'error' );
return;
}
// ✅ 根据订单状态渲染不同内容
switch ( $order->get_status() ) {
case 'processing':
echo '<h3>' . esc_html__( 'Processing Order Details', 'a-text-domain' ) . '</h3>';
echo '<p>' . sprintf( __( 'Your order #%d is being prepared for shipment.', 'a-text-domain' ), $order_id ) . '</p>';
break;
case 'completed':
echo '<h3>' . esc_html__( 'Completed Order', 'a-text-domain' ) . '</h3>';
echo '<p>' . sprintf( __( 'Thank you! Order #%d has been fulfilled.', 'a-text-domain' ), $order_id ) . '</p>';
break;
default:
echo '<h3>' . esc_html__( 'Order Summary', 'a-text-domain' ) . '</h3>';
echo '<p>' . sprintf( __( 'Order ID: %d | Status: %s', 'a-text-domain' ), $order_id, $order->get_status() ) . '</p>';
}
} else {
// 无 ID 时显示主菜单内容（如自定义仪表盘）
echo '<p>' . esc_html__( 'Welcome to Custom Menu — your personalized order hub.', 'a-text-domain' ) . '</p>';
}
}⚠️ 关键注意事项
- 重写规则刷新：首次添加规则后，需访问 WordPress 后台 → 设置 → 固定链接 → 保存更改（无需代码中调用 flush_rewrite_rules() 上线环境）。
- 权限校验：务必检查 current_user_can('view_order', $order_id)，防止越权访问他人订单。
- URL 安全性：使用 esc_url_raw() 处理跳转链接，absint() 强制转换 ID 为整数，杜绝注入风险。
- 端点钩子命名：woocommerce_account_{endpoint}_endpoint 中的 {endpoint} 必须与 add_rewrite_rule 中的路径前缀一致（此处为 custom-menu），否则钩子不触发。
通过以上结构化改造，即可实现“点击订单旁按钮 → 跳转至 /my-account/custom-menu/{id}/ → 渲染该订单专属内容”的完整闭环，彻底解决默认内容覆盖问题，为复杂会员中心交互奠定坚实基础。
