Manager

Back Back Up Advanced Editor

<?php

/**
 * bbPress User Template Tags
 *
 * @package bbPress
 * @subpackage TemplateTags
 */

// Exit if accessed directly
defined( 'ABSPATH' ) || exit;

/** User Loop *****************************************************************/

/**
 * Extension of WP_User_Query to allow easy looping
 *
 * @since 2.6.0 bbPress (r6330)
 */
class BBP_User_Query extends WP_User_Query {

/**
	 * The amount of users for the current query.
	 *
	 * @since 2.6.0 bbPress (r6330)
	 * @access public
	 * @var int
	 */
	public $user_count = 0;

/**
	 * Index of the current item in the loop.
	 *
	 * @since 2.6.0 bbPress (r6330)
	 * @access public
	 * @var int
	 */
	public $current_user = -1;

/**
	 * Whether the loop has started and the caller is in the loop.
	 *
	 * @since 2.6.0 bbPress (r6330)
	 * @access public
	 * @var bool
	 */
	public $in_the_loop = false;

/**
	 * The current user.
	 *
	 * @since 2.6.0 bbPress (r6330)
	 * @access public
	 * @var WP_User
	 */
	public $user;

/**
	 * PHP5 constructor.
	 *
	 * @since 2.6.0 bbPress (r6330)
	 * @access public
	 *
	 * @param null|string|array $query Optional. The query variables.
	 */
	public function __construct( $query = null ) {
		if ( ! empty( $query ) ) {
			parent::__construct( $query );
			$this->user_count = count( $this->results );
		}
	}

/**
	 * Set up the next user and iterate current user index.
	 *
	 * @since 2.6.0 bbPress (r6330)
	 * @access public
	 *
	 * @return WP_User Next user.
	 */
	public function next_user() {
		$this->current_user++;
		$this->user = $this->results[ $this->current_user ];

return $this->user;
	}

/**
	 * Sets up the current user.
	 *
	 * Retrieves the next user, sets up the user, sets the 'in the loop'
	 * property to true.
	 *
	 * @since 2.6.0 bbPress (r6330)
	 * @access public
	 *
	 * @global WP_User $user
	 */
	public function the_user() {
		$this->in_the_loop = true;

// loop has just started
		if ( $this->current_user === -1 ) {

/**
			 * Fires once the loop is started.
			 *
			 * @since 2.6.0 bbPress (r6330)
			 *
			 * @param WP_Query &$this The WP_Query instance (passed by reference).
			 */
			do_action_ref_array( 'loop_start', array( &$this ) );
		}

$this->next_user();
	}

/**
	 * Determines whether there are more users available in the loop.
	 *
	 * Calls the {@see 'loop_end'} action when the loop is complete.
	 *
	 * @since 2.6.0 bbPress (r6330)
	 * @access public
	 *
	 * @return bool True if users are available, false if end of loop.
	 */
	public function have_users() {
		if ( ( $this->current_user + 1 ) < $this->user_count ) {
			return true;
		} elseif ( ( ( $this->current_user + 1 ) === $this->user_count ) && ( $this->user_count > 0 ) ) {

/**
			 * Fires once the loop has ended.
			 *
			 * @since 2.6.0 bbPress (r6330)
			 *
			 * @param WP_Query &$this The WP_Query instance (passed by reference).
			 */
			do_action_ref_array( 'loop_end', array( &$this ) );

// Do some cleaning up after the loop
			$this->rewind_users();
		}

$this->in_the_loop = false;

return false;
	}

/**
	 * Rewind the users and reset user index.
	 *
	 * @since 2.6.0 bbPress (r6330)
	 * @access public
	 */
	public function rewind_users() {
		$this->current_user = -1;

if ( $this->user_count > 0 ) {
			$this->user = $this->results[ 0 ];
		}
	}
}

/**
 * The main user loop.
 *
 * @since 2.6.0 bbPress (r6330)
 *
 * @param array $args All the arguments supported by {@link WP_User_Query}
 * @return object Multidimensional array of user information
 */
function bbp_has_users( $args = array() ) {

// Parse arguments with default user query for most circumstances
	$r = bbp_parse_args( $args, array(
		'include'     => array(),
		'orderby'     => 'login',
		'order'       => 'ASC',
		'count_total' => false,
		'fields'      => 'all',
	), 'has_users' );

// Run the query
	$bbp             = bbpress();
	$bbp->user_query = new BBP_User_Query( $r );

// Filter & return
	return apply_filters( 'bbp_has_users', $bbp->user_query->have_users(), $bbp->user_query );
}

/**
 * Whether there are more users available in the loop
 *
 * @since 2.6.0 bbPress (r2464)
 *
 * @return object User information
 */
function bbp_users() {
	return bbpress()->user_query->have_users();
}

/**
 * Loads up the current user in the loop
 *
 * @since 2.6.0 bbPress (r2464)
 *
 * @return object User information
 */
function bbp_the_user() {
	return bbpress()->user_query->the_user();
}

/** Users *********************************************************************/

/**
 * Output a validated user id
 *
 * @since 2.0.0 bbPress (r2729)
 *
 * @param int $user_id Optional. User id
 * @param bool $displayed_user_fallback Fallback on displayed user?
 * @param bool $current_user_fallback Fallback on current user?
 */
function bbp_user_id( $user_id = 0, $displayed_user_fallback = true, $current_user_fallback = false ) {
	echo bbp_get_user_id( $user_id, $displayed_user_fallback, $current_user_fallback );
}
	/**
	 * Return a validated user id
	 *
	 * @since 2.0.0 bbPress (r2729)
	 *
	 * @param int $user_id Optional. User id
	 * @param bool $displayed_user_fallback Fallback on displayed user?
	 * @param bool $current_user_fallback Fallback on current user?
	 * @return int Validated user id
	 */
	function bbp_get_user_id( $user_id = 0, $displayed_user_fallback = true, $current_user_fallback = false ) {
		$bbp = bbpress();

// Easy empty checking
		if ( ! empty( $user_id ) && is_numeric( $user_id ) ) {
			$bbp_user_id = $user_id;

// Currently inside a user loop
		} elseif ( ! empty( $bbp->user_query->in_the_loop ) && isset( $bbp->user_query->user->ID ) ) {
			$bbp_user_id = $bbp->user_query->user->ID;

// Currently viewing or editing a user
		} elseif ( ( true === $displayed_user_fallback ) && ! empty( $bbp->displayed_user->ID ) ) {
			$bbp_user_id = $bbp->displayed_user->ID;

// Maybe fallback on the current_user ID
		} elseif ( ( true === $current_user_fallback ) && ! empty( $bbp->current_user->ID ) ) {
			$bbp_user_id = $bbp->current_user->ID;

// Failsafe
		} else {
			$bbp_user_id = 0;
		}

// Filter & return
		return (int) apply_filters( 'bbp_get_user_id', (int) $bbp_user_id, $displayed_user_fallback, $current_user_fallback );
	}

/**
 * Output ID of current user
 *
 * @since 2.0.0 bbPress (r2574)
 */
function bbp_current_user_id() {
	echo bbp_get_current_user_id();
}
	/**
	 * Return ID of current user
	 *
	 * @since 2.0.0 bbPress (r2574)
	 *
	 * @return int Current user id
	 */
	function bbp_get_current_user_id() {

// Filter & return
		return (int) apply_filters( 'bbp_get_current_user_id', bbp_get_user_id( 0, false, true ) );
	}

/**
 * Output ID of displayed user
 *
 * @since 2.0.0 bbPress (r2688)
 */
function bbp_displayed_user_id() {
	echo bbp_get_displayed_user_id();
}
	/**
	 * Return ID of displayed user
	 *
	 * @since 2.0.0 bbPress (r2688)
	 *
	 * @return int Displayed user id
	 */
	function bbp_get_displayed_user_id() {

// Filter & return
		return apply_filters( 'bbp_get_displayed_user_id', bbp_get_user_id( 0, true, false ) );
	}

/**
 * Output a sanitized user field value
 *
 * This function relies on the $filter parameter to decide how to sanitize
 * the field value that it finds. Since it uses the WP_User object's magic
 * __get() method, it can also be used to get user_meta values.
 *
 * @since 2.0.0 bbPress (r2688)
 *
 * @param string $field Field to get
 * @param string $filter How to filter the field value (null|raw|db|display|edit)
 */
function bbp_displayed_user_field( $field = '', $filter = 'display' ) {
	echo bbp_get_displayed_user_field( $field, $filter );
}
	/**
	 * Return a sanitized user field value
	 *
	 * This function relies on the $filter parameter to decide how to sanitize
	 * the field value that it finds. Since it uses the WP_User object's magic
	 * __get() method, it can also be used to get user_meta values.
	 *
	 * @since 2.0.0 bbPress (r2688)
	 *
	 * @param string $field Field to get
	 * @param string $filter How to filter the field value (null|raw|db|display|edit)
	 * @see WP_User::__get() for more on how the value is retrieved
	 * @see sanitize_user_field() for more on how the value is sanitized
	 * @return string|bool Value of the field if it exists, else false
	 */
	function bbp_get_displayed_user_field( $field = '', $filter = 'display' ) {

// Get the displayed user
		$user         = bbpress()->displayed_user;

// Juggle the user filter property because we don't want to muck up how
		// other code might interact with this object.
		$old_filter   = $user->filter;
		$user->filter = $filter;

// Get the field value from the WP_User object. We don't need to perform
		// an isset() because the WP_User::__get() does it for us.
		$value        = $user->$field;

// Put back the user filter property that was previously juggled above.
		$user->filter = $old_filter;

// Filter & return
		return apply_filters( 'bbp_get_displayed_user_field', $value, $field, $filter );
	}

/**
 * Output name of current user
 *
 * @since 2.0.0 bbPress (r2574)
 */
function bbp_current_user_name() {
	echo esc_attr( bbp_get_current_user_name() );
}
	/**
	 * Return name of current user
	 *
	 * @since 2.0.0 bbPress (r2574)
	 *
	 * @return string
	 */
	function bbp_get_current_user_name() {

// Default current user name
		$default = bbp_get_fallback_display_name();

// Check the $user_identity global
		$current_user_name = is_user_logged_in()
			? bbp_get_global_object( 'user_identity', false, $default )
			: $default;

// Filter & return
		return apply_filters( 'bbp_get_current_user_name', $current_user_name );
	}

/**
 * Output avatar of current user
 *
 * @since 2.0.0 bbPress (r2574)
 *
 * @param int $size Size of the avatar. Defaults to 40
 */
function bbp_current_user_avatar( $size = 40 ) {
	echo bbp_get_current_user_avatar( $size );
}

/**
	 * Return avatar of current user
	 *
	 * @since 2.0.0 bbPress (r2574)
	 *
	 * @param int $size Size of the avatar. Defaults to 40
	 * @return string Current user avatar
	 */
	function bbp_get_current_user_avatar( $size = 40 ) {

$user = bbp_get_current_user_id();
		if ( empty( $user ) ) {
			$user = bbp_get_current_anonymous_user_data( 'email' );
		}

$avatar = get_avatar( $user, $size );

// Filter & return
		return apply_filters( 'bbp_get_current_user_avatar', $avatar, $size );
	}

/**
 * Output link to the profile page of a user
 *
 * @since 2.0.0 bbPress (r2688)
 *
 * @param int $user_id Optional. User id
 */
function bbp_user_profile_link( $user_id = 0 ) {
	echo bbp_get_user_profile_link( $user_id );
}
	/**
	 * Return link to the profile page of a user
	 *
	 * @since 2.0.0 bbPress (r2688)
	 *
	 * @param int $user_id Optional. User id
	 * @return string User profile link
	 */
	function bbp_get_user_profile_link( $user_id = 0 ) {

// Validate user id
		$user_id = bbp_get_user_id( $user_id );
		if ( empty( $user_id ) ) {
			return false;
		}

$user      = get_userdata( $user_id );
		$user_link = '<a href="' . esc_url( bbp_get_user_profile_url( $user_id ) ) . '">' . esc_html( $user->display_name ) . '</a>';

// Filter & return
		return apply_filters( 'bbp_get_user_profile_link', $user_link, $user_id );
	}

/**
 * Output a users nicename to the screen
 *
 * @since 2.3.0 bbPress (r4671)
 *
 * @param int $user_id User ID whose nicename to get
 * @param array $args before|after|user_id|force
 */
function bbp_user_nicename( $user_id = 0, $args = array() ) {
	echo bbp_get_user_nicename( $user_id, $args );
}
	/**
	 * Return a users nicename to the screen
	 *
	 * @since 2.3.0 bbPress (r4671)
	 *
	 * @param int $user_id User ID whose nicename to get
	 * @param array $args before|after|user_id|force
	 * @return string User nicename, maybe wrapped in before/after strings
	 */
	function bbp_get_user_nicename( $user_id = 0, $args = array() ) {

// Bail if no user ID passed
		$user_id = bbp_get_user_id( $user_id );
		if ( empty( $user_id ) ) {
			return false;
		}

// Parse default arguments
		$r = bbp_parse_args( $args, array(
			'user_id' => $user_id,
			'before'  => '',
			'after'   => '',
			'force'   => ''
		), 'get_user_nicename' );

// Force the nicename (likely from a previous user query)
		if ( ! empty( $r['force'] ) ) {
			$nicename = (string) $r['force'];

// Maybe fallback to getting the nicename from user data
		} elseif ( ! empty( $r['user_id'] ) ) {
			$user     = get_userdata( $r['user_id'] );
			$nicename = ! empty( $user )
				? $user->user_nicename
				: '';

// Maybe fallback to empty string so filter still applies
		} else {
			$nicename = '';
		}

// Maybe wrap the nicename
		$retval = ! empty( $nicename )
			? $r['before'] . esc_html( $nicename ) . $r['after']
			: '';

// Filter & return
		return (string) apply_filters( 'bbp_get_user_nicename', $retval, $user_id, $r, $args );
	}

/**
 * Output URL to the profile page of a user
 *
 * @since 2.0.0 bbPress (r2688)
 *
 * @param int $user_id Optional. User id
 * @param string $user_nicename Optional. User nicename
 */
function bbp_user_profile_url( $user_id = 0, $user_nicename = '' ) {
	echo esc_url( bbp_get_user_profile_url( $user_id, $user_nicename ) );
}
	/**
	 * Return URL to the profile page of a user
	 *
	 * @since 2.0.0 bbPress (r2688)
	 *
	 * @param int $user_id Optional. User id
	 * @param string $user_nicename Optional. User nicename
	 * @return string User profile url
	 */
	function bbp_get_user_profile_url( $user_id = 0, $user_nicename = '' ) {

// Use displayed user ID if there is one, and one isn't requested
		$user_id = bbp_get_user_id( $user_id );
		if ( empty( $user_id ) ) {
			return false;
		}

// Bail if intercepted
		$intercept = bbp_maybe_intercept( 'bbp_pre_get_user_profile_url', func_get_args() );
		if ( bbp_is_intercepted( $intercept ) ) {
			return $intercept;
		}

// Pretty permalinks
		if ( bbp_use_pretty_urls() ) {

// Get username if not passed
			if ( empty( $user_nicename ) ) {
				$user_nicename = bbp_get_user_nicename( $user_id );
			}

// Run through home_url()
			$url = trailingslashit( bbp_get_root_url() . bbp_get_user_slug() ) . $user_nicename;
			$url = user_trailingslashit( $url );
			$url = home_url( $url );

// Unpretty permalinks
		} else {
			$url = add_query_arg( array(
				bbp_get_user_rewrite_id() => $user_id
			), home_url( '/' ) );
		}

// Filter & return
		return apply_filters( 'bbp_get_user_profile_url', $url, $user_id, $user_nicename );
	}

/**
 * Output link to the profile edit page of a user
 *
 * @since 2.0.0 bbPress (r2688)
 *
 * @param int $user_id Optional. User id
 */
function bbp_user_profile_edit_link( $user_id = 0 ) {
	echo bbp_get_user_profile_edit_link( $user_id );
}
	/**
	 * Return link to the profile edit page of a user
	 *
	 * @since 2.0.0 bbPress (r2688)
	 *
	 * @param int $user_id Optional. User id
	 * @return string User profile edit link
	 */
	function bbp_get_user_profile_edit_link( $user_id = 0 ) {

// Validate user id
		$user_id = bbp_get_user_id( $user_id );
		if ( empty( $user_id ) ) {
			return false;
		}

$user      = get_userdata( $user_id );
		$edit_link = '<a href="' . esc_url( bbp_get_user_profile_edit_url( $user_id ) ) . '">' . esc_html( $user->display_name ) . '</a>';

// Filter & return
		return apply_filters( 'bbp_get_user_profile_edit_link', $edit_link, $user_id );
	}

/**
 * Output URL to the profile edit page of a user
 *
 * @since 2.0.0 bbPress (r2688)
 *
 * @param int $user_id Optional. User id
 * @param string $user_nicename Optional. User nicename
 */
function bbp_user_profile_edit_url( $user_id = 0, $user_nicename = '' ) {
	echo esc_url( bbp_get_user_profile_edit_url( $user_id, $user_nicename ) );
}
	/**
	 * Return URL to the profile edit page of a user
	 *
	 * @since 2.0.0 bbPress (r2688)
	 *
	 * @param int $user_id Optional. User id
	 * @param string $user_nicename Optional. User nicename
	 * @return string
	 */
	function bbp_get_user_profile_edit_url( $user_id = 0, $user_nicename = '' ) {

$user_id = bbp_get_user_id( $user_id );
		if ( empty( $user_id ) ) {
			return false;
		}

// Bail if intercepted
		$intercept = bbp_maybe_intercept( 'bbp_pre_get_user_profile_edit_url', func_get_args() );
		if ( bbp_is_intercepted( $intercept ) ) {
			return $intercept;
		}

// Get user profile URL
		$profile_url = bbp_get_user_profile_url( $user_id, $user_nicename );

// Pretty permalinks
		if ( bbp_use_pretty_urls() ) {
			$url = trailingslashit( $profile_url ) . bbp_get_edit_slug();
			$url = user_trailingslashit( $url );

// Unpretty permalinks
		} else {
			$url = add_query_arg( array(
				bbp_get_edit_rewrite_id() => '1'
			), $profile_url );
		}

// Filter & return
		return apply_filters( 'bbp_get_user_edit_profile_url', $url, $user_id, $user_nicename );
	}

/**
 * Output a user's main role for display
 *
 * @since 2.1.0 bbPress (r3860)
 *
 * @param int $user_id
 */
function bbp_user_display_role( $user_id = 0 ) {
	echo esc_attr( bbp_get_user_display_role( $user_id ) );
}
	/**
	 * Return a user's main role for display
	 *
	 * @since 2.1.0 bbPress (r3860)
	 *
	 * @param int $user_id
	 * @return string
	 */
	function bbp_get_user_display_role( $user_id = 0 ) {

// Validate user id
		$user_id = bbp_get_user_id( $user_id );

// User is not registered
		if ( empty( $user_id ) ) {
			$role = esc_html__( 'Guest', 'bbpress' );

// User is not active
		} elseif ( bbp_is_user_inactive( $user_id ) ) {
			$role = esc_html__( 'Inactive', 'bbpress' );

// User have a role
		} else {
			$role_id = bbp_get_user_role( $user_id );
			$role    = bbp_get_dynamic_role_name( $role_id );
		}

// No role found so default to generic "Member"
		if ( empty( $role ) ) {
			$role = esc_html__( 'Member', 'bbpress' );
		}

// Filter & return
		return apply_filters( 'bbp_get_user_display_role', $role, $user_id );
	}

/**
 * Output the link to the admin section
 *
 * @since 2.0.0 bbPress (r2827)
 *
 * @param array $args Optional. See {@link bbp_get_admin_link()}
 */
function bbp_admin_link( $args = array() ) {
	echo bbp_get_admin_link( $args );
}
	/**
	 * Return the link to the admin section
	 *
	 * @since 2.0.0 bbPress (r2827)
	 *
	 * @param array $args Optional. This function supports these arguments:
	 *  - text: The text
	 *  - before: Before the lnk
	 *  - after: After the link
	 * @return The link
	 */
	function bbp_get_admin_link( $args = array() ) {

// Bail if user cannot globally moderate
		if ( ! current_user_can( 'moderate' ) ) {
			return;
		}

if ( ! empty( $args ) && is_string( $args ) && ( false === strpos( $args, '=' ) ) ) {
			$args = array( 'text' => $args );
		}

// Parse arguments against default values
		$r = bbp_parse_args( $args, array(
			'text'   => esc_html__( 'Admin', 'bbpress' ),
			'before' => '',
			'after'  => ''
		), 'get_admin_link' );

$retval = $r['before'] . '<a href="' . esc_url( admin_url() ) . '">' . $r['text'] . '</a>' . $r['after'];

// Filter & return
		return apply_filters( 'bbp_get_admin_link', $retval, $r, $args );
	}

/** User IP *******************************************************************/

/**
 * Output the author IP address of a post
 *
 * @since 2.0.0 bbPress (r3120)
 *
 * @param array $args Optional. If it is an integer, it is used as post id.
 */
function bbp_author_ip( $args = array() ) {
	echo bbp_get_author_ip( $args );
}
	/**
	 * Return the author IP address of a post
	 *
	 * @since 2.0.0 bbPress (r3120)
	 *
	 * @param array $args Optional. If an integer, it is used as reply id.
	 * @return string Author link of reply
	 */
	function bbp_get_author_ip( $args = array() ) {

// Used as post id
		$post_id = is_numeric( $args ) ? (int) $args : 0;

// Parse arguments against default values
		$r = bbp_parse_args( $args, array(
			'post_id' => $post_id,
			'before'  => '<span class="bbp-author-ip">(',
			'after'   => ')</span>'
		), 'get_author_ip' );

// Get the author IP meta value
		$author_ip = get_post_meta( $r['post_id'], '_bbp_author_ip', true );
		$author_ip = ! empty( $author_ip )
			? $r['before'] . esc_html( $author_ip ) . $r['after']
			: '';

// Filter & return
		return apply_filters( 'bbp_get_author_ip', $author_ip, $r, $args );
	}

/** Anonymous Fields **********************************************************/

/**
 * Get the default name that's displayed when a user cannot be identified.
 *
 * This might happen if a user was deleted but their content was retained, or
 * if something went wrong during saving anonymous user data to the database.
 *
 * @since 2.6.0 bbPress (r6561)
 *
 * @param int $object_id For additional context only, usually a post ID
 *
 * @return string
 */
function bbp_get_fallback_display_name( $object_id = 0 ) {
	$name = esc_html__( 'Anonymous', 'bbpress' );

// Filter & return
	return apply_filters( 'bbp_get_anonymous_name', $name, $object_id );
}

/**
 * Output the author display-name of a topic or reply.
 *
 * Convenience function to ensure proper template functions are called
 * and correct filters are executed. Used primarily to display topic
 * and reply author information in the anonymous form template-part.
 *
 * @since 2.5.0 bbPress (r5119)
 *
 * @param int $post_id
 */
function bbp_author_display_name( $post_id = 0 ) {
	echo esc_attr( bbp_get_author_display_name( $post_id ) );
}

/**
	 * Return the author display-name of a topic or reply.
	 *
	 * Convenience function to ensure proper template functions are called
	 * and correct filters are executed. Used primarily to display topic
	 * and reply author information in the anonymous form template-part.
	 *
	 * @since 2.5.0 bbPress (r5119)
	 *
	 * @param int $post_id
	 *
	 * @return string The name of the author
	 */
	function bbp_get_author_display_name( $post_id = 0 ) {

// Define local variable(s)
		$retval = '';

// Topic edit
		if ( bbp_is_topic_edit() ) {
			$retval = bbp_get_topic_author_display_name( $post_id );

// Reply edit
		} elseif ( bbp_is_reply_edit() ) {
			$retval = bbp_get_reply_author_display_name( $post_id );

// Not an edit, so rely on current user cookie data
		} else {
			$retval = bbp_get_current_anonymous_user_data( 'name' );
		}

// Filter & return
		return apply_filters( 'bbp_get_author_display_name', $retval, $post_id );
	}

/**
 * Output the author email of a topic or reply.
 *
 * Convenience function to ensure proper template functions are called
 * and correct filters are executed. Used primarily to display topic
 * and reply author information in the anonymous user form template-part.
 *
 * @since 2.5.0 bbPress (r5119)
 *
 * @param int $post_id
 */
function bbp_author_email( $post_id = 0 ) {
	echo esc_attr( bbp_get_author_email( $post_id ) );
}

/**
	 * Return the author email of a topic or reply.
	 *
	 * Convenience function to ensure proper template functions are called
	 * and correct filters are executed. Used primarily to display topic
	 * and reply author information in the anonymous user form template-part.
	 *
	 * @since 2.5.0 bbPress (r5119)
	 *
	 * @param int $post_id
	 *
	 * @return string The email of the author
	 */
	function bbp_get_author_email( $post_id = 0 ) {

// Define local variable(s)
		$retval = '';

// Topic edit
		if ( bbp_is_topic_edit() ) {
			$retval = bbp_get_topic_author_email( $post_id );

// Reply edit
		} elseif ( bbp_is_reply_edit() ) {
			$retval = bbp_get_reply_author_email( $post_id );

// Not an edit, so rely on current user cookie data
		} else {
			$retval = bbp_get_current_anonymous_user_data( 'email' );
		}

// Filter & return
		return apply_filters( 'bbp_get_author_email', $retval, $post_id );
	}

/**
 * Output the author url of a topic or reply.
 *
 * Convenience function to ensure proper template functions are called
 * and correct filters are executed. Used primarily to display topic
 * and reply author information in the anonymous user form template-part.
 *
 * @since 2.5.0 bbPress (r5119)
 *
 * @param int $post_id
 */
function bbp_author_url( $post_id = 0 ) {
	echo esc_attr( bbp_get_author_url( $post_id ) );
}

/**
	 * Return the author url of a topic or reply.
	 *
	 * Convenience function to ensure proper template functions are called
	 * and correct filters are executed. Used primarily to display topic
	 * and reply author information in the anonymous user form template-part.
	 *
	 * @since 2.5.0 bbPress (r5119)
	 *
	 * @param int $post_id
	 *
	 * @return string The url of the author
	 */
	function bbp_get_author_url( $post_id = 0 ) {

// Define local variable(s)
		$retval = '';

// Topic edit
		if ( bbp_is_topic_edit() ) {
			$retval = bbp_get_topic_author_url( $post_id );

// Reply edit
		} elseif ( bbp_is_reply_edit() ) {
			$retval = bbp_get_reply_author_url( $post_id );

// Not an edit, so rely on current user cookie data
		} else {
			$retval = bbp_get_current_anonymous_user_data( 'url' );
		}

// Filter & return
		return apply_filters( 'bbp_get_author_url', $retval, $post_id );
	}

/** Favorites *****************************************************************/

/**
 * Output the link to the user's favorites page (profile page)
 *
 * @since 2.0.0 bbPress (r2652)
 * @since 2.6.0 bbPress (r6308) Add pagination if in the loop
 *
 * @param int $user_id Optional. User id
 */
function bbp_favorites_permalink( $user_id = 0 ) {
	echo esc_url( bbp_get_favorites_permalink( $user_id ) );
}
	/**
	 * Return the link to the user's favorites page (profile page)
	 *
	 * @since 2.0.0 bbPress (r2652)
	 * @since 2.6.0 bbPress (r6308) Add pagination if in the loop
	 *
	 * @param int $user_id Optional. User id
	 * @return string Permanent link to user profile page
	 */
	function bbp_get_favorites_permalink( $user_id = 0 ) {

// Use displayed user ID if there is one, and one isn't requested
		$user_id = bbp_get_user_id( $user_id );
		if ( empty( $user_id ) ) {
			return false;
		}

// Bail if intercepted
		$intercept = bbp_maybe_intercept( 'bbp_pre_get_favorites_permalink', func_get_args() );
		if ( bbp_is_intercepted( $intercept ) ) {
			return $intercept;
		}

// Get user profile URL & page
		$profile_url = bbp_get_user_profile_url( $user_id );
		$page        = (int)  bbpress()->topic_query->paged;
		$paged       = (bool) bbpress()->topic_query->in_the_loop;

// Pretty permalinks
		if ( bbp_use_pretty_urls() ) {

// Base URL
			$url = trailingslashit( $profile_url ) . bbp_get_user_favorites_slug();

// Add page
			if ( ( true === $paged ) && ( $page > 1 ) ) {
				$url = trailingslashit( $url ) . bbp_get_paged_slug() . '/' . $page;
			}

// Ensure correct trailing slash
			$url = user_trailingslashit( $url );

// Unpretty permalinks
		} else {

// Base arguments
			$args = array(
				bbp_get_user_favorites_rewrite_id() => bbp_get_user_favorites_slug(),
			);

// Add page
			if ( ( true === $paged ) && ( $page > 1 ) ) {
				$args['page'] = $page;
			}

// Add arguments
			$url = add_query_arg( $args, $profile_url );
		}

// Filter & return
		return apply_filters( 'bbp_get_favorites_permalink', $url, $user_id );
	}

/**
 * Output the link to make a topic favorite/remove a topic from favorites
 *
 * @since 2.0.0 bbPress (r2652)
 * @since 2.6.0 bbPress (r6308) Add 'redirect_to' support
 *
 * @param array $args See {@link bbp_get_user_favorites_link()}
 * @param int $user_id Optional. User id
 * @param bool $wrap Optional. If you want to wrap the link in <span id="favorite-toggle">.
 */
function bbp_user_favorites_link( $args = array(), $user_id = 0, $wrap = true ) {
	echo bbp_get_user_favorites_link( $args, $user_id, $wrap );
}
	/**
	 * User favorites link
	 *
	 * Return the link to make a topic favorite/remove a topic from
	 * favorites
	 *
	 * @since 2.0.0 bbPress (r2652)
	 * @since 2.6.0 bbPress (r6308) Add 'redirect_to' support
	 *
	 * @param array $args This function supports these arguments:
	 *  - subscribe: Favorite text
	 *  - unsubscribe: Unfavorite text
	 *  - user_id: User id
	 *  - topic_id: Topic id
	 *  - before: Before the link
	 *  - after: After the link
	 * @param int $user_id Optional. User id
	 * @param int $topic_id Optional. Topic id
	 * @param bool $wrap Optional. If you want to wrap the link in <span id="favorite-toggle">. See ajax_favorite()
	 * @return string User favorites link
	 */
	function bbp_get_user_favorites_link( $args = array(), $user_id = 0, $wrap = true ) {

// Bail if favorites are inactive
		if ( ! bbp_is_favorites_active() ) {
			return false;
		}

// Parse arguments against default values
		$r = bbp_parse_args( $args, array(
			'favorite'    => esc_html__( 'Favorite',   'bbpress' ),
			'favorited'   => esc_html__( 'Unfavorite', 'bbpress' ),
			'user_id'     => 0,
			'object_id'   => 0,
			'object_type' => 'post',
			'before'      => '',
			'after'       => '',
			'redirect_to' => '',

// Deprecated. Use object_id.
			'forum_id'    => 0,
			'topic_id'    => 0
		), 'get_user_favorites_link' );

// Validate user and object ID's
		$user_id     = bbp_get_user_id( $r['user_id'], true, true );
		$object_type = sanitize_key( $r['object_type'] );

// Back-compat for deprecated arguments
		if ( ! empty( $r['topic_id'] ) ) {
			$object_id = absint( $r['topic_id'] );
		} elseif ( ! empty( $r['forum_id'] ) ) {
			$object_id = absint( $r['forum_id'] );
		} else {
			$object_id = absint( $r['object_id'] );
		}

// Bail if empty
		if ( empty( $user_id ) || empty( $object_id ) || empty( $object_type ) ) {
			return false;
		}

// No link if you can't edit yourself
		if ( ! current_user_can( 'edit_user', $user_id ) ) {
			return false;
		}

// Decide which link to show
		$is_fav = bbp_is_user_favorite( $user_id, $object_id );
		if ( ! empty( $is_fav ) ) {
			$text   = $r['favorited'];
			$q_args = array(
				'action'    => 'bbp_favorite_remove',
				'object_id' => $object_id
			);
		} else {
			$text   = $r['favorite'];
			$q_args = array(
				'action'    => 'bbp_favorite_add',
				'object_id' => $object_id
			);
		}

// Custom redirect
		if ( ! empty( $r['redirect_to'] ) ) {
			$q_args['redirect_to'] = urlencode( $r['redirect_to'] );
		}

// URL
		$url  = esc_url( wp_nonce_url( add_query_arg( $q_args ), 'toggle-favorite_' . $object_id ) );
		$sub  = $is_fav ? ' class="is-favorite"' : '';
		$html = sprintf( '%s<span id="favorite-%d"  %s><a href="%s" class="favorite-toggle" data-bbp-object-id="%d" data-bbp-object-type="%s" data-bbp-nonce="%s">%s</a></span>%s', $r['before'], $object_id, $sub, $url, $object_id, $object_type, wp_create_nonce( 'toggle-favorite_' . $object_id ), $text, $r['after'] );

// Initial output is wrapped in a span, ajax output is hooked to this
		if ( ! empty( $wrap ) ) {
			$html = '<span id="favorite-toggle">' . $html . '</span>';
		}

// Filter & return
		return apply_filters( 'bbp_get_user_favorites_link', $html, $r, $user_id, $object_id );
	}

/** Subscriptions *************************************************************/

/**
 * Output the link to the user's subscriptions page (profile page)
 *
 * @since 2.0.0 bbPress (r2688)
 * @since 2.6.0 bbPress (r6308) Add pagination if in the loop
 *
 * @param int $user_id Optional. User id
 */
function bbp_subscriptions_permalink( $user_id = 0 ) {
	echo esc_url( bbp_get_subscriptions_permalink( $user_id ) );
}
	/**
	 * Return the link to the user's subscriptions page (profile page)
	 *
	 * @since 2.0.0 bbPress (r2688)
	 * @since 2.6.0 bbPress (r6308) Add pagination if in the loop
	 *
	 * @param int $user_id Optional. User id
	 * @return string Permanent link to user subscriptions page
	 */
	function bbp_get_subscriptions_permalink( $user_id = 0 ) {

// Use displayed user ID if there is one, and one isn't requested
		$user_id = bbp_get_user_id( $user_id );
		if ( empty( $user_id ) ) {
			return false;
		}

// Bail if intercepted
		$intercept = bbp_maybe_intercept( 'bbp_pre_get_subscriptions_permalink', func_get_args() );
		if ( bbp_is_intercepted( $intercept ) ) {
			return $intercept;
		}

// Get user profile URL
		$profile_url = bbp_get_user_profile_url( $user_id );
		$page        = 0;
		$paged       = false;

// Get pagination data
		if ( bbpress()->topic_query->in_the_loop ) {
			$page  = (int)  bbpress()->topic_query->paged;
			$paged = (bool) bbpress()->topic_query->in_the_loop;

} elseif ( bbpress()->forum_query->in_the_loop ) {
			$page  = (int)  bbpress()->forum_query->paged;
			$paged = (bool) bbpress()->forum_query->in_the_loop;
		}

// Pretty permalinks
		if ( bbp_use_pretty_urls() ) {

// Base URL
			$url = trailingslashit( $profile_url ) . bbp_get_user_subscriptions_slug();

// Add page
			if ( ( true === $paged ) && ( $page > 1 ) ) {
				$url = trailingslashit( $url ) . bbp_get_paged_slug() . '/' . $page;
			}

// Ensure correct trailing slash
			$url = user_trailingslashit( $url );

// Unpretty permalinks
		} else {

// Base arguments
			$args = array(
				bbp_get_user_subscriptions_rewrite_id() => bbp_get_user_subscriptions_slug(),
			);

// Add page
			if ( ( true === $paged ) && ( $page > 1 ) ) {
				$args['page'] = $page;
			}

// Add arguments
			$url = add_query_arg( $args, $profile_url );
		}

// Filter & return
		return apply_filters( 'bbp_get_subscriptions_permalink', $url, $user_id );
	}

/**
 * Output the link to subscribe/unsubscribe from a topic
 *
 * @since 2.0.0 bbPress (r2668)
 * @since 2.6.0 bbPress (r6308) Add 'redirect_to' support
 *
 * @param array $args See {@link bbp_get_user_subscribe_link()}
 * @param int $user_id Optional. User id
 * @param bool $wrap Optional. If you want to wrap the link in <span id="subscription-toggle">.
 */
function bbp_user_subscribe_link( $args = array(), $user_id = 0, $wrap = true ) {
	echo bbp_get_user_subscribe_link( $args, $user_id, $wrap );
}
	/**
	 * Return the link to subscribe/unsubscribe from a forum or topic
	 *
	 * @since 2.0.0 bbPress (r2668)
	 * @since 2.6.0 bbPress (r6308) Add 'redirect_to' support
	 *
	 * @param array $args This function supports these arguments:
	 *  - subscribe: Subscribe text
	 *  - unsubscribe: Unsubscribe text
	 *  - user_id: User id
	 *  - topic_id: Topic id
	 *  - forum_id: Forum id
	 *  - before: Before the link
	 *  - after: After the link
	 * @param int $user_id Optional. User id
	 * @param bool $wrap Optional. If you want to wrap the link in <span id="subscription-toggle">.
	 * @return string Permanent link to topic
	 */
	function bbp_get_user_subscribe_link( $args = array(), $user_id = 0, $wrap = true ) {

// Bail if subscriptions are inactive
		if ( ! bbp_is_subscriptions_active() ) {
			return;
		}

// Parse arguments against default values
		$r = bbp_parse_args( $args, array(
			'subscribe'   => esc_html__( 'Subscribe',   'bbpress' ),
			'unsubscribe' => esc_html__( 'Unsubscribe', 'bbpress' ),
			'user_id'     => 0,
			'object_id'   => 0,
			'object_type' => 'post',
			'before'      => '',
			'after'       => '',
			'redirect_to' => '',

// Deprecated. Use object_id.
			'forum_id'    => 0,
			'topic_id'    => 0
		), 'get_user_subscribe_link' );

// Validate user
		$user_id     = bbp_get_user_id( $r['user_id'], true, true );
		$object_type = sanitize_key( $r['object_type'] );

// Bail if anything is missing
		if ( empty( $user_id ) || empty( $object_id ) || empty( $object_type ) ) {
			return false;
		}

// No link if you can't edit yourself
		if ( ! current_user_can( 'edit_user', $user_id ) ) {
			return false;
		}

// Decide which link to show
		$is_subscribed = bbp_is_user_subscribed( $user_id, $object_id );
		if ( ! empty( $is_subscribed ) ) {
			$text   = $r['unsubscribe'];
			$q_args = array(
				'action'      => 'bbp_unsubscribe',
				'object_id'   => $object_id,
				'object_type' => $object_type
			);
		} else {
			$text   = $r['subscribe'];
			$q_args = array(
				'action'      => 'bbp_subscribe',
				'object_id'   => $object_id,
				'object_type' => $object_type
			);
		}

// Custom redirect
		if ( ! empty( $r['redirect_to'] ) ) {
			$q_args['redirect_to'] = urlencode( $r['redirect_to'] );
		}

// URL
		$url  = esc_url( wp_nonce_url( add_query_arg( $q_args ), 'toggle-subscription_' . $object_id ) );
		$sub  = $is_subscribed ? ' class="is-subscribed"' : '';
		$html = sprintf( '%s<span id="subscribe-%d"  %s><a href="%s" class="subscription-toggle" data-bbp-object-id="%d" data-bbp-object-type="%d" data-bbp-nonce="%s">%s</a></span>%s', $r['before'], $object_id, $sub, $url, $object_id, $object_type, wp_create_nonce( 'toggle-subscription_' . $object_id ), $text, $r['after'] );

// Initial output is wrapped in a span, ajax output is hooked to this
		if ( ! empty( $wrap ) ) {
			$html = '<span id="subscription-toggle">' . $html . '</span>';
		}

// Filter & return
		return apply_filters( 'bbp_get_user_subscribe_link', $html, $r, $user_id, $object_id );
	}

/** Edit User *****************************************************************/

/**
 * Display profile edit success notice on user edit page
 *
 * @since 2.0.0 bbPress (r2688)
 */
function bbp_notice_edit_user_success() {

// Bail if no updated argument
	if ( empty( $_GET['updated'] ) ) {
		return;
	}

// Bail if not on users own profile
	if ( ! bbp_is_single_user_edit() ) {
		return;
	} ?>

<?php
}

/**
 * Display pending email change notice on user edit page
 *
 * @since 2.6.0 bbPress (r5660)
 */
function bbp_notice_edit_user_pending_email() {

// Bail if not on users own profile
	if ( ! bbp_is_user_home_edit() ) {
		return;
	}

// Check for pending email address change
	$user_id   = bbp_get_displayed_user_id();
	$key       = '_new_email';
	$new_email = get_user_meta( $user_id, $key, true );

// Bail if no pending email address change
	if ( empty( $new_email['newemail'] ) ) {
		return;
	}

// Build the nonced URL to dismiss the pending change
	$user_url = bbp_get_user_profile_edit_url( $user_id );
	$nonce    = "dismiss-{$user_id}{$key}";
	$args     = array(
		'action'  => 'bbp-update-user-email',
		'dismiss' => "{$user_id}{$key}"
	);

// Build the variables to pass into printf()
	$dismiss_url  = wp_nonce_url( add_query_arg( $args, $user_url ), $nonce );
	$dismiss_link = '<a href="' . esc_url( $dismiss_url ) . '">' . esc_html_x( 'Cancel', 'Dismiss pending user email address change', 'bbpress' ) . '</a>';
	$coded_email  = '<code>' . esc_html( $new_email['newemail'] ) . '</code>'; ?>

<?php
}

/**
 * Super admin privileges notice
 *
 * @since 2.0.0 bbPress (r2688)
 */
function bbp_notice_edit_user_is_super_admin() {
	if ( is_multisite() && ( bbp_is_single_user() || bbp_is_single_user_edit() ) && current_user_can( 'manage_network_options' ) && is_super_admin( bbp_get_displayed_user_id() ) ) : ?>

<?php endif;
}

/**
 * Drop down for selecting the user's display name
 *
 * @since 2.0.0 bbPress (r2688)
 */
function bbp_edit_user_display_name() {
	$bbp            = bbpress();
	$public_display = array();
	$public_display['display_username'] = $bbp->displayed_user->user_login;

if ( ! empty( $bbp->displayed_user->nickname ) ) {
		$public_display['display_nickname']  = $bbp->displayed_user->nickname;
	}

if ( ! empty( $bbp->displayed_user->first_name ) ) {
		$public_display['display_firstname'] = $bbp->displayed_user->first_name;
	}

if ( ! empty( $bbp->displayed_user->last_name ) ) {
		$public_display['display_lastname']  = $bbp->displayed_user->last_name;
	}

if ( ! empty( $bbp->displayed_user->first_name ) && ! empty( $bbp->displayed_user->last_name ) ) {
		$public_display['display_firstlast'] = $bbp->displayed_user->first_name . ' ' . $bbp->displayed_user->last_name;
		$public_display['display_lastfirst'] = $bbp->displayed_user->last_name  . ' ' . $bbp->displayed_user->first_name;
	}

// Only add this if it isn't duplicated elsewhere
	if ( ! in_array( $bbp->displayed_user->display_name, $public_display, true ) ) {
		$public_display = array( 'display_displayname' => $bbp->displayed_user->display_name ) + $public_display;
	}

$public_display = array_map( 'trim', $public_display );
	$public_display = array_unique( $public_display ); ?>

<?php foreach ( $public_display as $id => $item ) : ?>

<option id="<?php echo $id; ?>" value="<?php echo esc_attr( $item ); ?>"<?php selected( $bbp->displayed_user->display_name, $item ); ?>><?php echo $item; ?></option>

<?php endforeach; ?>

</select>

<?php
}

/**
 * Output blog role selector (for user edit)
 *
 * @since 2.0.0 bbPress (r2688)
 */
function bbp_edit_user_blog_role() {

// Bail if no user is being edited
	if ( ! bbp_is_single_user_edit() ) {
		return;
	}

// Get users current blog role
	$user_role  = bbp_get_user_blog_role( bbp_get_displayed_user_id() );

// Get the blog roles
	$blog_roles = bbp_get_blog_roles(); ?>

<?php foreach ( $blog_roles as $role => $details ) : ?>

<option <?php selected( $user_role, $role ); ?> value="<?php echo esc_attr( $role ); ?>"><?php echo bbp_translate_user_role( $details['name'] ); ?></option>

<?php endforeach; ?>

</select>

<?php
}

/**
 * Output forum role selector (for user edit)
 *
 * @since 2.2.0 bbPress (r4284)
 */
function bbp_edit_user_forums_role() {

// Bail if no user is being edited
	if ( ! bbp_is_single_user_edit() ) {
		return;
	}

// Get the user's current forum role
	$user_role     = bbp_get_user_role( bbp_get_displayed_user_id() );

// Get the folum roles
	$dynamic_roles = bbp_get_dynamic_roles();

// Only keymasters can set other keymasters
	if ( ! bbp_is_user_keymaster() ) {
		unset( $dynamic_roles[ bbp_get_keymaster_role() ] );
	} ?>

<?php foreach ( $dynamic_roles as $role => $details ) : ?>

<option <?php selected( $user_role, $role ); ?> value="<?php echo esc_attr( $role ); ?>"><?php echo bbp_translate_user_role( $details['name'] ); ?></option>

<?php endforeach; ?>

</select>

<?php
}

/**
 * Return user contact methods select box
 *
 * @since 2.0.0 bbPress (r2688)
 * @return string User contact methods
 */
function bbp_edit_user_contact_methods() {

// Get the core WordPress contact methods
	$contact_methods = wp_get_user_contact_methods( bbpress()->displayed_user );

// Filter & return
	return (array) apply_filters( 'bbp_edit_user_contact_methods', $contact_methods );
}

/**
 * Output the language chooser (for user edit)
 *
 * @since 2.6.0 bbPress (r6488)
 *
 * @param array $args See wp_dropdown_languages()
 * @return string
 */
function bbp_edit_user_language( $args = array() ) {

// Bail if no user is being edited
	if ( ! bbp_is_single_user_edit() ) {
		return;
	}

// Output the dropdown
	bbp_user_languages_dropdown( $args );
}

/** Topics Created ************************************************************/

/**
 * Output the link to the user's topics
 *
 * @since 2.2.0 bbPress (r4225)
 *
 * @param int $user_id Optional. User id
 */
function bbp_user_topics_created_url( $user_id = 0 ) {
	echo esc_url( bbp_get_user_topics_created_url( $user_id ) );
}
	/**
	 * Return the link to the user's topics
	 *
	 * @since 2.2.0 bbPress (r4225)
	 *
	 * @param int $user_id Optional. User id
	 * @return string Permanent link to user profile page
	 */
	function bbp_get_user_topics_created_url( $user_id = 0 ) {

// Use displayed user ID if there is one, and one isn't requested
		$user_id = bbp_get_user_id( $user_id );
		if ( empty( $user_id ) ) {
			return false;
		}

// Bail if intercepted
		$intercept = bbp_maybe_intercept( 'bbp_pre_get_user_topics_created_url', func_get_args() );
		if ( bbp_is_intercepted( $intercept ) ) {
			return $intercept;
		}

// Get user profile URL
		$profile_url = bbp_get_user_profile_url( $user_id );

// Pretty permalinks
		if ( bbp_use_pretty_urls() ) {
			$url = trailingslashit( $profile_url ) . bbp_get_topic_archive_slug();
			$url = user_trailingslashit( $url );

// Unpretty permalinks
		} else {
			$url = add_query_arg( array(
				bbp_get_user_topics_rewrite_id() => '1',
			), $profile_url );
		}

// Filter & return
		return apply_filters( 'bbp_get_user_topics_created_url', $url, $user_id );
	}

/** Replies Created ************************************************************/

/**
 * Output the link to the user's replies
 *
 * @since 2.2.0 bbPress (r4225)
 *
 * @param int $user_id Optional. User id
 */
function bbp_user_replies_created_url( $user_id = 0 ) {
	echo esc_url( bbp_get_user_replies_created_url( $user_id ) );
}
	/**
	 * Return the link to the user's replies
	 *
	 * @since 2.2.0 bbPress (r4225)
	 *
	 * @param int $user_id Optional. User id
	 * @return string Permanent link to user profile page
	 */
	function bbp_get_user_replies_created_url( $user_id = 0 ) {

// Use displayed user ID if there is one, and one isn't requested
		$user_id = bbp_get_user_id( $user_id );
		if ( empty( $user_id ) ) {
			return false;
		}

// Bail if intercepted
		$intercept = bbp_maybe_intercept( 'bbp_pre_get_user_replies_created_url', func_get_args() );
		if ( bbp_is_intercepted( $intercept ) ) {
			return $intercept;
		}

// Get user profile URL
		$profile_url = bbp_get_user_profile_url( $user_id );

// Pretty permalinks
		if ( bbp_use_pretty_urls() ) {
			$url = trailingslashit( $profile_url ) . bbp_get_reply_archive_slug();
			$url = user_trailingslashit( $url );

// Unpretty permalinks
		} else {
			$url = add_query_arg( array(
				bbp_get_user_replies_rewrite_id() => '1',
			), $profile_url );
		}

// Filter & return
		return apply_filters( 'bbp_get_user_replies_created_url', $url, $user_id );
	}

/** Engagements ***************************************************************/

/**
 * Output the link to the user's engagements
 *
 * @since 2.6.0 bbPress (r6320)
 *
 * @param int $user_id Optional. User id
 */
function bbp_user_engagements_url( $user_id = 0 ) {
	echo esc_url( bbp_get_user_engagements_url( $user_id ) );
}
	/**
	 * Return the link to the user's engagements
	 *
	 * @since 2.6.0 bbPress (r6320)
	 *
	 * @param int $user_id Optional. User id
	 * @return string Permanent link to user profile page
	 */
	function bbp_get_user_engagements_url( $user_id = 0 ) {

// Use displayed user ID if there is one, and one isn't requested
		$user_id = bbp_get_user_id( $user_id );
		if ( empty( $user_id ) ) {
			return false;
		}

// Bail if intercepted
		$intercept = bbp_maybe_intercept( 'bbp_pre_get_user_engagements_url', func_get_args() );
		if ( bbp_is_intercepted( $intercept ) ) {
			return $intercept;
		}

// Get user profile URL
		$profile_url = bbp_get_user_profile_url( $user_id );

// Pretty permalinks
		if ( bbp_use_pretty_urls() ) {
			$url = trailingslashit( $profile_url ) . bbp_get_user_engagements_slug();
			$url = user_trailingslashit( $url );

// Unpretty permalinks
		} else {
			$url = add_query_arg( array(
				bbp_get_user_engagements_rewrite_id() => '1',
			), $profile_url );
		}

// Filter & return
		return apply_filters( 'bbp_get_user_engagements_url', $url, $user_id );
	}

/** Language ******************************************************************/

/**
 * Output the select element used to save a user's language
 *
 * @since 2.6.0 bbPress (r6488)
 *
 * @param array $args See wp_dropdown_languages()
 */
function bbp_user_languages_dropdown( $args = array() ) {
	echo bbp_get_user_languages_dropdown( $args );
}

/**
	 * Return the select element used to save a user's language.
	 *
	 * @since 2.6.0 bbPress (r6488)
	 *
	 * @param array $args See wp_dropdown_languages()
	 * @return string
	 */
	function bbp_get_user_languages_dropdown( $args = array() ) {

// Get user language
		$user_id = ! empty( $args['user_id'] )
			? bbp_get_user_id( $args['user_id'], false, false )
			: bbp_get_displayed_user_id();

// Get user locale
		$user_locale = ! empty( $user_id )
			? get_userdata( $user_id )->locale
			: 'site-default';

// Get all languages
		$languages = get_available_languages();

// No locale for English
		if ( 'en_US' === $user_locale ) {
			$user_locale = '';

// Fallback to site-default if there is a mismatch
		} elseif ( '' === $user_locale || ! in_array( $user_locale, $languages, true ) ) {
			$user_locale = 'site-default';
		}

// Don't pass user ID in
		unset( $args['user_id'] );

// Parse arguments
		$r = bbp_parse_args( $args, array(
			'name'                        => 'locale',
			'id'                          => 'locale',
			'selected'                    => $user_locale,
			'languages'                   => $languages,
			'echo'                        => false,
			'show_available_translations' => false,
			'show_option_site_default'    => true
		), 'user_languages_dropdown' );

// Get the markup for the languages drop-down
		$retval = wp_dropdown_languages( $r );

// Filter & return
		return apply_filters( 'bbp_get_user_languages_dropdown', $retval, $r, $args );
	}

/** Login *********************************************************************/

/**
 * Handle the login and registration template notices
 *
 * @since 2.0.0 bbPress (r2970)
 */
function bbp_login_notices() {

// loggedout was passed
	if ( ! empty( $_GET['loggedout'] ) && ( true === $_GET['loggedout'] ) ) {
		bbp_add_error( 'loggedout', esc_html__( 'You are now logged out.', 'bbpress' ), 'message' );

// registration is disabled
	} elseif ( ! empty( $_GET['registration'] ) && ( 'disabled' === $_GET['registration'] ) ) {
		bbp_add_error( 'registerdisabled', esc_html__( 'New user registration is currently not allowed.', 'bbpress' ) );

// Prompt user to check their email
	} elseif ( ! empty( $_GET['checkemail'] ) && in_array( $_GET['checkemail'], array( 'confirm', 'newpass', 'registered' ), true ) ) {

switch ( $_GET['checkemail'] ) {

// Email needs confirmation
			case 'confirm' :
				bbp_add_error( 'confirm',    esc_html__( 'Check your e-mail for the confirmation link.',     'bbpress' ), 'message' );
				break;

// User requested a new password
			case 'newpass' :
				bbp_add_error( 'newpass',    esc_html__( 'Check your e-mail for your new password.',         'bbpress' ), 'message' );
				break;

// User is newly registered
			case 'registered' :
				bbp_add_error( 'registered', esc_html__( 'Registration complete. Please check your e-mail.', 'bbpress' ), 'message' );
				break;
		}
	}
}

/**
 * Redirect a user back to their profile if they are already logged in.
 *
 * This should be used before {@link get_header()} is called in template files
 * where the user should never have access to the contents of that file.
 *
 * @since 2.0.0 bbPress (r2815)
 *
 * @param string $url The URL to redirect to
 */
function bbp_logged_in_redirect( $url = '' ) {

// Bail if user is not logged in
	if ( ! is_user_logged_in() ) {
		return;
	}

// Setup the profile page to redirect to
	$redirect_to = ! empty( $url ) ? $url : bbp_get_user_profile_url( bbp_get_current_user_id() );

// Do a safe redirect
	bbp_redirect( $redirect_to );
}

/**
 * Output the required hidden fields when logging in
 *
 * @since 2.0.0 bbPress (r2815)
 */
function bbp_user_login_fields() {
?>

<?php

// Allow custom login redirection
	$redirect_to = apply_filters( 'bbp_user_login_redirect_to', '' );
	bbp_redirect_to_field( $redirect_to );

// Prevent intention hi-jacking of log-in form
	wp_nonce_field( 'bbp-user-login' );
}

/** Register ******************************************************************/

/**
 * Output the required hidden fields when registering
 *
 * @since 2.0.0 bbPress (r2815)
 */
function bbp_user_register_fields() {
?>

<?php

// Allow custom registration redirection
	$redirect_to = apply_filters( 'bbp_user_register_redirect_to', '' );
	bbp_redirect_to_field( add_query_arg( array( 'checkemail' => 'registered' ), $redirect_to ) );

// Prevent intention hi-jacking of sign-up form
	wp_nonce_field( 'bbp-user-register' );
}

/** Lost Password *************************************************************/

/**
 * Output the required hidden fields when user lost password
 *
 * @since 2.0.0 bbPress (r2815)
 */
function bbp_user_lost_pass_fields() {
?>

<?php

// Allow custom lost pass redirection
	$redirect_to = apply_filters( 'bbp_user_lost_pass_redirect_to', get_permalink() );
	bbp_redirect_to_field( add_query_arg( array( 'checkemail' => 'confirm' ), $redirect_to ) );

// Prevent intention hi-jacking of lost pass form
	wp_nonce_field( 'bbp-user-lost-pass' );
}

/** Author Avatar *************************************************************/

/**
 * Output the author link of a post
 *
 * @since 2.0.0 bbPress (r2875)
 *
 * @param array $args Optional. If it is an integer, it is used as post id.
 */
function bbp_author_link( $args = array() ) {
	echo bbp_get_author_link( $args );
}
	/**
	 * Return the author link of the post
	 *
	 * @since 2.0.0 bbPress (r2875)
	 *
	 * @param array $args Optional. If an integer, it is used as reply id.
	 * @return string Author link of reply
	 */
	function bbp_get_author_link( $args = array() ) {

$post_id = is_numeric( $args ) ? (int) $args : 0;

// Parse arguments against default values
		$r = bbp_parse_args( $args, array(
			'post_id'    => $post_id,
			'link_title' => '',
			'type'       => 'both',
			'size'       => 80,
			'sep'        => ''
		), 'get_author_link' );

// Confirmed topic
		if ( bbp_is_topic( $r['post_id'] ) ) {
			return bbp_get_topic_author_link( $r );

// Confirmed reply
		} elseif ( bbp_is_reply( $r['post_id'] ) ) {
			return bbp_get_reply_author_link( $r );
		}

// Default return value
		$author_link = '';

// Neither a reply nor a topic, so could be a revision
		if ( ! empty( $r['post_id'] ) ) {

// Get some useful reply information
			$user_id    = get_post_field( 'post_author', $r['post_id'] );
			$author_url = bbp_get_user_profile_url( $user_id );
			$anonymous  = bbp_is_reply_anonymous( $r['post_id'] );

// Generate title with the display name of the author
			if ( empty( $r['link_title'] ) ) {
				$author = get_the_author_meta( 'display_name', $user_id );
				$title  = empty( $anonymous )
					? esc_attr__( "View %s's profile",  'bbpress' )
					: esc_attr__( "Visit %s's website", 'bbpress' );

$r['link_title'] = sprintf( $title, $author );
			}

// Setup title and author_links array
			$author_links = array();
			$link_title   = ! empty( $r['link_title'] )
				? ' title="' . esc_attr( $r['link_title'] ) . '"'
				: '';

// Get avatar (unescaped, because HTML)
			if ( ( 'avatar' === $r['type'] ) || ( 'both' === $r['type'] ) ) {
				$author_links['avatar'] = get_avatar( $user_id, $r['size'] );
			}

// Get display name (escaped, because never HTML)
			if ( ( 'name' === $r['type'] ) || ( 'both' === $r['type'] ) ) {
				$author_links['name'] = esc_html( get_the_author_meta( 'display_name', $user_id ) );
			}

// Empty array
			$links  = array();
			$sprint = '<span %1$s>%2$s</span>';

// Wrap each link
			foreach ( $author_links as $link => $link_text ) {
				$link_class = ' class="bbp-author-' . esc_attr( $link ) . '"';
				$links[]    = sprintf( $sprint, $link_class, $link_text );
			}

// Juggle
			$author_links = $links;
			unset( $links );

// Filter sections
			$sections    = apply_filters( 'bbp_get_author_links', $author_links, $r, $args );

// Assemble sections into author link
			$author_link = implode( $r['sep'], $sections );

// Only wrap in link if profile exists
			if ( empty( $anonymous ) && bbp_user_has_profile( $user_id ) ) {
				$author_link = sprintf( '<a href="%1$s"%2$s%3$s>%4$s</a>', esc_url( $author_url ), $link_title, ' class="bbp-author-link"', $author_link );
			}
		}

// Filter & return
		return apply_filters( 'bbp_get_author_link', $author_link, $r, $args );
	}

/** Capabilities **************************************************************/

/**
 * Check if the user can access a specific forum
 *
 * @since 2.0.0 bbPress (r3127)
 *
 * @return bool
 */
function bbp_user_can_view_forum( $args = array() ) {

// Parse arguments against default values
	$r = bbp_parse_args( $args, array(
		'user_id'         => bbp_get_current_user_id(),
		'forum_id'        => bbp_get_forum_id(),
		'check_ancestors' => false
	), 'user_can_view_forum' );

// Validate parsed values
	$user_id  = bbp_get_user_id( $r['user_id'], false, false );
	$forum_id = bbp_get_forum_id( $r['forum_id'] );
	$retval   = false;

// User is a keymaster
	if ( ! empty( $user_id ) && bbp_is_user_keymaster( $user_id ) ) {
		$retval = true;

// Forum is public, and user can read forums or is not logged in
	} elseif ( bbp_is_forum_public( $forum_id, $r['check_ancestors'] ) ) {
		$retval = true;

// Forum is private, and user can see it
	} elseif ( bbp_is_forum_private( $forum_id, $r['check_ancestors'] ) && user_can( $user_id, 'read_forum', $forum_id ) ) {
		$retval = true;

// Forum is hidden, and user can see it
	} elseif ( bbp_is_forum_hidden( $forum_id, $r['check_ancestors'] ) && user_can( $user_id, 'read_forum', $forum_id  ) ) {
		$retval = true;
	}

// Filter & return
	return apply_filters( 'bbp_user_can_view_forum', $retval, $forum_id, $user_id );
}

/**
 * Check if the current user can publish topics
 *
 * @since 2.0.0 bbPress (r3127)
 *
 * @return bool
 */
function bbp_current_user_can_publish_topics() {

// Users need to earn access
	$retval = false;

// Always allow keymasters
	if ( bbp_is_user_keymaster() ) {
		$retval = true;

// Do not allow anonymous if not enabled
	} elseif ( ! is_user_logged_in() && bbp_allow_anonymous() ) {
		$retval = true;

// User is logged in
	} elseif ( current_user_can( 'publish_topics' ) ) {
		$retval = true;
	}

// Filter & return
	return (bool) apply_filters( 'bbp_current_user_can_publish_topics', $retval );
}

/**
 * Check if the current user can publish forums
 *
 * @since 2.1.0 bbPress (r3549)
 *
 * @return bool
 */
function bbp_current_user_can_publish_forums() {

// Users need to earn access
	$retval = false;

// Always allow keymasters
	if ( bbp_is_user_keymaster() ) {
		$retval = true;

// User is logged in
	} elseif ( current_user_can( 'publish_forums' ) ) {
		$retval = true;
	}

// Filter & return
	return (bool) apply_filters( 'bbp_current_user_can_publish_forums', $retval );
}

/**
 * Check if the current user can publish replies
 *
 * @since 2.0.0 bbPress (r3127)
 *
 * @return bool
 */
function bbp_current_user_can_publish_replies() {

// Users need to earn access
	$retval = false;

// Always allow keymasters
	if ( bbp_is_user_keymaster() ) {
		$retval = true;

// Do not allow anonymous if not enabled
	} elseif ( ! is_user_logged_in() && bbp_allow_anonymous() ) {
		$retval = true;

// User is logged in
	} elseif ( current_user_can( 'publish_replies' ) ) {
		$retval = true;
	}

// Filter & return
	return (bool) apply_filters( 'bbp_current_user_can_publish_replies', $retval );
}

/** Forms *********************************************************************/

/**
 * The following functions should be turned into mapped meta capabilities in a
 * future version. They exist only to remove complex logistical capability
 * checks from within template parts.
 */

/**
 * Get the forums the current user has the ability to see and post to
 *
 * @since 2.0.0 bbPress (r3127)
 *
 * @param array $args
 *
 * @return array
 */
function bbp_get_forums_for_current_user( $args = array() ) {

// Parse arguments against default values
	$r = bbp_parse_args( $args, array(
		'post_type'    => bbp_get_forum_post_type(),
		'post_status'  => bbp_get_public_status_id(),
		'post__not_in' => bbp_exclude_forum_ids( 'array' ),
		'numberposts'  => -1
	), 'get_forums_for_current_user' );

// Get the forums
	$forums = get_posts( $r );

// No availabe forums
	if ( empty( $forums ) ) {
		$forums = false;
	}

// Filter & return
	return apply_filters( 'bbp_get_forums_for_current_user', $forums, $r, $args );
}

/**
 * Performs a series of checks to ensure the current user can create forums.
 *
 * @since 2.1.0 bbPress (r3549)
 *
 * @return bool
 */
function bbp_current_user_can_access_create_forum_form() {

// Users need to earn access
	$retval = false;

// Always allow keymasters
	if ( bbp_is_user_keymaster() ) {
		$retval = true;

// Looking at a single forum & forum is open
	} elseif ( ( is_page() || is_single() ) && bbp_is_forum_open() ) {
		$retval = bbp_current_user_can_publish_forums();

// User can edit this forum
	} else {
		$retval = current_user_can( 'edit_forum', bbp_get_forum_id() );
	}

// Filter & return
	return (bool) apply_filters( 'bbp_current_user_can_access_create_forum_form', (bool) $retval );
}

/**
 * Performs a series of checks to ensure the current user can create topics.
 *
 * @since 2.0.0 bbPress (r3127)
 *
 * @return bool
 */
function bbp_current_user_can_access_create_topic_form() {

// Users need to earn access
	$retval = false;

// Always allow keymasters
	if ( bbp_is_user_keymaster() ) {
		$retval = true;

// Looking at a single forum & forum is open
	} elseif ( ( bbp_is_single_forum() || is_page() || is_single() ) && bbp_is_forum_open() ) {
		$retval = bbp_current_user_can_publish_topics();

// User can edit this topic
	} else {
		$retval = current_user_can( 'edit_topic', bbp_get_topic_id() );
	}

// Filter & return
	return (bool) apply_filters( 'bbp_current_user_can_access_create_topic_form', (bool) $retval );
}

/**
 * Performs a series of checks to ensure the current user can create replies.
 *
 * @since 2.0.0 bbPress (r3127)
 *
 * @return bool
 */
function bbp_current_user_can_access_create_reply_form() {

// Users need to earn access
	$retval = false;

// Always allow keymasters
	if ( bbp_is_user_keymaster() ) {
		$retval = true;

// Looking at a single topic, topic is open, and forum is open
	} elseif ( ( bbp_is_single_topic() || is_page() || is_single() ) && bbp_is_topic_open() && bbp_is_forum_open() && bbp_is_topic_published() ) {
		$retval = bbp_current_user_can_publish_replies();

// User can edit this reply
	} elseif ( bbp_get_reply_id() ) {
		$retval = current_user_can( 'edit_reply', bbp_get_reply_id() );

// User can edit this topic
	} elseif ( bbp_get_topic_id() ) {
		$retval = current_user_can( 'edit_topic', bbp_get_topic_id() );
	}

// Filter & return
	return (bool) apply_filters( 'bbp_current_user_can_access_create_reply_form', (bool) $retval );
}

/**
 * Performs a series of checks to ensure the current user should see the
 * anonymous user form fields.
 *
 * @since 2.5.0 bbPress (r5119)
 *
 * @return bool
 */
function bbp_current_user_can_access_anonymous_user_form() {

// Users need to earn access
	$retval = false;

// User is not logged in, and anonymous posting is allowed
	if ( bbp_is_anonymous() ) {
		$retval = true;

// User is editing a topic, and topic is authored by anonymous user
	} elseif ( bbp_is_topic_edit() && bbp_is_topic_anonymous() ) {
		$retval = true;

// User is editing a reply, and reply is authored by anonymous user
	} elseif ( bbp_is_reply_edit() && bbp_is_reply_anonymous() ) {
		$retval = true;
	}

// Filter & return
	return (bool) apply_filters( 'bbp_current_user_can_access_anonymous_user_form', (bool) $retval );
}

/** Moderators ****************************************************************/

/**
 * Output the moderators of a forum
 *
 * @since 2.6.0 bbPress
 *
 * @param int   $forum_id Optional. Topic id
 * @param array $args     See {@link bbp_get_moderator_list()}
 */
function bbp_moderator_list( $forum_id = 0, $args = array() ) {
	echo bbp_get_moderator_list( $forum_id, $args );
}

/**
	 * Return the moderators for an object
	 *
	 * @since 2.6.0 bbPress
	 *
	 * @param int   $object_id Optional. Object id
	 * @param array $args     This function supports these arguments:
	 *  - before: Before the tag list
	 *  - sep: Tag separator
	 *  - after: After the tag list
	 *
	 * @return string Moderator list of the object
	 */
	function bbp_get_moderator_list( $object_id = 0, $args = array() ) {

// Parse arguments against default values
		$r = bbp_parse_args( $args, array(
			'before' => '<div class="bbp-moderators"><p>' . esc_html__( 'Moderators:', 'bbpress' ) . '&nbsp;',
			'sep'    => ', ',
			'after'  => '</p></div>',
			'none'   => ''
		), 'get_moderator_list' );

// Get forum moderators
		$user_ids = bbp_get_moderator_ids( $object_id );
		if ( ! empty( $user_ids ) ) {

// In admin, use nicenames
			if ( is_admin() ) {
				$users = bbp_get_user_nicenames_from_ids( $user_ids );

// In theme, use display names & profile links
			} else {
				foreach ( $user_ids as $user_id ) {
					$users[] = bbp_get_user_profile_link( $user_id );
				}
			}

$retval = $r['before'] . implode( $r['sep'], $users ) . $r['after'];

// No forum moderators
		} else {
			$retval = $r['none'];
		}

// Filter & return
		return apply_filters( 'bbp_get_moderator_list', $retval );
	}