2,
'file' => false,
'function' => false,
'icon_url' => false,
'menu_title' => '',
'page_title' => '',
'position' => 100
);
$r = bp_parse_args(
$args,
$defaults
);
extract( $r, EXTR_SKIP );
$file = plugin_basename( $file );
$hookname = get_plugin_page_hookname( $file, '' );
$admin_page_hooks[$file] = sanitize_title( $menu_title );
if ( !empty( $function ) && !empty ( $hookname ) )
add_action( $hookname, $function );
if ( empty( $icon_url ) )
$icon_url = 'images/generic.png';
elseif ( is_ssl() && 0 === strpos( $icon_url, 'http://' ) )
$icon_url = 'https://' . substr( $icon_url, 7 );
do {
$position++;
} while ( !empty( $menu[$position] ) );
$menu[$position] = array ( $menu_title, $access_level, $file, $page_title, 'menu-top ' . $hookname, $hookname, $icon_url );
$_registered_pages[$hookname] = true;
return $hookname;
}
/** Activity ******************************************************************/
/**
* @deprecated 1.5.0
*/
function bp_is_activity_permalink() {
_deprecated_function( __FUNCTION__, '1.5', 'bp_is_single_activity' );
bp_is_single_activity();
}
/** Core **********************************************************************/
/**
* @deprecated 1.5.0
*/
function bp_core_get_wp_profile() {
_deprecated_function( __FUNCTION__, '1.5' );
$ud = get_userdata( bp_displayed_user_id() ); ?>
text.
* Now, just simply use wp_title().
*
* @deprecated 1.5.0
* @deprecated Use wp_title()
* @since 1.0.0
*
* @return string
*/
function bp_get_page_title() {
_deprecated_function( __FUNCTION__, '1.5', 'wp_title()' );
$title = wp_title( '|', false, 'right' ) . get_bloginfo( 'name', 'display' );
// Backpat for BP 1.2 filter
$title = apply_filters( 'bp_page_title', esc_attr( $title ), esc_attr( $title ) );
return apply_filters( 'bp_get_page_title', $title );
}
/**
* Generate a link to log out. Last used in BP 1.2-beta. You should be using wp_logout_url().
*
* @deprecated 1.5.0
* @deprecated Use wp_logout_url()
* @since 1.0.0
*/
function bp_log_out_link() {
_deprecated_function( __FUNCTION__, '1.5', 'wp_logout_url()' );
$logout_link = '' . __( 'Log Out', 'buddypress' ) . '';
echo apply_filters( 'bp_logout_link', $logout_link );
}
/**
* Send an email and a BP notification on receipt of an @-mention in a group
*
* @deprecated 1.5.0
* @deprecated Deprecated in favor of the more general bp_activity_at_message_notification()
*/
function groups_at_message_notification( $content, $poster_user_id, $group_id, $activity_id ) {
_deprecated_function( __FUNCTION__, '1.5', 'bp_activity_at_message_notification()' );
/* Scan for @username strings in an activity update. Notify each user. */
$pattern = '/[@]+([A-Za-z0-9-_\.@]+)/';
preg_match_all( $pattern, $content, $usernames );
/* Make sure there's only one instance of each username */
if ( !$usernames = array_unique( $usernames[1] ) )
return false;
$group = new BP_Groups_Group( $group_id );
foreach( (array) $usernames as $username ) {
if ( !$receiver_user_id = bp_core_get_userid( $username ) )
continue;
/* Check the user is a member of the group before sending the update. */
if ( !groups_is_user_member( $receiver_user_id, $group_id ) )
continue;
// Now email the user with the contents of the message (if they have enabled email notifications).
if ( 'no' != bp_get_user_meta( $receiver_user_id, 'notification_activity_new_mention', true ) ) {
$poster_name = bp_core_get_user_displayname( $poster_user_id );
$message_link = bp_activity_get_permalink( $activity_id );
$settings_slug = function_exists( 'bp_get_settings_slug' ) ? bp_get_settings_slug() : 'settings';
$settings_link = bp_core_get_user_domain( $receiver_user_id ) . $settings_slug . '/notifications/';
$poster_name = stripslashes( $poster_name );
$content = bp_groups_filter_kses( stripslashes( $content ) );
// Set up and send the message.
$ud = bp_core_get_core_userdata( $receiver_user_id );
$to = $ud->user_email;
$subject = bp_get_email_subject(
array(
'text' => sprintf(
/* translators: 1: the poster name. 2: the group name. */
_x( '%1$s mentioned you in the group "%2$s"', 'deprecated string', 'buddypress' ),
$poster_name,
$group->name
)
)
);
/* translators: 1: the poster name. 2: the group name. 3: the content of the activity. 4: the activity permalink. */
$message = sprintf( _x(
'%1$s mentioned you in the group "%2$s":
"%3$s"
To view and respond to the message, log in and visit: %4$s
---------------------
', 'deprecated string', 'buddypress' ), $poster_name, $group->name, $content, $message_link );
/* Send the message */
$to = apply_filters( 'groups_at_message_notification_to', $to );
$subject = apply_filters( 'groups_at_message_notification_subject', $subject, $group, $poster_name );
$message = apply_filters( 'groups_at_message_notification_message', $message, $group, $poster_name, $content, $message_link, $settings_link );
wp_mail( $to, $subject, $message );
}
}
do_action( 'bp_groups_sent_mention_email', $usernames, $subject, $message, $content, $poster_user_id, $group_id, $activity_id );
}
/**
* BP 1.5 simplified notification functions a bit
* @deprecated 1.5.0
*
* @return mixed
*/
function bp_core_delete_notifications_for_user_by_type( $user_id, $component_name, $component_action ) {
_deprecated_function( __FUNCTION__, '1.5', 'bp_core_delete_notifications_by_type()' );
return BP_Core_Notification::delete_for_user_by_type( $user_id, $component_name, $component_action );
}
/**
* @return mixed
*/
function bp_core_delete_notifications_for_user_by_item_id( $user_id, $item_id, $component_name, $component_action, $secondary_item_id = false ) {
_deprecated_function( __FUNCTION__, '1.5', 'bp_core_delete_notifications_by_item_id()' );
return BP_Core_Notification::delete_for_user_by_item_id( $user_id, $item_id, $component_name, $component_action, $secondary_item_id );
}
/**
* Last used by core in BP 1.1. The markup was merged into DTheme's header.php template.
* @deprecated 1.5.0
*/
function bp_search_form() {
_deprecated_function( __FUNCTION__, '1.1', 'No longer required.' );
$form = '
';
echo apply_filters( 'bp_search_form', $form );
}
/**
* Some _is_ function had their names normalized
* @deprecated 1.5.0
*/
function bp_is_profile_edit() {
_deprecated_function( __FUNCTION__, '1.5', 'bp_is_user_profile_edit()' );
return bp_is_user_profile_edit();
}
/**
* @deprecated 1.5.0
*/
function bp_is_change_avatar() {
_deprecated_function( __FUNCTION__, '1.5', 'bp_is_user_change_avatar()' );
return bp_is_user_change_avatar();
}
/**
* @deprecated 1.5.0
*/
function bp_is_friend_requests() {
_deprecated_function( __FUNCTION__, '1.5', 'bp_is_user_friend_requests()' );
return bp_is_user_friend_requests();
}
/**
* Checks to see if a component's URL should be in the root, not under a member page:
* eg: http://example.com/groups/the-group NOT http://example.com/members/andy/groups/the-group
* You should be using bp_is_root_component().
*
* @deprecated 1.5.0
* @deprecated bp_is_root_component()
* @return bool True if root component, else false.
*/
function bp_core_is_root_component( $component_name ) {
_deprecated_function( __FUNCTION__, '1.5', 'bp_is_root_component()' );
return bp_is_root_component( $component_name );
}
/** Theme *********************************************************************/
/**
* Contains functions which were moved out of BP-Default's functions.php
* in BuddyPress 1.5.
*
* @deprecated 1.5.0
* @since 1.5.0
*/
function bp_dtheme_deprecated() {
if ( !function_exists( 'bp_dtheme_wp_pages_filter' ) ) :
/**
* In BuddyPress 1.2.x, this function filtered the dropdown on the
* Settings > Reading screen for selecting the page to show on front to
* include "Activity Stream." As of 1.5.x, it is no longer required.
*
* @deprecated 1.5.0
* @deprecated No longer required.
* @param string $page_html A list of pages as a dropdown (select list)
* @return string
* @see wp_dropdown_pages()
* @since 1.2.0
*/
function bp_dtheme_wp_pages_filter( $page_html ) {
_deprecated_function( __FUNCTION__, '1.5', "No longer required." );
return $page_html;
}
endif;
if ( !function_exists( 'bp_dtheme_page_on_front_update' ) ) :
/**
* In BuddyPress 1.2.x, this function hijacked the saving of page on front setting to save the activity stream setting.
* As of 1.5.x, it is no longer required.
*
* @deprecated 1.5.0
* @deprecated No longer required.
* @param string $oldvalue Previous value of get_option( 'page_on_front' )
* @param string $oldvalue New value of get_option( 'page_on_front' )
* @return false|string
* @since 1.2.0
*/
function bp_dtheme_page_on_front_update( $oldvalue, $newvalue ) {
_deprecated_function( __FUNCTION__, '1.5', "No longer required." );
if ( !is_admin() || !bp_current_user_can( 'bp_moderate' ) )
return false;
return $oldvalue;
}
endif;
if ( !function_exists( 'bp_dtheme_page_on_front_template' ) ) :
/**
* In BuddyPress 1.2.x, this function loaded the activity stream template if the front page display settings allow.
* As of 1.5.x, it is no longer required.
*
* @deprecated 1.5.0
* @deprecated No longer required.
* @param string $template Absolute path to the page template
* @return string
* @since 1.2.0
*/
function bp_dtheme_page_on_front_template( $template ) {
_deprecated_function( __FUNCTION__, '1.5', "No longer required." );
return $template;
}
endif;
if ( !function_exists( 'bp_dtheme_fix_get_posts_on_activity_front' ) ) :
/**
* In BuddyPress 1.2.x, this forced the page ID as a string to stop the get_posts query from kicking up a fuss.
* As of 1.5.x, it is no longer required.
*
* @deprecated 1.5.0
* @deprecated No longer required.
* @since 1.2.0
*/
function bp_dtheme_fix_get_posts_on_activity_front() {
_deprecated_function( __FUNCTION__, '1.5', "No longer required." );
}
endif;
if ( !function_exists( 'bp_dtheme_fix_the_posts_on_activity_front' ) ) :
/**
* In BuddyPress 1.2.x, this was used as part of the code that set the activity stream to be on the front page.
* As of 1.5.x, it is no longer required.
*
* @deprecated 1.5.0
* @deprecated No longer required.
* @param array $posts Posts as retrieved by WP_Query
* @return array
* @since 1.2.5
*/
function bp_dtheme_fix_the_posts_on_activity_front( $posts ) {
_deprecated_function( __FUNCTION__, '1.5', "No longer required." );
return $posts;
}
endif;
if ( !function_exists( 'bp_dtheme_add_blog_comments_js' ) ) :
/**
* In BuddyPress 1.2.x, this added the JavaScript needed for blog comment replies.
* As of 1.5.x, we recommend that you enqueue the comment-reply JavaScript in your theme's header.php.
*
* @deprecated 1.5.0
* @deprecated Enqueue the comment-reply script in your theme's header.php.
* @since 1.2.0
*/
function bp_dtheme_add_blog_comments_js() {
_deprecated_function( __FUNCTION__, '1.5', "Enqueue the comment-reply script in your theme's header.php." );
if ( is_singular() && bp_is_blog_page() && get_option( 'thread_comments' ) )
wp_enqueue_script( 'comment-reply' );
}
endif;
}
add_action( 'after_setup_theme', 'bp_dtheme_deprecated', 15 );
/**
* In BP 1.5, the Settings functions were moved out of the Core and Members
* components, and moved into a new Settings component. This function is no
* longer needed as the nav structure is set up by the {@link BP_Component} class.
*
* @deprecated 1.5.0
* @since 1.6.0
*/
function bp_core_add_settings_nav() {
_deprecated_function( __FUNCTION__, '1.5' );
}
/**
* In BP 1.5, the Settings functions were moved out of the Core and Members
* components, and moved into a new Settings component. This function is no
* longer needed as new template files for the Settings component were
* introduced.
*
* @deprecated 1.5.0
* @since 1.6.0
*/
function bp_core_screen_general_settings() {
_deprecated_function( __FUNCTION__, '1.5', 'Moved into theme template' );
}
/**
* In BP 1.5, the Settings functions were moved out of the Core and Members
* components, and moved into a new Settings component. This function is no
* longer needed as new template files for the Settings component were
* introduced.
*
* @deprecated 1.5.0
* @since 1.6.0
*/
function bp_core_screen_general_settings_title() {
_deprecated_function( __FUNCTION__, '1.5', 'Moved into theme template' );
}
/**
* In BP 1.5, the Settings functions were moved out of the Core and Members
* components, and moved into a new Settings component. This function is no
* longer needed as new template files for the Settings component were
* introduced.
*
* @deprecated 1.5.0
* @since 1.6.0
*/
function bp_core_screen_general_settings_content() {
_deprecated_function( __FUNCTION__, '1.5', 'Moved into theme template' );
}
/**
* In BP 1.5, the Settings functions were moved out of the Core and Members
* components, and moved into a new Settings component. This function is no
* longer needed as new template files for the Settings component were
* introduced.
*
* @deprecated 1.5.0
* @since 1.6.0
*/
function bp_core_screen_notification_settings() {
_deprecated_function( __FUNCTION__, '1.5', 'Moved into theme template' );
}
/**
* In BP 1.5, the Settings functions were moved out of the Core and Members
* components, and moved into a new Settings component. This function is no
* longer needed as new template files for the Settings component were
* introduced.
*
* @deprecated 1.5.0
* @since 1.6.0
*/
function bp_core_screen_notification_settings_title() {
_deprecated_function( __FUNCTION__, '1.5', 'Moved into theme template' );
}
/**
* In BP 1.5, the Settings functions were moved out of the Core and Members
* components, and moved into a new Settings component. This function is no
* longer needed as new template files for the Settings component were
* introduced.
*
* @deprecated 1.5.0
* @since 1.6.0
*/
function bp_core_screen_notification_settings_content() {
_deprecated_function( __FUNCTION__, '1.5', 'Moved into theme template' );
}
/**
* In BP 1.5, the Settings functions were moved out of the Core and Members
* components, and moved into a new Settings component. This function is no
* longer needed as new template files for the Settings component were
* introduced.
*
* @deprecated 1.5.0
* @since 1.6.0
*/
function bp_core_screen_delete_account() {
_deprecated_function( __FUNCTION__, '1.5', 'Moved into theme template' );
}
/**
* In BP 1.5, the Settings functions were moved out of the Core and Members
* components, and moved into a new Settings component. This function is no
* longer needed as new template files for the Settings component were
* introduced.
*
* @deprecated 1.5.0
* @since 1.6.0
*/
function bp_core_screen_delete_account_title() {
_deprecated_function( __FUNCTION__, '1.5', 'Moved into theme template' );
}
/**
* In BP 1.5, the Settings functions were moved out of the Core and Members
* components, and moved into a new Settings component. This function is no
* longer needed as new template files for the Settings component were
* introduced.
*
* @deprecated 1.5.0
* @since 1.6.0
*/
function bp_core_screen_delete_account_content() {
_deprecated_function( __FUNCTION__, '1.5', 'Moved into theme template' );
}