如何根据用户角色动态重命名 WooCommerce “我的账户”导航标签-php教程-PHP中文网

如何根据用户角色动态重命名 WooCommerce “我的账户”导航标签

本文介绍如何使用 woocommerce_account_menu_items 过滤器，结合当前用户角色，动态修改 WooCommerce “我的账户”页面左侧菜单项的显示名称，支持管理员、订阅者等角色的差异化文案（如单复数切换、专属后缀等）。

本文介绍如何使用 woocommerce_account_menu_items 过滤器，结合当前用户角色，动态修改 woocommerce “我的账户”页面左侧菜单项的显示名称，支持管理员、订阅者等角色的差异化文案（如单复数切换、专属后缀等）。

在 WooCommerce 中，“我的账户”页面左侧的导航菜单（如“仪表盘”“订单”“地址”等）默认对所有用户统一显示。但实际业务中，不同用户角色（如管理员、VIP 会员、普通订阅者、批发客户）往往需要语义更精准或更具归属感的标签——例如将“Addresses”改为“Your Shipping Address”（仅一个地址时用单数），或将“Orders”强化为“Your Wholesale Orders”。这可通过钩子 woocommerce_account_menu_items 实现。

该过滤器在菜单渲染前触发，接收原始菜单数组 $items（键为 slug，值为显示文本），允许你完全重定义整个菜单结构。关键在于：必须先判断用户是否已登录，并准确获取其角色数组。以下是一个健壮、可扩展的实现示例：

add_filter( 'woocommerce_account_menu_items', 'rename_my_account_tabs_by_role', 9999 );
function rename_my_account_tabs_by_role( $items ) {
    // 仅对已登录用户生效
    if ( ! is_user_logged_in() ) {
        return $items;
    }

    $user = wp_get_current_user();
    $roles = (array) $user->roles;

    // 根据角色定制菜单（支持多角色匹配）
    if ( in_array( 'administrator', $roles, true ) ) {
        $items['dashboard']       = __( 'Admin Dashboard', 'woocommerce' );
        $items['orders']          = __( 'All Orders', 'woocommerce' );
        $items['downloads']       = __( 'File Downloads', 'woocommerce' );
        $items['edit-address']    = _n( 'Shipping Address', 'Shipping Addresses', wc_shipping_enabled() ? 2 : 1, 'woocommerce' );
        $items['payment-methods'] = __( 'Payment Gateways', 'woocommerce' );
        $items['edit-account']    = __( 'Admin Profile', 'woocommerce' );

    } elseif ( in_array( 'subscriber', $roles, true ) ) {
        // 示例：订阅者仅有一个产品，地址栏用单数 + 个性化提示
        $items['dashboard']    = __( 'Your Dashboard', 'woocommerce' );
        $items['orders']       = _n( 'Your Order', 'Your Orders', wc_get_customer_order_count( $user->ID ), 'woocommerce' );
        $items['edit-address'] = _n( 'Your Address', 'Your Addresses', wc_shipping_enabled() ? 2 : 1, 'woocommerce' );
        $items['edit-account'] = __( 'Your Account', 'woocommerce' );

    } elseif ( in_array( 'wholesale_customer', $roles, true ) ) {
        $items['orders']       = __( 'Wholesale Orders', 'woocommerce' );
        $items['edit-address'] = __( 'Business Address', 'woocommerce' );
        $items['payment-methods'] = __( 'Approved Payment Methods', 'woocommerce' );
    }

    // ⚠️ 注意：不要 unset('customer-logout') —— 它由 WooCommerce 自动处理，移除会导致登出失效
    return $items;
}

✅ 关键要点说明：

优先级设为 9999：确保你的逻辑在其他插件或主题修改之后执行，避免被覆盖；
使用 in_array( ..., true )：开启严格类型检查，防止角色名误匹配（如 'admin' 匹配 'administrator'）；
复数控制推荐 _n() 或 wc_get_customer_order_count()：比依赖 wc_shipping_enabled() 更精准反映用户真实数据状态；
仅重写需变更的键值：无需重复定义全部菜单项，只修改目标项即可，保留默认行为更安全；
避免操作 'customer-logout'：该条目由 WooCommerce 内部控制，手动修改或删除可能导致登出功能异常。