bp_core_new_nav_item (|字符串数组args美元字符串美元的组件“成员”

向指定组件的主导航添加项。

描述

参数

args美元

数组|字符串(必需)数组描述新的导航项。

  • “名字”
    (字符串)显示导航项的名称。
  • “鼻涕虫”
    (字符串)唯一的URL蛞蝓为导航项目。
  • “item_css_id”
    (bool |字符串)可选的。'id'属性为导航项。默认值:美元蛞蝓
  • “show_for_displayed_user”
    (保龄球)可选的。当查看其他成员的个人资料时,导航项是否应该可见。默认值:真的。
  • “site_admin_only”
    (保龄球)可选的。nav项目是否应该只对网站管理员可见(那些“bp_moderate”帽)。默认值:false。
  • “位置”
    (int)可选的。数值索引指定项目应该出现在导航数组的位置。默认值:99。
  • “screen_function”
    (调用)当导航项被点击时运行的回调函数。
  • “default_subnav_slug”
    (bool |字符串)可选的。当导航项被点击时要选择的默认子导航项的蛞蝓。

美元的组件

字符串(可选)导航附加到的组件。默认为“成员”。

默认值:“成员”

返回

(零|假)失败时返回false。

文件:bp-core / bp-core-buddybar.php

函数bp_core_new_nav_item($args, $component = 'members') {if (!Bp_is_active ($component)) {return;} $defaults = array('name' => false, //显示nav项的名称。'slug' => false, // nav项目的URL slug。'item_css_id' => false, //应用到导航项的HTML的CSS ID。'show_for_displayed_user' => true, //当查看另一个用户时,这个导航项显示吗?'site_admin_only' => false, //只有站点管理员才能看到这个导航项吗?'position' => 99, //该导航项应该定位的索引。'screen_function' => false, //单击时要运行的函数的名称。'default_subnav_slug' => false //默认subnav项目点击时选择的slug。); $r = wp_parse_args( $args, $defaults ); // Validate nav link data. $nav_item = bp_core_create_nav_link( $r, $component ); /* * To mimic legacy behavior, if bp_core_create_nav_link() returns false, we make * an early exit and don't attempt to register the screen function. */ if ( false === $nav_item ) { return false; } // Then, hook the screen function for the added nav item. $hooked = bp_core_register_nav_screen_function( $nav_item ); if ( false === $hooked ){ return false; } /** * Fires after adding an item to the main BuddyPress navigation array. * Note that, when possible, the more specific action hooks * `bp_core_create_nav_link` or `bp_core_register_nav_screen_function` * should be used. * * @since BuddyPress 1.5.0 * * @param array $r Parsed arguments for the nav item. * @param array $args Originally passed in arguments for the nav item. * @param array $defaults Default arguments for a nav item. */ do_action( 'bp_core_new_nav_item', $r, $args, $defaults ); }

更新日志

更新日志
版本 描述
BuddyPress 1.1.0 介绍了。

问题吗?

我们总是很乐意帮助您解决代码或其他问题!搜索我们的开发人员文档联络支持,或与我们联系销售团队