<?php
/**
 * Deprecated Functions.
 *
 * @package BuddyPress
 * @deprecated 15.0.0
 */

/**
 * Output whether signup is allowed.
 *
 * @since 1.1.0
 * @deprecated 15.0.0
 */
function bp_signup_allowed() {
	_deprecated_function( __FUNCTION__, '15.0.0', 'bp_get_signup_allowed()' );

	// phpcs:ignore WordPress.Security.EscapeOutput
	echo bp_get_signup_allowed();
}

/**
 * Delete an activity item by activity id.
 *
 * @since 1.1.0
 * @deprecated 15.0.0
 *
 * @param array|string $args Optional. See BP_Activity_Activity::get for a
 *                           description of accepted arguments.
 * @return bool
 */
function bp_activity_delete_by_item_id( $args = '' ) {
	_deprecated_function( __FUNCTION__, '15.0.0', 'bp_activity_delete()' );

	$r = bp_parse_args(
		$args,
		array(
			'item_id'           => false,
			'component'         => false,
			'type'              => false,
			'user_id'           => false,
			'secondary_item_id' => false,
		)
	);

	return bp_activity_delete( $r );
}

/**
 * Delete an activity item by its content.
 *
 * @since 1.1.0
 * @deprecated 15.0.0
 *
 * @param int    $user_id   The user id.
 * @param string $content   The activity id.
 * @param string $component The activity component.
 * @param string $type      The activity type.
 * @return bool
 */
function bp_activity_delete_by_content( $user_id, $content, $component, $type ) {
	_deprecated_function( __FUNCTION__, '15.0.0', 'bp_activity_delete()' );

	return bp_activity_delete(
		array(
			'user_id'   => $user_id,
			'content'   => $content,
			'component' => $component,
			'type'      => $type
		)
	);
}

/**
 * Delete a user's activity for a component.
 *
 * @since 1.1.0
 * @deprecated 15.0.0
 *
 * @param int    $user_id   The user id.
 * @param string $component The activity component.
 * @return bool
 */
function bp_activity_delete_for_user_by_component( $user_id, $component ) {
	_deprecated_function( __FUNCTION__, '15.0.0', 'bp_activity_delete()' );

	return bp_activity_delete(
		array(
			'user_id'   => $user_id,
			'component' => $component
		)
	);
}

/**
 * Delete an activity item by activity id.
 *
 * @since 1.1.0
 * @deprecated 15.0.0
 *
 * @param int $activity_id ID of the activity item to be deleted.
 * @return bool
 */
function bp_activity_delete_by_activity_id( $activity_id ) {
	_deprecated_function( __FUNCTION__, '15.0.0', 'bp_activity_delete()' );

	return bp_activity_delete( array( 'id' => $activity_id ) );
}

/**
 * Update the spam status of the member on multisite configs.
 *
 * @since 5.0.0
 * @deprecated 15.0.0
 *
 * @param int    $user_id Optional. The user ID to spam or ham.
 * @param string $value   Optional. '0' to mark the user as `ham`, '1' to mark as `spam`.
 * @return bool
 */
function bp_core_update_member_status( $user_id = 0, $value = 0 ) {
	_deprecated_function( __FUNCTION__, '15.0.0' );

	if ( ! is_multisite() || ! $user_id ) {
		return false;
	}

	/**
	 * The `update_user_status()` function is deprecated since WordPress 5.3.0.
	 * Continue to use it if WordPress current major version is lower than 5.3.
	 */
	if ( bp_get_major_wp_version() < 5.3 ) {
		return update_user_status( $user_id, 'spam', $value );
	}

	if ( $value ) {
		$value = '1';
	}

	// Otherwise use the replacement function.
	$user = wp_update_user(
		array(
			'ID'   => $user_id,
			'spam' => $value,
		)
	);

	if ( is_wp_error( $user ) ) {
		return false;
	}

	return true;
}