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 | 介绍了。 |