BuddyPress menu item,
* regardless of which actual BuddyPress admin screen we are on.
*
* The conditional prevents the behaviour when the user is viewing the
* backpat "Help" page, the Activity page, or any third-party plugins.
*
* @global string $plugin_page
* @global array $submenu
* @since BuddyPress (1.6.0)
*/
function bp_core_modify_admin_menu_highlight() {
global $plugin_page, $submenu_file;
// This tweaks the Settings subnav menu to show only one BuddyPress menu item
if ( ! in_array( $plugin_page, array( 'bp-activity', 'bp-general-settings', ) ) ) {
$submenu_file = 'bp-components';
}
// Network Admin > Tools
if ( in_array( $plugin_page, array( 'bp-tools', 'available-tools' ) ) ) {
$submenu_file = $plugin_page;
}
}
/**
* Generates markup for a fallback top-level BuddyPress menu page, if the site is running
* a legacy plugin which hasn't been updated. If the site is up to date, this page
* will never appear.
*
* @see bp_core_admin_backpat_menu()
* @since BuddyPress (1.6.0)
* @todo Add convenience links into the markup once new positions are finalised.
*/
function bp_core_admin_backpat_page() {
$url = bp_core_do_network_admin() ? network_admin_url( 'settings.php' ) : admin_url( 'options-general.php' );
$settings_url = add_query_arg( 'page', 'bp-components', $url ); ?>
Settings > BuddyPress. Profile Fields has been moved into the Users menu.', 'buddypress' ), esc_url( $settings_url ), bp_get_admin_url( 'users.php?page=bp-profile-setup' ) ); ?>
admin->notices as $notice ) {
$notice_types[] = $notice['type'];
}
$notice_types = array_unique( $notice_types );
foreach ( $notice_types as $type ) {
$notices = wp_list_filter( buddypress()->admin->notices, array( 'type' => $type ) );
printf( '', sanitize_html_class( $type ) );
foreach ( $notices as $notice ) {
printf( '
%s
', $notice['message'] );
}
printf( '
' . __( 'For more information:', 'buddypress' ) . '
' .
'' . __( 'Managing Components', 'buddypress' ) . '
' .
'' . __( 'Support Forums', 'buddypress' ) . '
'
);
break;
// Pages page
case 'settings_page_bp-page-settings' :
// Help tabs
$screen->add_help_tab( array(
'id' => 'bp-page-overview',
'title' => __( 'Overview', 'buddypress' ),
'content' => bp_core_add_contextual_help_content( 'bp-page-overview' ),
) );
// Help panel - sidebar links
$screen->set_help_sidebar(
'' . __( 'For more information:', 'buddypress' ) . '
' .
'' . __( 'Managing Pages', 'buddypress' ) . '
' .
'' . __( 'Support Forums', 'buddypress' ) . '
'
);
break;
// Settings page
case 'settings_page_bp-settings' :
// Help tabs
$screen->add_help_tab( array(
'id' => 'bp-settings-overview',
'title' => __( 'Overview', 'buddypress' ),
'content' => bp_core_add_contextual_help_content( 'bp-settings-overview' ),
) );
// Help panel - sidebar links
$screen->set_help_sidebar(
'' . __( 'For more information:', 'buddypress' ) . '
' .
'' . __( 'Managing Settings', 'buddypress' ) . '
' .
'' . __( 'Support Forums', 'buddypress' ) . '
'
);
break;
// Profile fields page
case 'users_page_bp-profile-setup' :
// Help tabs
$screen->add_help_tab( array(
'id' => 'bp-profile-overview',
'title' => __( 'Overview', 'buddypress' ),
'content' => bp_core_add_contextual_help_content( 'bp-profile-overview' ),
) );
// Help panel - sidebar links
$screen->set_help_sidebar(
'' . __( 'For more information:', 'buddypress' ) . '
' .
'' . __( 'Managing Profile Fields', 'buddypress' ) . '
' .
'' . __( 'Support Forums', 'buddypress' ) . '
'
);
break;
}
}
add_action( 'contextual_help', 'bp_core_add_contextual_help' );
/**
* renders contextual help content to contextual help tabs
*
* @since BuddyPress (1.7.0)
*/
function bp_core_add_contextual_help_content( $tab = '' ) {
switch ( $tab ) {
case 'bp-comp-overview' :
$retval = __( 'By default, all but four of the BuddyPress components are enabled. You can selectively enable or disable any of the components by using the form below. Your BuddyPress installation will continue to function. However, the features of the disabled components will no longer be accessible to anyone using the site.', 'buddypress' );
break;
case 'bp-page-overview' :
$retval = __( 'BuddyPress Components use WordPress Pages for their root directory/archive pages. You can change the page associations for each active component by using the form below.', 'buddypress' );
break;
case 'bp-settings-overview' :
$retval = __( 'Extra configuration settings are provided and activated. You can selectively enable or disable any setting by using the form on this screen.', 'buddypress' );
break;
case 'bp-profile-overview' :
$retval = __( 'Your users will distinguish themselves through their profile page. Create relevant profile fields that will show on each users profile.
Note: Any fields in the first group will appear on the signup page.', 'buddypress' );
break;
default:
$retval = false;
break;
}
// Wrap text in a paragraph tag
if ( !empty( $retval ) ) {
$retval = '' . $retval . '
';
}
return $retval;
}
/** Separator *****************************************************************/
/**
* Add a separator to the WordPress admin menus
*
* @since BuddyPress (1.7.0)
*
* @uses bp_current_user_can() To check users capability on root blog
*/
function bp_admin_separator() {
// Bail if BuddyPress is not network activated and viewing network admin
if ( is_network_admin() && ! bp_is_network_activated() ) {
return;
}
// Bail if BuddyPress is network activated and viewing site admin
if ( ! is_network_admin() && bp_is_network_activated() ) {
return;
}
// Prevent duplicate separators when no core menu items exist
if ( ! bp_current_user_can( 'bp_moderate' ) ) {
return;
}
// Bail if there are no components with admin UI's. Hardcoded for now, until
// there's a real API for determining this later.
if ( ! bp_is_active( 'activity' ) && ! bp_is_active( 'groups' ) ) {
return;
}
global $menu;
$menu[] = array( '', 'read', 'separator-buddypress', '', 'wp-menu-separator buddypress' );
}
/**
* Tell WordPress we have a custom menu order
*
* @since BuddyPress (1.7.0)
*
* @param bool $menu_order Menu order
* @uses bp_current_user_can() To check users capability on root blog
* @return bool Always true
*/
function bp_admin_custom_menu_order( $menu_order = false ) {
// Bail if user cannot see admin pages
if ( ! bp_current_user_can( 'bp_moderate' ) ) {
return $menu_order;
}
return true;
}
/**
* Move our custom separator above our custom post types
*
* @since BuddyPress (1.7.0)
*
* @param array $menu_order Menu Order
* @uses bp_current_user_can() To check users capability on root blog
* @return array Modified menu order
*/
function bp_admin_menu_order( $menu_order = array() ) {
// Bail if user cannot see admin pages
if ( empty( $menu_order ) || ! bp_current_user_can( 'bp_moderate' ) ) {
return $menu_order;
}
// Initialize our custom order array
$bp_menu_order = array();
// Menu values
$last_sep = is_network_admin() ? 'separator1' : 'separator2';
/**
* Filters the custom admin menus.
*
* @since BuddyPress (1.7.0)
*
* @param array $value Empty array.
*/
$custom_menus = (array) apply_filters( 'bp_admin_menu_order', array() );
// Bail if no components have top level admin pages
if ( empty( $custom_menus ) ) {
return $menu_order;
}
// Add our separator to beginning of array
array_unshift( $custom_menus, 'separator-buddypress' );
// Loop through menu order and do some rearranging
foreach ( (array) $menu_order as $item ) {
// Position BuddyPress menus above appearance
if ( $last_sep == $item ) {
// Add our custom menus
foreach( (array) $custom_menus as $custom_menu ) {
if ( array_search( $custom_menu, $menu_order ) ) {
$bp_menu_order[] = $custom_menu;
}
}
// Add the appearance separator
$bp_menu_order[] = $last_sep;
// Skip our menu items
} elseif ( ! in_array( $item, $custom_menus ) ) {
$bp_menu_order[] = $item;
}
}
// Return our custom order
return $bp_menu_order;
}
/** Utility *****************************************************************/
/**
* When using a WP_List_Table, get the currently selected bulk action
*
* WP_List_Tables have bulk actions at the top and at the bottom of the tables,
* and the inputs have different keys in the $_REQUEST array. This function
* reconciles the two values and returns a single action being performed.
*
* @since BuddyPress (1.7.0)
* @return string
*/
function bp_admin_list_table_current_bulk_action() {
$action = ! empty( $_REQUEST['action'] ) ? $_REQUEST['action'] : '';
// If the bottom is set, let it override the action
if ( ! empty( $_REQUEST['action2'] ) && $_REQUEST['action2'] != "-1" ) {
$action = $_REQUEST['action2'];
}
return $action;
}
/** Menus *********************************************************************/
/**
* Register meta box and associated JS for BuddyPress WP Nav Menu .
*
* @since BuddyPress (1.9.0)
*/
function bp_admin_wp_nav_menu_meta_box() {
if ( ! bp_is_root_blog() ) {
return;
}
add_meta_box( 'add-buddypress-nav-menu', __( 'BuddyPress', 'buddypress' ), 'bp_admin_do_wp_nav_menu_meta_box', 'nav-menus', 'side', 'default' );
add_action( 'admin_print_footer_scripts', 'bp_admin_wp_nav_menu_restrict_items' );
}
/**
* Build and populate the BuddyPress accordion on Appearance > Menus.
*
* @since BuddyPress (1.9.0)
*
* @global $nav_menu_selected_id
*/
function bp_admin_do_wp_nav_menu_meta_box() {
global $nav_menu_selected_id;
$walker = new BP_Walker_Nav_Menu_Checklist( false );
$args = array( 'walker' => $walker );
$post_type_name = 'buddypress';
$tabs = array();
$tabs['loggedin']['label'] = __( 'Logged-In', 'buddypress' );
$tabs['loggedin']['pages'] = bp_nav_menu_get_loggedin_pages();
$tabs['loggedout']['label'] = __( 'Logged-Out', 'buddypress' );
$tabs['loggedout']['pages'] = bp_nav_menu_get_loggedout_pages();
?>
ID ) ) {
$user_id = absint( $user_object->ID );
}
// Bail early if user cannot perform this action, or is looking at themselves
if ( current_user_can( 'edit_user', $user_id ) && ( bp_loggedin_user_id() !== $user_id ) ) {
// Admin URL could be single site or network
$url = bp_get_admin_url( 'users.php' );
// If spammed, create unspam link
if ( bp_is_user_spammer( $user_id ) ) {
$url = add_query_arg( array( 'action' => 'ham', 'user' => $user_id ), $url );
$unspam_link = wp_nonce_url( $url, 'bp-spam-user' );
$actions['ham'] = sprintf( '%2$s', esc_url( $unspam_link ), esc_html__( 'Not Spam', 'buddypress' ) );
// If not already spammed, create spam link
} else {
$url = add_query_arg( array( 'action' => 'spam', 'user' => $user_id ), $url );
$spam_link = wp_nonce_url( $url, 'bp-spam-user' );
$actions['spam'] = sprintf( '%2$s', esc_url( $spam_link ), esc_html__( 'Spam', 'buddypress' ) );
}
}
// Create a "View" link
$url = bp_core_get_user_domain( $user_id );
$actions['view'] = sprintf( '%2$s', esc_url( $url ), esc_html__( 'View', 'buddypress' ) );
// Return new actions
return $actions;
}
/**
* Catch requests to mark individual users as spam/ham from users.php.
*
* @since BuddyPress (2.0.0)
*/
function bp_core_admin_user_manage_spammers() {
// Print our inline scripts on non-Multisite
add_action( 'admin_footer', 'bp_core_admin_user_spammed_js' );
$action = isset( $_REQUEST['action'] ) ? $_REQUEST['action'] : false;
$updated = isset( $_REQUEST['updated'] ) ? $_REQUEST['updated'] : false;
$mode = isset( $_POST['mode'] ) ? $_POST['mode'] : false;
// if this is a multisite, bulk request, stop now!
if ( 'list' == $mode ) {
return;
}
// Process a spam/ham request
if ( ! empty( $action ) && in_array( $action, array( 'spam', 'ham' ) ) ) {
check_admin_referer( 'bp-spam-user' );
$user_id = ! empty( $_REQUEST['user'] ) ? intval( $_REQUEST['user'] ) : false;
if ( empty( $user_id ) ) {
return;
}
$redirect = wp_get_referer();
$status = ( $action == 'spam' ) ? 'spam' : 'ham';
// Process the user
bp_core_process_spammer_status( $user_id, $status );
$redirect = add_query_arg( array( 'updated' => 'marked-' . $status ), $redirect );
wp_redirect( $redirect );
}
// Display feedback
if ( ! empty( $updated ) && in_array( $updated, array( 'marked-spam', 'marked-ham' ) ) ) {
if ( 'marked-spam' === $updated ) {
$notice = __( 'User marked as spammer. Spam users are visible only to site admins.', 'buddypress' );
} else {
$notice = __( 'User removed from spam.', 'buddypress' );
}
bp_core_add_admin_notice( $notice );
}
}
/**
* Inline script that adds the 'site-spammed' class to spammed users.
*
* @since BuddyPress (2.0.0)
*/
function bp_core_admin_user_spammed_js() {
?>