функция since 3.1.0

get_dashboard_url()

Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.

Сигнатура

get_dashboard_url( int $user_id, string $path = '', string $scheme = 'admin' ): string

Описание

Если пользователь не принадлежит ни одному сайту, используется глобальная консоль пользователя. Если пользователь принадлежит текущему сайту, возвращается консоль текущего сайта. Если пользователь не может редактировать текущий сайт, возвращается консоль его основного сайта.

Оригинал (английский)

If a user does not belong to any site, the global user dashboard is used. If the user belongs to the current site, the dashboard for the current site is returned. If the user cannot edit the current site, the dashboard to the user’s primary site is returned.

Параметры

$user_id int необязательный
ID пользователя. По умолчанию текущий пользователь.
$path string необязательный = ''
Необязательный путь относительно консоли. Используйте только пути, известные администраторам как сайта, так и пользователя.
$scheme string необязательный = 'admin'
Используемая схема. Значение по умолчанию 'admin', которое подчиняется force_ssl_admin() и is_ssl() . Можно передать 'http' или 'https', чтобы принудительно задать эти схемы.

Возвращаемое значение

string

Исходный код

wp-includes/link-template.php:3984

function get_dashboard_url( $user_id = 0, $path = '', $scheme = 'admin' ) {
	$user_id = $user_id ? (int) $user_id : get_current_user_id();

	$blogs = get_blogs_of_user( $user_id );

	if ( is_multisite() && ! user_can( $user_id, 'manage_network' ) && empty( $blogs ) ) {
		$url = user_admin_url( $path, $scheme );
	} elseif ( ! is_multisite() ) {
		$url = admin_url( $path, $scheme );
	} else {
		$current_blog = get_current_blog_id();

		if ( $current_blog && ( user_can( $user_id, 'manage_network' ) || in_array( $current_blog, array_keys( $blogs ), true ) ) ) {
			$url = admin_url( $path, $scheme );
		} else {
			$active = get_active_blog_for_user( $user_id );
			if ( $active ) {
				$url = get_admin_url( $active->blog_id, $path, $scheme );
			} else {
				$url = user_admin_url( $path, $scheme );
			}
		}
	}

	/**
	 * Filters the dashboard URL for a user.
	 *
	 * @since 3.1.0
	 *
	 * @param string $url     The complete URL including scheme and path.
	 * @param int    $user_id The user ID.
	 * @param string $path    Path relative to the URL. Blank string if no path is specified.
	 * @param string $scheme  Scheme to give the URL context. Accepts 'http', 'https', 'login',
	 *                        'login_post', 'admin', 'relative' or null.
	 */
	return apply_filters( 'user_dashboard_url', $url, $user_id, $path, $scheme );
}

История изменений

ВерсияОписание
3.1.0 Introduced.

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.