bp_core_create_subnav_link (|字符串数组args美元＝＇＇，字符串美元的组件＝“成员”）
添加一个子导航链接到BuddyPress导航。
描述
参数
- args美元
-
（数组|字符串）(可选)数组描述新的子导航项。
- “名字”
(字符串)显示子导航项的名称。 - “鼻涕虫”
(字符串)子导航项的唯一URL蛞蝓。 - “parent_slug”
(字符串)新的子导航项应该被添加到顶层导航项的蛞蝓(蛞蝓)。 - “parent_url”
(字符串)父导航项的URL。 - “item_css_id”
(bool |字符串)可选的。'id'属性为导航项。默认值:$slug的值。 - “user_has_access”
(保龄球)可选的。如果登录的用户可以访问子导航项，则为True，否则为false。可以在注册子导航时动态设置;例如,使用bp_is_my_profile ()仅限配置文件所有者访问。默认值:真的。 - “site_admin_only”
(保龄球)可选的。nav项目是否应该只对网站管理员可见(那些“bp_moderate”帽)。默认值:false。 - “位置”
(int)可选的。指定项目在子导航数组中的位置的数值索引。默认值:90。 - “screen_function”
(调用)当导航项被点击时运行的回调函数。 - “链接”
(字符串)可选的。子导航项应该指向的URL。默认为$parent_url + $slug生成的值。 - “show_in_admin_bar”
(保龄球)可选的。是否应该将导航项添加到组管理员的“编辑”管理栏菜单中。默认值:false。
默认值:“
- “名字”
- 美元的组件
-
（字符串）(可选)导航附加到的组件。默认为“成员”。
默认值:“成员”
返回
(假|数组)失败时返回false, newBP_Core_Nav_Item成功实例。
源
文件:bp-core / bp-core-buddybar.php
函数bp_core_create_subnav_link($args = "， $component = 'members') {$bp = buddypress();$r = wp_parse_args($args, array('name' => false， //显示nav项的名称。'slug' => false， // nav项目的URL slug。'parent_slug' => false， //父导航项的URL slug。'parent_url' => false， //父项的URL。'item_css_id' => false， //应用到导航项的HTML的CSS ID。'user_has_access' => true， //登录的用户可以看到这个导航项吗?'no_access_url' => '， 'site_admin_only' => false， //只有站点管理员才能看到这个导航项吗?'position' => 90， //该导航项应该定位的索引。'screen_function' => false， //单击时要运行的函数的名称。 'link' => '', // The link for the subnav item; optional, not usually required. 'show_in_admin_bar' => false, // Show the Manage link in the current group's "Edit" Admin Bar menu. ) ); // If we don't have the required info we need, don't create this subnav item. if ( empty( $r['name'] ) || empty( $r['slug'] ) || empty( $r['parent_slug'] ) || empty( $r['parent_url'] ) || empty( $r['screen_function'] ) ) return false; // Link was not forced, so create one. if ( empty( $r['link'] ) ) { $r['link'] = trailingslashit( $r['parent_url'] . $r['slug'] ); $parent_nav = $bp->{$component}->nav->get_primary( array( 'slug' => $r['parent_slug'] ), false ); // If this sub item is the default for its parent, skip the slug. if ( $parent_nav ) { $parent_nav_item = reset( $parent_nav ); if ( ! empty( $parent_nav_item->default_subnav_slug ) && $r['slug'] === $parent_nav_item->default_subnav_slug ) { $r['link'] = trailingslashit( $r['parent_url'] ); } } } // If this is for site admins only and the user is not one, don't create the subnav item. if ( ! empty( $r['site_admin_only'] ) && ! bp_current_user_can( 'bp_moderate' ) ) { return false; } if ( empty( $r['item_css_id'] ) ) { $r['item_css_id'] = $r['slug']; } $subnav_item = array( 'name' => $r['name'], 'link' => $r['link'], 'slug' => $r['slug'], 'parent_slug' => $r['parent_slug'], 'css_id' => $r['item_css_id'], 'position' => $r['position'], 'user_has_access' => $r['user_has_access'], 'no_access_url' => $r['no_access_url'], 'screen_function' => &$r['screen_function'], 'show_in_admin_bar' => (bool) $r['show_in_admin_bar'], ); buddypress()->{$component}->nav->add_nav( $subnav_item ); return $subnav_item; }
更新日志
| 版本 | 描述 |
|---|---|
| BuddyPress测试盒框 | 介绍了。 |